Glossary

AECloud intermediary

AECloud's role in preparing and submitting supported e-Invoice documents to MyInvois on behalf of an authorized taxpayer. This is separate from the merchant integration client's authentication to AECloud.

AECloud business payload

The business-oriented JSON contract accepted by an AECloud document endpoint. It is not a MyInvois Submit Documents wrapper or a complete regulatory UBL document.

Access token

A temporary OAuth2 bearer credential used to authorize API requests.

Accepted UUID

The unique identifier assigned to an individual document accepted by LHDN for processing.

API base URL

The environment-specific URL prefix for the AECloud versioned endpoints. In this guide it is represented by {api_base_url}.

Cancellation

An operation that asks LHDN to cancel an eligible submitted e-Invoice and records the outcome in AECloud.

Client ID

The identifier of a merchant API client. It is used with the client secret to request an access token.

Client secret

The confidential credential paired with a client ID. It must never be exposed in source code or documentation.

Company code

The AECloud merchant GUID used to route a payload and scope applicable queries or actions.

Consolidated submission

A scheduled process that groups eligible transactions according to the merchant's consolidated-submission configuration.

Document number

The stable POS or ERP reference supplied as sales.documentNo.

InProgress

A status indicating that document processing is underway. Resubmission and voiding are not allowed in this state.

Long ID

An identifier used together with the accepted UUID to form a validated-document sharing link.

OAuth2 client credentials

A system-to-system authentication flow in which a client ID and secret are exchanged for a bearer access token.

In this guide, the credential authenticates the merchant's downstream system to AECloud. AECloud uses a separate intermediary authentication flow when communicating with MyInvois.

QR custom GUID

A downstream-generated unique receipt identifier supplied as aec.qr_custom_guid. It supports receipt/customer-portal linkage and must not be reused across different documents.

Sale GUID

The AECloud identifier returned for a stored document. It is used for status, void, and cancellation operations.

Self-billed document

An e-Invoice document issued by the buyer under an applicable self-billing scenario. Its supplier and buyer roles differ from a normal sale document.

Submission UID

The identifier assigned to an LHDN submission operation. One submission and an individual accepted document have different identifiers.

Terminal status

A state not expected to change through ordinary processing, such as Valid, Invalid, Voided, or Cancelled.

TIN

Tax Identification Number. A taxpayer's TIN should be validated with its matching identification type and number.

Void

An AECloud operation that stops and locks an unsubmitted document before it becomes valid or enters active LHDN processing.