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.

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

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.

API Introduction

API Guides

Use Cases

SDK / No-code

Tax invoice issuance API

Tax invoice issuance webhook

Supplier registration API

Cash receipt webhook

Common errors

​Tax invoice issuance API

​Tax invoice issuance webhook

​Supplier registration API

​Cash receipt webhook

​Common errors

Tax invoice issuance API

Tax invoice issuance webhook

Supplier registration API

Cash receipt webhook

Common errors