Connect Shopify

Audience: Shop owner (Admin) Time: 5 minutes

The envoice app is listed on the Shopify App Store. Once installed and connected, it files LHDN e-invoices for your Shopify orders from inside your Shopify admin: one order at a time, in bulk, or automatically when an order is paid.

1. Install the app

  1. In the Shopify App Store, search for envoice and open the envoice app.
  2. Click Install and approve the permissions.

2. Connect your envoice shop

  1. Open the envoice app in your Shopify admin and click Connect to envoice.
  2. A window titled Connect your Shopify store opens on envoice.my. Sign in with Zoho, Google, GitHub or email, or create a free account.
  3. Pick the envoice shop to link and click Connect store. If you have only one shop it is picked for you. No shop yet? Click Create shop and connect.
  4. The window shows Connected. and closes by itself. The app finishes setup on its own and shows your plan and monthly usage.

In envoice, Settings > Integrations now shows Shopify as connected under Storefront apps.

3. Add your LHDN credentials

The Shopify app files through your envoice shop, so the shop needs MyInvois credentials and a filing destination. Until then, documents go to the internal test mock. See Start in the demo shop and go live.

4. File your orders

In the app's order list:

  • One order: click Submit to MyInvois on the order. The row shows the LHDN status, UUID and a View QR link within seconds. WhatsApp shares the validation link with the buyer.
  • Several orders: tick the rows and click Submit selected to MyInvois.
  • A buyer who wants the e-invoice in their own name: click Add buyer TIN, choose the ID type, enter the number, click Verify TIN, then Submit with this buyer.

You can also collect the TIN at checkout: add a cart attribute named TIN (and optionally ID type, ID value, Business name) to your theme. Orders that carry it file with that buyer automatically.

Test, unpaid, cancelled and refunded orders are blocked with a plain reason. An order that is already validated is never filed twice. Orders in other currencies file with Bank Negara Malaysia's exchange rate for the day.

5. Automate it

Turn on Auto-submit paid orders and choose a mode:

  • File each order individually. Every paid order becomes its own e-invoice, and refunds file matching credit notes automatically.
  • Record for monthly consolidated e-invoice. Orders are recorded and you file one consolidated e-invoice at month end from envoice (Documents > Consolidated). Orders above RM10,000 still file individually.

Optional conditions: Skip non-MYR orders (on by default), a Minimum order total, and tags to include or exclude orders (for example tag no-einvoice).

Refunds and cancelling

  • Each Shopify refund, full or partial, files as a credit note that references the original e-invoice: automatically in individual mode, or with File credit note on the order.
  • Cancel e-invoice works within LHDN's 72-hour window. After that, use a credit note.

Plans

The app shows your plan and monthly usage at the top, and its upgrade button opens the plans available to Shopify merchants. Documents are counted in envoice the same way as everywhere else; consolidated mode uses one document per month for all recorded orders.

Uninstalling the app disconnects the store at once. E-invoices already filed stay in your envoice account, because they are tax records.

Related articles