이벤트 데이터
홈택스수집 전자세금계산서 웹훅에서 발생하는 수집 이벤트입니다.
팝빌은 홈택스에서 수집한 전자세금계산서 매입/매출 내역을 1시간 간격(정시)으로 고객사 서버로 자동 전달합니다.
홈택스수집 Webhook 실행은 파트너 센터(1600-8536)로 연락하여 홈택스 수집정보를 설정한 이후 이용 가능합니다.
Webhook - Header
필드명 | 설명 | 필수 | 예시 |
---|---|---|---|
Pb-Webhook-Type | Webhook 유형 | Y | HT.TAXINVOICEXML |
Pb-Webhook-MID | 이벤트 식별값 | Y | 016120000002-1777d55c2c41492ab06826d |
Pb-Webhook-Corpnum | 팝빌 사업자번호 | Y | 6798700433 |
Content-Type | Webhook 메시지 Body 타입 | Y | application/json |
Authorization | Base64 인코딩한 BASIC 인증정보 | N |
Basic VEVTVDoxMjM=
HTTP 인증 사용하는 경우 추가 항목
|
X-Api-Key | API Key 인증정보 | N |
TESTAPIKEY
HTTP 인증 사용하는 경우 추가 항목
|
팝빌은 기본으로 제공되는 Header 필드 외 프로그램 공급사 운영환경에 맞춘 커스텀 필드 지원이 가능합니다.
커스텀 필드 추가가 필요한 경우 팝빌 기술지원센터(1600-9854)로 문의주시기 바랍니다.
Webhook - Body
필드명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|
writeDate | String | 8 | Y |
작성일자
형식 : yyyyMMdd
|
ntsconfirmNum | String | 24 | Y | 국세청승인번호 |
issueDT | String | 14 | Y |
발행일시
형식 : yyyyMMddHHmmss
|
sendDate | String | 8 | Y |
전송일자
형식 : yyyyMMdd
|
invoiceType | Number | 3 | Y |
전자세금계산서 종류
|
taxType | String | 2 | Y |
과세형태
과세
영세
면세
|
taxTotal | String | 18 | Y | 세액 합계 |
supplyCostTotal | String | 18 | Y | 공급가액 합계 |
totalAmount | String | 18 | Y | 합계금액 |
purposeType | String | 2 | Y |
영수/청구
영수
청구
없음
|
serialNum | String | 30 | N | 일련번호 |
cash | String | 18 | N | 현금 |
chkBill | String | 18 | N | 수표 |
credit | String | 18 | N | 외상 |
note | String | 18 | N | 어음 |
remark1 | String | 150 | 조건부 | 비고1 |
remark2 | String | 150 | N | 비고2 |
remark3 | String | 150 | N | 비고3 |
invoicerCorpNum | String | 10 | Y | 공급자 사업자번호 |
invoicerMgtKey | String | 24 | 조건부 | 공급자 문서번호 |
invoicerTaxRegID | String | 4 | N |
공급자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
|
invoicerCorpName | String | 200 | Y | 공급자 상호 |
invoicerCEOName | String | 100 | Y | 공급자 대표자 성명 |
invoicerAddr | String | 300 | N | 공급자 주소 |
invoicerBizType | String | 100 | N | 공급자 업태 |
invoicerBizClass | String | 100 | N | 공급자 종목 |
invoicerContactName | String | 100 | N | 공급자 담당자 성명 |
invoicerDeptName | String | 100 | N | 공급자 담당자 부서명 |
invoicerTEL | String | 20 | N | 공급자 담당자 연락처 |
invoicerEmail | String | 100 | N | 공급자 담당자 이메일 |
invoiceeCorpNum | String | 10 | Y | 공급받는자 사업자번호 |
invoiceeType | String | 3 | Y |
공급받는자 구분
사업자
개인
외국인
|
invoiceeMgtKey | String | 24 | 조건부 | 공급받는자 문서번호 |
invoiceeTaxRegID | String | 4 | N |
공급받는자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
|
invoiceeCorpName | String | 200 | Y | 공급받는자 상호 |
invoiceeCEOName | String | 100 | Y | 공급받는자 대표자 성명 |
invoiceeAddr | String | 300 | N | 공급받는자 주소 |
invoiceeBizType | String | 100 | N | 공급받는자 업태 |
invoiceeBizClass | String | 100 | N | 공급받는자 종목 |
invoiceeContactName1 | String | 100 | N | 공급받는자 주)담당자 성명 |
invoiceeDeptName1 | String | 100 | N | 공급받는자 주)담당자 부서명 |
invoiceeTEL1 | String | 20 | N | 공급받는자 주)담당자 연락처 |
invoiceeEmail1 | String | 100 | N | 공급받는자 주)담당자 이메일 |
invoiceeContactName2 | String | 100 | N | 공급받는자 부)담당자 성명 |
invoiceeDeptName2 | String | 100 | N | 공급받는자 부)담당자 부서명 |
invoiceeTEL2 | String | 20 | N | 공급받는자 부)담당자 연락처 |
invoiceeEmail2 | String | 100 | N | 공급받는자 부)담당자 이메일 |
trusteeCorpNum | String | 10 | 조건부 | 수탁자 사업자번호 |
trusteeMgtKey | String | 24 | 조건부 | 수탁자 문서번호 |
trusteeTaxRegID | String | 4 | N |
수탁자 종사업장번호
종사업장 식별번호는 4자리 숫자로만 구성
|
trusteeCorpName | String | 200 | 조건부 | 수탁자 상호 |
trusteeCEOName | String | 100 | 조건부 | 수탁자 대표자 성명 |
trusteeAddr | String | 300 | N | 수탁자 주소 |
trusteeBizType | String | 100 | N | 수탁자 업태 |
trusteeBizClass | String | 100 | N | 수탁자 종목 |
trusteeContactName | String | 100 | N | 수탁자 담당자 성명 |
trusteeDeptName | String | 100 | N | 수탁자 담당자 부서명 |
trusteeTEL | String | 20 | N | 수탁자 담당자 연락처 |
trusteeEmail | String | 100 | N | 수탁자 담당자 이메일 |
modifyCode | Number | 1 | 조건부 |
수정 사유코드
|
orgNTSConfirmNum | String | 24 | 조건부 | 당초승인번호 |
detailList | Array | 99 | N | 품목 상세정보 |
detailList 객체
필드명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|
serialNum | Number | 2 | Y | 일련번호 |
purchaseDT | String | 8 | N |
거래일자
형식 : yyyyMMdd
|
itemName | String | 100 | N | 품명 |
spec | String | 60 | N | 규격 |
qty | String | 12 | N | 수량 |
unitCost | String | 18 | N | 단가 |
supplyCost | String | 18 | N | 공급가액 |
tax | String | 18 | N | 세액 |
remark | String | 100 | N | 비고 |
이벤트 예시
홈택스수집 전자세금계산서 웹훅에서 발생하는 수집 이벤트 예시입니다.
각 이벤트 발생시점은 [수집]에서 확인 가능합니다.
실제 고객사 서버로 전송된 웹훅 이벤트 정보는 [Webhook 실행내역 확인] 을 참고하여 주시기 바랍니다.
-
전자세금계산서 매입/매출 내역수집
팝빌이 업데이트된 데이터를 수집하여 등록된 콜백 URL에 1시간(정시) 간격으로 자동 전달하는 시점에 실행됩니다.
{ "writeDate": "20221111", "sendDate": "20221111", "issueDT": "20221111112809", "invoiceType": 101, "taxType": "과세", "invoicerCorpNum": "6798700433", "invoicerCorpName": "(주)링크허브", "invoicerCEOName": "공급자 대표", "invoicerAddr": "공급자 주소", "invoicerBizType": "공급자 업태", "invoicerBizClass": "공급자 종목", "invoicerContactName": "공급자 담당자 성명", "invoicerTEL": "공급자 담당자 연락처", "invoicerEmail": "공급자 담당자 이메일", "invoiceeCorpNum": "1234567890", "invoiceeType": "사업자", "invoiceeCorpName": "공급받는자 사업자", "invoiceeCEOName": "공급받는자 대표", "invoiceeAddr": "공급받는자 주소", "invoiceeBizType": "공급받는자 업태", "invoiceeBizClass": "공급받는자 종목", "invoiceeContactName1": "공급받는자 담당자 성명", "invoiceeEmail1": "공급받는자 담당자 이메일", "taxTotal": "20000", "supplyCostTotal": "200000", "totalAmount": "220000", "purposeType": "청구", "ntsconfirmNum": "202211114100020300000777", "detailList": [ { "serialNum": 1, "purchaseDT": "20221111", "itemName": "테스트 결제", "supplyCost": "200000", "tax": "20000" } ] }