All guides
Troubleshooting5 min read
WooCommerce orders not syncing to Zoho Books? How to fix it
Most sync problems come down to a short list of causes. Work through these checks in order — the sync log usually tells you which one applies.
Troubleshooting checklist
- Open the configuration's Logs tab (Orders → Logs). Every attempt is recorded with its result; an error message there is the fastest route to the cause.
- Confirm the Zoho account is still connected on WoZoBridge → Integrations. If the connection shows an error, disconnect and reconnect, or refresh the token.
- Check the region. The region chosen at authorization must match your Zoho data center (com, eu, in, au, jp, ca).
- Check the organization. Books and Inventory configurations must point at the right Zoho organization.
- Check the trigger. If the configuration fires on Completed, an order sitting in Processing will not sync until its status changes.
- Check field mapping. A required Zoho field left unmapped, or a value Zoho rejects, will fail that record.
- Confirm WooCommerce and WoZoBridge are both active and that WordPress scheduled tasks (WP-Cron) are running on your host.
Retrying failed orders
After fixing the cause, run a manual sync for the affected order or a batch sync for a range. The failed-order viewer and logs show whether the retry succeeded.
Still stuck?
Send us the log message through the contact page and we will help you trace it.
Frequently asked questions
- Why is the order in Zoho CRM but not in Zoho Books?
- Each configuration targets one Zoho app. Create a separate Order configuration for Books if you only set one up for CRM.
- Where do I see why a sync failed?
- In the Logs tab of the Products, Customers or Orders area for the configuration you used.