Create a Replacement Tax Invoice (388)

POST

/api/v1/core/documents/replacement

Creates a Replacement Tax Invoice (388, ใบแทน) referencing an existing tax invoice. Line items must match the original — only buyer information is corrected. Returns the clean Open API envelope.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Created replacement document

Bodyapplication/json

🟠409

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/core/documents/replacement' \
--header 'Idempotency-Key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "referenceDocumentId": "11111111-1111-1111-1111-111111111111",
    "referenceDocumentNo": "INV-2026-0001",
    "referenceDocumentDate": "2026-06-10",
    "referenceDocumentTypeCode": "388",
    "purposeCode": "TIVC02",
    "templateNo": "INV-7QX2K9",
    "buyer": {
        "name": "บริษัท ตัวอย่าง (แก้ที่อยู่) จำกัด",
        "taxId": "0105556000000",
        "taxIdSchemeId": "TXID",
        "branchNo": "00000"
    },
    "items": [
        {
            "lineId": 1,
            "productName": "บริการที่ปรึกษา",
            "unitPrice": 1000,
            "quantity": 2,
            "unit": "ครั้ง",
            "vatTypeCode": "VAT"
        }
    ]
}'

Response Example

200 - Example 1

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

Modified at 2026-06-18 10:47:09

Create Cancellation Note (T07)

Create multiple tax documents in one request