When the Odoo connection fails
The three diagnostic tools, and the most common causes of failure.
Check Connection
Tries to reach Odoo with your current details and reports back immediately. Always start here.
Init Odoo
Re-runs the initialization step on its own. Use it when the connection works but initialization failed during automatic setup.
Reload
Re-fetches the lists from Odoo — taxes, journals, warehouses. Use it after adding something new in Odoo that is not showing up in the dropdowns here.
The most common causes
Wrong URL — make sure there is no path on the end.
Wrong database name — the single most frequent cause.
Changed password — changing the Odoo user's password stops the connector at once.
Insufficient rights — the connection succeeds and operations fail.
Odoo is down — open Odoo in a browser to confirm.
Watch out for Odoo password changes
If someone changes the password of the user the connector signs in as, everything stops with no warning from Zid. This is a good reason to use a dedicated connector user.
Still failing?
Contact technical support with the WhatsApp button at the bottom of the screen, and quote the exact error message you saw.