Connecter Odoo : recevoir commandes et clients, consulter le stock
Créez une API Key dans Odoo sous My Profile → Account Security, saisissez l’URL de l’instance, la base de données, le nom d’utilisateur et l’API Key dans Integration, testez, mappez, activez.
Le connecteur Odoo importe les commandes de vente et les clients de votre ERP Odoo dans ce système et peut consulter les quantités de stock détenues dans Odoo. Il lit les données d’Odoo : il ne renvoie pas les changements de stock vers Odoo, n’importe pas les factures et n’envoie pas le fulfillment vers Odoo. Une connexion par instance et base de données Odoo.
Prérequis#
- Une instance Odoo à laquelle vous pouvez vous connecter, et le login d’un utilisateur Odoo pour l’intégration.
- Pour Odoo Online : l’accès à l’API externe nécessite le forfait Custom. Avec tout autre forfait Odoo Online, aucune valeur ne permettra la connexion : vérifiez le forfait avant de commencer.
- Vous connaissez l’adresse de votre instance (par ex. https://mycompany.odoo.com ; auto-hébergé : l’adresse de votre serveur) et le nom de la base de données — dans le sélecteur de base de données de la page de connexion Odoo, et pour Odoo Online généralement le sous-domaine.
- Droit dans Odoo d’ouvrir My Profile et de créer une API Key sous l’onglet Account Security.
Obtenir les identifiants#
- Connectez-vous à Odoo avec l’utilisateur de l’intégration, cliquez sur l’avatar en haut à droite et ouvrez My Profile.
- Ouvrez l’onglet Account Security et cliquez sur New API Key.
- Copiez l’API Key créée par Odoo. Dans cette connexion, l’API Key est utilisée à la place du mot de passe lors de la connexion : il n’y a donc pas de mot de passe séparé à chercher, la clé elle-même tient lieu de mot de passe.
- Notez en même temps les trois autres valeurs : l’adresse de l’instance, le nom de la base de données indiqué dans le sélecteur de la page de connexion Odoo (pour Odoo Online, généralement le sous-domaine) et le login de ce même utilisateur.
Remplir dans Integration#
- Ouvrez Integration → Marketplace → Odoo → Nouvelle connexion.
- base_url, obligatoire, URL de l’instance Odoo : l’adresse de votre instance, par ex. https://mycompany.odoo.com. Pour une instance auto-hébergée, saisissez l’adresse de votre serveur. Elle doit commencer par http:// ou https://.
- database, obligatoire, nom de la base de données : le nom affiché dans le sélecteur de base de données de la page de connexion Odoo, par ex. mycompany. Pour Odoo Online, c’est généralement le sous-domaine de l’adresse de votre instance.
- username, obligatoire, nom d’utilisateur (login) : le login de l’utilisateur Odoo pour l’intégration, par ex. admin. Utilisez le login du même utilisateur que celui qui a créé l’API Key : la forme exacte du login dépend de votre instance.
- api_key, obligatoire, API key : collez l’API Key copiée depuis My Profile → Account Security → New API Key. C’est un champ de type mot de passe, utilisé à la place du mot de passe et conservé comme secret.
Tester la connexion#
Cliquez sur Tester la connexion. Le test exécute deux étapes réelles. D’abord, il demande sa version à l’instance, sans connexion, pour confirmer que l’adresse répond et lire la version du serveur. Ensuite, il se connecte réellement avec votre database, username et api_key — la clé tenant lieu de mot de passe — et seule une connexion réussie compte comme un succès. Autrement dit, une adresse correcte avec une clé incorrecte ne passe pas : l’adresse prouve que l’instance répond, la connexion prouve les identifiants. Si base_url manque ou ne commence pas par http:// ou https://, le test s’arrête avec MISSING_BASE_URL ; si database, username ou api_key manque, il s’arrête avec MISSING_CREDENTIALS, car les trois sont nécessaires pour la connexion réelle.
Mapping / choisir un modèle#
Choisissez le mapping standard Odoo. Il travaille avec les modèles standard d’Odoo : les commandes de vente viennent de sale.order, les clients de res.partner et les consultations de stock lisent product.product. Après un test réussi, lancez une extraction et comparez une commande réelle côte à côte (numéro de commande, client, lignes et quantités), puis comparez la quantité d’un produit avec ce qu’affiche Odoo, avant d’activer. Si un champ de votre instance diffère du modèle standard, ajustez ce champ dans le mapping plutôt que de renommer quoi que ce soit dans Odoo.
Activer#
Après activation, la connexion importe les commandes de vente et les clients d’Odoo dans ce système selon la fréquence définie, et les consultations de stock lisent les quantités actuelles dans Odoo. Surveillez les premières extractions dans Runs / Logs et comparez-les avec Odoo avant de laisser la connexion sans surveillance.
Ce que cette connexion ne fait pas : elle ne renvoie pas les changements de stock vers Odoo, n’importe pas les factures d’Odoo et n’envoie pas le fulfillment ni les résultats d’expédition vers Odoo. Continuez à gérer cela dans Odoo même, ou dans les systèmes où le travail se fait réellement.
FAQ#
L’adresse s’ouvre bien, mais le test échoue avec AUTH_FAILED
L’instance répond — l’étape de version a répondu — mais la connexion réelle a été refusée. Cela signifie que database, username ou api_key ne correspond pas : les trois valeurs doivent aller ensemble, et la clé doit être celle du même utilisateur que le username. Une adresse correcte seule ne fait jamais réussir ce test.
Créez une nouvelle API Key pour l’utilisateur de l’intégration (avatar en haut à droite → My Profile → onglet Account Security → New API Key), copiez-la exactement dans le champ api_key, revérifiez database dans le sélecteur de la page de connexion Odoo et username comme le login de cet utilisateur, puis retestez.
Le test s’arrête avec MISSING_CREDENTIALS ou MISSING_BASE_URL
L’un des quatre champs est vide, ou l’adresse n’est pas utilisable. MISSING_BASE_URL signifie que base_url manque ou ne commence pas par http:// ou https://. MISSING_CREDENTIALS signifie que database, username ou api_key manque — et le test ne peut pas se connecter réellement sans les trois.
Remplissez les quatre champs selon l’étape de saisie dans Integration : base_url avec l’adresse complète de l’instance, http:// ou https:// inclus, database et username complets, et api_key collée en entier, sans rien tronquer. Enregistrez, puis retestez.
Toutes les valeurs semblent correctes, mais Odoo Online ne se connecte toujours pas
Votre forfait Odoo Online n’inclut pas l’accès à l’API externe. Seul le forfait Custom ouvre l’API externe sur Odoo Online : avec un autre forfait, l’instance répond dans le navigateur, mais les appels API externes ne sont pas disponibles — les valeurs ne sont pas le problème.
Vérifiez d’abord le forfait de l’instance Odoo Online. Passez l’instance au forfait Custom, puis retestez la même connexion avec les mêmes quatre valeurs — entre-temps, ne changez pas les valeurs à répétition.
Connecté, mais aucune commande de vente n’est importée
La connexion fonctionne — le test s’est réellement connecté — mais il n’y a rien de nouveau à importer : la base de données Odoo n’a pas de nouvelles commandes de vente dans la plage d’extraction, ou les commandes présentes ne sont pas des commandes de vente sur sale.order.
Créez ou confirmez une commande de vente dans Odoo, vérifiez qu’elle appartient à la même base de données que celle de la connexion, lancez une extraction manuelle et confirmez que la commande apparaît dans l’aperçu ou dans Runs / Logs.