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.
| Action | What it does |
|---|---|
| Sync (on a row) | Queues that order |
| Sync Selected | Queues the orders you ticked |
| Sync All Orders | Queues 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:
- Contact. Finds or creates the Zoho contact. See Customers on orders.
- Items and taxes. Matches each line to a Zoho item and tax. See Items and Tax mapping.
- Documents. Creates the sales order, the invoice, or both. See Documents.
- Payments. Records each successful payment. See Payments.
- Credit notes. One per refund. See Refunds.
- Tracking. Ship date and tracking on the sales order.
- 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 to | Use |
|---|---|
| Sync a handful of recent orders | Tick them and click Sync Selected |
| Sync a date range, or a list of order numbers | Backfill |
| Preview what would be created, without creating it | A dry-run backfill |
| Find orders that never reached Zoho | Reconcile |
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.