> ## 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.

# Error Codes

> A reference for Bolta API error codes.

## Tax invoice issuance API

| Status code | Error code              | Message                       |
| ----------- | ----------------------- | ----------------------------- |
| `400`       | `NOT_FOUND_CERTIFICATE` | No certificate is registered. |

## Tax invoice issuance webhook

| Error code                  | Message                                                                          |
| --------------------------- | -------------------------------------------------------------------------------- |
| `INVALID_SUPPLIER_BUSINESS` | The supplier's business registration number is invalid (unregistered or closed). |
| `INVALID_SUPPLIED_BUSINESS` | The recipient's business registration number is invalid.                         |
| `INTERNAL_SERVER_ERROR`     | An error occurred on the Bolta server.                                           |
| `INVALID_CERTIFICATE`       | The registered certificate is invalid (expired or revoked).                      |

## Supplier registration API

| Status code | Error code                  | Message                               |
| ----------- | --------------------------- | ------------------------------------- |
| `400`       | `INVALID_SUPPLIER_BUSINESS` | Invalid business registration number. |

## Cash receipt webhook

When cash receipt issuance or cancellation fails, the API includes one of the following codes in `data.cause.code` in the webhook payload and `failure.code` in the status response.

| Error code                      | Message                                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------------------- |
| `INVALID_ISSUER`                | Check the supplier information or the cash receipt issuance registration status.            |
| `INVALID_RECIPIENT_IDENTIFIER`  | Check the cash receipt payment method information.                                          |
| `ORIGINAL_ISSUANCE_FAILED`      | The original cash receipt issuance failed, so the cancellation request cannot be processed. |
| `CANCELLATION_TARGET_NOT_FOUND` | The transaction has already been canceled or cannot be canceled.                            |
| `UNKNOWN`                       | Cash receipt processing failed. If the problem persists, contact customer support.          |

<Info>
  If the API rejects an issuance request during validation, it returns the common error `INVALID_REQUEST` (400). Check `message` to identify the invalid field.
</Info>

## Common errors

| Status code | Error code              | Message                                                                                                                                                             |
| ----------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | `INVALID_REQUEST`       | The request could not be processed. This response is returned when a required parameter is missing or a parameter format is invalid. Check your request parameters. |
| `404`       | `NOT_FOUND`             | The requested resource does not exist. Double-check the API address you requested.                                                                                  |
| `500`       | `INTERNAL_SERVER_ERROR` | An error occurred on the Bolta server.                                                                                                                              |