홈택스_전자신고결과조회(세금신고결과조회)

홈 > 조회/발급 > 세금 신고 납부 > 전자신고결과조회(세금신고결과조회)

METHOD

POST

URI

/scrap/common/hometax/TaxReturnResultsInquiry

Content Type

application/json

Charset

UTF-8

Last Updated

2021-12-14

Request Fields

필드명(영문) 필드명(한글) 필수여부 암호화여부 타입 양식 최대길이 샘플데이터 설명

USERGUBUN

사용자구분

STRING

1:개인, 2:개인사업자, 3:법인

REGNUMBER

사업자번호 또는 주민번호

true

NUMBER

"-" 구분 없이 숫자만 입력

STARTDATE

조회시작일

STRING

yyyyMMdd

예) 20180801

ENDDATE

조회종료일

STRING

YYYYMMDD

예) 20180830

HIDDENINFO

개인정보 숨김처리

STRING

Y: 개인정보 보임, N: 개인정보 숨김

기본: N

TAXKIND

세목

STRING

1:종합소득세, 2:원천세, 3:법인세, 4:부가가치세

-

P_CERTNAME

인증서이름

STRING

개별인증서를 위한 CERT 정보

P_CERTPWD

인증서 비밀번호

true

STRING

개별인증서를 위한 CERT 정보

P_SIGNCERT_DER

DER 파일

STRING

BASE64

개별인증서를 위한 CERT 정보

P_SIGNPRI_KEY

KEY 파일

STRING

BASE64

개별인증서를 위한 CERT 정보

Response Fields

필드명(영문) 필드명(한글) 필수여부 암호화여부 타입 양식 최대길이 샘플데이터 설명

errCode

errCode

STRING

정상일 때는 '0000', 오류일 경우 오류코드 반환

errMsg

errMsg

STRING

오류발생 시 오류메시지

result

result

STRING

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

STRING

SUCCESS : 성공
FAIL :실패

data.ERRMSG

에러메세지

STRING

RESULT값이 FAIL일 경우 스크래핑 서비스 오류 메세지 출력

data.ERRDOC

에러 문서 메시지

STRING

data.ETRACK

에러추적번호

STRING

data.ECODE

에러코드

STRING

data.CONTENTS

XML데이터 출력부

STRING

출력된 XML을 Base64처리한 데이터

HTTP Request

POST /scrap/common/hometax/TaxReturnResultsInquiry
Host: https://datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Length: 453
Content-Type: application/json;charset=UTF-8

{
  "USERGUBUN" : "3",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "STARTDATE" : "20200101",
  "ENDDATE" : "20200131",
  "HIDDENINFO" : "N",
  "TAXKIND" : "4",
  "P_CERTNAME" : "cn=홍길동(),ou=SHB,ou=personal4IB,o=yessign,c=kr",
  "P_CERTPWD" : "QOf0TPlnwX4YNsrA==",
  "P_SIGNCERT_DER" : "MIIFmzCCBIOgAwIBAgIEJCSREDANBgkqQsF...GLlqn+XWQTrcdfB/KEtJLlSmL4/Bha6i4no=",
  "P_SIGNPRI_KEY" : "MIIFEDAaBggqgxqMmkQBDzAOBAgC+vZm...w+HVjzFOA1RLy5GNGOnnNAgst7QUmWCA=="
}

HTTP Response

HTTP/1.1 200 OK
Date:Tue, 14 Dec 2021 09:24:25 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 268

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "ECODE" : "",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS",
    "CONTENTS" : "PD94bWwgdmVyc2lvbj0nMS4wJyBlb...uZURWT0xpc3QvPjwvcm9vdD4="
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/hometax/TaxReturnResultsInquiry' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "USERGUBUN" : "3",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "STARTDATE" : "20200101",
  "ENDDATE" : "20200131",
  "HIDDENINFO" : "N",
  "TAXKIND" : "4",
  "P_CERTNAME" : "cn=홍길동(),ou=SHB,ou=personal4IB,o=yessign,c=kr",
  "P_CERTPWD" : "QOf0TPlnwX4YNsrA==",
  "P_SIGNCERT_DER" : "MIIFmzCCBIOgAwIBAgIEJCSREDANBgkqQsF...GLlqn+XWQTrcdfB/KEtJLlSmL4/Bha6i4no=",
  "P_SIGNPRI_KEY" : "MIIFEDAaBggqgxqMmkQBDzAOBAgC+vZm...w+HVjzFOA1RLy5GNGOnnNAgst7QUmWCA=="
}'