Zync Docs
Monitoring & Reconciliation

Logs

See every sync result, find failures, retry orders and export logs as CSV.

Every sync writes its result to Logs: what was synced, in which direction, whether it worked, and Zoho's message when it did not. Open Logs in the app menu.

The numbers at the top

Four tiles count the last 24 hours by status. The fifth is the one to watch:

TileMeaning
Success, Failed, Skipped, Dry runLog rows of each status in the last 24 hours
Orders needing attentionOrders whose most recent sync failed and that have not synced successfully since

Statuses

StatusMeaningWhat to do
SuccessThe record was created or updated in ZohoNothing
FailedZoho or Shopify refused the sync, after the automatic retriesRead the message, fix the cause, retry
SkippedThe record was left out on purpose: a filter, a guest-order rule, a partly matched productNothing, unless the reason surprises you
Dry runA dry-run backfill worked out what it would doRead the plan. Nothing was changed

Find a log

FilterOptions
TypeOrder, Product, Customer, Inventory
StatusSuccess, Failed, Skipped, Dry run
From / ToA date range
SearchPart of the message, a Shopify order ID or a Zoho ID

The count under the filters shows how many logs match. Clear filters resets them. The list shows 50 rows per page.

Retry failed orders

When orders need attention, a banner appears with Retry all failed orders. It queues up to 500 of them at once.

To retry one order, click Retry on its failed row.

Retrying is safe. An order that is already in Zoho is updated, not created again.

Fix the cause first

A retry repeats the same sync. If the message is "tax not found" or "invalid account", correct the setting or the Zoho record first, then retry.

Export CSV

Export CSV downloads the logs that match your current filters, newest first, up to 5,000 rows. The file has the date and time, type, status, direction, record ID, Zoho ID and message.

Use it to send a list of failures to your accountant, or to keep a record before deleting logs.

Delete logs

Delete logs removes the logs that match your current filters, or all of the store's logs when no filter is set. You are asked to confirm.

  • Failed logs are kept, unless you filter to Status: Failed and delete those on purpose.
  • Deleting logs changes nothing in Zoho or Shopify.
  • It cannot be undone.

Reading a failure

A failed row's message is Zoho's own explanation where there is one. Common ones are explained in Troubleshooting.

One failed row is written per order, not one per attempt, so the count of failed rows is the count of orders to look at.

  • Reconcile compares Shopify with Zoho for a date range. It finds orders that never synced at all, which have no log.
  • Zoho API limits explains the "syncing is paused" banner.