Last Updated: 20th September 2024

Void Document

POST

/einvoices/void

LHDN

This API endpoint allows to set status of a Document to Void.

Only Documents that are in Draft, PendingApproval, Invalid status can be Voided.

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 {1}]

required

reference_number

string

required

Document reference number to be voided.

Example

{
  "reference_number": "BeaconX-22873"
}

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/void' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_number": "BeaconX-22873"
}'

Responses

🟢200OK

application/json

Body

status

string

required

message

string

required

data

array[string]

required

Examples

SuccessException

{
  "status": "Failed",
  "message": "Document is already voided.",
  "data": []
}

Modified at 2024-09-19 19:57:20

Cancel/Reject Documents

Unvoid Document