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.
Watch the overview
61-second silent overview. Follow the steps below for setup and filing instructions.
1. Install the app
- In the Shopify App Store, search for envoice and open the envoice app.
- Click Install and approve the permissions.
Open full-size screenshot (new tab)2. Connect your envoice shop
- Open the envoice app in your Shopify admin and click Connect to envoice.
- A window titled Connect your Shopify store opens on envoice.my. Sign in with Zoho, Google, GitHub or email, or create a free account.
- Pick the envoice shop to link. If you have only one shop it is picked for you.
- Tick I run your store's address. This confirms the store is yours: its orders get filed under your envoice shop. Got the connect link from someone else? Stop here.
- Click Connect store. No shop yet? Click Create shop and connect.
- The window shows Connected to your shop name and closes by itself. The app finishes setup on its own and shows your plan and monthly usage.
Open full-size screenshot (new tab)
Open full-size screenshot (new tab)
Open full-size screenshot (new tab)
Open full-size screenshot (new tab)In envoice, Settings > Integrations now shows Shopify as connected under Storefront apps.
Open full-size screenshot (new tab)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 the app shows Sandbox mode and a Finish setting up envoice checklist, and documents go to the internal test mock, not to LHDN.
Open full-size screenshot (new tab)- Get your Client ID and Client Secret from the MyInvois portal: Get your LHDN MyInvois API credentials.
- Paste them into envoice: Enter your LHDN credentials into envoice. Set up next to MyInvois credentials in the app opens that page.
- Click Set up next to Go live to switch from sandbox to production. More on this in Start in the demo shop and go live.
Faster with Chrome: the free envoice LHDN helper also works inside the app in your Shopify admin. It registers envoice in MyInvois and brings the Client ID and Client Secret back for you.
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.
Open full-size screenshot (new tab)The order list shows which orders are not submitted, validated or awaiting consolidation.
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).
Open full-size screenshot (new tab)Open Settings beside Auto-submit paid orders to choose a filing mode and set conditions. This demo store has Skip non-MYR orders switched off.
Let buyers request an e-invoice
Most online buyers do not need an e-invoice in their own name. Some do: a company buying supplies, or a buyer claiming the purchase as a business expense. With envoice's request portal they fill in their own TIN and company details, and envoice files the e-invoice in their name for that order. You do not have to collect the details yourself.
Switch on the portal
In envoice, open Settings > Portal and switch on Enable portal, then click Save portal settings. Leave Review requests before filing on to check each request first. Full steps: Let buyers request e-invoices (customer portal).
Find your portal link
- In envoice: Settings > Portal, under Share the portal (Saved portal URL).
- In the envoice app in your Shopify admin: Settings tab, Buyer request portal. It has Copy, Copy order email line and Download QR. If it says Request portal is off, click Turn on in envoice.
On Pro and Enterprise the link is https://<your-name>.envoice.my; on other plans it is https://envoice.my/request/<your-name>.
Add the link to the order confirmation email
- In the envoice app, open Settings and click Copy order email line. The line already has your portal link.
- In your Shopify admin, go to Settings > Notifications.
- Click Customer notifications, then Order confirmation.
Open full-size screenshot (new tab)- Click Edit code.
- In Email body (HTML), press Ctrl+F (Cmd+F on Mac) and find
{{ email_body }}. This is the greeting under the title.
Open full-size screenshot (new tab)- Click at the end of the line that holds
{{ email_body }}and press Enter. - Paste the line on the new empty line.
Open full-size screenshot (new tab)- Click Save. Click Preview to check it.
The line looks like this, with your own portal link:
<p>Need an e-invoice in your company name? Request it here, your order number is already filled in:<br>
Perlukan e-Invois atas nama syarikat anda? Mohon di sini, nombor pesanan anda sudah diisi:<br>
<a href="https://envoice.my/request/demo-fitness?ref={{ order_name | remove_first: '#' | url_encode }}">https://envoice.my/request/demo-fitness</a></p>
{{ order_name }} is the order number (for example #1001). The line drops the # so the portal finds the order. The link carries only the order number, with no tracking.
Add the link to the thank you page
Shopify does not let stores paste their own code into the thank you and order status pages. The envoice block does it instead. It shows the e-invoice status and a Request it link with the order number filled in.
- In the envoice app, open Settings and click Add to thank-you page. The checkout editor opens with the Apps panel.
- Click + next to einvoice-status and choose Thank you. The block appears on the page.
Open full-size screenshot (new tab)- Click + next to einvoice-status again and choose Order status.
- Click Save.
The link shows only when the portal is on and your envoice shop files to LHDN for real (not sandbox). It hides once the order has its own e-invoice.
Print the QR on Shopify POS receipts
For in-store sales on Shopify POS, print the portal QR on every receipt.
- In your Shopify admin, go to Sales channels > Point of Sale > Settings and click Printed receipts.
- Under Footer, click QR code.
- In URL, paste your portal link. In Label, type
Scan to request an e-invoice.
Open full-size screenshot (new tab)- Click Save.
The buyer scans the QR and types the order number from the receipt.
What the buyer does
The buyer opens the link, checks the order number (the link fills it in; typed by hand, #1001 and 1001 both work), the purchase date and the total, and adds their own TIN and company details. With Review requests before filing on, the request waits in envoice under Documents > Requests for you to approve.
envoice matches the request to the Shopify order by its order number and total and files the e-invoice in the buyer's name. If the order was recorded for your monthly consolidated e-invoice, envoice takes it out of the pool, or files a credit note for it when that month is already consolidated, so LHDN does not count the sale twice.
The portal works best with Record for monthly consolidated e-invoice. An order already filed as its own e-invoice (individual mode) cannot take a second one: the portal tells the buyer to contact you. To put their details on it, cancel it within 72 hours and file it again with Add buyer TIN.
Check submission history
Open Submission history to review previous filings. Search by order or document ID, or use the status and document-type filters to narrow the list.
Open full-size screenshot (new tab)Order numbers keep each filing connected to its Shopify order.
Select a row to see the document's buyer, line items, totals, LHDN result and timeline. Validated documents include View validation QR and Receipt PDF links.
Open full-size screenshot (new tab)This example uses a general-public buyer and placeholder products.
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. Your plan has two monthly limits: e-invoices, and consolidated sales (orders with no buyer TIN, recorded for the monthly consolidated e-invoice). Orders count the same way as everywhere else in envoice. To raise either limit, upgrade your plan in the envoice app.
Uninstalling the app disconnects the store at once. E-invoices already filed stay in your envoice account, because they are tax records.