Skip to main content

Tax invoice issuance API

For INVALID_SUPPLIER_BUSINESS, check that the issuer’s business registration number is registered in the integration and environment associated with your API key.

Tax invoice issuance webhook

The API can also pass an NTS result code through to cause.code as is. If you receive a code that is not in the table, check cause.message and contact Bolta with the issuanceKey before you issue the invoice again.

Issuer registration API

Cash receipt API

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. ORIGINAL_ISSUANCE_FAILED and CANCELLATION_TARGET_NOT_FOUND are returned only with CASH_RECEIPT_CANCEL_FAILED.
  • ORIGINAL_ISSUANCE_FAILED: Bolta accepted the cancellation request while the original issuance was in progress, but the original issuance later failed
  • CANCELLATION_TARGET_NOT_FOUND: The cancellation target could not be found or was already canceled. This also applies when it was fully or partially canceled outside Bolta (for example, on Hometax) or already had a cancellation request

Tax invoice issuance deadline API

See Tax Invoice Issuance Deadline for details.

Business registration status API

When a bulk lookup cannot check only some numbers, the API returns 200 instead of an error and sets status to null for those items. See Business Registration Status for details.

Business registration certificate extraction and verification API

See Business Registration Certificate Extraction and Verification.

Business profile API

See Business Profile.

Revenue and expense API

See Revenue and Expense for details.

Bank account transactions API

See Bank Account Transactions for details.

Bank account holder API

When a holder lookup fails, a single inquiry returns HTTP 400, while a bulk inquiry returns the item error in results[].error with HTTP 200. See Bank Account Holder for details.

Document issuance API

See Document Issuance for details.

Tax invoice PDF API

See Tax Invoice PDF.

Common errors