Scraping API Guide

HTAX_종합소득세과세표준확정신고서 조회(간편인증)

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

METHOD

POST

URI

/scrap/common/hometax/FinalIncomeTaxBaseSimple

Content Type

application/json

Charset

UTF-8

Last Updated

2022-11-29

Request Fields

필드명(영문)	필드명(한글)	필수여부	암호화여부	타입	양식	설명
LOGINOPTION	간편인증로그인방법	true		STRING	0 :카카오톡 1:삼성패스 2:페이코 3:통신사 4:KB모바일인증서	간편인증 로그인시 필수필드
TELECOMGUBUN	통신사구분			STRING	1 : SKT 2 : KT 3 : LG U+	간편인증 로그인시 필수필드 LOGINOPTION 3번 통신사 선택시 입력
JUMINNUM	로그인용 주민번호	true	true	STRING	"-"없이 주민번호13자리 또는 생년월일 8자리 입력	간편인증 로그인시 필수필드
USERNAME	로그인용 성명	true		STRING		간편인증 로그인시 필수필드
HPNUMBER	휴대전화번호	true		STRING		간편인증 로그인시 필수필드
REGNUMBER	사업자번호 또는 주민번호	true	true	STRING		조회시 필수입력
USERGUBUN	사용자구분	true		STRING	1:개인
STARTDATE	조회시작일	true		STRING	yyyyMMdd	ex: 20200525
ENDDATE	조회종료일	true		STRING	yyyyMMdd	ex: 20200525
HIDDENINFO	개인정보 숨김처리			STRING	Y: 개인정보 보임, N: 개인정보 숨김	기본: N

필드명(영문)

필드명(한글)

필수여부

암호화여부

타입

양식

최대길이

샘플데이터

설명

LOGINOPTION

간편인증로그인방법

true

STRING

0 :카카오톡
1:삼성패스
2:페이코
3:통신사
4:KB모바일인증서

간편인증 로그인시 필수필드

TELECOMGUBUN

통신사구분

STRING

1 : SKT
2 : KT
3 : LG U+

간편인증 로그인시 필수필드
LOGINOPTION 3번 통신사 선택시 입력

JUMINNUM

로그인용 주민번호

true

STRING

"-"없이 주민번호13자리 또는 생년월일 8자리 입력

간편인증 로그인시 필수필드

USERNAME

로그인용 성명

true

STRING

간편인증 로그인시 필수필드

HPNUMBER

휴대전화번호

true

STRING

간편인증 로그인시 필수필드

REGNUMBER

사업자번호 또는 주민번호

true

STRING

조회시 필수입력

USERGUBUN

사용자구분

true

STRING

1:개인

STARTDATE

조회시작일

true

STRING

yyyyMMdd

ex: 20200525

ENDDATE

조회종료일

true

STRING

yyyyMMdd

ex: 20200525

HIDDENINFO

개인정보 숨김처리

STRING

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

기본: N

Response Fields

필드명(영문)

필드명(한글)

필수여부

암호화여부

타입

양식

최대길이

샘플데이터

설명

errCode

STRING

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

errMsg

STRING

오류발생 시 오류메시지

result

STRING

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

STRING

SUCCESS : 성공
FAIL :실패

data.ERRMSG

오류 메시지

STRING

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

data.ERRDOC

에러 문서 메시지

STRING

data.ECODE

에러코드

STRING

data.ETRACK

오류추적번호

STRING

오류발생 위치 확인에 필요한 추적번호

data.LIST[]

[종] : 종합소득세 [농] : 농어촌특별세

data.LIST[].AGIAMT

[종]종합소득금액

STRING

data.LIST[].INCDDCAMT

[종]소득공제

STRING

data.LIST[].STASAMT

[종]과세표준

STRING

data.LIST[].TXRTE

[종]세율

STRING

data.LIST[].CMPTTXAMT

[종]산출세액

STRING

data.LIST[].RETXAMT

[종]세액감면

STRING

data.LIST[].DDCTXAMT

[종]세액공제

STRING

data.LIST[].OGNTXSBTRSCPMTXAMT

[종]납부(환급) 할 총 세액

STRING

data.LIST[].AGTXDCSTXAMT

[종](결정세액) 종합과세

STRING

data.LIST[].SRMHINCDCSTXAMT

[종](결정세액) 분리과세

STRING

data.LIST[].DCSTXAMT

[종](결정세액) 합계

STRING

data.LIST[].ADTTXAMT

[종]가산세

STRING

data.LIST[].ADDPMTTXAMT

[종]추가납부세액

STRING

data.LIST[].AGITXSUMTXAMT

[종]합계

STRING

data.LIST[].PPMTXAMT

[종]기납부세액

STRING

data.LIST[].PMTSPCSTXAMT

[종](납부특례세액) 차감

STRING

data.LIST[].ADTPMTSPCSTXAMT

[종](납부특례세액) 가산

STRING

data.LIST[].OGNTXINPMSCHUTXAMT

[종](분납할세액) 2개월 내

STRING

data.LIST[].OGNTXSBTRPMTTXAMT

[종]신고기한 이내 납부할 세액

STRING

data.LIST[].STASAMT2

[농]과세표준

STRING

data.LIST[].TXRTE2

[농]세율

STRING

data.LIST[].CMPTTXAMT2

[농]산출세액

STRING

data.LIST[].AGTXDCSTXAMT2

[농](결정세액) 종합과세

STRING

data.LIST[].SRMHINCDCSTXAMT2

[농](결정세액) 분리과세

STRING

data.LIST[].DCSTXAMT2

[농](결정세액) 합계

STRING

data.LIST[].ADTTXAMT2

[농]가산세

STRING

data.LIST[].ADDPMTTXAMT2

[농]추가납부세액

STRING

data.LIST[].AGITXSUMTXAMT2

[농]합계

STRING

data.LIST[].PPMTXAMT2

[농]기납부세액

STRING

data.LIST[].OGNTXSBTRSCPMTXAMT2

[농]납부(환급) 할 총 세액

STRING

data.LIST[].INPMSCHUTXAMT2

[농](납부특례세액) + (분납할세액)

STRING

data.LIST[].OGNTXSBTRPMTTXAMT2

[농]신고기한 이내 납부할 세액

STRING

HTTP Request

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

{
  "LOGINOPTION" : "0",
  "TELECOMGUBUN" : null,
  "JUMINNUM" : "8ExJVfTfMfIOWng==",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01012341234",
  "USERGUBUN" : "1",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "REQYEAR" : "2020",
  "HIDDENINFO" : null,
  "OUTPUTDOCU" : [ {
    "OUTPUTDOCUTYPE" : "PDF"
  } ],
  "STARTDATE" : "20200101",
  "ENDDATE" : "20200501"
}

HTTP Response

HTTP/1.1 200 OK
Date:Tue, 29 Nov 2022 09:01:46 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 1147

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "ECODE" : "",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS",
    "LIST" : [ {
      "ADTTXAMT" : "0",
      "AGITXSUMTXAMT" : "84165",
      "OGNTXSBTRPMTTXAMT2" : "0",
      "PMTSPCSTXAMT" : "0",
      "STASAMT" : "2902762",
      "CMPTTXAMT" : "174165",
      "OGNTXINPMSCHUTXAMT" : "0",
      "TXRTE2" : "0.00",
      "PPMTXAMT" : "38000",
      "INPMSCHUTXAMT2" : "0",
      "INCDDCAMT" : "3148300",
      "DCSTXAMT" : "84165",
      "DCSTXAMT2" : "0",
      "ADTPMTSPCSTXAMT" : "0",
      "OGNTXSBTRPMTTXAMT" : "46165",
      "AGIAMT" : "6051062",
      "DDCTXAMT" : "90000",
      "PPMTXAMT2" : "0",
      "ADTTXAMT2" : "0",
      "OGNTXSBTRSCPMTXAMT2" : "0",
      "RETXAMT" : "0",
      "AGITXSUMTXAMT2" : "0",
      "ADDPMTTXAMT" : "0",
      "STASAMT2" : "0",
      "OGNTXSBTRSCPMTXAMT" : "46165",
      "TXRTE" : "6.00",
      "ADDPMTTXAMT2" : "0",
      "CMPTTXAMT2" : "0",
      "AGTXDCSTXAMT2" : "0",
      "AGTXDCSTXAMT" : "84165",
      "SRMHINCDCSTXAMT" : "0",
      "SRMHINCDCSTXAMT2" : "0"
    } ]
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/hometax/FinalIncomeTaxBaseSimple' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "LOGINOPTION" : "0",
  "TELECOMGUBUN" : null,
  "JUMINNUM" : "8ExJVfTfMfIOWng==",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01012341234",
  "USERGUBUN" : "1",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "REQYEAR" : "2020",
  "HIDDENINFO" : null,
  "OUTPUTDOCU" : [ {
    "OUTPUTDOCUTYPE" : "PDF"
  } ],
  "STARTDATE" : "20200101",
  "ENDDATE" : "20200501"
}'

참고자료

2 Path Fields

Response

errCode 값이 '0001' 인 경우 다음의 응답 데이터가 리턴됨.

필드명(영문)	필드명(한글)	양식	설명
data.callbackId	콜백ID
data.callbackType	구분	'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'ANY'
data.callbackData	구분 값	Base64 Image.	data.callbackType 필드가 'CAPTCHA’일 경우 Image 응답.
data.timeout	타임아웃		해당시간까지 입력 가능

필드명(영문)

필드명(한글)

양식

설명

data.callbackId

콜백ID

data.callbackType

구분

'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'ANY'

data.callbackData

구분 값

Base64 Image.

data.callbackType 필드가 'CAPTCHA’일 경우 Image 응답.

data.timeout

타임아웃

해당시간까지 입력 가능

Request

다음의 API 로 요청

METHOD

POST

URI

/scrap/captcha

필드명(영문)	필드명(한글)	양식	설명
callbackId	콜백ID		data.callbackId 필드로 응답받은 콜백ID 입력
callbackType	구분	'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'ANY'	data.callbackType 필드로 응답 받은 구분 입력
callbackResponse	구분 값		callbackType(구분)이 'SMS', 'CAPTCHA', 'OTP', 'SINGLE’일 경우 인증문자 입력.
callbackResponse1	임시 비밀번호		callbackType(구분)이 'TWO’일 경우에만 해당. 요청 시 입력한 Email로 받은 임시 비밀번호.
callbackResponse2	변경할 비밀번호		callbackType(구분)이 'TWO’일 경우에만 해당.
retry	캡챠이미지 갱신여부	'Y':이미지 갱신	callbackType(구분)이 'CAPTCHA’일 경우에만 해당.

필드명(영문)

필드명(한글)

양식

설명

callbackId

콜백ID

data.callbackId 필드로 응답받은 콜백ID 입력

callbackType

구분

'SMS', 'CAPTCHA', 'OTP', 'TWO', 'SINGLE', 'ANY'

data.callbackType 필드로 응답 받은 구분 입력

callbackResponse

구분 값

callbackType(구분)이 'SMS', 'CAPTCHA', 'OTP', 'SINGLE’일 경우 인증문자 입력.

callbackResponse1

임시 비밀번호

callbackType(구분)이 'TWO’일 경우에만 해당. 요청 시 입력한 Email로 받은 임시 비밀번호.

callbackResponse2

변경할 비밀번호

callbackType(구분)이 'TWO’일 경우에만 해당.

retry

캡챠이미지 갱신여부

'Y':이미지 갱신

callbackType(구분)이 'CAPTCHA’일 경우에만 해당.