Create a Tax Invoice (388)

POST

/v1/documents/tax-invoice

Documents

Creates a 388 Tax Invoice. The document type is fixed by the path (any documentType in the body is ignored). Seller identity is resolved server-side and tax & summary totals are computed by the backend. Returns the clean Open API envelope; document-data validation failure → 422 VALIDATION_FAILED. Email/SMS validation issues are non-fatal and returned as data.warnings.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Document created

Bodyapplication/json

🟠409

🟠422

Request Example

Shell

JavaScript

Java

Swift

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": "buyer@example.com"
            },
            "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 วัน"
}'

Response Example

200 - Example 1

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

Modified at 2026-06-18 11:27:06

Create a Replacement Tax Invoice (388)

Advanced document search with date range