HTAX_증여세결정정보조회(간편인증)

증여세결정정보조회:신고/납부>증여세>증여세결정정보조회

METHOD

POST

URI

/scrap/common/hometax/DeterminedGiftTaxSimple

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

주민번호 또는 생년월일8자리

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

USERNAME

로그인용 성명

true

STRING

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

HPNUMBER

휴대전화번호

true

STRING

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

USERGUBUN

사용자구분

true

STRING

1:개인

REGNUMBER

사업자번호 또는 주민번호

true

STRING

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

REFNDAY

조회기준일

true

STRING

yyyyMMdd

Response Fields

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

errCode

errCode

STRING

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

errMsg

errMsg

STRING

오류발생 시 오류메시지

result

result

STRING

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

STRING

SUCCESS : 성공
FAIL :실패

data.ERRMSG

오류 메시지

STRING

-

data.ERRDOC

에러 문서 메시지

STRING

-

data.ECODE

에러코드

STRING

data.ETRACK

오류추적번호

STRING

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

data.DECISIONLIST[]

결정목록리스트

data.DECISIONLIST[].DTNDT

증여일자

STRING

yyyyMMdd

data.DECISIONLIST[].TXPRNM

증여자

STRING

data.DECISIONLIST[].DNRNO

납세자번호

STRING

data.DECISIONLIST[].INHDTNPRPCLSFNM

재산종류

STRING

data.DECISIONLIST[].PRPCNTN01

증여재산 소재지

STRING

data.DECISIONLIST[].SCTMDTNADTAMT

과세가액

STRING

data.DECISIONLIST[].ERETXAMT

공제금액

STRING

data.DECISIONLIST[].STASAMT

과세표준

STRING

data.DECISIONLIST[].TOTADCSTXAMT

총결정세액

STRING

data.DECISIONLIST[].PPMTXAMT

기납부세액

STRING

data.DECISIONLIST[].DNTCRFNDTXAMT

고지세액

STRING

data.DECISIONLIST[].DETAILLIST[]

증여재산 구간

data.DECISIONLIST[].DETAILLIST[].DTNPRPCFTSUMAMT

재산가액

STRING

HTTP Request

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

{
  "LOGINOPTION" : "0",
  "TELECOMGUBUN" : "2",
  "JUMINNUM" : "8ExJVfTfMfIOWng==",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01012345678",
  "USERGUBUN" : "1",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "REFNDAY" : "20221101"
}

HTTP Response

HTTP/1.1 200 OK
Date:Tue, 29 Nov 2022 07:23:08 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 618

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "ECODE" : "",
    "ERRDOC" : "",
    "DECISIONLIST" : [ {
      "TXPRNM" : "김**",
      "STASAMT" : "1904390",
      "DNTCRFNDTXAMT" : "0",
      "INHDTNPRPCLSFNM" : "현금",
      "PRPCNTN01" : "",
      "PPMTXAMT" : "101396",
      "DTNDT" : "19980101",
      "DNRNO" : "123456-*******",
      "ERETXAMT" : "0",
      "TOTADCSTXAMT" : "101396",
      "SCTMDTNADTAMT" : "1904390",
      "DETAILLIST" : [ {
        "DTNPRPCFTSUMAMT" : "1904390"
      } ]
    } ],
    "RESULT" : "SUCCESS"
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/common/hometax/DeterminedGiftTaxSimple' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "LOGINOPTION" : "0",
  "TELECOMGUBUN" : "2",
  "JUMINNUM" : "8ExJVfTfMfIOWng==",
  "USERNAME" : "홍길동",
  "HPNUMBER" : "01012345678",
  "USERGUBUN" : "1",
  "REGNUMBER" : "8SxYL+DfTfMfIOWng==",
  "REFNDAY" : "20221101"
}'

참고자료

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

타임아웃

해당시간까지 입력 가능

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’일 경우에만 해당.