웹훅 이벤트

홈택스 현금영수증 수집에서 발생하는 웹훅 이벤트입니다.
팝빌은 홈택스에서 수집한 현금영수증 매입/매출 내역을 매일 오전 8시으로 고객사 서버로 자동 전달합니다.

홈택스수집 Webhook 실행은 파트너 센터(1600-8536)로 연락하여 홈택스 수집정보를 설정한 이후 이용 가능합니다.

웹훅 헤더

변수명	필수	설명	예시
Pb-Webhook-Type	Y	Webhook 유형	HT.CASHBILL
Pb-Webhook-MID	Y	이벤트 식별값	016120000002-1777d55c2c41492ab06826d
Pb-Webhook-Corpnum	Y	팝빌 사업자번호	6798700433
Content-Type	Y	Webhook 메시지 Body 타입	application/json
Authorization	N	Base64 인코딩한 BASIC 인증정보	Basic VEVTVDoxMjM= HTTP 인증 사용하는 경우 추가 항목
X-Api-Key	N	API Key 인증정보	TESTAPIKEY HTTP 인증 사용하는 경우 추가 항목

팝빌은 기본으로 제공되는 Header 필드 외 프로그램 공급사 운영환경에 맞춘 커스텀 필드 지원이 가능합니다.
커스텀 필드 추가가 필요한 경우 팝빌 기술지원센터(1600-9854)로 문의주시기 바랍니다.

홈택스수집

현금영수증 매입/매출 내역수집에서 발생하는 웹훅 이벤트입니다.
각 이벤트 발생시점은 [수집]에서 확인 가능합니다.

이벤트 유형	설명
HTCashbill	현금영수증 매입/매출 내역수집

실제 고객사 서버로 전송된 웹훅 이벤트 정보는 [Webhook 실행내역 확인] 을 참고하여 주시기 바랍니다.

HTCashbill - 현금영수증 매입/매출 내역수집

팝빌이 업데이트된 데이터를 수집하여 등록된 콜백 URL에 매일 오전 8시에 자동 전달하는 시점에 실행됩니다.

이벤트 본문

변수명	타입	길이	필수	설명
ntsconfirmNum	string	9	Y	국세청승인번호
tradeDate	string	8	Y	거래일자 형식 : yyyyMMdd
tradeDT	string	14	Y	거래일시 형식 : yyyyMMddHHmmss
tradeType	string	4	Y	문서형태 승인거래 취소거래
tradeUsage	string	5	Y	거래구분 소득공제용 지출증빙용
totalAmount	string	9	Y	거래금액
supplyCost	string	9	Y	공급가액
tax	string	9	Y	부가세
serviceFee	string	9	Y	봉사료
invoiceType	string	2	Y	현금영수증 유형 매입 매출
franchiseCorpNum	string	10	N	가맹점(발행자) 사업자번호 {invoiceType}="매입" 경우 반환
franchiseCorpName	string	200	N	가맹점(발행자) 상호 {invoiceType}="매입" 경우 반환
franchiseCorpType	string	1	N	가맹점(발행자) 사업자유형 1일반과세자 2간이과세자 3과세특례자 {invoiceType}="매입" 경우 반환
identityNum	string	4	N	식별번호 반환되는 식별번호의 값은 마지막 4자리 숫자값 반환
identityNumType	string	1	Y	식별번호 유형 1주민등록번호 2사업자번호 3휴대전화번호 4신용카드번호
customerName	string	70	N	구매자(고객) 성명
cardOwnerName	string	70	N	카드소유자명
deductionType	string	1	N	공제유형 12공제 34불공제

이벤트 예시

{
        "ntsconfirmNum": "K00178490",
        "tradeDate": "20221019",
        "tradeDT": "20221019000000",
        "tradeType": "승인거래",
        "tradeUsage": "소득공제용",
        "totalAmount": "5000",
        "supplyCost": "4545",
        "tax": "455",
        "serviceFee": "0",
        "invoiceType": "매출",
        "franchiseCorpNum": "6798700433",
        "franchiseCorpType": 0,
        "identityNumType": 3,
        "identityNum": "5117",
        "customerName": "홍길동",
        "deductionType": 0
    }