MyInvois e-Invoice for WooCommerce — LHDN e-invoices from the order in Malaysia

MyInvois e-Invoice submits a WooCommerce order to MyInvois, the system of the Malaysian tax authority LHDN. You press a button in the order, the plugin builds the document, passes it on and shows the validation result. The plugin works only through your own Client ID and secret.

This plugin has never submitted a real document. First submit a few documents in the sandbox with your own data.

Digital signature. The plugin sends documents of version 1.0, without a digital signature. In the FAQ of its SDK, LHDN says version 1.0 may be submitted without digital signature validation until LHDN officially announces its retirement, and strongly recommends version 1.1 with a signature. The plugin has no version 1.1 or signing yet. Before you submit production documents, check this with your tax adviser.

The plugin makes no promise of compliance with Malaysian law and is not accounting or tax advice. Check TIN, classification and taxes with your accountant.

What the buyer sees

If a buyer needs an invoice for a company, they enter a TIN and registration number at checkout. The fields are optional and work at classic and block checkout. Without a TIN an order is not submitted on its own: for such orders Pro has a monthly consolidated invoice.

What the admin gets

In the settings you pick sandbox or production, enter keys, seller data, MSIC and document defaults. The order has a box with the buyer TIN, a submit button and the status. Once a document is accepted, a link to it in MyInvois appears, and once refused, the codes and reason text are shown.

In Pro a document goes by itself on Completed, a refund becomes a refund note, a document can be cancelled, and orders without a TIN gather into a consolidated invoice.

How it works, step by step

1. In the MyInvois portal you register your system and take the Client ID and secret.
2. You enter them in the plugin and fill in seller data and MSIC.
3. You stay on the sandbox first.
4. You press submit in the order.
5. LHDN validates the document and the plugin shows the result.
6. After the sandbox you switch to production.

Under the hood

• No intermediary: the shop talks to LHDN directly with your keys.
• The hash is taken over the exact bytes of the document.
• The token is kept for an hour and renewed after a 401.
• Documents are not signed: version 1.0.
• The total is built from rounded lines, so a difference of a sen from the order total is possible.
• Consolidation skips non-MYR orders and orders with refunds.

How to install

1. Plugins → Add New → Upload Plugin: pick the zip and activate.
2. WooCommerce → MyInvois: stay on the sandbox and enter the Client ID and secret.
3. Fill in seller data, TIN, MSIC, address and phone.
4. Press the connection test and submit a test order.
5. For Pro: paste the key or start the 7-day trial.

The module is not on wordpress.org yet: the free version and Pro are one archive from this page. Without a key it works as the free version.