Skip to navigation

Cancel Malaysia E-Invoice

View as Markdown

Cancel a previously submitted Malaysia e-invoice document on LHDN MyInvois.

You can cancel by sending either:

  • docId (Staple document ID), or

  • uuid (MyInvois document UUID)

Important:
Cancellation is subject to MyInvois/LHDN rules, such as allowed time window and document state.
If cancellation is not allowed, clients should issue a Credit Note instead.


Endpoint

POST /v2/einvoice/malaysia/cancel


Request Headers

AttributeTypeOptionDescription
x-api-keyStringRequiredA unique string
AuthorizationStringRequiredBearer token

Content-Type: application/json
Accept: application/json


Request Payload (by docId)

FieldTypeRequiredDescription
reasonString✅Cancellation reason
docIdNumber✅Staple document ID

Sample

{
"reason": "Wrong line item quantity",
"docId": 242020
}

Request Payload (by uuid)

FieldTypeRequiredDescription
reasonString✅Cancellation reason
uuidString✅MyInvois document UUID

Sample

{
"reason": "Wrong line item quantity",
"uuid": "KAQ2848KJ35CCAH3PY86FMMK10"
}

Response (Success)

{
"uuid": "KAQ2848KJ35CCAH3PY86FMMK10",
"status": "Cancelled"
}

Response Field Notes

  • uuid: MyInvois document UUID of the cancelled document

  • status: Expected success value is Cancelled


Error Notes

If cancellation fails, clients should inspect the returned error details from this endpoint.

Example request payload:

{
"reason": "Wrong line item quantity",
"docId": 242020
}

Authentication

x-api-keystring
API key issued by Staple.
AuthorizationBearer
JWT obtained from the login endpoint.

Request

This endpoint expects an object.
reasonstringOptional

Response

OK