Zync Docs
Getting Started

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

DataDirectionWhat it becomes in Zoho
Products and variantsShopify to ZohoAn item, or an item group with one item per variant
Inventory levelsShopify to Zoho, or Zoho to ShopifyStock per mapped warehouse
CustomersShopify to ZohoA contact, matched by email first
OrdersShopify to ZohoA sales order, an invoice, or both
PaymentsShopify to ZohoA customer payment against the invoice
RefundsShopify to ZohoA credit note applied to the invoice
CancellationsShopify to ZohoThe Zoho documents are voided
FulfilmentsShopify to ZohoShip 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

  1. 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.
  2. 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.
  3. A worker picks the job up, reads the current record from Shopify and brings Zoho in line with it.
  4. 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 recordMetafieldHolds
Product and variantcustom.zoho_item_idThe Zoho item (or item group) ID
Customercustom.zoho_contact_idThe Zoho contact ID
Ordercustom.zoho_order_idThe Zoho sales order or invoice ID
Ordercustom.zoho_sync_stateWhich 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

PageWhat you do there
HomeSee your plan and reach support
ConnectionConnect Zoho and map locations to warehouses
ProductsProduct settings, inventory sync, and the product list
AI MatchLink Shopify variants to existing Zoho items
OrdersOrder settings, documents and accounting, backfill, and the order list
CustomersCustomer auto sync and the customer list
LogsEvery sync result, with retry and CSV export
ReconcileCompare Shopify orders with Zoho documents for a date range

Next step

Follow the installation guide. Most stores are connected and syncing within an afternoon.