웹훅은 데이터가 변경되었을 때 파트너 서버에서 실시간으로 알림을 받을 수 있는 기능입니다. 웹훅을 연동해서 전자세금계산서 발행 상태 업데이트와 같은 변경 사항을 실시간으로 받아보세요.웹훅 사용하기#
1. 웹훅 이벤트 타입을 알아보세요#
웹훅으로 등록할 수 있는 이벤트 타입은 아래와 같습니다.이벤트 타입 | 설명 |
---|
TAX_INVOICE_ISSUANCE_SUCCESS | 전자세금계산서 발행에 성공했을 때 발생되는 이벤트입니다. |
TAX_INVOICE_ISSUANCE_FAILURE | 전자세금계산서 발행에 실패했을 때 발생되는 이벤트입니다. |
2. 웹훅 이벤트를 등록하세요#
웹훅은 테스트 환경과 라이브 환경 각각 별개로 등록하여야 합니다.3. 전자세금계산서 발행 성공/실패 시 웹훅이 발송됩니다.#
라이브 키
를 이용하는 경우 웹훅 발송까지 15분 가량 소요되며, 테스트 키
를 이용하는 경우 전자세금계산서 발행 요청 10초 ~ 30초 뒤 웹훅이 발송됩니다.이벤트 타입#
TAX_INVOICE_ISSUANCE_SUCCESS#
전자세 금계산서 발행 성공을 알려주는 웹훅입니다.이벤트 본문#
{
"eventType": "TAX_INVOICE_ISSUANCE_SUCCESS",
"data": {
"issuanceKey": "IssuanceKey_0FE29D3930EF0C6F01J0XQ6WVFN3K9SB99Q6T13S50",
"taxInvoiceUrl": "https://app.bolta.io/taxInvoices/..."
}
}
TAX_INVOICE_ISSUANCE_FAILURE#
전자세금계산서 발행 실패를 알려주는 웹훅입니다.이벤트 본문#
{
"eventType": "TAX_INVOICE_ISSUANCE_FAILURE",
"data": {
"issuanceKey": "IssuanceKey_0FE29D3930EF0C6F01J0XQ6WVFN3K9SB99Q6T13S50",
"cause": {
"code": "NOT_FOUND_CERTIFICATE",
"message": "공동인증서가 등록되지 않았습니다."
}
}
}
Modified at 2025-04-14 13:40:28