Zoho Books guides

Switch to envoice from another e-invoice app

Move from another Zoho e-invoice app to envoice without filing any document twice.

Who this is forShop owner (Admin)

Estimated time15 minutes

You can move to envoice from another Zoho Books e-invoice app. Your past filings stay valid at LHDN. Nothing is filed twice.


1. Pick a cutover date

Choose the day envoice takes over. Documents before that day stay with the old app. From that day, submit everything from the envoice widget.

Do not submit the same document from both apps.

2. Register envoice as an ERP in MyInvois

envoice needs its own Client ID and Client Secret. See Get your LHDN MyInvois API credentials. Then connect Zoho Books.

3. What envoice detects automatically

envoice reads the old app's fields on each Zoho document.

  • Already filed. An invoice, credit note or debit note that already has an LHDN UUID from the old app is blocked. The panel shows Filed by another e-invoice app with the UUID. envoice will not file it again.
  • Notes on old invoices. A credit, debit or refund note you file with envoice can adjust an invoice the old app filed. envoice uses that invoice's UUID from the old app's field.

Documents the old app never filed need nothing. envoice reads them from Zoho as they are.

4. Copy LHDN details on contacts and items

Right after you connect, the envoice widget in Zoho Books asks Switching from another e-invoice app? Click Copy now. A summary shows how many contacts and items were updated.

The widget shows how many contacts and items were updatedOpen full-size screenshot (new tab)

If you connected on the web, envoice shows the same offer during onboarding.

Missed it? In envoice, open your shop, go to Zoho Integration, open Connection tools and click Copy LHDN details from previous e-invoice app.

Copy LHDN details in Connection tools, with the resultOpen full-size screenshot (new tab)

envoice copies:

From the old app Into the envoice field
TIN TIN
Registration scheme (NRIC, BRN, PASSPORT, ARMY) ID Type
Registration number ID Value
SST registration number SST Registration
Item classification LHDN Classification
Product tariff code LHDN Tariff Code
Country of origin LHDN Country of Origin

Only empty envoice fields are filled. Your own values are never overwritten. A classification with no LHDN match is skipped and counted, so set it by hand. See Set LHDN fields on contacts and items.

A large organisation may need more than one run. Click again until it says nothing remains. Running it again is safe.

Past filings show in envoice

The same copy saves every document the old app filed as a Previous app record. You find them in envoice under Invoices, in a Previous app section below your own documents. It shows on the first page when no filter is set.

Previous app records in envoice InvoicesOpen full-size screenshot (new tab)
  • They are read only. To cancel one, use MyInvois or the old app.
  • They do not count towards your plan usage or monthly totals, and never join a consolidated e-invoice.
  • They are included when you download your MyInvois records.

So your full e-invoice history is in one place from the day you switch.

5. Revoke the old app

After the cutover date, revoke the old app's access in MyInvois (Representatives > ERP) so it can no longer file for you.

Keep the old app's fields in Zoho. They hold the LHDN UUIDs of its past filings, which envoice reads to block duplicates and to reference old invoices. Uninstalling an extension can remove its fields, so check with its provider before you uninstall it.

Where to go next