{"openapi":"3.0.3","info":{"title":"APICK 사업자 증빙서류 통합 조회","version":"1.0.0","description":"본인 간편인증 후 사업자 증빙서류 통합 조회 자료를 확인합니다. 문서확인번호: 발급된 사업자등록증명의 문서확인번호 상호: 사업자 상호 사업자등록번호: 대상 사업자등록번호 10자리 개업일자: 개업일자"},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/req_business_cert_bundle":{"post":{"summary":"사업자 증빙서류 통합 조회","description":"본인 간편인증 후 사업자 증빙서류 통합 조회 자료를 확인합니다. 문서확인번호: 발급된 사업자등록증명의 문서확인번호 상호: 사업자 상호 사업자등록번호: 대상 사업자등록번호 10자리 개업일자: 개업일자","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","description":"결과 스키마 버전 (고정값: \"1.0\")"},"transactionId":{"type":"string","description":"결과 조회에 사용하는 트랜잭션 ID"},"product":{"type":"string","description":"조회 항목 코드. 결과조회에도 같은 값이 오므로 어느 항목의 결과인지 대조할 수 있습니다."},"status":{"type":"string","description":"처리 상태 (AUTH_REQUESTED: 인증 요청 완료)"},"resultAvailable":{"type":"boolean","description":"결과 데이터 포함 여부. 인증 요청 응답은 항상 false 입니다."},"charged":{"type":"boolean","description":"이번 호출의 과금 발생 여부. 실제 발송에 성공하면 true 입니다."},"sources":{"type":"array","items":{}},"message":{"type":"string","description":"상태 메시지 (고정값: \"인증 대기중입니다.\")"},"expiresAt":{"type":"string","description":"인증 유효 기한(ISO 8601). 이 시각까지 승인하지 못하면 인증 실패 처리됩니다."},"success":{"type":"integer","description":"과금 여부0: 실패 또는 재사용(무과금)1: 발송 성공(과금)"},"approvals":{"type":"integer","description":"필요한 간편인증 승인 횟수. 조회 항목 하나당 1회입니다."}},"description":"인증 요청 결과"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"조회 대상의 이름입니다. 간편인증·개인 조회에서는 성명, 기업 조회에서는 법인명·상호를 뜻합니다. 생년월일·전화번호 같은 보조 식별자와 함께 확인하세요. (string)","example":"홍길동"},"birthDate":{"type":"string","description":"대상자의 생년월일 8자리입니다. 예: 19900101. 주민등록상 생년월일과 같아야 하며, 하이픈·공백은 넣지 않습니다. (string)","example":"19900101"},"phone":{"type":"string","description":"본인 명의 휴대전화 번호입니다. 하이픈 없이 숫자만 입력하며(예: 01012341234), 인증 문자를 받을 수 있는 번호여야 합니다. (string)","example":"01011112222"},"authProvider":{"type":"string","description":"사용할 간편인증 수단의 식별자입니다. 예: kakao, naver, toss, pass. 지원 값과 표시 이름은 이 문서의 간편인증 목록을 확인하세요. (string)","example":"kakao"},"business_no":{"type":"string","description":"사업자등록번호 10자리 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"1234567890"},"engl_yn":{"type":"string","description":"영문 증명 여부 Y/N(기본 N) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"N"},"use_purpose":{"type":"string","description":"사용용도 코드(10097) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"99"},"submit_to":{"type":"string","description":"제출처 코드(10150) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"99"},"delivery":{"type":"string","description":"교부방법(06 프린터·10 화면·04 팩스·12 전자문서지갑) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"06"},"quantity":{"type":"string","description":"발급희망수량 1~5 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"1"},"email":{"type":"string","description":"검증·발송할 이메일 주소입니다. @와 도메인을 포함한 전체 주소를 보내며, 형식이 맞지 않으면 조회 전에 거부됩니다. (string)"},"fax_no":{"type":"string","description":"팩스번호(팩스 발송 시 필수) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"wallet_address":{"type":"string","description":"전자문서지갑 주소(지갑 발급 시 필수) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"format":{"type":"string","description":"응답 형식(pdf=PDF만·json=PDF를 JSON으로 파싱·both=둘 다, 기본 both) (string)","example":"both"},"year":{"type":"string","description":"조회할 연도(4자리)입니다. 서비스별 지원 범위를 확인하세요. (string)","example":"2025"},"period":{"type":"string","description":"과세기간(1=1기, 2=2기, all=연간) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)","example":"all"},"agreed":{"type":"string","description":"대표자 본인 확인 동의. bind_id 가 없으면 true 로 보내야 접수됩니다. 빠지면 인증을 보내지 않고 무과금으로 거절합니다. 결과에 대표자명이 있으면 응답의 bind_id 로 다음 조회에 다시 쓸 수 있습니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)","example":"true"},"bind_id":{"type":"string","description":"이전 사업자 조회 결과에서 받은 bind_id. 같은 계정·같은 사업자등록번호이고 유효기간(90일) 안이면 agreed 없이 접수합니다. (string)"}},"required":["name","birthDate","phone","authProvider","business_no","use_purpose","submit_to","delivery","year"]}}}}}},"/rest/get_business_cert_bundle":{"post":{"summary":"사업자 증빙서류 통합 조회","description":"본인 간편인증 후 사업자 증빙서류 통합 조회 자료를 확인합니다. 문서확인번호: 발급된 사업자등록증명의 문서확인번호 상호: 사업자 상호 사업자등록번호: 대상 사업자등록번호 10자리 개업일자: 개업일자","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"schemaVersion":{"type":"string","description":"결과 스키마 버전 (고정값: \"1.0\")"},"transactionId":{"type":"string","description":"트랜잭션 ID"},"product":{"type":"string","description":"조회 항목 코드. 인증요청 응답과 같은 값입니다."},"status":{"type":"string","description":"처리 상태 (위 표 참고)"},"resultAvailable":{"type":"boolean","description":"실제 결과 포함 여부. 과금 여부도 이 값으로 결정됩니다."},"charged":{"type":"boolean","description":"이번 호출의 과금 발생 여부. 최초 결과 반환에서만 true 입니다."},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"type":{"type":"string"},"status":{"type":"string"}}},"description":"항상 포함됩니다. 값이 없으면 빈 배열 [] 입니다. 항목이 여러 개인 상품에서 어느 것이 성공·실패했는지 알려줍니다. 각 항목은 source(자료 이름), type(데이터 종류), status(SUCCESS/FAILED). 결과 준비가 끝나기 전에는 아직 확정되지 않은 항목이 FAILED 로 보일 수 있습니다."},"message":{"type":"string","description":"상태 메시지"},"expiresAt":{"type":"string"},"success":{"type":"integer","description":"과금 여부0: 결과 없음 또는 재조회(무과금)1: 최초 결과 반환(과금)"},"progress":{"type":"object","properties":{"total":{"type":"integer"},"completed":{"type":"integer"}},"description":"진행률(COLLECTING 일 때). total(전체 항목), completed(완료 항목)"},"checkedAt":{"type":"string","description":"실제 정보를 확인한 시각. 한국시간(UTC+09:00) ISO 8601 이며 재조회 유효기간의 기준입니다."},"resultExpiresAt":{"type":"string","description":"결과 재조회 만료 시각. 한국시간(UTC+09:00) ISO 8601 입니다."},"result":{"type":"object","properties":{"businessRegistrationCert":{"type":"object","additionalProperties":true,"properties":{"문서확인번호":{"type":"string","description":"발급된 사업자등록증명의 문서확인번호"},"상호":{"type":"string","description":"사업자 상호"},"사업자등록번호":{"type":"string","description":"대상 사업자등록번호 10자리"},"개업일자":{"type":"string","description":"개업일자"},"업태":{"type":"string","description":"업태"},"종목":{"type":"string","description":"종목"},"PDF데이터":{"type":"object","description":"PDF를 JSON으로 파싱한 값(PDF데이터 공통 구조)","properties":{}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"vatTaxBaseCert":{"type":"object","properties":{"문서확인번호":{"type":"string","description":"발급된 증명의 문서확인번호"},"귀속연도":{"type":"string","description":"귀속연도 4자리"},"과세기간":{"type":"string","description":"과세기간 표기"},"과세표준":{"type":"string","description":"과세표준 금액(원 단위 숫자)"},"매출세액":{"type":"string","description":"매출세액(원 단위 숫자)"},"PDF데이터":{"type":"object","description":"PDF를 JSON으로 파싱한 값(PDF데이터 공통 구조)"}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"financialStatementCert":{"type":"object","properties":{"문서확인번호":{"type":"string","description":"발급된 증명의 문서확인번호"},"귀속연도":{"type":"string","description":"사업연도 4자리"},"자산총계":{"type":"string","description":"자산총계(원 단위 숫자)"},"부채총계":{"type":"string","description":"부채총계(원 단위 숫자)"},"자본총계":{"type":"string","description":"자본총계(원 단위 숫자)"},"매출액":{"type":"string","description":"매출액(원 단위 숫자)"},"영업이익":{"type":"string","description":"영업이익(원 단위 숫자)"},"당기순이익":{"type":"string","description":"당기순이익(원 단위 숫자)"},"PDF데이터":{"type":"object","description":"PDF를 JSON으로 파싱한 값(PDF데이터 공통 구조)"}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."}},"description":"조회된 결과 묶음. 실제 데이터가 있을 때만 포함됩니다."},"errorCode":{"type":"string","description":"오류 구분. RESULT_EXPIRED(재조회 기간 만료) / AUTH_EXPIRED / AUTH_REJECTED / COLLECT_FAILED"}},"description":"상태·결과"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"transactionId":{"type":"string","description":"/rest/req_business_cert_bundle 가 반환한 트랜잭션 ID (string)","example":"9f2c4a7b1d8e35c60a4f7b2d1e9c803a"}},"required":["transactionId"]}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}