📌 Key Takeaways
- Two routes: LHDN offers two ways to submit e-invoices: the MyInvois Portal, and the MyInvois API, which connects your accounting or ERP system directly or through a technology provider.
- Portal suits low volume: The portal supports one-by-one entry and batch upload using LHDN’s predefined Excel template, and LHDN positions it for businesses without an API connection.
- API suits volume and control: LHDN describes the API as ideal for large taxpayers or businesses with substantial transaction volume, with XML or JSON submissions in UBL 2.1 format.
- Same validation rules: Both routes go through the same near real-time validation, unique identifier number, QR code and 72-hour cancellation and rejection window.
- Middle path: Accounting software with built-in MyInvois API submission, such as AutoCount Cloud Accounting, gives SMEs API benefits without building an integration themselves.
Table of Contents
- MyInvois API or MyInvois Portal: The Short Answer
- How the MyInvois Portal Works
- How MyInvois API Integration Works
- MyInvois Portal vs MyInvois API: Side-by-Side Comparison
- Three Practical Options for Malaysian SMEs
- Using the MyInvois API Through AutoCount
- How to Choose Your e-Invoice Submission Method
- Next Steps: Move from Manual Uploads to Automated Submission
- Frequently Asked Questions
MyInvois API or MyInvois Portal: The Short Answer
Use the MyInvois Portal if you issue a small number of invoices and have no system that can connect to LHDN; use the MyInvois API, either through your own integration or through accounting software that has it built in, if you issue invoices regularly, need consolidated or self-billed e-invoices, or want e-invoices to come straight from your sales records. For most Malaysian SMEs above a handful of invoices a week, API submission through their accounting software is the more sustainable choice because it removes double entry.
Both methods lead to the same result: an e-invoice validated by LHDN with a unique identifier number. The difference is how the data gets there, who keys it in, and how errors are caught. This guide compares the two routes using LHDN’s e-Invoice Guideline and the MyInvois SDK, and explains the practical trade-offs we see when helping Malaysian businesses choose.
How the MyInvois Portal Works
The MyInvois Portal is LHDN’s web application for taxpayers who cannot issue e-invoices through their own systems. LHDN’s guideline describes it as suited to businesses that need to issue e-invoices but do not have an API connection available. There are two ways to submit through it:
- Single submission: you fill in an online form with all the required fields for each e-invoice.
- Batch upload: you prepare multiple e-invoices in LHDN’s predefined Microsoft Excel spreadsheet and upload the file.
Once an e-invoice is validated, the portal can generate a PDF visual representation with a QR code, which your buyer can scan to check the e-invoice’s status on MyInvois.
Where the portal works well
- Very low invoice volumes, such as a consultant issuing a few invoices a month.
- Occasional self-billed e-invoices or one-off transactions that your normal system does not handle.
- A temporary fallback while an integration is being set up or tested.
Where it struggles
- Double entry. Each invoice is created in your accounting system and again in the portal, so mistakes and mismatches creep in.
- Batch preparation effort. Spreadsheets must match LHDN’s template exactly, and someone has to export, reformat and check them every time.
- No link back to your books. The unique identifier number and validation status have to be recorded against the original invoice manually.
How MyInvois API Integration Works
With the MyInvois API, your accounting or ERP system sends e-invoices to LHDN automatically and receives the validation result back. LHDN’s guideline describes the API as ideal for large taxpayers or businesses with substantial transaction volume, noting that it requires upfront investment in technology. There are three ways to connect:
- Direct integration between your ERP or accounting system and the MyInvois System.
- Peppol service providers, who connect to MyInvois on your behalf.
- Non-Peppol technology providers, such as accounting software vendors and middleware platforms.
What the API requires
- Structured data: e-invoices are submitted in XML or JSON following the Universal Business Language (UBL) 2.1 data structure.
- A digital certificate: each submission carries a digital signature that verifies the issuer. Where a technology provider submits for you, the e-invoice is signed with the provider’s certificate.
- Taxpayer permissions: if an intermediary submits on your behalf, you grant it permission in MyInvois, and the intermediary can only act within those permissions.
The API submission flow, step by step
- Your system authenticates with MyInvois and obtains an access token.
- The invoice is converted into UBL 2.1 XML or JSON and digitally signed.
- The document is submitted, and MyInvois returns a submission reference.
- MyInvois runs structure and core field checks immediately, then signature, taxpayer, referenced-document and duplicate checks in the background.
- Your system polls the submission status and receives either a valid result, with the unique identifier number and the details needed for the validation link, or an error response explaining what to fix.
- Your system stores the result against the original invoice and embeds the QR code in the visual representation shared with the buyer.
The full requirements are in the LHDN e-Invoice guidelines, which also explain the validation statuses of Submitted, Valid, Invalid and Cancelled.
Technical limits to plan around
The MyInvois SDK integration practices and API documentation set out the operating rules developers must follow, including:
- Up to 100 e-invoices per submission, a maximum submission size of 5 MB and up to 300 KB per e-invoice.
- A recommended limit of 100 Submit Documents requests per minute per client ID, with lower limits for other calls such as cancellation and searches.
- Access tokens should be cached and reused for their lifetime rather than requested for every call.
- Status should be checked by polling the submission, and documents should not be resubmitted after a successful response, as this is flagged as a duplicate.
- The sandbox is for functional testing only, has lower rate limits and deletes data after up to three months.
None of this is difficult for an experienced developer, but it is ongoing work. LHDN updates the SDK and validation rules, so a custom integration needs someone to maintain it.
MyInvois Portal vs MyInvois API: Side-by-Side Comparison
| Factor | MyInvois Portal | MyInvois API |
|---|---|---|
| Best for | Low volumes, no connected system | Regular or high volumes, invoices generated in a system |
| How data is entered | Online form or Excel batch upload | Sent automatically from accounting or ERP records |
| Upfront cost | No system cost, staff time only | Software, integration or provider fees |
| Ongoing effort | Rekeying or spreadsheet preparation for every batch | Exception handling only, plus maintenance when LHDN updates the SDK |
| Error risk | Higher, because data is typed or copied twice | Lower, because data comes from one source |
| Validation result | Shown on screen, recorded manually | Returned to your system and stored against the invoice |
| Consolidated and self-billed e-invoices | Possible, but prepared by hand | Can be generated from POS, purchase or payment records |
| Scales with growth | Poorly | Well |
Whichever route you choose, the compliance rules are identical. Validation happens in near real-time, each valid e-invoice receives an LHDN unique identifier number and validation link, and suppliers can cancel, or buyers can request rejection of, an e-invoice within 72 hours of validation. After 72 hours, corrections must be made through a credit note, debit note or refund note e-invoice.
Three Practical Options for Malaysian SMEs
In practice, the choice is rarely just portal or API. Most businesses we work with end up in one of three set-ups.
Option 1: Portal only
Suitable for very small volumes or businesses that are voluntarily adopting e-invoicing. Low cost, but heavy on manual work and only sensible while volumes stay low.
Option 2: Accounting software with built-in MyInvois API
Your accounting software handles the API connection, digital signing, retries and status updates. You issue invoices as usual, and they are submitted to LHDN from the same screen. For most Malaysian SMEs this offers the best balance of cost and control, because the vendor maintains the integration as LHDN changes its rules.
Option 3: Custom ERP integration or middleware
Larger businesses running Oracle NetSuite, a custom system or several platforms may integrate directly or through a Peppol or technology provider. This gives the most flexibility but needs proper design, testing and ownership. Our article on how NetSuite handles Malaysia e-invoicing compliance explains how this works in an ERP setting.
Using the MyInvois API Through AutoCount
AutoCount’s e-invoice solution is an example of Option 2. AutoCount says its AutoCount e-Invoice Platform (AIP) is built on LHDN’s official e-Invoice SDK and enables direct submission of e-invoices to MyInvois through the familiar AutoCount interface. According to AutoCount, the platform:
- Manages buyer details and TINs during onboarding.
- Updates MSIC codes and units of measure in line with LHDN requirements.
- Queues invoices and retries submissions during LHDN downtime until they are validated.
- Supports standard e-invoices from AutoCount Accounting and AutoCount Cloud Accounting, consolidated e-invoices for retail and F&B through POS, and self-billed e-invoices for cases such as payments to agents, dealers and distributors.
AutoCount Cloud Accounting lets you submit for e-invoice validation directly within the system, without maintaining servers. If you consolidate B2C sales, our guide to e-invoice consolidation rules SMEs often miss covers what to watch for.
How to Choose Your e-Invoice Submission Method
Work through these questions before deciding:
- How many invoices do you issue each month? If the answer is more than you would happily retype, the portal will become a bottleneck.
- Where are invoices created today? If they already come from an accounting, POS or ERP system, submitting from that system avoids duplicate records.
- Do you need consolidated or self-billed e-invoices? These are much easier to generate from source transactions than to prepare by hand.
- Who will maintain the connection? A custom integration needs an owner who tracks SDK and rule changes. Built-in software integration shifts that work to the vendor.
- What happens when LHDN is unavailable? Check whether your method queues and retries automatically or depends on someone resubmitting.
- Are you within scope? Under LHDN’s General Guideline version 4.8, taxpayers with annual turnover or revenue of less than RM3 million are exempt, subject to group rules, but may adopt e-invoicing voluntarily.
For the errors we see most often after go-live, read common e-invoicing mistakes Malaysian SMEs make.
Next Steps: Move from Manual Uploads to Automated Submission
If your team is retyping invoices into the MyInvois Portal or rebuilding Excel batches every week, that is usually the signal to move to API submission through your accounting system. Start by listing your invoice types, monthly volumes and the systems that create them, then check which of those can submit to MyInvois directly.
iDynamics implements and supports AutoCount for Malaysian businesses, including set-up of e-invoice submission. See how AutoCount Cloud Accounting with built-in e-invoice validation could replace manual uploads, or request a free consultation and demo with iDynamics to review your current e-invoice process.
Frequently Asked Questions
What is the MyInvois API?
The MyInvois API is LHDN’s application programming interface that lets accounting and ERP systems submit e-invoices to the MyInvois System automatically and receive validation results. Submissions use XML or JSON in the UBL 2.1 structure and are digitally signed.
Is the MyInvois Portal free to use?
The MyInvois Portal is provided by LHDN for taxpayers to submit e-invoices without their own system integration. The main cost is staff time, because invoices must be keyed in individually or prepared in LHDN’s Excel template for batch upload.
Can I use both the MyInvois Portal and the API?
Yes. Both routes submit to the same MyInvois System, so a business can submit most invoices through its accounting software and use the portal for occasional exceptions. The validation rules, unique identifier number and 72-hour cancellation window are the same either way.
How many e-invoices can be submitted in one MyInvois API call?
According to the MyInvois SDK, each submission can contain up to 100 e-invoices, with a maximum submission size of 5 MB and up to 300 KB per e-invoice. The SDK also recommends a limit of 100 submission requests per minute per client ID.
Do I need a developer to use the MyInvois API?
Not necessarily. If your accounting software has built-in MyInvois submission, such as AutoCount, the vendor handles the API connection. A developer or integration partner is usually needed only for custom ERP or middleware integrations.
Stephanie Chong
Stephanie writes about Malaysia’s e-invoicing, SST, tax codes, and accounting system readiness for SMEs. At iDynamics Asia, their content helps business owners and finance teams understand LHDN requirements, prepare their accounting software, and avoid common setup mistakes when managing tax-related business processes.
Expertise Areas:
Malaysia e-invoicing, LHDN e-invoice readiness, MyInvois, SST, tax codes, self-billed e-invoices, invoice consolidation, accounting system setup, SME finance operations.
