> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bolta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 세금계산서 웹훅

> 전자세금계산서 발행 결과 웹훅의 이벤트 타입과 페이로드를 안내합니다.

전송 방식과 방화벽 설정, 로그 확인은 [웹훅 이벤트](/docs/api-introduction/webhook-events)를 참고하세요.

## 이벤트 타입

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

## 페이로드

### 발행 성공

```json theme={"dark"}
{
  "eventType": "TAX_INVOICE_ISSUANCE_SUCCESS",
  "data": {
    "issuanceKey": "IssuanceKey_0FE29D3930EF0C6F01J0XQ6WVFN3K9SB99Q6T13S50",
    "taxInvoiceUrl": "https://app.bolta.io/taxInvoices/..."
  }
}
```

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

### 발행 실패

```json theme={"dark"}
{
  "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분   |

## 웹훅이 오지 않을 때

[전자세금계산서 내용 조회](/api-reference/세금계산서/전자세금계산서-내용-조회)로 발행 상태를 확인하세요.