Zync Docs
Orders & Accounting

Backfill

Send past Shopify orders through the sync by date range or order number, with a dry run to preview the result.

A backfill sends past Shopify orders through the same sync as live orders, with your current settings. Use it to:

  • Bring in orders from before you installed Zync.
  • Catch up after auto sync was off for a while.
  • Apply a settings change to orders that already synced, for example to raise missing invoices or record payments.

Open Orders → Backfill.

Run a backfill

Choose what to backfill

ModeUse it for
By date rangeEvery order placed between a start and an end date
By order numbersSpecific orders, for example #1001, #1002

Set the range or the numbers

By date range: pick the Start date and End date, or click Week to date, Month to date or Last 30 days. Dates are in UTC.

By order numbers: type or paste the numbers, separated by commas or new lines. A bare number such as 1001 is read as #1001. Up to 500 numbers per run.

Choose the options

OptionDefaultMeaning
Only orders that are not in Zoho yetTickedSkips orders that already have a Zoho document. Untick it to also bring those up to date
Dry runUntickedPreviews the result without creating anything. See below

Start

Click Start backfill (or Start dry run). The backfill is queued and runs in the background. Follow it in Logs.

Dry run

A dry run works out what would happen for each order and writes it to Logs with the status Dry run. Nothing is created or changed in Zoho or Shopify.

A dry-run row looks like this:

Dry run for #1001: Create sales order; Create invoice from sales order; Record payment of 1180 (shopify_payments)

Run one before your first real backfill, and after changing document, tax or payment settings. Filter Logs to Status: Dry run to read the results.

What a backfill does for each order

Exactly what a live sync does, in the same order: documents, then the invoice, payments, credit notes and tracking each order is due. See Order sync.

Your filters still apply. An order that the payment, fulfilment or source filter holds back is skipped, and the reason is logged.

One setting is ignored: Only sync orders placed on or after. You chose the dates yourself, so the backfill uses them.

Safe to run again

A backfill never creates an order twice. An order already in Zoho is brought up to date, and anything already done is left alone. If a run is interrupted, start it again with the same range.

Limits

LimitValue
Orders in one date-range run5,000. If the range holds more, Logs says so. Run the rest as a second range
Order numbers in one run500
How far backShopify only returns orders from the last 60 days, unless the app has been granted access to all orders

A large backfill uses many Zoho API calls. If your Zoho daily limit is reached, the backfill pauses and continues on its own. See Zoho API limits.

The summary row

When a backfill has queued its orders, it writes one summary row to Logs, for example:

Backfill 2026-10-01 to 2026-10-31: 412 order(s) queued, 38 already in Zoho

Each order then gets its own row as it syncs.

Examples

GoalSettings
Import last month's orders for the first timeDate range, Only orders that are not in Zoho yet ticked
Preview before importingThe same, with Dry run ticked
You switched to Sales order and invoice together and want invoices for last month's ordersDate range, Only orders that are not in Zoho yet unticked
Fix three orders finance asked aboutOrder numbers #1042, #1057, #1063, Only orders that are not in Zoho yet unticked