{"openapi":"3.0.3","info":{"title":"APICK 사업자 국세 통합조회","version":"1.0.0","description":"본인 간편인증 후 사업자 국세 통합조회 자료를 확인합니다. 사업자등록번호: 조회한 사업자등록번호 10자리 귀속연도: 귀속연도 4자리 반기: 상반기 또는 하반기 매출건수: 전자세금계산서 매출 건수"},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/req_hometax_biz_bundle":{"post":{"summary":"사업자 국세 통합조회","description":"본인 간편인증 후 사업자 국세 통합조회 자료를 확인합니다. 사업자등록번호: 조회한 사업자등록번호 10자리 귀속연도: 귀속연도 4자리 반기: 상반기 또는 하반기 매출건수: 전자세금계산서 매출 건수","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":"상태 메시지 (고정값: \"인증 대기중입니다.\")"},"approvals":{"type":"integer","description":"사용자가 휴대폰에서 승인해야 하는 횟수. 같은 인증으로 처리되는 조회는 묶음이어도 1회입니다."},"expiresAt":{"type":"string","description":"인증 유효 기한(ISO 8601). 이 시각까지 승인하지 못하면 인증 실패 처리됩니다."},"success":{"type":"integer","description":"과금 여부0: 실패 또는 재사용(무과금)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"},"businessNo":{"type":"string","description":"사업자등록번호 10자리 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"businessYear":{"type":"string","description":"귀속연도 4자리. 없으면 지난해 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"business_type":{"type":"string","description":"사업자 구분. corporate(법인)는 공동인증서가 필수, personal(개인)은 간편인증·공동인증서 모두 가능. 없으면 personal (string)"},"certificate_id":{"type":"string","description":"등록한 공동인증서 ID. 없으면 기본 인증서를 쓴다 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"auth_type":{"type":"string","description":"인증 방식. certificate(공동인증서) 또는 simple(간편인증). 없으면 business_type·certificate_id 로 정한다 (string)"},"business_no":{"type":"string","description":"사업자등록번호 10자리 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"engl_yn":{"type":"string","description":"영문 증명 여부 Y/N(기본 N) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"use_purpose":{"type":"string","description":"사용용도 코드 2자리. 모르면 99(기타)를 보냅니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"submit_to":{"type":"string","description":"제출처 코드 2자리. 모르면 99(기타)를 보냅니다. 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"delivery":{"type":"string","description":"교부방법(06 프린터·10 화면·04 팩스·12 전자문서지갑). 문서는 응답으로 받으므로 보통 06 을 보냅니다. (string)"},"quantity":{"type":"string","description":"발급희망수량 1~5(생략 시 1) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"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)"},"year":{"type":"string","description":"귀속연도 4자리(최근 5년) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"period":{"type":"string","description":"과세기간(1=1기, 2=2기, all=연간) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"cert_type":{"type":"string","description":"증명 종류(B0006 납세증명서·B0010 해외이주용). 해외이주용은 submit_to 를 06 으로 보냅니다. (string)"},"start_month":{"type":"string","description":"수납기간 시작월 2자리(01~12, 생략 시 01) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"end_month":{"type":"string","description":"수납기간 종료월 2자리(01~12, 생략 시 12) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"itrf_cd":{"type":"string","description":"세목 코드 2자리(10 종합소득세·41 부가가치세·99 기타) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"issuance":{"type":"string","description":"발급유형(1 한글·2 영문, 생략 시 1) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"from":{"type":"string","description":"조회 시작 연월입니다. YYYY-MM 형식(예: 1995-01)으로 보내며, 종료 연월보다 늦으면 빈 결과가 옵니다. (string)","example":"2025-01"},"to":{"type":"string","description":"조회 종료 연월입니다. YYYY-MM 형식(예: 2025-12)으로 보내며, 시작 연월보다 빠르면 빈 결과가 옵니다. (string)","example":"2025-12"},"bind_id":{"type":"string","description":"이미 확인한 사업자 바인딩 ID 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"agreed":{"type":"string","description":"바인딩이 없을 때 사업자 정보 확인에 동의하면 true true/false로 보내며, 생략하면 서버 기본값이 적용됩니다. true = 이 필드가 나타내는 조건이 성립한 경우, false = 성립하지 않은 경우입니다. 두 값 모두 정상 응답에 올 수 있으며, 값이 없으면 필드가 생략되거나 null일 수 있습니다. (boolean)"},"keyword":{"type":"string","description":"거래처 이름 일부로 걸러 볼 때 쓴다(40자 이내) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"}},"required":["name","birthDate","phone","authProvider"]}}}}}},"/rest/get_hometax_biz_bundle":{"post":{"summary":"사업자 국세 통합조회","description":"본인 간편인증 후 사업자 국세 통합조회 자료를 확인합니다. 사업자등록번호: 조회한 사업자등록번호 10자리 귀속연도: 귀속연도 4자리 반기: 상반기 또는 하반기 매출건수: 전자세금계산서 매출 건수","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":{"businessSales":{"type":"object","additionalProperties":true,"properties":{"사업자등록번호":{"type":"string","description":"조회한 사업자등록번호 10자리"},"귀속연도":{"type":"string","description":"귀속연도 4자리"},"반기":{"type":"string","description":"상반기 또는 하반기"},"매출건수":{"type":"integer","description":"전자세금계산서 매출 건수"},"매출공급가액":{"type":"integer","description":"매출 공급가액 합계(원)"},"매출세액":{"type":"integer","description":"매출 부가가치세 합계(원)"},"매출합계금액":{"type":"integer","description":"공급가액 + 세액(원)"}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"businessPurchase":{"type":"object","properties":{"사업자등록번호":{"type":"string","description":"조회한 사업자등록번호 10자리"},"귀속연도":{"type":"string","description":"귀속연도 4자리"},"반기":{"type":"string","description":"상반기 또는 하반기"},"매입건수":{"type":"integer","description":"전자세금계산서 매입 건수"},"매입공급가액":{"type":"integer","description":"매입 공급가액 합계(원)"},"매입세액":{"type":"integer","description":"매입 부가가치세 합계(원)"},"매입합계금액":{"type":"integer","description":"공급가액 + 세액(원)"}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"businessRegistrationCert":{"type":"object","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데이터 공통 구조)"}},"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":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"closureCert":{"type":"object","properties":{"문서확인번호":{"type":"string","description":"발급된 폐업사실증명의 문서확인번호"},"상호":{"type":"string","description":"사업자 상호"},"사업자등록번호":{"type":"string","description":"대상 사업자등록번호 10자리"},"개업일자":{"type":"string","description":"개업일자"},"폐업일자":{"type":"string","description":"폐업일자"},"업태":{"type":"string","description":"업태"},"종목":{"type":"string","description":"종목"},"PDF데이터":{"type":"object","description":"PDF를 JSON으로 파싱한 값(PDF데이터 공통 구조)"}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"taxClearanceCert":{"type":"object","properties":{"문서확인번호":{"type":"string","description":"발급된 납세증명서의 문서확인번호"},"상호":{"type":"string","description":"사업자 상호"},"사업자등록번호":{"type":"string","description":"대상 사업자등록번호 10자리"},"주소":{"type":"string","description":"사업장 주소"},"유효기간":{"type":"string","description":"증명서 유효기간"},"PDF데이터":{"type":"object","description":"PDF를 JSON으로 파싱한 값(PDF데이터 공통 구조)"}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"etaxSalesList":{"type":"object","properties":{"사업자등록번호":{"type":"string","description":"조회한 사업자등록번호 10자리"},"구분":{"type":"string","description":"매출 또는 매입"},"조회기간":{"type":"object","properties":{"시작":{"type":"string","description":"조회 시작일"},"끝":{"type":"string","description":"조회 종료일"}},"description":"실제로 조회한 기간(YYYYMMDD)"},"건수":{"type":"integer","description":"조회된 전자세금계산서 건수"},"합계":{"type":"object","properties":{"공급가액":{"type":"integer","description":"공급가액 합계(원)"},"세액":{"type":"integer","description":"부가가치세 합계(원)"},"합계금액":{"type":"integer","description":"공급가액 + 세액(원)"}},"description":"조회된 문서의 공급가액·세액 합계(원)"},"장부반영건수":{"type":"integer","description":"자체 장부에 저장된 건수. 장부 저장에 실패하면 0 이다."},"초과분있음":{"type":"boolean","description":"한 번에 돌려주는 건수 상한(100건)을 넘겨 잘렸는지"},"문서":{"type":"object","items":{"type":"object","properties":{"승인번호":{"type":"string"},"작성일자":{"type":"string"},"거래처사업자번호":{"type":"string"},"거래처상호":{"type":"string"},"공급가액":{"type":"integer"},"세액":{"type":"integer"},"합계금액":{"type":"integer"},"전송상태":{"type":"string"},"수정구분":{"type":"string"},"수정사유":{"type":"string"},"원본승인번호":{"type":"string"},"품목":{"type":"array","items":{"type":"object","properties":{"품목명":{"type":"string"},"규격":{"type":"string"},"수량":{"type":"integer"},"단가":{"type":"integer"},"공급가액":{"type":"integer"},"세액":{"type":"integer"}}}}}},"description":"승인번호 단위 문서 목록. 없으면 빈 배열이다.","properties":{"승인번호":{"type":"string","description":"전자세금계산서 승인번호"},"작성일자":{"type":"string","description":"작성일자"},"거래처사업자번호":{"type":"string","description":"거래처 사업자등록번호 10자리"},"거래처상호":{"type":"string","description":"거래처 상호"},"공급가액":{"type":"integer","description":"공급가액(원)"},"세액":{"type":"integer","description":"부가가치세(원)"},"합계금액":{"type":"integer","description":"공급가액 + 세액(원)"},"전송상태":{"type":"string","description":"전송 상태(전송완료·미전송)"},"수정구분":{"type":"string","description":"NORMAL 또는 AMENDED"},"수정사유":{"type":"string","description":"수정세금계산서 사유. 정상 문서면 빈 문자열"},"원본승인번호":{"type":"string","description":"수정세금계산서의 원본 승인번호. 정상 문서면 빈 문자열"},"품목":{"type":"array","description":"품목 목록. 없으면 빈 배열이다.","items":{"type":"object","properties":{"품목명":{"type":"string","description":"품목명"},"규격":{"type":"string","description":"규격"},"수량":{"type":"number","description":"수량"},"단가":{"type":"integer","description":"단가(원)"},"공급가액":{"type":"integer","description":"품목 공급가액(원)"},"세액":{"type":"integer","description":"품목 세액(원)"}}}}}},"안내":{"type":"string","description":"건별 내역이 0건일 때만 오는 안내 문장. 결과가 있으면 필드가 없다."}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"etaxPurchaseList":{"type":"object","properties":{"사업자등록번호":{"type":"string","description":"조회한 사업자등록번호 10자리"},"구분":{"type":"string","description":"매출 또는 매입"},"조회기간":{"type":"object","properties":{"시작":{"type":"string","description":"조회 시작일"},"끝":{"type":"string","description":"조회 종료일"}},"description":"실제로 조회한 기간(YYYYMMDD)"},"건수":{"type":"integer","description":"조회된 전자세금계산서 건수"},"합계":{"type":"object","properties":{"공급가액":{"type":"integer","description":"공급가액 합계(원)"},"세액":{"type":"integer","description":"부가가치세 합계(원)"},"합계금액":{"type":"integer","description":"공급가액 + 세액(원)"}},"description":"조회된 문서의 공급가액·세액 합계(원)"},"장부반영건수":{"type":"integer","description":"자체 장부에 저장된 건수. 장부 저장에 실패하면 0 이다."},"초과분있음":{"type":"boolean","description":"한 번에 돌려주는 건수 상한(100건)을 넘겨 잘렸는지"},"문서":{"type":"object","items":{"type":"object","properties":{"승인번호":{"type":"string"},"작성일자":{"type":"string"},"거래처사업자번호":{"type":"string"},"거래처상호":{"type":"string"},"공급가액":{"type":"integer"},"세액":{"type":"integer"},"합계금액":{"type":"integer"},"전송상태":{"type":"string"},"수정구분":{"type":"string"},"수정사유":{"type":"string"},"원본승인번호":{"type":"string"},"품목":{"type":"array","items":{"type":"object","properties":{"품목명":{"type":"string"},"규격":{"type":"string"},"수량":{"type":"integer"},"단가":{"type":"integer"},"공급가액":{"type":"integer"},"세액":{"type":"integer"}}}}}},"description":"승인번호 단위 문서 목록. 없으면 빈 배열이다.","properties":{"승인번호":{"type":"string","description":"전자세금계산서 승인번호"},"작성일자":{"type":"string","description":"작성일자"},"거래처사업자번호":{"type":"string","description":"거래처 사업자등록번호 10자리"},"거래처상호":{"type":"string","description":"거래처 상호"},"공급가액":{"type":"integer","description":"공급가액(원)"},"세액":{"type":"integer","description":"부가가치세(원)"},"합계금액":{"type":"integer","description":"공급가액 + 세액(원)"},"전송상태":{"type":"string","description":"전송 상태(전송완료·미전송)"},"수정구분":{"type":"string","description":"NORMAL 또는 AMENDED"},"수정사유":{"type":"string","description":"수정세금계산서 사유. 정상 문서면 빈 문자열"},"원본승인번호":{"type":"string","description":"수정세금계산서의 원본 승인번호. 정상 문서면 빈 문자열"},"품목":{"type":"array","description":"품목 목록. 없으면 빈 배열이다.","items":{"type":"object","properties":{"품목명":{"type":"string","description":"품목명"},"규격":{"type":"string","description":"규격"},"수량":{"type":"number","description":"수량"},"단가":{"type":"integer","description":"단가(원)"},"공급가액":{"type":"integer","description":"품목 공급가액(원)"},"세액":{"type":"integer","description":"품목 세액(원)"}}}}}},"안내":{"type":"string","description":"건별 내역이 0건일 때만 오는 안내 문장. 결과가 있으면 필드가 없다."}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"etaxSalesSummary":{"type":"object","properties":{"사업자등록번호":{"type":"string","description":"조회한 사업자등록번호 10자리"},"구분":{"type":"string","description":"매출 또는 매입"},"조회기간":{"type":"object","properties":{"시작":{"type":"string","description":"조회 시작일"},"끝":{"type":"string","description":"조회 종료일"}},"description":"실제로 조회한 기간(YYYYMMDD)"},"거래처수":{"type":"integer","description":"합계표에 잡힌 거래처 수"},"건수":{"type":"integer","description":"거래처별 전자세금계산서 매수 합계"},"합계":{"type":"object","properties":{"공급가액":{"type":"integer","description":"공급가액 합계(원)"},"세액":{"type":"integer","description":"부가가치세 합계(원)"},"합계금액":{"type":"integer","description":"공급가액 + 세액(원)"}},"description":"거래처별 합계의 총합(원)"},"거래처":{"type":"object","items":{"type":"object","properties":{"사업자등록번호":{"type":"string"},"상호":{"type":"string"},"건수":{"type":"integer"},"공급가액":{"type":"integer"},"세액":{"type":"integer"},"합계금액":{"type":"integer"},"수취구분":{"type":"string"}}},"description":"거래처별 합계 목록. 없으면 빈 배열이다.","properties":{"사업자등록번호":{"type":"string","description":"거래처 사업자등록번호. 주민등록번호 수취분은 가린 표시값"},"상호":{"type":"string","description":"거래처 상호"},"건수":{"type":"integer","description":"전자세금계산서 매수"},"공급가액":{"type":"integer","description":"공급가액 합계(원)"},"세액":{"type":"integer","description":"부가가치세 합계(원)"},"합계금액":{"type":"integer","description":"공급가액 + 세액(원)"},"수취구분":{"type":"string","description":"수취구분(사업자등록번호·주민등록번호)"}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"etaxPurchaseSummary":{"type":"object","properties":{"사업자등록번호":{"type":"string","description":"조회한 사업자등록번호 10자리"},"구분":{"type":"string","description":"매출 또는 매입"},"조회기간":{"type":"object","properties":{"시작":{"type":"string","description":"조회 시작일"},"끝":{"type":"string","description":"조회 종료일"}},"description":"실제로 조회한 기간(YYYYMMDD)"},"거래처수":{"type":"integer","description":"합계표에 잡힌 거래처 수"},"건수":{"type":"integer","description":"거래처별 전자세금계산서 매수 합계"},"합계":{"type":"object","properties":{"공급가액":{"type":"integer","description":"공급가액 합계(원)"},"세액":{"type":"integer","description":"부가가치세 합계(원)"},"합계금액":{"type":"integer","description":"공급가액 + 세액(원)"}},"description":"거래처별 합계의 총합(원)"},"거래처":{"type":"object","items":{"type":"object","properties":{"사업자등록번호":{"type":"string"},"상호":{"type":"string"},"건수":{"type":"integer"},"공급가액":{"type":"integer"},"세액":{"type":"integer"},"합계금액":{"type":"integer"},"수취구분":{"type":"string"}}},"description":"거래처별 합계 목록. 없으면 빈 배열이다.","properties":{"사업자등록번호":{"type":"string","description":"거래처 사업자등록번호. 주민등록번호 수취분은 가린 표시값"},"상호":{"type":"string","description":"거래처 상호"},"건수":{"type":"integer","description":"전자세금계산서 매수"},"공급가액":{"type":"integer","description":"공급가액 합계(원)"},"세액":{"type":"integer","description":"부가가치세 합계(원)"},"합계금액":{"type":"integer","description":"공급가액 + 세액(원)"},"수취구분":{"type":"string","description":"수취구분(사업자등록번호·주민등록번호)"}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"etaxStats":{"type":"object","properties":{"사업자등록번호":{"type":"string","description":"조회한 사업자등록번호 10자리"},"조회기간":{"type":"object","properties":{"시작":{"type":"string","description":"조회 시작 연월"},"끝":{"type":"string","description":"조회 종료 연월"}},"description":"실제로 조회한 연월(YYYYMM)"},"월수":{"type":"integer","description":"결과에 담긴 월 수"},"합계":{"type":"object","properties":{"매출건수":{"type":"integer","description":"매출 전자세금계산서 건수 합계"},"매출공급가액":{"type":"integer","description":"매출 공급가액 합계(원)"},"매출세액":{"type":"integer","description":"매출 부가가치세 합계(원)"},"매입건수":{"type":"integer","description":"매입 전자세금계산서 건수 합계"},"매입공급가액":{"type":"integer","description":"매입 공급가액 합계(원)"},"매입세액":{"type":"integer","description":"매입 부가가치세 합계(원)"}},"description":"조회기간 전체 합계"},"월별":{"type":"object","items":{"type":"object","properties":{"귀속월":{"type":"string"},"매출거래처수":{"type":"integer"},"매출건수":{"type":"integer"},"매출공급가액":{"type":"integer"},"매출세액":{"type":"integer"},"매입거래처수":{"type":"integer"},"매입건수":{"type":"integer"},"매입공급가액":{"type":"integer"},"매입세액":{"type":"integer"}}},"description":"귀속월별 통계. 없으면 빈 배열이다.","properties":{"귀속월":{"type":"string","description":"귀속 연월"},"매출거래처수":{"type":"integer","description":"매출 거래처 수"},"매출건수":{"type":"integer","description":"매출 전자세금계산서 건수"},"매출공급가액":{"type":"integer","description":"매출 공급가액(원)"},"매출세액":{"type":"integer","description":"매출 부가가치세(원)"},"매입거래처수":{"type":"integer","description":"매입 거래처 수"},"매입건수":{"type":"integer","description":"매입 전자세금계산서 건수"},"매입공급가액":{"type":"integer","description":"매입 공급가액(원)"},"매입세액":{"type":"integer","description":"매입 부가가치세(원)"}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"etaxClientList":{"type":"object","properties":{"사업자등록번호":{"type":"string","description":"조회한 사업자등록번호 10자리"},"검색어":{"type":"string","description":"거래처 이름으로 걸러 본 값. 없으면 빈 문자열"},"거래처수":{"type":"integer","description":"조회된 거래처 수"},"거래처":{"type":"object","items":{"type":"object","properties":{"사업자등록번호":{"type":"string"},"상호":{"type":"string"},"대표자":{"type":"string"},"주소":{"type":"string"},"업태":{"type":"string"},"종목":{"type":"string"},"수취구분":{"type":"string"},"등록일":{"type":"string"},"변경일":{"type":"string"}}},"description":"거래처 목록. 없으면 빈 배열이다.","properties":{"사업자등록번호":{"type":"string","description":"거래처 사업자등록번호. 주민등록번호 수취분은 가린 표시값"},"상호":{"type":"string","description":"거래처 상호"},"대표자":{"type":"string","description":"대표자 성명"},"주소":{"type":"string","description":"사업장 주소"},"업태":{"type":"string","description":"업태"},"종목":{"type":"string","description":"종목"},"수취구분":{"type":"string","description":"수취구분(사업자등록번호·주민등록번호)"},"등록일":{"type":"string","description":"거래처 최초 등록일"},"변경일":{"type":"string","description":"거래처 정보 최종 변경일"}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"etaxItemList":{"type":"object","properties":{"사업자등록번호":{"type":"string","description":"조회한 사업자등록번호 10자리"},"검색어":{"type":"string","description":"품목 이름으로 걸러 본 값. 없으면 빈 문자열"},"품목수":{"type":"integer","description":"조회된 품목 수. 등록한 품목이 없으면 0"},"품목":{"type":"object","items":{"type":"object","properties":{"품목코드":{"type":"string"},"품목명":{"type":"string"},"규격":{"type":"string"},"단위":{"type":"string"},"단가":{"type":"integer"},"비고":{"type":"string"},"등록일":{"type":"string"},"변경일":{"type":"string"}}},"description":"품목 목록. 없으면 빈 배열이다.","properties":{"품목코드":{"type":"string","description":"품목 코드"},"품목명":{"type":"string","description":"품목 이름"},"규격":{"type":"string","description":"규격"},"단위":{"type":"string","description":"단위"},"단가":{"type":"integer","description":"단가(원)"},"비고":{"type":"string","description":"비고"},"등록일":{"type":"string","description":"품목 최초 등록일"},"변경일":{"type":"string","description":"품목 정보 최종 변경일"}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"etaxStatus":{"type":"object","properties":{"확인건수":{"type":"integer","description":"전송 상태를 확인한 건수"},"확인시각":{"type":"string","description":"확인한 시각(ISO 8601)"},"상태":{"type":"object","items":{"type":"object","properties":{"승인번호":{"type":"string"},"구분":{"type":"string"},"전송상태":{"type":"string"},"상태코드":{"type":"string"}}},"description":"승인번호별 전송 상태","properties":{"승인번호":{"type":"string","description":"전자세금계산서 승인번호"},"구분":{"type":"string","description":"매출 또는 매입"},"전송상태":{"type":"string","description":"전송 상태(전송완료·미전송)"},"상태코드":{"type":"string","description":"확인된 상태 코드. 없으면 빈 문자열"}}},"장부에없는승인번호":{"type":"array","items":{},"description":"요청했지만 내 장부에 없어 확인하지 않은 승인번호"}},"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_hometax_biz_bundle 가 반환한 트랜잭션 ID (string)","example":"9f2c4a7b1d8e35c60a4f7b2d1e9c803a"}},"required":["transactionId"]}}}}}}},"x-code-tables":[{"title":"오류와 복구","columns":["상황","HTTP","data.error","해결"],"rows":[["이름·생년월일·휴대전화 번호가 비었거나 형식이 틀림","400","입력 항목이 잘못됐습니다.(이름) — 괄호 안에 항목 이름(생년월일 8자리·휴대전화 번호)이 표시됩니다.","값을 고쳐 인증 요청을 다시 보냅니다. 인증이 발송되지 않아 과금되지 않습니다."],["authProvider 가 허용값이 아니거나 지금 쓸 수 없는 인증방식","400","입력 항목이 잘못됐습니다.(인증방식)","간편인증 방식 표의 값(예: kakao)으로 보냅니다."],["추가 입력(사업자등록번호 포함)이 비었거나 형식이 틀림","424","서비스 요청에 실패했습니다.","요청 표의 형식대로 고쳐 다시 보냅니다. 귀속연도는 최근 5년의 4자리, 코드는 2자리 숫자, 교부방법은 06·10·04·12 중 하나입니다. 인증이 발송되지 않아 과금되지 않습니다."],["bind_id 없이 agreed 를 빠뜨림","400","입력 항목이 잘못됐습니다.(agreed)","agreed=true 를 함께 보냅니다."],["bind_id 유효기간이 지났거나 폐기됨","410","사업자 인증 유효기간이 지났습니다. 다시 인증해 주세요.","bind_id 를 빼고 agreed=true 로 다시 접수합니다."],["없는 bind_id","404","사업자 인증 정보를 찾을 수 없습니다.","bind_id 를 빼고 agreed=true 로 다시 접수합니다."],["bind_id 의 사업자등록번호와 business_no 가 다름","400","입력한 사업자등록번호가 인증된 번호와 다릅니다.","bind_id 를 만든 사업자등록번호로 보내거나, bind_id 없이 agreed=true 로 접수합니다."],["products 에 담기지 않은 값","400","입력 항목이 잘못됐습니다.(products)","아래 선택할 수 있는 조회의 상품 키로 보냅니다."],["products 가 비었음","400","조회할 상품을 하나 이상 골라 주세요.(products)","받을 조회를 하나 이상 고릅니다."],["고른 조회에 필요한 추가 입력이 비었음","400","입력 항목이 잘못됐습니다.(…) — 괄호 안에 빠진 항목이 표시됩니다.","요청 표에서 그 조회가 쓰는 입력을 채웁니다."],["같은 상품의 앞선 요청을 처리하는 중","429","앞선 요청을 처리하고 있습니다. 잠시 후 다시 시도해 주세요.","인증 요청을 다시 보내지 말고 잠시 뒤 받은 transactionId 로 결과를 조회합니다."],["보유 포인트가 이번 호출 단가보다 적음","200","data 대신 result.error 에 사용 가능한 포인트이 부족합니다.","충전한 뒤 다시 호출합니다. 결과조회는 같은 transactionId 를 그대로 씁니다."],["결과를 청구하는 순간 포인트가 부족함","402","결제 금액보다 보유 포인트이 부족합니다.","충전한 뒤 같은 transactionId 로 다시 조회합니다. 결과는 24시간 보관됩니다."],["결과조회에 transactionId 가 없음","400","입력 항목이 잘못됐습니다.(transactionId)","인증 요청 응답의 transactionId 를 보냅니다."],["없는 transactionId 또는 다른 상품의 결과조회 경로","404","요청을 찾을 수 없습니다.","인증 요청한 상품의 /rest/get_hometax_biz_bundle 로 조회합니다."],["사용자가 승인을 거부함","200","없음 — status=AUTH_REJECTED, errorCode=AUTH_REJECTED","다시 시도할지 사용자에게 묻고 인증 요청부터 다시 합니다(인증 요청 단가가 다시 발생)."],["5분 안에 승인하지 않음","200","없음 — status=AUTH_EXPIRED, errorCode=AUTH_EXPIRED","인증 요청부터 다시 합니다. 결과 단가는 발생하지 않습니다."],["조회하지 못함(대상이 아니거나 일시적으로 처리하지 못함)","200","없음 — status=FAILED, errorCode=COLLECT_FAILED","결과 단가는 발생하지 않습니다. 입력값과 대표자 본인 여부를 확인한 뒤 잠시 후 인증 요청부터 다시 합니다."],["결과 재조회 기간(24시간)이 지남","200","없음 — errorCode=RESULT_EXPIRED","받은 결과는 바로 저장해 두세요. 다시 받으려면 인증 요청부터 합니다."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}