Issue Tax Invoice
The sum of all item amounts becomes the issuance amount. Provide each item’s tax (tax) according to taxType.
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.
Authorizations
Append a colon to your API key, Base64-encode it, and put it in the header. Enter the API key as the username and leave the password empty.
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
Write date
"2024-08-24"
RECEIPT: receipt, CLAIM: claim
RECEIPT, CLAIM 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"
Supplier
Supplied party
Items
1 - 16 elementsTrustee information for brokered tax invoice issuance.
Tax invoice note. If the recipient's identification number is a foreign registration number, pass null or omit the field.
1 - 150Response
Issuance request identifier. Its format and length may change, so store the entire string as is.
"8D529FAD3EBAE050B79CE943CCC7CEDE"
