Zoho ERP to Odoo migration, step by step

Bring your Zoho ERP chart of accounts, taxes, customers, vendors and products into a new Odoo 20 instance. Zoho is only read, never changed.

Updated . 6 min read

You can move out of Zoho ERP yourself, from your dashboard, in a few minutes. We create a new Odoo 20 instance for you as a free trial, copy your Zoho data into it section by section, and then count everything again on both sides and show you the result.

Nothing in Zoho is changed. We ask Zoho for read-only access, so we can read your data but cannot create, edit or delete anything there. You keep working in Zoho the whole time, and you decide later whether to go live on Odoo.

Read this part first: what comes across, and what does not

Zoho migrations bring your master data - the things the rest of your books refer to:

  • Company & Chart of Accounts
  • Business Locations & Warehouses
  • Taxes
  • Customers & Vendors
  • Products

Your transactions do not come across. Invoices, bills, payments, sales and purchase orders and journal entries stay in Zoho. So does the history behind your account balances. What you get is a new Odoo that is set up the way your business is set up and ready to trade - not a copy of your books.

That is a real limit, and it is worth being blunt about it, because it decides whether this is useful to you. If you need your invoices and balances in Odoo as well, talk to us before you start: moving those is work we do, just not work this button does. Migrating from ERPNext or Sage Accounting does bring the documents.

Before you start

  • A Zoho login that can see the organization you want to move, and permission to approve access for it. Zoho shows you an approval screen during the migration, and whoever is signed in to Zoho at that moment is the one approving.
  • Which Zoho region your account is in. Zoho keeps each account in one region and the address differs: zoho.com, zoho.eu, zoho.in and so on. It is the end of the web address you use for Zoho. Pick the wrong one and Zoho will not recognise your sign-in.
  • An account here. The migrated instance is a free trial, like any new instance, so you do not need to pay anything to try this.
  • Nothing to install, and no export file to prepare. We read Zoho through its own API while the migration runs.

Step 1: Start a new project

In your dashboard, click New Project and choose Migrate from another system.

The Start a new project dialog, with the Migrate from another system card

Step 2: Choose Zoho ERP

Pick Zoho ERP as the system you are moving from. The wizard has five steps, and the sidebar keeps track of where you are; you can go back at any point before you start the migration.

Step 1 of the wizard: choosing Zoho ERP as the system to migrate from

Step 3: Choose what to bring over

There are five kinds of data, and they all start selected. Leave them as they are unless you have a reason not to - they depend on each other, and anything another item needs is brought over automatically.

Step 2 of the wizard: the five kinds of Zoho data

Step 4: Connect Zoho and approve read-only access

Choose the region your Zoho account is in, then click Connect Zoho. A new tab opens on Zoho's own site, where you sign in if you are not already. We never see your Zoho password.

Step 3 of the wizard: the Zoho region picker and the Connect Zoho button

Zoho then asks you to approve the connection, and lists exactly what it is granting: reading your settings, your contacts and your chart of accounts. Nothing on that list lets us change anything.

Zoho's approval screen, granting read-only access to settings, contacts and the chart of accounts

Approve, and the tab closes by itself. Back in the wizard, choose the organization to migrate if your login has more than one.

Step 5: Name the new instance and start

Give the new instance a name, which becomes its web address, and set the email and password you will sign in to Odoo with. The last step shows a summary; click Start the migration and you can leave the page. Until you click it nothing has been created in Odoo and nothing has been copied out of Zoho.

How long it takes

A few minutes in all. Creating the Odoo instance takes a couple of minutes, and copying the data usually takes a few more. Customers and vendors are the slow part, because Zoho is asked about each one in turn, so a few hundred contacts take several minutes on their own. The progress page tells you what is happening: one line per kind of data, with how many records were created. You can close the page and come back to it; the migration keeps running.

The finished migration, with every section ticked and its record counts

The verification checks are the part to read

When the data is in, we count it again, on both sides. The verification table compares your Zoho organization with the new Odoo: how many ledger accounts, tax rates, customers, vendors and products there are, and where each went.

Verification: every check matching, with the comparison table

Every check matching means every one of those comparisons agreed. If one does not match, it is listed with both numbers so you can see exactly what differs rather than discovering it in three months.

One row is there to inform rather than to pass or fail: how many of your migrated contacts ended up with a billing address. Contacts that have no address in Zoho have none in Odoo either, so that number is usually lower than your contact count, and that is correct.

A few differences are normal. Zoho's accounts are created alongside the ones a new Odoo starts with, so your chart of accounts will be a little longer than it was, and the same is true of tax rates.

If something goes wrong

A migration that fails can be retried from where it stopped: the sections that already finished are kept. It tells you why it failed in plain words. If you would rather start over, Cancel and remove deletes the half-finished instance and everything in it.

In every one of those cases your Zoho organization is untouched, because we only ever read from it. Your Zoho connection is kept encrypted while the migration runs and is erased when it finishes, and our access to your Zoho account ends with it. You can also withdraw it yourself in Zoho at any time.

If you are stuck, or a check does not match and you cannot see why, contact us with the name of the instance and we will look at the run with you.

What this does not cover yet

  • Transactions. Invoices, bills, payments, orders and journal entries are not migrated, as above. This is the big one.
  • One organization per migration. If you run several in Zoho, each needs its own run and its own Odoo instance.
  • The migration creates a new Odoo 20 instance. It does not merge your Zoho data into an Odoo you already use.
  • It copies your records, not your customisations: custom fields, templates and workflows you built in Zoho do not come across.

Rather not run the server yourself?

Get managed Odoo hosting with backups, SSL, monitoring and updates handled for you. Free for 10 days.