Zync Docs
Orders & Accounting

Order sync

See which orders are in Zoho, and sync or resync orders by hand.

Open Orders → Order Sync to see your Shopify orders with their Zoho link, and to sync orders yourself.

The order list

Each row shows the order, its date, customer, total, Zoho ID and status. Use All, Synced and Not Synced to filter the list.

ActionWhat it does
Sync (on a row)Queues that order
Sync SelectedQueues the orders you ticked
Sync All OrdersQueues your orders that are not in Zoho yet
Resync order to Zoho (icon on a synced row)Brings the Zoho documents up to date with the order as it is now

A sync is queued, not instant. The status changes to Synced a few moments later. Every result is written to Logs.

Manual syncs follow your settings

A manual sync uses the same filters and document settings as an automatic one. An order that your filters hold back shows in Logs as Skipped, with the reason.

What happens when an order syncs

Zync reads the order from Shopify as it is now and does whatever is still missing in Zoho, in this order:

  1. Contact. Finds or creates the Zoho contact. See Customers on orders.
  2. Items and taxes. Matches each line to a Zoho item and tax. See Items and Tax mapping.
  3. Documents. Creates the sales order, the invoice, or both. See Documents.
  4. Payments. Records each successful payment. See Payments.
  5. Credit notes. One per refund. See Refunds.
  6. Tracking. Ship date and tracking on the sales order.
  7. Void. If the order was cancelled and voiding is on.

After each step, Zync saves what it did on the Shopify order. The next sync of the same order starts where the last one stopped.

Safe to run again

You can sync the same order as often as you like:

  • An order already in Zoho is updated, never created a second time.
  • Before creating a document, Zync searches Zoho for one whose reference number is the Shopify order name. If it finds one, it links to it.
  • Payments and credit notes carry a reference to their Shopify transaction or refund, and are looked up the same way.
  • Two events for the same order (Shopify often sends "created" and "paid" within a second) are processed one after the other, not at the same time.

When a sync fails

A failed job is tried again automatically, up to three times, with a longer wait each time. If it still fails, one row is written to Logs with Zoho's error message.

Fix the cause, then click Retry on that row in Logs, or Retry all failed orders.

Syncing many orders

You want toUse
Sync a handful of recent ordersTick them and click Sync Selected
Sync a date range, or a list of order numbersBackfill
Preview what would be created, without creating itA dry-run backfill
Find orders that never reached ZohoReconcile

Syncing from the Shopify admin

Sync to Zoho is also available on an order's page in the Shopify admin, and for selected orders in the order list. See Admin actions.