Connect OpenCart

Audience: Shop owner (Admin) Time: 10 minutes

The extension envoice - LHDN e-Invoice is listed free on the OpenCart Marketplace. It works with OpenCart 4.0 and files e-invoices for your orders automatically or on demand. You need an envoice account; the Free plan is enough to start.

1. Install the extension

  1. Download the extension from the OpenCart Marketplace (search for envoice). The file is envoice.ocmod.zip.
  2. In your OpenCart admin, go to Extensions > Installer, click Upload and choose the zip.
  3. Go to Extensions > Extensions, choose Modules, find envoice - LHDN e-Invoice and click Install (the green plus).
  4. Click Edit (the pencil) to open it.

2. Connect your envoice shop

  1. In the module, under Connection, click Connect to envoice.
  2. A window titled Connect your OpenCart store opens on envoice.my. Sign in, or create a free account first.
  3. Pick the shop to link and connect. The window confirms the connection and closes by itself.

The module shows Connected. A Sandbox label shows while your envoice shop is not yet filing to LHDN. To go live, see Start in the demo shop and go live.

3. Choose your settings

Under Settings:

  • Auto-submit paid orders: file automatically when an order enters a paid status.
  • Paid statuses: the order statuses that count as paid. Default: Processing and Complete.
  • Submission mode: Individual e-invoice per order, or Record for monthly consolidated e-invoice (B2C).
  • Skip non-MYR orders: do not auto-submit foreign currency orders; submit them by hand.
  • Minimum order total: only auto-submit orders at or above this amount. Leave empty for all orders.

Leave API base (dev only) and Public base (dev only) empty. Click Save settings.

4. File orders by hand

The module lists your recent orders with their Order status, Total and e-Invoice status. Actions on each row:

  • Submit e-invoice or Record for consolidation
  • Add buyer TIN: enter the buyer's ID, click Verify TIN (checked against LHDN), then Save buyer
  • Receipt to open the receipt PDF, and Refresh status
  • Resubmit after a failure
  • Credit note for a refund, Cancel within LHDN's 72-hour window, and Cancel CN to cancel a credit note first

Orders with a buyer TIN, orders above RM10,000 and foreign currency orders always file individually, even in consolidated mode. Foreign currency amounts use Bank Negara Malaysia's reference rate.

Disconnect

Click Disconnect in the module. Filed e-invoices stay in your envoice account.

Related articles