HTAX_현금영수증 매입내역조회(ID/PW)

홈택스 현금영수증 매입내역조회 업무

METHOD

POST

URI

/scrap/corpTax/nts/CashReceiptPurchaseID

Content Type

application/json

Charset

UTF-8

Last Updated

2021-11-02

Request Fields

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

REGNUMBER

사업자등록번호

"-" 제외 10자리 숫자 입력

USERGUBUN

사용자구분

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

개인은 신청불가능함.

LOGINID

로그인아이디

STRING

아이디로그인시 필수입력.

LOGINPWD

로그인비밀번호

true

STRING

아이디로그인시 필수입력.

STARTDATE

조회시작일

STRING

yyyyMMdd

예) 20180801

ENDDATE

조회종료일

STRING

yyyyMMdd

예) 20180830

SUMYN

합계금액출력여부

Y: 합계금액출력, N: 합계금액미출력

Response Fields

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

errCode

errCode

STRING

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

errMsg

errMsg

STRING

오류발생 시 오류메시지

result

result

STRING

SUCCESS/FAIL

data.RESULT

전체 성공/실패 여부

SUCCESS : 성공
FAIL :실패

data.ERRMSG

에러메세지

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

data.ERRDOC

에러 문서 메시지

data.ECODE

에러코드

data.ETRACK

에러추적번호

data.USERNAME

상호명

data.USERBIZNUM

사업자등록번호

data.SUMTOTATRSAMT

총 거래금액

data.HISTORY[].USEDATE

거래일자

yyyyMMdd

data.HISTORY[].USETIME

거래시간

HHmmss

data.HISTORY[].CARDUSERNAME

사용자명

data.HISTORY[].BIZNUMBER

가맹점사업자번호

data.HISTORY[].FRANNAME

가맹점명

data.HISTORY[].VALUEOFSUPPLY

공급가액

(단위: 원)

data.HISTORY[].SURTAX

부가세

(단위: 원)

data.HISTORY[].TIP

봉사료

(단위: 원)

data.HISTORY[].TOTALAMT

총금액

(단위: 원)

data.HISTORY[].RECOGNUMBER

승인번호

data.HISTORY[].IDCONFIRM

발급수단

data.HISTORY[].TRDSECTION

거래구분

data.HISTORY[].EXEMPTIONYN

공제여부

HTTP Request

POST /scrap/corpTax/nts/CashReceiptPurchaseID
Host: https://datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Length: 194
Content-Type: application/json;charset=UTF-8

{
  "REGNUMBER" : "2148159394",
  "USERGUBUN" : "3",
  "LOGINID" : "eaccounting01",
  "LOGINPWD" : "wqb19tfu/bMbtn5M8w==",
  "STARTDATE" : "20210101",
  "ENDDATE" : "20210101",
  "SUMYN" : "Y"
}

HTTP Response

HTTP/1.1 200 OK
Date:Tue, 2 Nov 2021 07:07:15 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 1067

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "SUMTOTATRSAMT" : "7067654",
    "ECODE" : "",
    "USERNAME" : "기웅정보통신",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS",
    "USERBIZNUM" : "1234567890",
    "HISTORY" : [ {
      "VALUEOFSUPPLY" : "101182",
      "RECOGNUMBER" : "177652363",
      "BIZNUMBER" : "1122334455",
      "SURTAX" : "10118",
      "FRANNAME" : "기웅가맹점",
      "TRDSECTION" : "승인거래",
      "USETIME" : "074927",
      "CARDUSERNAME" : "서지원",
      "USEDATE" : "20210101",
      "IDCONFIRM" : "4282",
      "TOTALAMT" : "111300",
      "TIP" : "0",
      "EXEMPTIONYN" : "공제"
    }, {
      "VALUEOFSUPPLY" : "910",
      "RECOGNUMBER" : "178827825",
      "BIZNUMBER" : "1122334455",
      "SURTAX" : "90",
      "FRANNAME" : "기웅가맹점",
      "TRDSECTION" : "승인거래",
      "USETIME" : "150209",
      "CARDUSERNAME" : "서지원",
      "USEDATE" : "20210103",
      "IDCONFIRM" : "4282",
      "TOTALAMT" : "1000",
      "TIP" : "0",
      "EXEMPTIONYN" : "공제"
    } ]
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/corpTax/nts/CashReceiptPurchaseID' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "REGNUMBER" : "2148159394",
  "USERGUBUN" : "3",
  "LOGINID" : "eaccounting01",
  "LOGINPWD" : "wqb19tfu/bMbtn5M8w==",
  "STARTDATE" : "20210101",
  "ENDDATE" : "20210101",
  "SUMYN" : "Y"
}'