Create a tax invoice (e-Tax Invoice, type 388)

Creates a Thai e-Tax Invoice, generates the official PDF, digitally signs it, and (if your
company has delivery turned on) emails/SMSes it to the buyer.

What you send: the buyer, the line items, and a few options. That's it.

What we fill in for you (do not send these):

Seller — taken from your account. You only confirm it via header.seller.taxId.

VAT and all totals — computed from your line prices and isVatIncluded. Never send tax amounts.

Document number — auto-generated if you leave documentNo empty.

The response is synchronous: on success you get back the finished, signed PDF inline as
Base64 (data.pdf), with status: "Completed".

Errors (HTTP 422, no document created):

VALIDATION_FAILED — a field is missing or wrong; error.fields lists exactly which.

SELLER_MISMATCH — seller.taxId is not your own company's tax id (you can only invoice as yourself).

Warnings (still HTTP 200, document created): e.g. a bad delivery email — returned in
data.warnings; the invoice is still created, only the email/SMS is skipped.

Tip: resolve the buyer's address codes (sub-district / district / province / post code) with
GET /v1/locations/search before calling this.

curl --location '/v1/documents/tax-invoice' \ --header 'Idempotency-Key;' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "header": { "buyer": { "branchNo": "00000", "buildingNumber": "123", "countryCode": "TH", "delivery": { "email": "[email protected]" }, "districtCode": "1005", "name": "บริษัท ตัวอย่าง จำกัด", "postCode": "10110", "provinceCode": "10", "street": "สุขุมวิท", "subDistrictCode": "100502", "taxId": "0105556000000", "taxIdSchemeId": "TXID" }, "documentDetails": { "isVatIncluded": false, "issueDate": "2026-06-17T10:30:00+07:00", "templateNo": "INV-7QX2K9" } }, "items": [ { "lineId": 1, "productName": "บริการที่ปรึกษา", "quantity": 2, "unit": "ครั้ง", "unitPrice": 1000, "vatTypeCode": "VAT" } ], "remark": "ชำระภายใน 30 วัน" }'

{ "data": { "documentNo": "INV-2026-0001", "documentType": "388", "pdf": "string", "status": "Completed", "warnings": [ { "code": "string", "message": "string" } ] }, "error": null, "success": true }

Create a tax invoice (e-Tax Invoice, type 388)

Request

Responses