Issue Tax Invoice
The sum of all item amounts becomes the issuance amount. Provide each item’s tax (tax) according to taxType.
The total item supply cost must not be zero. If the total tax is neither zero nor null, it must have the same sign as the total supply cost.
See the Issuance amount guide for calculation details and the Brokered Tax Invoice Issuance guide for the brokered workflow.
The API removes invisible characters from the request text but keeps tabs, line feeds, and carriage returns. It rejects supplementary characters above U+FFFF, such as emoji, with 400. See Unsupported characters.
curl --request POST \
--url https://xapi.bolta.io/v1/taxInvoices/issue \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"date": "2026-07-28",
"purpose": "CLAIM",
"taxType": "TAXABLE",
"supplier": {
"identificationNumber": "1234567890",
"organizationName": "Supplier Company",
"representativeName": "Supplier Representative",
"manager": {
"email": "supplier@example.com"
}
},
"supplied": {
"identificationNumber": "0987654321",
"organizationName": "Recipient Company",
"representativeName": "Recipient Representative",
"managers": [
{
"email": "recipient@example.com"
}
]
},
"items": [
{
"date": "2026-07-28",
"name": "Taxable item",
"supplyCost": 100000,
"tax": 10000
}
]
}
'{
"issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}Authorizations
Headers
Client reference ID for a tax invoice request. This header is optional. Enter a non-blank value between 1 and 255 characters. After this value is used with a tax invoice issuance API, the same API key cannot reuse it, regardless of the request content or endpoint. A duplicate returns 400 Bad Request with INVALID_REQUEST. If you do not receive a response, do not resend the request. Check the accepted request with the request status API.
1 - 255\SBody
TAXABLE: taxable (e-tax invoice), ZERO_RATE: zero-rate (e-tax invoice), TAX_FREE: tax-exempt (invoice). For TAXABLE the item tax cannot be null; for ZERO_RATE every item's tax must be 0. For TAX_FREE every item's tax must be null or omitted.
TAXABLE, ZERO_RATE, TAX_FREE "TAXABLE"
"ZERO_RATE"
"TAX_FREE"
curl --request POST \
--url https://xapi.bolta.io/v1/taxInvoices/issue \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"date": "2026-07-28",
"purpose": "CLAIM",
"taxType": "TAXABLE",
"supplier": {
"identificationNumber": "1234567890",
"organizationName": "Supplier Company",
"representativeName": "Supplier Representative",
"manager": {
"email": "supplier@example.com"
}
},
"supplied": {
"identificationNumber": "0987654321",
"organizationName": "Recipient Company",
"representativeName": "Recipient Representative",
"managers": [
{
"email": "recipient@example.com"
}
]
},
"items": [
{
"date": "2026-07-28",
"name": "Taxable item",
"supplyCost": 100000,
"tax": 10000
}
]
}
'{
"issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}