Cancel/Reject Documents - BeaconX e-Invoice API

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

In the event of AR, triggering this endpoint will submit a Cancel request (only available within 72 hours of e-Invoice being created).

In the event of AP, triggering this endpoint will submit a Request to Reject the e-Invoice to Supplier. Note: the decision to approve the rejection ultimately lies with the Supplier. This is just a request.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

documents

array [object {3}]

required

lhdn_uin

string

required

LHDN UIN of document to be cancelled / rejected.

reference_number

string

required

Document reference number to be cancelled / rejected.

reason

string

required

Reason for cancellation / rejection. Limited to 300 characters in length.

Example

{
    "documents": [
{ "lhdn_uin": "EAHNBY77J0PSPKPCZ1B6XQ4J10", "reason": "LHDN Error" },
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

object {0}

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"
    }
  ]
}