Elbuz échange avec Odoo directement via l’API Odoo, sans fichiers : catalogue, stock des entrepôts et commandes arrivent dans Elbuz ; prix, nouveaux produits et liens fournisseurs des listes de prix repartent vers Odoo.
Quand c’est utile :
- Stock et comptabilité dans Odoo — produits avec variantes, photos, attributs et stock par entrepôt arrivent dans Elbuz.
- Prix calculés sur les listes fournisseurs — Elbuz n’envoie à Odoo que les prix modifiés.
- Achats dans Odoo — l’onglet “Achats” du produit affiche les fournisseurs, leurs références, prix et délais.
- Commandes Odoo dans la file commune — chacune devient une “Commande client”.
Pour commencer : créez une clé API dans Odoo.
Ce que fait la connexion Odoo
- Importe les produits dans le catalogue — nom, référence, code-barres, prix, poids, descriptions, catégorie ; chaque variante devient une fiche à part.
- Regroupe les variantes en famille et transforme couleurs, tailles et autres axes de variante en attributs-options.
- Récupère les photos avec la galerie du site Odoo, même si les images d’Odoo exigent une connexion.
- Reflète les entrepôts — le stock de chaque produit dans chaque entrepôt Odoo.
- Reçoit les commandes de vente et ajoute les fournisseurs Odoo aux contacts.
- Exporte vers Odoo les prix, les nouveaux produits avec photo et catégorie, au besoin les descriptions, le SEO et les données principales, et les liens fournisseurs.
Ce qui circule dans chaque sens :
- Запит або дія
- Примітка
Ce qu’il faut côté Odoo : adresse et clé API
Elbuz se connecte à Odoo au nom d’un utilisateur Odoo, avec sa clé API. Il faut trois valeurs :
- Adresse Odoo — comme dans le navigateur, par exemple
https://company.odoo.com. Si le serveur héberge plusieurs bases, ajoutez le nom de la base à l’adresse :https://erp.company.com/?db=main. Sur Odoo Online, la base se déduit de l’adresse. - Clé API — créée dans Odoo, à coller dans le champ “Clé API Odoo”.
- Identifiant utilisateur — uniquement pour Odoo 18 et antérieur. Odoo 19 et suivants fonctionnent avec la seule clé : laissez le champ vide.
Inutile d’indiquer la version d’Odoo : Elbuz détecte si le serveur gère le nouveau protocole d’Odoo 19+ et bascule sur l’ancien pour Odoo 14–18.
Où obtenir la clé API : pas à pas
| Où | Que faire |
|---|---|
| Odoo | Avatar en haut à droite → Mes préférences → onglet Sécurité → bloc “Clés API” → Create API Key. Dans Odoo 20, ce bouton peut rester en anglais |
| Au même endroit | Confirmer le mot de passe, saisir une description (par exemple « Elbuz ») et une durée de validité |
| Au même endroit | Copier la clé — Odoo ne l’affiche qu’une fois |
| Elbuz | Modèle “Odoo” → carte “Connexion” → adresse, clé (et identifiant pour Odoo 18 et antérieur) → “Enregistrer” → “Vérifier la connexion” |
1
Onglet « Sécurité »2
Bouton « Create API Key »- Onglet « Sécurité » de la fenêtre « Changer mes préférences » (avatar → « Mes préférences »).
- Create API Key crée une clé ; Odoo ne l’affiche qu’une fois. Au-dessus — une clé existante « elbuz » avec la portée RPC et sa date d’expiration.
Dans Odoo 20, une clé vit au plus trois mois. Une fois expirée, import et export s’arrêtent avec l’erreur “Invalid apikey”. Programmez un rappel : créez une nouvelle clé et saisissez-la dans les deux modèles avant l’échéance.
Créez dans Odoo un utilisateur à part, par exemple « Elbuz », avec des droits sur les ventes, l’inventaire et les achats. Vous voyez ainsi ce qu’a modifié l’intégration, et l’accès se retire facilement sans toucher aux comptes des personnes.
Sur Odoo Online (cloud), l’API externe n’est disponible qu’avec la formule Custom. Avec One App Free et Standard, Odoo refuse les requêtes. Odoo sur votre propre serveur ou sur Odoo.sh n’a pas cette limite.
Odoo doit être accessible depuis Internet. Elbuz fonctionne dans le cloud et n’accède pas aux réseaux internes : un serveur Odoo visible uniquement sur le réseau du bureau ne se connectera pas.
Comment connecter
- Créez un modèle de type “Odoo” et, dans la carte “Connexion”, saisissez l’adresse, la clé API et, pour Odoo 18 et antérieur, l’identifiant.
- Enregistrez le modèle et cliquez sur “Vérifier la connexion” — l’adresse et la clé enregistrées sont testées. Si Odoo répond avec le nom de votre société, la clé est acceptée.
- Dans la carte “Données à importer”, ne cochez que le nécessaire (ce qu’active chaque case), enregistrez et lancez.
Ce qu’il faut importer depuis Odoo : les cases du modèle
C’est vous qui choisissez quoi récupérer : le modèle Odoo n’affiche que les cases que la connexion prend réellement en charge. Une case décochée — l’exécution saute cette partie.
| Case | Ce qui arrive |
|---|---|
| Produits | fiches des produits et des variantes (champs) |
| Catégories | catégorie du produit : celle du site Odoo, sinon la catégorie interne d’Odoo ; fonctionne avec “Produits” |
| Attributs | axes de variante en attributs-options, plus les autres attributs ; avec “Produits” (variantes) |
| Photos | photo principale et galerie du site Odoo ; avec “Produits” (photos) |
| Entrepôts | entrepôts Odoo et stock du produit dans chacun ; sans “Produits”, met à jour le stock des fiches déjà importées (entrepôts) |
| Commandes | commandes de vente en documents “Commande client” (commandes) |
| Importer les fournisseurs Odoo comme contacts | fournisseurs dans le groupe “Fournisseur” (fournisseurs) |
1
Produits2
Entrepôts3
Fournisseurs Odoo en contacts- Produits — importe les fiches produits avec leurs variantes.
- Entrepôts — importe les entrepôts Odoo et le stock par entrepôt.
- Fournisseurs — crée les fournisseurs Odoo comme contacts du groupe « Fournisseur ».
Ordre d’exécution : fournisseurs → produits → entrepôts → commandes. Les entrepôts passent après les produits, car le stock s’écrit dans des fiches existantes.
Vitesse et volumes
La connexion lit et écrit par lots : pages de 500 produits, photos en plusieurs requêtes parallèles, prix par paquets de 500 en une requête. Mesures du 11.11.2026, Odoo 20 sur le même ordinateur qu’Elbuz (sans latence réseau) :
| Opération | Volume | Durée |
|---|---|---|
| import du catalogue avec photos | 3 049 produits, 3 039 photos | 8 s |
| import complet dans le catalogue Elbuz | 3 054 produits et 24 commandes | 37 s ; nouvelle exécution — 23 s |
| export de tous les prix | 3 000 produits | 22 s |
| export quotidien des prix | 3 000 produits, dont 100 modifiés | 0,8 s |
Sur votre Odoo, la durée dépend de son serveur et de sa formule, mais le rapport reste le même : inutile d’exporter toute la liste de prix à chaque fois, Elbuz écarte lui-même les prix inchangés. Le bouton “Arrêter” du journal interrompt l’import du catalogue et des commandes après la page en cours.
Ce qui arrive dans la fiche
Chaque variante d’un produit Odoo devient une fiche Elbuz distincte. Un produit Odoo sans variantes donne une seule fiche.
| Données Odoo | Champ de la fiche Elbuz |
|---|---|
| nom (pour une variante — avec les attributs, par exemple « Table (Blanc, Acier) ») | Nom |
| référence interne (Internal Reference) | Référence |
| code-barres | Code-barres (chiffres uniquement) |
| prix de vente de la variante | Prix |
| quantité en stock (avec l’application Inventaire) | Stock ; une valeur négative devient zéro |
| poids | Poids |
| description de vente | Description courte |
| description pour le site Odoo, titre et description SEO | Description complète, méta-titre, méta-description |
| actif et case “Ventes” | Activité : désactivé si le produit ne peut pas être vendu |
Chaque fiche reçoit une clé immuable : l’ID du produit dans Odoo. Grâce à elle, Elbuz reconnaît le produit à chaque exécution, même si le nom ou la référence ont changé dans Odoo. Deux produits Odoo différents portant le même nom restent donc deux fiches et ne fusionnent pas.
Un produit créé dans Odoo par l’export depuis Elbuz est reconnu à l’import comme votre fiche existante : pas de seconde fiche.
Ce que fait une nouvelle exécution de vos modifications
L’exécution remet dans la fiche l’état actuel d’Odoo : nom, référence, code-barres, prix, stock, activité, descriptions. Un champ vide dans Odoo n’efface pas votre valeur. Les produits créés dans Odoo par l’export Elbuz sont ignorés : Elbuz gère leur prix et leur stock. Figer un prix : “Prix fixe” dans la fiche (vue d’ensemble de l’import).
Photos et attributs ne sont chargés qu’à la création de la fiche. Sur une fiche existante, l’exécution ne les met pas à jour : une photo changée dans Odoo ne change pas dans Elbuz.
Un produit supprimé ou archivé dans Odoo reste tel quel dans Elbuz : l’exécution ne récupère que les produits existants et ne désactive rien. Les fiches Odoo se retrouvent dans la fenêtre “Produits” via la colonne “Source : code” (odoo).
Variantes, attributs et photos
Les variantes d’un même produit Odoo sont regroupées en famille de produits : toutes ont le même “Nom de la famille (déclinaisons)”, le nom du produit Odoo. Sur le site, on passe de l’une à l’autre avec des boutons de couleur et de taille, chacune avec son prix, sa photo et son stock.
- Les axes de variante (couleur, taille, matière des pieds…) arrivent en attributs-options — ce sont eux qui font basculer les variantes.
- Les attributs Odoo sans variantes arrivent en attributs ordinaires ; plusieurs valeurs — séparées par un point-virgule.
- Deux produits Odoo différents avec variantes et le même nom reçoivent une famille suffixée de l’ID du modèle de produit Odoo, par exemple « T-shirt #101 », pour que leurs variantes ne se mélangent pas.
1
Color2
Legs- Color — l’option de couleur de la variante, avec sa valeur.
- Legs — l’option de pieds de la variante, avec sa valeur.
Sans la case “Attributs”, les variantes deviennent quand même des fiches distinctes d’une même famille, mais sans attributs-options. Le sélecteur n’apparaît alors pas sur le site tant que vous n’avez pas marqué les attributs de déclinaison à la main.
Photos des produits
Les images d’Odoo ne s’ouvrent qu’après connexion à Odoo : un lien vers elles ne servirait à rien dans Elbuz. La connexion récupère donc le fichier lui-même via l’API, le dépose dans votre stockage Elbuz et inscrit dans la fiche son propre lien.
- Photo principale — la photo de la variante, à défaut celle du produit.
- Galerie — photos supplémentaires du site Odoo (application eCommerce) : d’abord celles de la variante, puis celles du produit.
- Une photo, un fichier. Une photo commune à cinq variantes n’est chargée qu’une fois ; une nouvelle exécution sans changement ne télécharge rien.
Stock par entrepôt
La case “Entrepôts” crée dans Elbuz un miroir des entrepôts Odoo : chaque entrepôt Odoo devient un entrepôt Elbuz du même nom, avec le même stock que dans Odoo. Le système principal pour le stock, c’est Odoo.
- Un nouvel entrepôt Odoo apparaît de lui-même dans Elbuz à l’exécution suivante.
- Chaque variation de stock est inscrite au journal des mouvements de l’entrepôt comme synchronisation, sans document. Une nouvelle exécution sans changement dans Odoo n’écrit rien.
- Le stock total de la fiche est la somme de tous les entrepôts Odoo.
1
YourCompany2
Kyiv WH- YourCompany — entrepôt miroir d’un entrepôt Odoo.
- Kyiv WH — un autre entrepôt Odoo, importé avec son stock.
Sans l’application Inventaire, Odoo n’a ni entrepôts ni quantités : le journal d’exécution affiche une erreur pour les entrepôts, et les produits sont importés sans stock.
Mieux vaut ne pas gérer les mouvements par des documents Elbuz sur les entrepôts miroirs : l’exécution suivante rétablit le stock d’Odoo. Vos propres entrepôts Elbuz et leurs documents ne sont pas touchés par la connexion.
Commandes de vente et fournisseurs
Chaque commande de vente Odoo devient une “Commande client” avec le numéro Odoo (ex. S00042). Une nouvelle exécution ne crée pas de doublon : elle met à jour statut (sauf changé à la main), paiement et livraison, et complète contacts et adresse vides. Lignes et montant ne sont pas réécrits : modifiée dans Odoo, la commande garde son ancien contenu.
| Dans Odoo | Dans le document Elbuz |
|---|---|
| ligne de produit | ligne du document liée à la fiche ; prix — taxe et remise de la ligne comprises |
| ligne de livraison | montant de la livraison (pas une ligne de produit) |
| sections et notes de la commande | non reprises |
| client | nom, e-mail, téléphone |
| adresse de livraison | ville, pays, code postal, adresse ; sans adresse distincte — celle du client |
| note et référence client de la commande | commentaire du document |
| état et statut de facturation | statut de commande et de paiement — pour la correspondance des statuts |
Le montant du document égale le total Odoo, taxe comprise. La première exécution prend toutes les commandes de vente, devis (brouillons) et annulées compris — leur état figure dans le statut ; les suivantes, seulement celles modifiées depuis. Celles modifiées dans la dernière seconde de l’exécution précédente reviennent et sont simplement mises à jour.
Les fournisseurs Odoo dans les contacts
La case “Importer les fournisseurs Odoo comme contacts” ajoute les fournisseurs Odoo dans Elbuz, groupe “Fournisseur” : nom, e-mail, téléphones, site web, numéro fiscal, pays, ville, adresse, code postal et commentaire.
- Est fournisseur un partenaire Odoo marqué comme fournisseur (marque ajoutée par les applications Achats ou Comptabilité). Sans elle — ceux qui figurent dans les prix d’achat des produits.
- Les contacts rattachés à une société ne deviennent pas des fournisseurs distincts.
- Le contact est recherché par son nom. S’il existe déjà, l’exécution ne le modifie pas : vos changements dans la fiche du contact sont conservés.
Ce qu’il faut exporter vers Odoo
L’export est un modèle “Odoo” distinct dans la fenêtre “Export de données”, avec la même adresse et la même clé. Ce qui est envoyé dépend des cases de la carte “Données à exporter” :
| Case | Effet dans Odoo |
|---|---|
| Produits | met à jour le prix des produits liés — seulement ceux dont le prix a changé (prix des variantes) |
| Publier les nouveaux produits | crée les produits absents d’Odoo : nom, prix, référence, code-barres, poids, description courte |
| Catégories | attribue une catégorie au nouveau produit en la créant dans Odoo selon son chemin |
| Photos | envoie la photo principale du nouveau produit |
| Liens fournisseurs | remplit l’onglet “Achats” (en détail) ; cochée par défaut |
| Descriptions et SEO | pour les produits liés, envoie la description courte dans la description de vente et la description complète dans la description produit du site Odoo, ainsi que le titre SEO et la méta-description ; désactivé par défaut |
| Données principales (nom, référence, code-barres, poids) | met à jour ces champs des produits liés ; le nom seulement pour les produits sans variantes, car les variantes le partagent avec le modèle ; désactivé par défaut |
Un champ vide dans Elbuz n’efface pas la valeur dans Odoo, et seuls les champs modifiés sont envoyés. Sans l’application “Site Web”, Odoo n’a pas de place pour la description complète : seule la courte est alors envoyée.
1
Produits2
Publier les nouveaux produits3
Liens fournisseurs4
Descriptions et SEO- Produits — envoie vers Odoo les prix des produits déjà liés.
- Publier les nouveaux produits — crée dans Odoo les produits qui n’y existent pas encore, avec catégorie et photo.
- Liens fournisseurs — transmet les lignes fournisseur des listes de prix vers l’onglet « Achats » du produit Odoo.
- Descriptions et SEO — envoie les descriptions et les données SEO.
Est lié un produit importé de la même base Odoo ou déjà créé par cet export. Il n’est pas recréé ; un produit d’une autre base Odoo n’est pas lié. Pas de case « uniquement les modifications » pour Odoo : Elbuz compare lui-même les prix avec Odoo et n’envoie que ceux qui ont changé.
Prix des variantes
Odoo 20 a un prix par variante, Elbuz écrit chacun. Dans Odoo 18 et antérieur, le prix est commun au modèle de produit, la variante n’ajoute qu’un supplément d’attribut. Elbuz y écrit le prix de base si vos variantes sans supplément coûtent pareil ; sinon il saute ce modèle, et le journal indique combien sont concernés.
- Le stock n’est pas écrit dans Odoo. Odoo gère lui-même l’inventaire, et Elbuz y prend le stock.
- Photo et catégorie ne sont transmises qu’aux nouveaux produits ; celles des produits existants dans Odoo restent inchangées.
- Un code-barres en double dans l’un des nouveaux produits n’arrête pas les autres : Odoo refuse seulement ce produit, la raison figure dans le journal.
Les liens fournisseurs dans l’onglet “Achats”
Elbuz sait chez quels fournisseurs se trouve chaque produit du catalogue, grâce aux listes de prix liées. La case “Liens fournisseurs” reporte cela dans Odoo, dans l’onglet standard “Achats” de la fiche produit : autant de lignes par produit que de fournisseurs.
| Ligne “Achats” dans Odoo | Provenance |
|---|---|
| Fournisseur | fournisseur de la liste de prix ; absent d’Odoo — créé comme société fournisseur |
| Code et nom du produit chez le fournisseur | référence et nom du produit dans la liste de prix |
| Prix et devise | prix de la liste dans la devise du fournisseur si elle est active dans Odoo ; sinon dans votre devise de base si elle l’est ; sinon converti au taux Elbuz dans la devise de la société Odoo. Si aucune ne convient, la ligne n’est pas écrite, erreur au journal |
| Délai de livraison | nombre de jours du délai de livraison de la liste de prix |
1
Onglet « Achats »2
Lignes fournisseurs- Onglet « Achats » de la fiche produit Odoo.
- Fournisseurs des listes de prix Elbuz : prix dans leur devise ou converti, délai de livraison.
- Pas de changement, pas d’écriture. Une ligne déjà identique n’est pas réécrite ; celles modifiées sont mises à jour par paquets de 500.
- Un lien retiré dans Elbuz disparaît aussi dans Odoo — mais seulement chez vos fournisseurs, ceux qui ont une liste de prix dans Elbuz, et seulement pour les produits inclus dans cet export.
- Les lignes des fournisseurs saisis uniquement dans Odoo ne sont pas touchées. Vos acheteurs peuvent y gérer leurs propres fournisseurs à côté.
Le nom du contact dans Elbuz et celui du partenaire dans Odoo doivent être identiques. Sinon, Odoo aura une seconde société au nom venant d’Elbuz, et les liens y seront rattachés.
Scénarios
Stock et comptabilité dans Odoo, ventes et listes de prix dans Elbuz
Import planifié : “Produits”, “Attributs”, “Entrepôts”. Export : “Produits” (prix) et “Liens fournisseurs”. Le stock vient d’Odoo, les prix partent vers Odoo depuis les listes de prix.
Les acheteurs travaillent dans Odoo
Export avec la seule case “Liens fournisseurs”. L’onglet “Achats” de chaque produit montre les fournisseurs à jour, leurs prix et délais.
Migration d’Odoo vers Elbuz
Un seul import avec toutes les cases, fournisseurs et commandes compris. Photos, familles de variantes, catégories et historique des ventes suivent les produits.
Les commandes Odoo dans la file commune
Un modèle d’import distinct avec la seule case “Commandes”, planifié : les commandes Odoo côtoient celles du site et des marketplaces.
Les nouveautés des listes de prix directement dans Odoo
Export avec “Publier les nouveaux produits”, “Catégories” et “Photos” : un produit apparu dans le catalogue Elbuz est créé dans Odoo avec sa photo et sa place dans l’arborescence des catégories.
Que faire si Odoo ne se connecte pas
| Ce qui s’affiche | Cause | Que faire |
|---|---|---|
| “Invalid apikey” | clé expirée, révoquée ou copiée incomplètement | créez une nouvelle clé dans Odoo (comment) et saisissez-la dans les deux modèles |
| “Odoo < 19: login is required” | Odoo 18 ou antérieur fonctionne avec identifiant et clé | remplissez le champ “Identifiant utilisateur” |
| “login or API key rejected” | identifiant d’un autre utilisateur que le propriétaire de la clé, ou mauvaise base | vérifiez l’identifiant ; indiquez la base dans l’adresse avec ?db= |
| “blocked: private or reserved address” | Odoo est sur le réseau local, pas sur Internet | rendez Odoo accessible depuis Internet par un nom de domaine |
| “Odoo : erreur API — stock.warehouse” | l’application Inventaire n’est pas installée dans Odoo | installez-la ou décochez “Entrepôts” |
| “Odoo : erreur d’export product.supplierinfo” | l’utilisateur Odoo propriétaire de la clé n’a pas de droits sur les prix d’achat | donnez-lui des droits sur les achats ou décochez “Liens fournisseurs” ; l’onglet “Achats” de la fiche est visible avec l’application Achats |
| produits sans photos | la case “Photos” a été cochée après la première exécution | les photos n’arrivent que sur les nouvelles fiches ; pour les existantes, ajoutez les photos dans Elbuz ou supprimez les fiches et relancez |
Questions fréquentes
Peut-on exporter les commandes d’Elbuz vers Odoo ?
Non. Les commandes vont uniquement d’Odoo vers Elbuz (commandes de vente).
Elbuz met-il à jour le stock dans Odoo ?
Non. Le système principal pour le stock est Odoo, Elbuz se contente de refléter son stock (stock par entrepôt).
Quelles versions d’Odoo sont prises en charge ?
Odoo 14–20 : Community, Enterprise, Odoo.sh et Odoo Online avec la formule Custom ; testé sur Odoo 18 et 20. Odoo 18 et antérieur demandent aussi l’identifiant (ce qu’il faut).
J’ai supprimé un produit dans Odoo — pourquoi est-il resté dans Elbuz ?
L’exécution ne récupère que les produits existants et ne désactive rien. Désactivez ou supprimez la fiche superflue dans la fenêtre “Produits” (nouvelle exécution).
Peut-on connecter plusieurs bases Odoo ?
Oui, un modèle par base. Les fiches de bases différentes ne se mélangent pas : la clé du produit contient l’identifiant de la base.
Les attributs du produit sont-ils envoyés à Odoo ?
Non. L’export envoie le prix et, pour les nouveaux produits, le nom, la référence, le code-barres, le poids, la description, la catégorie et la photo (ce qu’il faut exporter).
Un produit dans plusieurs catégories du site Odoo — où atterrit-il ?
Dans la plus profonde. Les autres catégories du site ne sont pas reprises (les cases).
Où la trouver et qui y a accès
- Menu
- Données de référence → Opérations → Import de données (depuis Odoo) et Export de données (vers Odoo)
- Modèle
- nouveau modèle → type “Odoo” ; un modèle = une base Odoo
- Droit d’accès
- fenêtres “Import de données” et “Export de données” dans “Autorisations des groupes”
- À préparer
- l’adresse Odoo, une clé API ; pour Odoo 18 et antérieur, aussi l’identifiant
1
Adresse Odoo2
Identifiant utilisateur3
Clé API Odoo4
Vérifier la connexion- Adresse Odoo — l’adresse de votre Odoo ; pour une base précise, ajoutez ?db=nom.
- Identifiant utilisateur — nécessaire uniquement pour Odoo 18 et antérieur.
- Clé API Odoo — la clé créée dans les préférences de l’utilisateur Odoo.
- Vérifier la connexion — teste l’accès avant le premier import.
Fonctionnement général des modèles d’import : vue d’ensemble de l’import de données.
Sujets connexes
- Pour comprendre comment un modèle d’import traite n’importe quelle source — Import de données dans le catalogue.
- Pour que les variantes Odoo se sélectionnent sur le site par couleur et taille — Familles de produits.
- Pour envoyer les prix d’Elbuz vers Odoo selon un planning — Modèles d’export.
- S’il n’y a pas encore de liens fournisseurs — Connecter et importer une liste de prix.
