Last Updated: 20th September 2024

Cancel Document

POST

/einvoices/cancel_reject

This API endpoint supports both Cancel to Reject e-Invoices.

Triggering this endpoint will submit a Cancel request (only available within 72 hours of e-Invoice being created).

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "documents": [
        { 
            "lhdn_uin": "EAHNBY77J0PSPKPCZ1B6XQ4J10", 
            "invoice_number": "INV-001",
            "reason": "System Error" 
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://einvoice-api.beaconx.com.my/einvoices/cancel_reject' \
--header 'Content-Type: application/json' \
--data-raw '{
    "documents": [
        { 
            "lhdn_uin": "EAHNBY77J0PSPKPCZ1B6XQ4J10", 
            "invoice_number": "INV-001",
            "reason": "System Error" 
        }
    ]
}'

Responses

🟢200Success

application/json

Body

Example

{
    "status": "OK",
    "message": "",
    "data": [
        {
            "lhdn_uin": "",
            "invoice_number": "INV/123",
            "status": "cancelled",
            "message": ""
        },
        {
            "lhdn_uin": "",
            "invoice_number": "INV/124",
            "status": "failed",
            "message": "Cancellation not allowed after 72 hours"
        },
        {
            "lhdn_uin": "123",
            "invoice_number": "",
            "status": "failed",
            "message": "Document not found. Please check UIN"
        }
    ]
}

Modified at 2025-06-20 08:53:52

Create Document(s)

Void Document