Introduction
What Zync syncs between Shopify and Zoho, in which direction, and how records stay linked.
Zync is a Shopify app by Techspawn Solutions. It connects one Shopify store to one Zoho organisation, using either Zoho Books or Zoho Inventory, in any of Zoho's five data centres (India, United States, Europe, Australia and Japan). There is nothing to install on the Zoho side: you create an API client in the Zoho API Console and authorise it with OAuth.
What syncs
| Data | Direction | What it becomes in Zoho |
|---|---|---|
| Products and variants | Shopify to Zoho | An item, or an item group with one item per variant |
| Inventory levels | Shopify to Zoho, or Zoho to Shopify | Stock per mapped warehouse |
| Customers | Shopify to Zoho | A contact, matched by email first |
| Orders | Shopify to Zoho | A sales order, an invoice, or both |
| Payments | Shopify to Zoho | A customer payment against the invoice |
| Refunds | Shopify to Zoho | A credit note applied to the invoice |
| Cancellations | Shopify to Zoho | The Zoho documents are voided |
| Fulfilments | Shopify to Zoho | Ship date and tracking on the sales order |
Each row is switched on separately. A store that only wants orders in Zoho Books can leave product and inventory sync off.
Orders always flow from Shopify to Zoho
Zync never creates or edits Shopify orders from Zoho. For inventory you choose one source of truth, Shopify or Zoho, and stock flows from it to the other system.
How a sync runs
- Something happens in Shopify: an order is placed, a product is edited, stock changes. Shopify tells Zync through a webhook. You can also start a sync yourself from the app or from the Shopify admin.
- Zync puts a job on a queue. Jobs for one store run in order, a few at a time, so a busy day cannot flood Zoho.
- A worker picks the job up, reads the current record from Shopify and brings Zoho in line with it.
- The Zoho ID is saved on the Shopify record as a metafield, and the result is written to Logs.
If Zoho is briefly unavailable the job is tried again, up to three times with a growing delay. If Zoho says your API limit is reached, syncing pauses and resumes on its own. See Zoho API limits.
How records stay linked
Zync stores the Zoho ID on the Shopify record itself, in the custom metafield namespace:
| Shopify record | Metafield | Holds |
|---|---|---|
| Product and variant | custom.zoho_item_id | The Zoho item (or item group) ID |
| Customer | custom.zoho_contact_id | The Zoho contact ID |
| Order | custom.zoho_order_id | The Zoho sales order or invoice ID |
| Order | custom.zoho_sync_state | Which invoice, payments, credit notes and shipments are already in Zoho |
Because of these links, syncing the same record again updates the existing Zoho record instead of creating a second one. The details are in Data and metafields.
The app's pages
| Page | What you do there |
|---|---|
| Home | See your plan and reach support |
| Connection | Connect Zoho and map locations to warehouses |
| Products | Product settings, inventory sync, and the product list |
| AI Match | Link Shopify variants to existing Zoho items |
| Orders | Order settings, documents and accounting, backfill, and the order list |
| Customers | Customer auto sync and the customer list |
| Logs | Every sync result, with retry and CSV export |
| Reconcile | Compare Shopify orders with Zoho documents for a date range |
Next step
Follow the installation guide. Most stores are connected and syncing within an afternoon.