HTAX_지급명세서 조회_기타소득(간편인증)

My홈택스 > 연말정산, 지급명세서 > 지급명세서 등 제출내역

METHOD

POST

URI

/scrap/common/hometax/OtherIncomePaymtInfoSimple

Content Type

application/json

Charset

UTF-8

Last Updated

2022-11-29

Request Fields

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

LOGINOPTION

간편인증로그인방법

true

STRING

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

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

TELECOMGUBUN

통신사구분

true

STRING

1 : SKT
2 : KT
3 : LG U+

JUMINNUM

로그인용 주민번호

true

true

STRING

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

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

USERNAME

로그인용 성명

true

STRING

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

HPNUMBER

휴대전화번호

true

STRING

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

USERGUBUN

사용자구분

true

STRING

1:개인

REGNUMBER

사업자번호 또는 주민번호

true

STRING

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

REQYEAR

귀속연도

true

STRING

yyyy

HIDDENINFO

개인정보 숨김처리

STRING

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

기본: N

OUTPUTDOCU[]

문서 출력

true

본 업무는 PDF만 출력 가능

OUTPUTDOCU[].OUTPUTDOCUTYPE

출력되는 문서 타입

true

STRING

PDF : PDF 문서 출력

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.ECODE

에러코드

STRING

data.ETRACK

오류추적번호

STRING

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

data.LIST[]

리스트

data.LIST[].STMTKIND

입력된 지금명세서 종류

STRING

data.LIST[].MATEKNDNM

자료구분

STRING

data.LIST[].REQYEAR

귀속연도

STRING

yyyy

data.LIST[].PNSNINCAGTXPYMNAMT

연금소득 종합과세(지급액)

STRING

data.LIST[].TOTAPYMNAMT

지급총액

STRING

data.LIST[].OUTFILE[]

원문파일(BASE64)

data.LIST[].OUTFILE[].OUTTYPE

원문파일타입

STRING

ex) "PDF"

data.LIST[].OUTFILE[].OUTDATA

원문파일 데이터(BASE64)

STRING

HTTP Request

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

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

HTTP Response

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

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "ECODE" : "",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS",
    "LIST" : [ {
      "OUTFILE" : [ {
        "OUTTYPE" : "PDF",
        "OUTDATA" : "JVBERi0xLjQKJeLjz9M...TQ4NDgzCiUlRU9GCg=="
      } ],
      "REQYEAR" : "2019",
      "STMTKIND" : "2",
      "PNSNINCAGTXPYMNAMT" : "null",
      "MATEKNDNM" : "거주자기타소득지급명세서",
      "TOTAPYMNAMT" : "575527"
    } ]
  }
}

Curl Request

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

참고자료

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