{"openapi":"3.0.3","info":{"title":"APICK 전자세금계산서 발급사실 확인","version":"1.0.0","description":"공급자·공급받는자 등록번호와 승인번호·작성일자·공급가액으로 전자세금계산서·전자계산서의 발급 사실을 확인합니다. 거래처가 제출한 계산서가 실제 발급된 것인지 위조 여부를 판정할 때 씁니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/tax_invoice_third_party_check":{"post":{"summary":"전자세금계산서 발급사실 확인","description":"공급자·공급받는자 등록번호와 승인번호·작성일자·공급가액으로 전자세금계산서·전자계산서의 발급 사실을 확인합니다. 거래처가 제출한 계산서가 실제 발급된 것인지 위조 여부를 판정할 때 씁니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"verified":{"type":"boolean","description":"발급 사실 확인 결과입니다. true면 발급 이력이 확인된 계산서, false면 발급 이력이 없는 계산서입니다."},"reason":{"type":"string","description":"false일 때 사유 코드(NOT_FOUND)입니다. 확인되면 빈 값입니다."},"approval_no":{"type":"string","description":"조회한 승인번호입니다."},"write_date":{"type":"string","description":"작성일자(YYYYMMDD)입니다."},"supplier_no":{"type":"string","description":"공급자 사업자등록번호입니다."},"recipient_no":{"type":"string","description":"공급받는자 등록번호입니다."},"issue_date":{"type":"string","description":"발급일(YYYY-MM-DD)입니다. 확인된 경우에만 옵니다."},"issue_time":{"type":"string","description":"발급 시각(HH:MM:SS)입니다. 값이 없으면 null입니다.","nullable":true},"doc_type":{"type":"string","description":"문서 종류(전자세금계산서·전자계산서)입니다."},"supplier_name":{"type":"string","description":"공급자 상호입니다. 값이 없으면 null입니다.","nullable":true},"recipient_name":{"type":"string","description":"공급받는자 상호입니다. 값이 없으면 null입니다.","nullable":true},"supply_amount":{"type":"integer","description":"공급가액(원)입니다. 값이 없으면 null입니다.","nullable":true},"tax_amount":{"type":"integer","description":"세액(원)입니다. 값이 없으면 null입니다.","nullable":true}}},"api":{"type":"object","properties":{"success":{"type":"boolean"},"cost":{"type":"integer","description":"차감된 포인트입니다. 실패하면 0입니다."},"ms":{"type":"integer","description":"처리 시간(밀리초)입니다."},"pl_id":{"type":"integer","description":"과금 기록 번호입니다. 문의할 때 함께 알려 주세요."}}}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"splr_no":{"type":"string","description":"공급자 사업자등록번호 10자리 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"1208800767"},"dmnr_no":{"type":"string","description":"공급받는자 등록번호 — 사업자 10자리 또는 주민 13자리 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"2208162517"},"etan":{"type":"string","description":"승인번호(24자리 이상, 공백·하이픈 제거 후 사용) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"202611014100000000000000"},"wrt_dt":{"type":"string","description":"작성일자 YYYYMMDD 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"20261101"},"sum_amt":{"type":"string","description":"공급가액(원, 숫자만) 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"100000"}},"required":["splr_no","dmnr_no","etan","wrt_dt","sum_amt"]}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["입력 형식 오류","400","공급자 사업자등록번호를 올바르게 입력하세요. 등 안내 문구","각 항목의 형식을 확인해 다시 보냅니다."],["일시적 조회 실패","424","전자(세금)계산서 발급사실을 확인하지 못했습니다.","잠시 후 같은 요청을 다시 보냅니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}