세금계산서 웹훅 - 볼타 사용 가이드

전송 방식과 방화벽 설정, 로그 확인은 웹훅 이벤트를 참고하세요.

이벤트 타입

이벤트 타입	설명
`TAX_INVOICE_ISSUANCE_SUCCESS`	전자세금계산서 발행에 성공했을 때
`TAX_INVOICE_ISSUANCE_FAILURE`	전자세금계산서 발행에 실패했을 때

페이로드

발행 성공

{
  "eventType": "TAX_INVOICE_ISSUANCE_SUCCESS",
  "data": {
    "issuanceKey": "IssuanceKey_0FE29D3930EF0C6F01J0XQ6WVFN3K9SB99Q6T13S50",
    "taxInvoiceUrl": "https://app.bolta.io/taxInvoices/..."
  }
}

필드	타입	설명
`eventType`	string	이벤트 타입
`data.issuanceKey`	string	발행 요청 식별번호
`data.taxInvoiceUrl`	string	세금계산서 URL

발행 실패

{
  "eventType": "TAX_INVOICE_ISSUANCE_FAILURE",
  "data": {
    "issuanceKey": "IssuanceKey_0FE29D3930EF0C6F01J0XQ6WVFN3K9SB99Q6T13S50",
    "cause": {
      "code": "NOT_FOUND_CERTIFICATE",
      "message": "공동인증서가 등록되지 않았습니다."
    }
  }
}

필드	타입	설명
`eventType`	string	이벤트 타입
`data.issuanceKey`	string	발행 요청 식별번호
`data.cause.code`	string	에러 코드
`data.cause.message`	string	에러 설명

웹훅 발송 시간

발송 시간은 요청에 사용한 API 키 환경에 따라 다릅니다.

환경	발송 소요 시간
테스트 키 (`test_`)	발행 요청 후 10~30초
라이브 키 (`live_`)	발행 요청 후 약 10분

웹훅이 오지 않을 때

전자세금계산서 내용 조회로 발행 상태를 확인하세요.