HTAX_소득금액증명신청(회원로그인)

홈택스 소득금액증명신청 업무 (회원로그인)

METHOD

POST

URI

/scrap/common/hometax/AmtOfIncomeCertificateMember

Request fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

TELNUMBER

신청자전화번호

전화번호 및 휴대전화번호 둘 중 하나는 필수입력.

HPNUMBER

신청자휴대전화번호

전화번호 및 휴대전화번호 둘 중 하나는 필수입력.

EMAIL

이메일

JUMINYN

주민번호공개

1: 공개, 2: 비공개

ADDRYN

주소공개

GUBUN

증명구분

1: 근로소득자용 , 2: 연말정산한 사업소득자용, 3: 종합소득세신고자용, 4: 연말정산한 연금소득자용, 5: 연말정산한 종교인소득자용.

STARTYEAR

조회시작년도

yyyy

ENDYEAR

조회종료년도

yyyy

P_CERTNAME

인증서이름

개별인증서를 위한 CERT 정보

P_CERTPWD

인증서 비밀번호

TRUE

개별인증서를 위한 CERT 정보

P_SIGNCERT_DER

DER 파일

BASE64

개별인증서를 위한 CERT 정보

P_SIGNPRI_KEY

KEY 파일

BASE64

개별인증서를 위한 CERT 정보

Response fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

data.RESULT

전체 성공/실패 여부

SUCCESS : 성공 FAIL :실패

data.ERRMSG

에러메세지

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

data.ERRDOC

에러 문서 메시지

(주민등록등본, 주민등록초본, 지방세납세증명) CANCEL:캡챠입력취소

data.ECODE

에러코드

data.ETRACK

에러추적번호

data.SUCCESSNUM

발급번호

data.ADDRESS

신청자 주소

data.USERNAME

신청자 명

data.USERJUMIN

신청자 주민등록번호

TRUE

data.INCOMELIST[].REQGUBUN

소득구분

data.INCOMELIST[].REQYEAR

귀속연도

yyyy

data.INCOMELIST[].REQCORNAME

법인명

data.INCOMELIST[].REQCORNUM

사업자등록번호

data.INCOMELIST[].REQAMT

소득금액

data.INCOMELIST[].REQTAX

총결정세액

errCode

errCode

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

errMsg

errMsg

오류발생 시 오류메시지

result

result

SUCCESS/FAIL

HTTP request

POST /scrap/common/hometax/AmtOfIncomeCertificateMember HTTP/1.1
Host: datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Type: application/json;charset=UTF-8
Content-Length: 488

{
  "TELNUMBER" : null,
  "HPNUMBER" : "01012341234",
  "EMAIL" : "abc123@gmail.com",
  "JUMINYN" : "1",
  "ADDRYN" : "1",
  "GUBUN" : "1",
  "STARTYEAR" : "2017",
  "ENDYEAR" : "2017",
  "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: Mon, 18 May 2020 05:48:10 GMT
Content-Length: 599
Connection: keep-alive
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "ADDRESS" : "서울 금천구 가산동 IT캐슬 2동",
    "ECODE" : "",
    "USERNAME" : "홍***",
    "ERRDOC" : "",
    "SUCCESSNUM" : "1111-111-1111-111",
    "USERJUMIN" : "8ExJVfTfMfIOWng==",
    "INCOMELIST" : [ {
      "REQTAX" : "5133",
      "REQAMT" : "10000000",
      "REQYEAR" : "2017",
      "REQCORNUM" : "1234567890",
      "REQGUBUN" : "근로소득(갑종)연말정산",
      "REQCORNAME" : "기웅정보통신"
    } ],
    "RESULT" : "SUCCESS"
  }
}

Curl request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/hometax/AmtOfIncomeCertificateMember' -i -X POST \
    -H 'Authorization: Token ******************************' \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "TELNUMBER" : null,
  "HPNUMBER" : "01012341234",
  "EMAIL" : "abc123@gmail.com",
  "JUMINYN" : "1",
  "ADDRYN" : "1",
  "GUBUN" : "1",
  "STARTYEAR" : "2017",
  "ENDYEAR" : "2017",
  "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=="
}'