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:
| Tile | Meaning |
|---|---|
| Success, Failed, Skipped, Dry run | Log rows of each status in the last 24 hours |
| Orders needing attention | Orders whose most recent sync failed and that have not synced successfully since |
Statuses
| Status | Meaning | What to do |
|---|---|---|
| Success | The record was created or updated in Zoho | Nothing |
| Failed | Zoho or Shopify refused the sync, after the automatic retries | Read the message, fix the cause, retry |
| Skipped | The record was left out on purpose: a filter, a guest-order rule, a partly matched product | Nothing, unless the reason surprises you |
| Dry run | A dry-run backfill worked out what it would do | Read the plan. Nothing was changed |
Find a log
| Filter | Options |
|---|---|
| Type | Order, Product, Customer, Inventory |
| Status | Success, Failed, Skipped, Dry run |
| From / To | A date range |
| Search | Part 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.
Related
- 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.