Malaysia e-Invoice · LHDN / IRBM · MyInvois

Malaysia's mandatory
e-invoicing framework —
fully implemented.

All 5 IRBM document types. Phase 2 (1 Jul 2025) and Phase 3 (1 Jan 2026) deadlines. LHDN API integration, X.509 digital signature, UBL 2.1 XML mapping — end-to-end.

5
IRBM Document Types
72h
Buyer Rejection Window
RM300
Penalty Per Invoice
Book a Free Assessment Also need Peppol? →
Regulatory Timeline

Malaysia e-Invoice Phase Deadlines

IRBM has structured the rollout in three phases by annual turnover. Non-compliance carries financial penalties and, for repeated offences, criminal liability.

✓ Live Since Aug 2024
Phase 1
Annual Turnover > RM 100 Million

Large corporations were the first wave. Mandatory API or MyInvois Portal submission required. LHDN validation and UUID assignment live for this group since August 2024.

⚠ Deadline: 1 July 2025
Phase 2
Annual Turnover > RM 25 Million

Mid-size businesses — including manufacturers, distributors, and service firms above RM25M — must be fully compliant by 1 July 2025. This is the most time-sensitive deadline right now.

Deadline: 1 Jan 2026
Phase 3
All Remaining Businesses

All Malaysian businesses regardless of turnover must comply by 1 January 2026. No exemptions remain after this date. Now is the time to begin implementation planning.

⚠ Non-Compliance Penalties

Under the Income Tax Act 1967 (as amended), failure to issue a valid e-invoice carries a penalty of RM200 to RM1,000 per invoice. Repeated or wilful non-compliance can result in fines of up to RM20,000, a term of imprisonment, or both. X.509 digital signature and UUID are required on every validated document.

Where does your business fall?

Turnover > RM 100M Phase 1 — already mandatory Should be live now
Turnover > RM 25M Phase 2 — 1 July 2025 Immediate action required
All other businesses Phase 3 — 1 Jan 2026 Begin planning now
IRBM Document Types

The 5 Mandatory Document Types

IRBM mandates five distinct e-invoice document types. Each has a specific use case, set of mandatory fields, and the party responsible for issuance. Implementation must cover all five.

Type 01

Invoice

Standard commercial invoice for any taxable supply of goods or services between a supplier and a buyer — B2B and B2C.

Issued by: Supplier
Key fields: Supplier TIN, Buyer TIN, MSIC code, SST registration number, line-item tax category codes, total amounts.
Type 02

Credit Note

Issued to reduce the value of a previously validated invoice. Used for returns, discounts granted after invoice validation, or pricing corrections downward.

Issued by: Supplier
Must reference the original invoice UUID. Net effect reduces the supplier's taxable supply and the buyer's input tax claim.
Type 03

Debit Note

Issued to increase the value of a previously validated invoice. Used for additional charges, under-billed amounts, or price adjustments upward.

Issued by: Supplier
Must reference the original invoice UUID. Net effect increases the taxable supply and the buyer's corresponding input tax.
Type 04

Refund Note

Issued when a validated invoice has been settled and the supplier subsequently refunds part or all of the amount. Distinct from a Credit Note in that payment has already occurred.

Issued by: Supplier
References the original invoice UUID. Triggers a corresponding adjustment to the tax position for both parties.
Type 05

Self-Billed Invoice

Buyer issues the invoice on behalf of the supplier. Applies to specific qualifying transactions: agents and sub-agents, dealers, distributors, payments to foreign suppliers, and other IRBM-defined categories.

Issued by: Buyer (on behalf of Supplier)
Requires IRBM approval. Both parties' TINs must appear. The buyer assumes the compliance obligation for issuance and submission.

Implementation note: Your middleware or ERP integration must be capable of generating, signing, and submitting all five document types. A common implementation gap is handling Credit Notes and Self-Billed Invoices correctly — particularly the UUID cross-reference requirement and buyer-initiated submission flow.

Technical Architecture

The LHDN Document Lifecycle

Every validated e-invoice passes through this five-stage flow. Understanding it is the first step to implementing it correctly — and building the rejection and archival handling that most implementations miss.

1

Document Created in ERP or Accounting System

The invoice (or other document type) is generated with all mandatory IRBM fields populated: Supplier TIN, Buyer TIN, MSIC code (Malaysia Standard Industrial Classification), SST registration number (where applicable), and line-item tax category codes. UBL 2.1 XML schema must be correctly mapped from internal ERP data structures.

2
Two Submission Paths

Signed & Submitted to LHDN

The document is signed with an X.509 digital certificate before transmission. There are two submission paths: the LHDN API (programmatic, used by middleware and ERP integrations — recommended for volume) and the MyInvois Portal (manual, web-based — suitable for very small volumes or testing). Most Phase 2 businesses will require API integration.

3
Real-Time

Validated by LHDN — UUID & QR Code Assigned

LHDN validates the document in real time — checking schema compliance, TIN references, tax calculations, and MSIC codes. On successful validation, LHDN assigns a Unique Document Identifier (UUID) and generates a QR code. The LHDN validation timestamp is returned and starts both 72-hour windows simultaneously.

4
72-Hour Window

Buyer Notified — Rejection & Cancellation Window Opens

From the LHDN validation timestamp, a 72-hour window opens simultaneously for two actions: (1) the Buyer may formally reject the invoice via LHDN (e.g., wrong amounts, wrong party details); (2) the Supplier may cancel the invoice. After 72 hours, neither action is possible — the invoice is confirmed. Your ERP must monitor rejection status and surface alerts to the relevant team.

5

Validated Invoice Archived

If not rejected or cancelled within 72 hours, the invoice is confirmed. Both parties must retain the validated document — including the UUID and QR code — for the IRBM-stipulated archival period. The QR code links to the LHDN verification portal where anyone can verify the invoice's authenticity. Archival must be integrated into your document management workflow.

Implementation Experience

Implemented, Not Theorised

Every item below reflects work I have personally built, tested, and deployed in production environments — not knowledge drawn from documentation alone.

X.509 Digital Signature

Certificate embedded into the submission payload prior to LHDN API call. Covers certificate provisioning, signing algorithm configuration, and signature validation handling.

LHDN API — Full Endpoint Coverage

Submit document, get document status, cancel document, and reject document endpoints — all implemented and tested against LHDN's sandbox and production environments.

📄
UBL 2.1 XML Mapping

Internal ERP invoice line items mapped to the IRBM UBL 2.1 schema. Covers namespace handling, extension schema compliance, and all mandatory/conditional field population.

🏷
MSIC Code Integration

MSIC code lookup table integrated with product/service catalogue in the ERP. Automated assignment at line-item level based on product classification rules.

Rejection & Cancellation Flow

Buyer-initiated rejection via LHDN portal reflected back into the ERP in near real-time. Supplier cancellation flow with 72-hour enforcement and ERP status synchronisation.

🗄
UUID & QR Code Archival

UUID and QR code stored against each invoice record in the ERP. QR verification link embedded in customer-facing invoice PDF. Archival retention policy implemented.

What I Offer

Services for Malaysia e-Invoice

  • 01

    LHDN API Integration

    Direct middleware connection to MyInvois. Handles document submission, real-time validation response, UUID/QR retrieval, status polling, rejection detection, and cancellation flows.

    Deliverables: Working API middleware, endpoint documentation, error-handling playbook
  • 02

    ERP & Accounting System Bridge

    Connect SAP, Oracle, Xero, SQL Accounting, or custom internal systems to the e-invoice pipeline. No disruption to existing finance workflows. Covers all 5 document types.

    Deliverables: Integration spec, ERP connector, UAT sign-off checklist
  • 03

    Gap Assessment & Readiness Audit

    Know exactly where you stand before your compliance deadline. A structured review of your current invoicing stack, data quality, and team readiness — delivered as a ranked action list.

    Deliverables: Gap report, prioritised action list, implementation roadmap with timeline
  • 04

    Team Training & Documentation

    Finance and IT team handoff. Standard operating procedures covering daily submission, error handling, rejection response, and LHDN portal navigation. Includes ongoing advisory support.

    Deliverables: SOP documents, training session, Q&A reference guide
  • 05

    Full Document Type Compliance

    Coverage of all five IRBM document types — including the commonly missed Self-Billed Invoice (buyer-issued) flows for agents, dealers, distributors, and foreign suppliers.

    Deliverables: All 5 document templates, submission tests, Self-Billed eligibility checklist
Why Act Now
72h
Buyer rejection window from LHDN validation timestamp
  • Phase 1 (>RM100M) — live since Aug 2024
  • Phase 2 (>RM25M) — mandatory 1 July 2025
  • Phase 3 (all businesses) — mandatory 1 Jan 2026
  • Penalties: RM200–RM1,000 per invoice
  • Repeated non-compliance: up to RM20,000 or imprisonment
  • X.509 digital signature + UUID required per document
Get a Free Assessment →
Let's Talk

Ready to Start Your
Phase 2 Implementation?

Phase 2 deadline is 1 July 2025. First consultation is complimentary — let's identify your gaps and map out your implementation plan.

hello@peppwise.com
Send an Enquiry Book a Discovery Call