Self-Billed Documents

Self-billed endpoints are separate from normal sale endpoints. Use them only when the transaction qualifies for self-billing and the merchant, acting as buyer, is responsible for issuing the document.

The MyInvois type codes are:

Document	Type code
Self-billed invoice	11
Self-billed credit note	12
Self-billed debit note	13
Self-billed refund note	14

AECloud selects the appropriate conversion from the endpoint family; the downstream system does not call the MyInvois submission endpoint directly.

Endpoints

POST {api_base_url}/self_billed/invoice_submission
POST {api_base_url}/self_billed/credit_note_submission
POST {api_base_url}/self_billed/debit_note_submission
POST {api_base_url}/self_billed/refund_note_submission

Supplier instead of customer

For a non-consolidated self-billed payload, use a supplier object instead of the normal sale customer object. Required fields are:

• name and contact;
• tin, idType, and idNum;
• msicCode and msicDescription;
• addressLine1, city, state, and country.

Optional stored fields include email, sstRegNum, addressLine2, addressLine3, and postcode.

Example fragment:

"supplier": {
  "name": "TEST FOREIGN SUPPLIER",
  "contact": "+6500000000",
  "tin": "{applicable_supplier_tin}",
  "idType": "PASSPORT",
  "idNum": "{supplier_identification}",
  "msicCode": "{applicable_msic_code}",
  "msicDescription": "{applicable_msic_description}",
  "email": "supplier@example.com",
  "addressLine1": "1 TEST ROAD",
  "city": "SINGAPORE",
  "state": "{applicable_state_code}",
  "postcode": "{applicable_postcode}",
  "country": "{applicable_country_code}"
}

The fragment is illustrative. Determine the legally applicable TIN, identification, state, country, and business-classification values for the actual supplier.

Self-billed adjustments

Self-billed credit, debit, and refund notes require originalInvoices. They must refer to an original self-billed invoice. Do not use a normal sale invoice as the source reference.

Party-role check

The most common structural mistake is reversing the parties. For normal sale documents, the merchant is supplier and the payload provides customer. For self-billed documents, the merchant is buyer and the payload provides supplier.

Review the current MyInvois e-Invoice types and the relevant self-billed document structure before production use.