Synco Documentation
Connections

Connection Troubleshooting

Resolve common WooCommerce authorization, callback, Odoo authentication, and location-mapping problems.

WooCommerce problems

Message or symptomWhat to check
Missing store_urlEnter a store address in the Connection form before submitting.
Invalid WooCommerce storeConfirm the URL is correct, WooCommerce is active, and the REST API is reachable from the internet.
Authorization deniedStart the connection again and approve Read/Write access on the WordPress authorization page.
Missing credentialsRepeat authorization; the callback did not receive both generated credentials.
Invalid state parameterRestart from Synco instead of reusing an old callback URL.
Credentials failed validationReconnect the store and confirm the approving WordPress user can manage WooCommerce.
Connected but no automatic eventsReconnect to let Synco register webhooks again, then review sync status.

The callback must be reachable over public HTTPS. Local development stores need a secure tunnel, but production stores should use their normal HTTPS domain.

Odoo problems

Message or symptomWhat to check
All fields are requiredSupply the store, server, database, user, and password/API key.
Odoo authentication failedCheck the exact database, login, and password/API key. Confirm the user is active.
Could not reach OdooVerify the server URL, TLS certificate, firewall, reverse proxy, and Odoo availability.
No databases listedWait for discovery, check server reachability, or enter the exact database name manually.
Company/location drawer is unavailableSave and verify the Odoo connection first.
Location creation failsConfirm the Odoo user can create stock locations in the selected company.

Store selection and authorization

Synco rejects configuration changes for stores the signed-in user does not own. If a page opens the wrong store, use the store selector and repeat the action with the intended site.

Safe recovery sequence

  1. Stop automatic sync for the affected resource.
  2. Verify WooCommerce and Odoo connections.
  3. Confirm company, location, direction, and mapping settings.
  4. Run one manual item.
  5. Inspect its job details.
  6. Re-enable automation only after the manual result is correct.