HTAX_현금영수증 매입내역조회

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

METHOD

POST

URI

/scrap/corpTax/nts/CashReceiptPurchase

Content Type

application/json

Charset

UTF-8

Last Updated

2023-04-03

Request Fields

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

REGNUMBER

사업자등록번호

true

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

USERGUBUN

사용자구분

true

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

개인은 신청불가능함.

STARTDATE

조회시작년월

true

yyyyMM

ENDDATE

조회종료년월

true

STRING

yyyyMM

SUMYN

합계금액출력여부

true

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

P_CERTNAME

인증서이름

true

개별인증서를 위한 CERT 정보

P_CERTPWD

인증서 비밀번호

true

true

개별인증서를 위한 CERT 정보

P_SIGNCERT_DER

DER 파일

true

BASE64

개별인증서를 위한 CERT 정보

P_SIGNPRI_KEY

KEY 파일

true

BASE64

개별인증서를 위한 CERT 정보

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[]

내역 리스트

data.HISTORY[].USEDATE

거래일자

yyyyMMdd

data.HISTORY[].USETIME

거래시간

HHmmss

data.HISTORY[].CARDUSERNAME

사용자명

data.HISTORY[].BIZNUMBER

가맹점사업자번호

data.HISTORY[].FRANNAME

가맹점명

data.HISTORY[].VALUEOFSUPPLY

공급가액

(단위: 원)

data.HISTORY[].SURTAX

부가세

APPHISTORYVIEW가 1(상세조회)일 경우 출력.

data.HISTORY[].TIP

봉사료

(단위: 원)

data.HISTORY[].TOTALAMT

총금액

(단위: 원)

data.HISTORY[].RECOGNUMBER

승인번호

data.HISTORY[].IDCONFIRM

발급수단

data.HISTORY[].TRDSECTION

거래구분

data.HISTORY[].EXEMPTIONYN

공제여부

HTTP Request

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

{
  "REGNUMBER" : "2148159394",
  "USERGUBUN" : "3",
  "STARTDATE" : "202001",
  "ENDDATE" : "202012",
  "SUMYN" : "Y",
  "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, 3 Apr 2023 08:06:07 GMT
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Content-Length: 1079

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ETRACK" : "",
    "ERRMSG" : "",
    "SUMTOTATRSAMT" : "33000",
    "ECODE" : "",
    "USERNAME" : "기웅정보통신",
    "ERRDOC" : "",
    "RESULT" : "SUCCESS",
    "USERBIZNUM" : "1234567890",
    "HISTORY" : [ {
      "VALUEOFSUPPLY" : "800000",
      "RECOGNUMBER" : "101713071",
      "BIZNUMBER" : "1122334455",
      "SURTAX" : "0",
      "FRANNAME" : "기웅가맹점",
      "TRDSECTION" : "승인거래",
      "USETIME" : "144229",
      "CARDUSERNAME" : "기웅정보통신（주）",
      "USEDATE" : "20200123",
      "IDCONFIRM" : "9394",
      "TOTALAMT" : "800000",
      "TIP" : "0",
      "EXEMPTIONYN" : "불공제"
    }, {
      "VALUEOFSUPPLY" : "20000",
      "RECOGNUMBER" : "590855188",
      "BIZNUMBER" : "1122334455",
      "SURTAX" : "2000",
      "FRANNAME" : "기웅가맹점",
      "TRDSECTION" : "승인거래",
      "USETIME" : "100248",
      "CARDUSERNAME" : "기웅정보통신（주）",
      "USEDATE" : "20200922",
      "IDCONFIRM" : "9394",
      "TOTALAMT" : "22000",
      "TIP" : "0",
      "EXEMPTIONYN" : "공제"
    } ]
  }
}

Curl Request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/corpTax/nts/CashReceiptPurchase' -i -X POST \
     -H 'Authorization: Token ******************************' \
     -H 'Content-Type: application/json;charset=UTF-8' \
     -d '{
  "REGNUMBER" : "2148159394",
  "USERGUBUN" : "3",
  "STARTDATE" : "202001",
  "ENDDATE" : "202012",
  "SUMYN" : "Y",
  "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=="
}'