HTAX_전자(세금)계산서 매입/매출 내역조회

홈택스 전자세금계산서 매입/매출내역조회

METHOD

POST

URI

/scrap/corpTax/nts/eTaxInvoice

Request fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

SCRETCARD

보안카드번호

TRUE

보안카드에 기재된 번호 전부를 "^"구분자로 입력 1368954812344567……

TXAGNTMGMTNO

세무대리인관리번호

TXAGNTMGMTPW

세무대리인관리비밀번호

TRUE

STARTDATE

조회시작일

YYYYMMDD

예) 20180801

ENDDATE

조회종료일

YYYYMMDD

예) 20180830

REGNUMBER

사업자등록번호

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

CHECKNUM

조회기준

1 : 작성일자, 2 : 발행일자, 3 : 전송일자

REGNUM

조회 사업자번호

TRUE

사업자번호로만 조회하고자하는 경우 입력.

REGNUMKIND

공급(받는)자의 등록번호 종류

1:사업자등록번호, 2:주민등록번호, 3:외국인

REGNUM의 등록번호 종류 선택. 추후 제공 예정

MINORREGNUM

공급(받는)자의 종사업장 번호

추후 제공 예정

ITEMQUERY

품목조회 추가

Y : 품목추가, N : 품목제외

기본으로 품목 제공, 추후 제외 추가 예정

GIVEQUERY

수탁사업자 추가

Y : 수탁추가, N : 수탁제외

추후 제공 예정

TAXFREE

면세조회 구분

Y : 면세, N : 세금

DETALEGUBUN

상세조회

추후 제공 예정

CHGERGUBUN

영위사업자 전환

2 : 사업자 전환 여부

P_CERTNAME

인증서이름

개별인증서를 위한 CERT 정보

P_CERTPWD

인증서 비밀번호

TRUE

개별인증서를 위한 CERT 정보

P_SIGNCERT_DER

DER 파일

BASE64

개별인증서를 위한 CERT 정보

P_SIGNPRI_KEY

KEY 파일

BASE64

개별인증서를 위한 CERT 정보

Response fields

필드명(영문) 필드명(한글) 암호화여부 양식 설명

data.RESULT

전체 성공/실패 여부

SUCCESS : 성공 FAIL :실패

data.ERRMSG

에러메세지

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

data.ERRDOC

에러 문서 메시지

(주민등록등본, 주민등록초본, 지방세납세증명) CANCEL:캡챠입력취소

data.TAXLIST.LIST[].LISTGUBUN

구분

1 : 매출 2 : 매입

data.TAXLIST.LIST[].WRITEDATE

작성일자

data.TAXLIST.LIST[].APPNUMBER

승인번호

data.TAXLIST.LIST[].PUBDATE

발행일자

data.TAXLIST.LIST[].TRANSDATE

전송일자

data.TAXLIST.LIST[].REGNUM1

입력한사업자번호의 사업자번호

data.TAXLIST.LIST[].REGNUM2

입력한사업자번호의 종사업자번호

data.TAXLIST.LIST[].COMNAME

입력한사업자번호의 상호

data.TAXLIST.LIST[].PRENAME

입력한사업자번호의 대표자명

data.TAXLIST.LIST[].ADDRESS

입력한사업자번호의 주소

data.TAXLIST.LIST[].REGNUM3

상대방 사업자번호

data.TAXLIST.LIST[].REGNUM4

상대방 종사업자번호

data.TAXLIST.LIST[].COMNAME2

상대방 상호

data.TAXLIST.LIST[].PRENAME2

상대방 대표자명

data.TAXLIST.LIST[].ADDRESS2

상대방 주소

data.TAXLIST.LIST[].SUM

합계금액

data.TAXLIST.LIST[].SUPPLY

공급가액

data.TAXLIST.LIST[].TAX

세액

data.TAXLIST.LIST[].SORT

전자세금계산서 분류

data.TAXLIST.LIST[].KIND

종류

data.TAXLIST.LIST[].TYPE

발행유형

data.TAXLIST.LIST[].BIGO

비고

data.TAXLIST.LIST[].DIV

기타

data.TAXLIST.LIST[].EMAIL1

공급자이메일

data.TAXLIST.LIST[].EMAIL2

공급받는자이메일1

data.TAXLIST.LIST[].EMAIL3

공급받는자이메일2

data.TAXLIST.LIST[].GIVEREGNUM

수탁사업자 등록번호

추후 제공예정

data.TAXLIST.LIST[].GIVEREGNAME

수탁사업자 상호

추후 제공예정

data.TAXLIST.LIST[].ITEMDATE

대표품목일자

data.TAXLIST.LIST[].ITEMNAME

대표 품목명

data.TAXLIST.LIST[].ITEMST

대표 품목규격

data.TAXLIST.LIST[].ITEMNUM

대표 품목수량

data.TAXLIST.LIST[].ITEMCOST

대표 품목단가

data.TAXLIST.LIST[].ITEMSUP

대표 품목공급가액

data.TAXLIST.LIST[].ITEMTAX

대표 품목세액

data.TAXLIST.LIST[].ITEMNOTE

대표 품목비고

data.ITEMDETAIL.LIST[].APPNUMBER

승인번호

data.ITEMDETAIL.LIST[].NUM

순번

data.ITEMDETAIL.LIST[].REGNUM1

공급받는자 등록번호

매출일 경우 값 출력

data.ITEMDETAIL.LIST[].REGNUM2

입력한사업자번호의 종사업자번호

data.ITEMDETAIL.LIST[].ITEMDATE

품목일자

data.ITEMDETAIL.LIST[].ITEMNAME

품목명

data.ITEMDETAIL.LIST[].ITEMST

품목규격

data.ITEMDETAIL.LIST[].ITEMNUM

품목수량

data.ITEMDETAIL.LIST[].ITEMCOST

품목단가

data.ITEMDETAIL.LIST[].ITEMSUP

품목공급가액

data.ITEMDETAIL.LIST[].ITEMTAX

품목세액

data.ITEMDETAIL.LIST[].ITEMNOTE

품목비고

errCode

errCode

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

errMsg

errMsg

오류발생 시 오류메시지

result

result

SUCCESS/FAIL

HTTP request

POST /scrap/corpTax/nts/eTaxInvoice HTTP/1.1
Host: datahub-dev.scraping.co.kr
Authorization: Token ******************************
Content-Length: 632
Content-Type: application/json;charset=UTF-8

{
  "SCRETCARD" : null,
  "TXAGNTMGMTNO" : null,
  "TXAGNTMGMTPW" : null,
  "STARTDATE" : "20200120",
  "ENDDATE" : "20200120",
  "REGNUMBER" : "1234567890",
  "CHECKNUM" : "",
  "REGNUMKIND" : "",
  "MINORREGNUM" : null,
  "ITEMQUERY" : "Y",
  "GIVEQUERY" : null,
  "TAXFREE" : null,
  "DETALEGUBUN" : null,
  "CHGERGUBUN" : "",
  "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
Content-Length: 3746
Date: Wed, 21 Oct 2020 08:13:25 GMT
Connection: keep-alive
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked

{
  "errCode" : "0000",
  "errMsg" : "success",
  "result" : "SUCCESS",
  "data" : {
    "ERRMSG" : "",
    "ITEMDETAIL" : {
      "LIST" : [ {
        "ITEMNOTE" : "",
        "REGNUM1" : "123-45-67890",
        "ITEMSUP" : "70000",
        "APPNUMBER" : "20200120-41000021-90086783",
        "ITEMST" : "",
        "ITEMTAX" : "7000",
        "NUM" : "1",
        "REGNUM2" : "502-81-93867",
        "ITEMCOST" : "0",
        "ITEMDATE" : "2020-01-20",
        "ITEMNUM" : "",
        "ITEMNAME" : "카페24 무통장입금서비스"
      }, {
        "ITEMNOTE" : "",
        "REGNUM1" : "123-45-67890",
        "ITEMSUP" : "-550000",
        "APPNUMBER" : "20200120-41000021-90054121",
        "ITEMST" : "",
        "ITEMTAX" : "-55000",
        "NUM" : "1",
        "REGNUM2" : "223-82-66519",
        "ITEMCOST" : "0",
        "ITEMDATE" : "2020-01-20",
        "ITEMNUM" : "",
        "ITEMNAME" : "세무주치의 수수료(전산사용료, 세무신고 대행료)"
      } ]
    },
    "ERRDOC" : "",
    "TAXLIST" : {
      "LIST" : [ {
        "REGNUM4" : "",
        "REGNUM2" : "",
        "TAX" : "100000",
        "PUBDATE" : "2020-02-10",
        "REGNUM3" : "213-11-12345",
        "COMNAME2" : "이지스",
        "ITEMSUP" : "70000",
        "APPNUMBER" : "20200120-41000021-90086783",
        "GIVEREGNAME" : "",
        "SUPPLY" : "1000000",
        "LISTGUBUN" : "1",
        "COMNAME" : "기웅유통",
        "TYPE" : "ASP발급",
        "ITEMDATE" : "2020-01-20",
        "ITEMNUM" : "",
        "PRENAME" : "홍길동",
        "ADDRESS2" : "서울 금천구 가산동 550-1 2동 613~615호",
        "WRITEDATE" : "2020-01-20",
        "PRENAME2" : "임꺽정",
        "TRANSDATE" : "2020-02-10",
        "ITEMNOTE" : "",
        "ITEMST" : "",
        "SUM" : "990000",
        "EMAIL2" : "email@email.com",
        "EMAIL3" : "email@email.com",
        "EMAIL1" : "email@email.com",
        "BIGO" : "카페24 무통장입금서비스(아이디:meetkmi0)",
        "DIV" : "영수",
        "GIVEREGNUM" : "",
        "REGNUM1" : "123-12-12345",
        "ITEMTAX" : "7000",
        "ADDRESS" : "서울 금천구 가산동 IT캐슬 2동",
        "KIND" : "일반",
        "SORT" : "세금계산서",
        "ITEMCOST" : "0",
        "ITEMNAME" : "카페24 무통장입금서비스"
      }, {
        "REGNUM4" : "",
        "REGNUM2" : "",
        "TAX" : "100000",
        "PUBDATE" : "2020-01-21",
        "REGNUM3" : "213-11-12345",
        "COMNAME2" : "이지스",
        "ITEMSUP" : "-550000",
        "APPNUMBER" : "20200120-41000021-90054121",
        "GIVEREGNAME" : "",
        "SUPPLY" : "1000000",
        "LISTGUBUN" : "1",
        "COMNAME" : "기웅유통",
        "TYPE" : "ASP발급",
        "ITEMDATE" : "2020-01-20",
        "ITEMNUM" : "",
        "PRENAME" : "홍길동",
        "ADDRESS2" : "서울특별시 금천구 가산디지털2로 98 2동 613~615호 ",
        "WRITEDATE" : "2020-01-20",
        "PRENAME2" : "임꺽정",
        "TRANSDATE" : "2020-01-21",
        "ITEMNOTE" : "",
        "ITEMST" : "",
        "SUM" : "990000",
        "EMAIL2" : "email@email.com",
        "EMAIL3" : "email@email.com",
        "EMAIL1" : "email@email.com",
        "BIGO" : "아파트세무주치의  ( 입금은행 : 우리은행 / 계좌번호: 26519868218011 로 입금)",
        "DIV" : "청구",
        "GIVEREGNUM" : "",
        "REGNUM1" : "123-12-12345",
        "ITEMTAX" : "-55000",
        "ADDRESS" : "서울 금천구 가산동 IT캐슬 2동",
        "KIND" : "일반",
        "SORT" : "세금계산서",
        "ITEMCOST" : "0",
        "ITEMNAME" : "세무주치의 수수료(전산사용료, 세무신고 대행료)"
      } ]
    },
    "RESULT" : "SUCCESS"
  }
}

Curl request

$ curl 'https://datahub-dev.scraping.co.kr/scrap/corpTax/nts/eTaxInvoice' -i -X POST \
    -H 'Authorization: Token ******************************' \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "SCRETCARD" : null,
  "TXAGNTMGMTNO" : null,
  "TXAGNTMGMTPW" : null,
  "STARTDATE" : "20200120",
  "ENDDATE" : "20200120",
  "REGNUMBER" : "1234567890",
  "CHECKNUM" : "",
  "REGNUMKIND" : "",
  "MINORREGNUM" : null,
  "ITEMQUERY" : "Y",
  "GIVEQUERY" : null,
  "TAXFREE" : null,
  "DETALEGUBUN" : null,
  "CHGERGUBUN" : "",
  "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=="
}'