{"openapi":"3.0.3","info":{"title":"APICK 국세 증명서 원본 확인","version":"1.0.0","description":"국세 증명서에 인쇄된 발급번호(14자리)와 등록번호로 발급 사실을 확인합니다. 납세증명서·소득금액증명·사업자등록증명 등 제출받은 증명서가 실제 발급된 것인지 위조 여부를 판정할 때 씁니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/tax_cert_verify":{"post":{"summary":"국세 증명서 원본 확인","description":"국세 증명서에 인쇄된 발급번호(14자리)와 등록번호로 발급 사실을 확인합니다. 납세증명서·소득금액증명·사업자등록증명 등 제출받은 증명서가 실제 발급된 것인지 위조 여부를 판정할 때 씁니다.","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)입니다. 확인되면 빈 값입니다."},"cert_no":{"type":"string","description":"조회한 발급번호입니다."},"issue_date":{"type":"string","description":"발급일(YYYY-MM-DD)입니다."},"issue_time":{"type":"string","description":"발급 시각(HH:MM:SS)입니다."},"tax_period":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"description":"과세기간(from·to, 연월)입니다. 증명서 종류에 따라 없을 수 있습니다."},"issue_count":{"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":{"cert_no":{"type":"string","description":"증명서의 발급번호 14자리. 연계문서는 첫 자리 T (예: 20260101123456) (string)","example":"20260101123456"},"txpr_no":{"type":"string","description":"등록번호 — 주민등록번호 앞 6자리(개인) 또는 사업자등록번호 10자리 문자열로 보내며, 빼거나 빈 값으로 보내면 요청이 거부됩니다. (string)","example":"881111"},"txpr_clsf":{"type":"string","description":"납세자 구분. 01 개인 02 사업자 (기본: 등록번호 길이로 자동 판정) 가능한 값은 2가지입니다. 01 = 01 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. 02 = 02 값을 뜻하며, 같은 응답의 다른 필드와 함께 해석하세요. (string)","enum":["01","02"]}},"required":["cert_no","txpr_no"]}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["발급번호 형식 오류","400","발급번호를 올바르게 입력하세요.","숫자 14자리(연계문서는 T+13자리)로 보냅니다."],["등록번호 형식 오류","400","등록번호를 올바르게 입력하세요.","주민 앞 6자리 또는 사업자등록번호 10자리로 보냅니다."],["일시적 조회 실패","424","국세 증명서 발급번호를 확인하지 못했습니다.","잠시 후 같은 요청을 다시 보냅니다. 과금되지 않습니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}