{"openapi":"3.0.3","info":{"title":"APICK 개인 국세 통합조회","version":"1.0.0","description":"본인 간편인증 후 개인 국세 통합조회 자료를 확인합니다. 조회연도: 실제로 조회한 전체 귀속연도 목록(4자리 문자열). 금융소득이 없는 연도도 포함한다. 연도별: 귀속연도별 소득 집계. 합계 건수가 0인 연도는 담기지 않아 조회연도보다 적을 수 있다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/req_hometax_bundle":{"post":{"summary":"개인 국세 통합조회","description":"본인 간편인증 후 개인 국세 통합조회 자료를 확인합니다. 조회연도: 실제로 조회한 전체 귀속연도 목록(4자리 문자열). 금융소득이 없는 연도도 포함한다. 연도별: 귀속연도별 소득 집계. 합계 건수가 0인 연도는 담기지 않아 조회연도보다 적을 수 있다.","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"},"incomeYears":{"type":"string","description":"조회 연수(1~5). 기본 1 숫자로 보내며, 허용 범위를 벗어나면 요청이 거부됩니다. (number)"},"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)"},"years":{"type":"string","description":"이번 달부터 몇 년치를 거슬러 조회할지 정합니다. 1~10 사이 정수이며, 생략하면 1년치만 조회합니다. 연수를 늘리면 응답 크기와 처리 시간이 늘어납니다. (number)"},"year":{"type":"string","description":"귀속연도 4자리(최근 5년) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (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)"},"amount_open_yn":{"type":"string","description":"금액 공개 여부 Y/N(생략 시 N) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"income_source_open_yn":{"type":"string","description":"소득발생처 공개 여부 Y/N(생략 시 Y) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"withholding_all_print_yn":{"type":"string","description":"원천징수의무자 전체 표시 Y/N(생략 시 N) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"address_open_yn":{"type":"string","description":"주소 공개 여부 Y/N(생략 시 N) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (string)"},"resno_open_yn":{"type":"string","description":"주민등록번호 공개 여부 Y/N(생략 시 N) 문자열로 보내며, 생략하면 서버 기본값이 적용되거나 해당 조건이 해제됩니다. (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)"},"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)"}},"required":["name","birthDate","phone","authProvider"]}}}}}},"/rest/get_hometax_bundle":{"post":{"summary":"개인 국세 통합조회","description":"본인 간편인증 후 개인 국세 통합조회 자료를 확인합니다. 조회연도: 실제로 조회한 전체 귀속연도 목록(4자리 문자열). 금융소득이 없는 연도도 포함한다. 연도별: 귀속연도별 소득 집계. 합계 건수가 0인 연도는 담기지 않아 조회연도보다 적을 수 있다.","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":{"personalIncome":{"type":"object","additionalProperties":true,"properties":{"조회연도":{"type":"array","description":"실제로 조회한 전체 귀속연도 목록(4자리 문자열). 금융소득이 없는 연도도 포함한다.","items":{"type":"string"}},"연도별":{"type":"array","description":"귀속연도별 소득 집계. 합계 건수가 0인 연도는 담기지 않아 조회연도보다 적을 수 있다.","items":{"type":"object","properties":{"귀속연도":{"type":"string","description":"귀속연도 4자리"},"소득종류별":{"type":"object","description":"확인된 이자소득·배당소득별 집계. 근로·사업소득은 포함하지 않는다. 확인되지 않은 종류의 키는 생략된다.","properties":{"이자소득":{"type":"object","description":"이자소득이 확인된 경우의 집계(금액 단위 원). 없으면 키 생략. 값이 없으면 생략되거나 빈 값입니다.","properties":{"건수":{"type":"integer","description":"소득 건수"},"소득금액":{"type":"integer","description":"소득금액 합계(원)"},"소득세":{"type":"integer","description":"소득세 합계(원)"},"지방소득세":{"type":"integer","description":"지방소득세 합계(원)"},"농어촌특별세":{"type":"integer","description":"농어촌특별세 합계(원)"},"세액합계":{"type":"integer","description":"소득세 + 지방소득세 + 농어촌특별세(원)"}}},"배당소득":{"type":"object","description":"배당소득이 확인된 경우의 집계(금액 단위 원). 없으면 키 생략. 값이 없으면 생략되거나 빈 값입니다.","properties":{"건수":{"type":"integer","description":"소득 건수"},"소득금액":{"type":"integer","description":"소득금액 합계(원)"},"소득세":{"type":"integer","description":"소득세 합계(원)"},"지방소득세":{"type":"integer","description":"지방소득세 합계(원)"},"농어촌특별세":{"type":"integer","description":"농어촌특별세 합계(원)"},"세액합계":{"type":"integer","description":"소득세 + 지방소득세 + 농어촌특별세(원)"}}}}},"합계":{"type":"object","description":"그 연도의 전체 합계","properties":{"건수":{"type":"integer","description":"소득 건수"},"소득금액":{"type":"integer","description":"소득금액 합계(원)"},"소득세":{"type":"integer","description":"소득세 합계(원)"},"지방소득세":{"type":"integer","description":"지방소득세 합계(원)"},"농어촌특별세":{"type":"integer","description":"농어촌특별세 합계(원)"},"세액합계":{"type":"integer","description":"소득세 + 지방소득세 + 농어촌특별세(원)"}}}}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"cashReceiptDeduction":{"type":"object","properties":{"조회연도":{"type":"array","items":{"type":"string"},"description":"실제로 조회된 귀속연도 목록(4자리 문자열)."},"전체합계":{"type":"object","properties":{"건수":{"type":"integer","description":"현금영수증 사용 건수"},"사용금액":{"type":"integer","description":"사용금액 합계(원)"},"소득공제건수":{"type":"integer","description":"소득공제에 반영된 건수"},"소득공제금액":{"type":"integer","description":"소득공제에 반영된 금액(원)"}},"description":"조회한 전체 연도의 합계."},"연도별":{"type":"object","items":{"type":"object","properties":{"귀속연도":{"type":"string"},"합계":{"type":"object","properties":{"건수":{"type":"integer"},"사용금액":{"type":"integer"},"소득공제건수":{"type":"integer"},"소득공제금액":{"type":"integer"}}},"사용내역":{"type":"array","items":{"type":"object","properties":{"거래일시":{"type":"string"},"가맹점":{"type":"string"},"금액":{"type":"integer"},"승인번호":{"type":"string"},"거래구분":{"type":"string"},"거래상태":{"type":"string"},"소득공제대상":{"type":"boolean"},"소득공제반영":{"type":"boolean"}}}}}},"description":"귀속연도별 합계와 사용내역.","properties":{"귀속연도":{"type":"string","description":"귀속연도 4자리"},"합계":{"type":"object","description":"그 연도의 합계","properties":{"건수":{"type":"integer","description":"현금영수증 사용 건수"},"사용금액":{"type":"integer","description":"사용금액 합계(원)"},"소득공제건수":{"type":"integer","description":"소득공제에 반영된 건수"},"소득공제금액":{"type":"integer","description":"소득공제에 반영된 금액(원)"}}},"사용내역":{"type":"array","description":"건별 사용내역. 사용이 없으면 빈 배열이다.","items":{"type":"object","properties":{"거래일시":{"type":"string","description":"승인 일시"},"가맹점":{"type":"string","description":"가맹점명"},"금액":{"type":"integer","description":"승인 금액(원)"},"승인번호":{"type":"string","description":"현금영수증 승인번호"},"거래구분":{"type":"string","description":"승인·취소 구분"},"거래상태":{"type":"string","description":"거래 상태"},"소득공제대상":{"type":"boolean","description":"소득공제 대상이면 true, 아니면 false."},"소득공제반영":{"type":"boolean","description":"소득공제가 반영됐으면 true, 아니면 false."}}}}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"incomeByPayer":{"type":"object","properties":{"조회연도":{"type":"array","items":{"type":"string"},"description":"실제로 조회한 귀속연도 목록(4자리 문자열)."},"전체합계":{"type":"object","properties":{"건수":{"type":"integer","description":"지급명세서 건수"},"지급액":{"type":"integer","description":"그 유형 기준 금액의 합계(원). 유형마다 기준 항목이 다르다(총지급액·과세소득·용역제공대가·급여 등)."},"소득세":{"type":"integer","description":"소득세 합계(원)"},"지방소득세":{"type":"integer","description":"지방소득세 합계(원)"}},"description":"조회한 전체 유형·연도의 합계. 지급명세서가 하나도 없으면 건수가 0이다."},"유형별":{"type":"object","items":{"type":"object","properties":{"유형":{"type":"string"},"합계":{"type":"object","properties":{"건수":{"type":"integer"},"지급액":{"type":"integer"},"소득세":{"type":"integer"},"지방소득세":{"type":"integer"}}},"내역":{"type":"array","items":{"type":"object","properties":{"지급명세서종류":{"type":"string"},"지급자":{"type":"string"},"사업자등록번호":{"type":"string"},"귀속연도":{"type":"string"},"지급연도":{"type":"string"},"소득구분":{"type":"string"},"업종구분":{"type":"string"},"용역구분":{"type":"string"},"총지급액":{"type":"integer"},"과세소득":{"type":"integer"},"용역제공대가":{"type":"integer"},"급여 등":{"type":"integer"},"인정상여금액":{"type":"integer"},"비과세소득":{"type":"integer"},"필요경비":{"type":"integer"},"소득금액":{"type":"integer"},"소득세":{"type":"integer"},"지방소득세":{"type":"integer"}}}}}},"description":"지급명세서 자료종류별 소득내역. 내역이 있는 유형만 담긴다.","properties":{"유형":{"type":"string","description":"자료종류. 사업장제공자·간이기타·간이사업·간이근로·일용 중 하나다."},"합계":{"type":"object","description":"그 유형의 합계","properties":{"건수":{"type":"integer","description":"지급명세서 건수"},"지급액":{"type":"integer","description":"그 유형 기준 금액의 합계(원). 유형마다 기준 항목이 다르다(총지급액·과세소득·용역제공대가·급여 등)."},"소득세":{"type":"integer","description":"소득세 합계(원)"},"지방소득세":{"type":"integer","description":"지방소득세 합계(원)"}}},"내역":{"type":"array","description":"지급자별 소득 한 건씩. 자료종류와 값 존재 여부에 따라 하위 필드가 생략된다.","items":{"type":"object","properties":{"지급명세서종류":{"type":"string","description":"지급명세서 종류 표기"},"지급자":{"type":"string","description":"지급자(징수의무자)명"},"사업자등록번호":{"type":"string","description":"지급자 사업자등록번호 10자리(하이픈 포함)"},"귀속연도":{"type":"string","description":"귀속연도 4자리"},"지급연도":{"type":"string","description":"지급연도 4자리. 간이기타·간이사업에만 온다."},"소득구분":{"type":"string","description":"소득구분 표기. 간이기타에만 온다."},"업종구분":{"type":"string","description":"업종구분 표기. 간이사업에만 온다."},"용역구분":{"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":"소득금액(원). 간이기타에 온다."},"소득세":{"type":"integer","description":"소득세(원)"},"지방소득세":{"type":"integer","description":"지방소득세(원)"}}}}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"incomeDataCheck":{"type":"object","properties":{"조회연도":{"type":"array","items":{"type":"string"},"description":"실제로 조회된 귀속연도 목록(4자리 문자열)."},"연도별":{"type":"object","items":{"type":"object","properties":{"귀속연도":{"type":"string"},"연간소득총액":{"type":"integer"},"근로소득":{"type":"integer"},"근로소득(간이)":{"type":"integer"},"사업소득(간이)":{"type":"integer"},"원천징수 사업소득":{"type":"integer"},"사업장 사업소득":{"type":"integer"},"금융소득":{"type":"integer"},"연금소득":{"type":"integer"},"기타소득":{"type":"integer"},"종교인소득":{"type":"integer"}}},"description":"귀속연도별 소득자료 합계. 자료가 없는 연도는 담기지 않으며 확인되지 않은 금액 필드는 생략될 수 있다.","properties":{"귀속연도":{"type":"string","description":"귀속연도 4자리"},"연간소득총액":{"type":"integer","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":"기타소득(원)"},"종교인소득":{"type":"integer","description":"종교인소득(원)"}}},"근로소득상세":{"type":"object","properties":{"귀속연도":{"type":"string","description":"귀속연도 4자리"},"신청 구분":{"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":"상반기 일용근로소득(원)"},"하반기 일용근로소득":{"type":"integer","description":"하반기 일용근로소득(원)"}},"description":"조회 시점의 반기 기준 근로소득 상세. 키는 항상 존재하며 조회 기간이 아니면 null이다.","nullable":true},"지급자별":{"type":"object","items":{"type":"object","properties":{"자료출처":{"type":"string"},"지급자 상호(법인명)":{"type":"string"},"지급자 사업자등록번호":{"type":"string"},"수입금액":{"type":"integer"},"업종":{"type":"string"},"업종코드":{"type":"string"}}},"description":"지급자별 소득자료. 자료가 없으면 빈 배열이며 하위 필드는 값이 있을 때만 포함된다.","properties":{"자료출처":{"type":"string","description":"소득자료 종류 표기"},"지급자 상호(법인명)":{"type":"string","description":"지급자 상호 또는 법인명"},"지급자 사업자등록번호":{"type":"string","description":"지급자 사업자등록번호. 하이픈 없이 10자리로 온다."},"수입금액":{"type":"integer","description":"수입금액(원)"},"업종":{"type":"string","description":"업종 표기"},"업종코드":{"type":"string","description":"업종코드"}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"taxReturnHistory":{"type":"object","properties":{"조회기간":{"type":"object","properties":{"시작":{"type":"string","description":"조회 구간 시작(8자리)"},"끝":{"type":"string","description":"조회 구간 끝(8자리)"}},"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":"string"},"신고구분":{"type":"string"},"신고상세":{"type":"string"},"세목":{"type":"string"},"작성방법":{"type":"string"},"납부년월":{"type":"string"},"납부금액":{"type":"integer"},"고지금액":{"type":"integer"}}},"description":"제출된 신고서 목록. 신고가 없으면 빈 배열이다.","properties":{"신고일":{"type":"string","description":"신고서 제출일 원문. 예: YYYYMMDD. 구분 기호는 자료에 따라 다르다."},"과세기간":{"type":"string","description":"신고서에 적힌 과세기간"},"신고서":{"type":"string","description":"신고서 종류"},"신고구분":{"type":"string","description":"정기·수정 등 신고 구분"},"신고상세":{"type":"string","description":"신고 상세 구분"},"세목":{"type":"string","description":"세목"},"작성방법":{"type":"string","description":"작성 방법"},"납부년월":{"type":"string","description":"납부 연월 원문. 예: YYYYMM. 납부 내역이 없으면 빈 값이다."},"납부금액":{"type":"integer","description":"납부금액(원)"},"고지금액":{"type":"integer","description":"고지금액(원)"}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"taxPaymentHistory":{"type":"object","properties":{"조회기간":{"type":"object","properties":{"시작":{"type":"string","description":"조회 구간 시작(8자리)"},"끝":{"type":"string","description":"조회 구간 끝(8자리)"}},"description":"조회 구간."},"합계":{"type":"object","properties":{"납부건수":{"type":"integer","description":"납부 건수"},"납부금액":{"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":"string"},"귀속연도":{"type":"string"},"납부금액":{"type":"integer"},"국세":{"type":"integer"},"지방소득세":{"type":"integer"},"농어촌특별세":{"type":"integer"},"가산금":{"type":"integer"},"납부구분":{"type":"string"},"전자납부번호":{"type":"string"}}},"description":"국세 납부 건별 내역. 납부금액은 국세·지방소득세·농어촌특별세·가산금을 더한 값이다.","properties":{"납부일":{"type":"string","description":"납부일"},"세목":{"type":"string","description":"세목"},"귀속연도":{"type":"string","description":"귀속연도"},"납부금액":{"type":"integer","description":"총 납부금액(원)"},"국세":{"type":"integer","description":"국세분(원)"},"지방소득세":{"type":"integer","description":"지방소득세분(원)"},"농어촌특별세":{"type":"integer","description":"농어촌특별세분(원)"},"가산금":{"type":"integer","description":"가산금(원)"},"납부구분":{"type":"string","description":"납부 구분"},"전자납부번호":{"type":"string","description":"전자납부번호"}}},"환급내역":{"type":"object","items":{"type":"object","properties":{"세목":{"type":"string"},"환급금액":{"type":"integer"},"환급방법":{"type":"string"},"과세기간시작":{"type":"string"},"과세기간종료":{"type":"string"},"환급결정일":{"type":"string"},"처리상태":{"type":"string"},"은행":{"type":"string"}}},"description":"환급 결정·지급 내역. 없으면 빈 배열이다.","properties":{"세목":{"type":"string","description":"세목"},"환급금액":{"type":"integer","description":"환급금액(원)"},"환급방법":{"type":"string","description":"환급 방법"},"과세기간시작":{"type":"string","description":"환급 대상 과세기간 시작"},"과세기간종료":{"type":"string","description":"환급 대상 과세기간 종료"},"환급결정일":{"type":"string","description":"환급 결정일"},"처리상태":{"type":"string","description":"처리 상태"},"은행":{"type":"string","description":"환급 계좌 은행"}}},"체납내역":{"type":"object","items":{"type":"object","properties":{"세목":{"type":"string"},"고지세액":{"type":"integer"},"감액세액":{"type":"integer"},"일부납부세액":{"type":"integer"},"잔여납부할세액":{"type":"integer"},"전자납부번호":{"type":"string"}}},"description":"체납 건별 내역. 없으면 빈 배열이다.","properties":{"세목":{"type":"string","description":"세목"},"고지세액":{"type":"integer","description":"고지세액(원)"},"감액세액":{"type":"integer","description":"감액세액(원)"},"일부납부세액":{"type":"integer","description":"일부 납부한 세액(원)"},"잔여납부할세액":{"type":"integer","description":"남은 납부할 세액(원)"},"전자납부번호":{"type":"string","description":"전자납부번호"}}},"압류재산내역":{"type":"object","items":{"type":"object","properties":{"압류기관":{"type":"string"},"재산종류":{"type":"string"},"압류일자":{"type":"string"}}},"description":"압류 재산 목록. 없으면 빈 배열이다.","properties":{"압류기관":{"type":"string","description":"압류한 기관"},"재산종류":{"type":"string","description":"압류 재산 종류"},"압류일자":{"type":"string","description":"압류일"}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"incomeAmountCert":{"type":"object","properties":{"문서확인번호":{"type":"string","description":"발급된 소득금액증명의 문서확인번호"},"귀속연도":{"type":"string","description":"증명의 귀속연도 4자리"},"응답형식":{"type":"string","description":"요청한 응답 형식(pdf·json·both)"},"소득금액":{"type":"string","description":"귀속연도의 소득금액(원 단위 숫자). 금액이 없으면 빠진다."},"발급문서":{"type":"string","description":"발급된 PDF 원본을 base64 로 인코딩한 문자열. format 이 json 이면 빠진다."},"문서파일명":{"type":"string","description":"발급 문서의 파일명"},"문서해시":{"type":"string","description":"발급 문서의 SHA-256"},"문서크기":{"type":"integer","description":"발급 문서의 바이트 크기"},"PDF데이터":{"type":"object","description":"PDF를 열어 글자를 뽑고 라벨 기준으로 만든 값. format 이 pdf 이면 빠진다.","properties":{"사용가능":{"type":"boolean","description":"PDF에서 글자를 뽑았는지"},"페이지수":{"type":"integer","description":"PDF 페이지 수"},"필드":{"type":"object","description":"라벨로 찾은 값(원문 표기 그대로)"},"텍스트":{"type":"string","description":"추출한 전체 텍스트"},"사유":{"type":"string","description":"글자를 뽑지 못한 이유. 성공이면 빠진다."}}}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"pensionCreditCert":{"type":"object","properties":{"문서확인번호":{"type":"string","description":"발급된 확인서의 문서확인번호"},"귀속연도":{"type":"string","description":"귀속연도 4자리"},"PDF데이터":{"type":"object","description":"PDF를 JSON으로 파싱한 값(PDF데이터 공통 구조)"}},"description":"이 조회 항목의 결과입니다. 항목은 결과 규격을 참고하세요."},"taxPaymentHistoryCert":{"type":"object","properties":{"문서확인번호":{"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":"인증요청 단계에서 발급된 거래 ID입니다. 인증요청 응답의 transactionId를 그대로 넣어야 하며, 임의 값이나 만료된 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 중 하나입니다. 인증이 발송되지 않아 과금되지 않습니다."],["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_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"}}}}