Skip to content
Document type 12

Self-billed credit note — the buyer issues a credit against a self-billed invoice they previously issued.

Type 12 is the self-billed mirror of a credit note. The buyer (who issued the original self-billed invoice on the supplier's behalf) issues a credit note to themselves, reducing the supplier's liability. Same party-flip rules as type 11: the buyer is the issuer-of-record, the supplier is the party whose MSIC code matters.

When to issue

Four common scenarios.

  1. 01Tax agent issuing a credit against a self-billed invoice they previously issued for a client.
  2. 02Procurement team correcting an over-payment they self-billed earlier in the period.
  3. 03Marketplace platform reducing a merchant's payout after a returned transaction.
  4. 04Co-operative recalculating a member's dividend after period-end reconciliation.
Required LHDN fields

What this document type carries that a generic invoice doesn't.

  • Original self-billed invoice reference — UUID of the parent type-11 document.
  • Party-flip preserved — buyer is the issuer, supplier is the party whose books the credit affects.
  • Supplier MSIC code required (same as type 11).
  • Reason code from LHDN's structured list.
How Bridge handles it

Same pipeline as every other type.

All four self-billed types share the same `buildUblInvoiceXml` pipeline. Type 12 inherits the parent-UUID enforcement of regular credit notes (02) plus the party-flip handling of self-billed invoices (11) — the bridge keeps both invariants in the schema layer so the integration team doesn't need to special-case it.

Last updated · May 2026

Independent reference. MyInvois is operated by LHDN. We are not affiliated with LHDN.