Intégration Odoo Amazon eBay : ce qui fonctionne nativement
Intégration Odoo avec Amazon et eBay : découvrez les fonctions natives, les limites d’eBay et quand choisir un module, un middleware ou du sur-mesure.
Long Nguyen
Développeur fullstack · Ingénieur IA · Chercheur
Odoo s’intègre-t-il nativement à Amazon et eBay ?
Amazon : oui, grâce au connecteur Amazon développé par Odoo. eBay : cela dépend de votre version d’Odoo et, pour les versions récentes, il faut partir du principe qu’un module tiers ou un développement sur mesure sera nécessaire.
Voici la situation en :
- Amazon. Odoo propose un connecteur Amazon qui importe régulièrement les commandes dans Odoo, associe les offres Amazon aux produits Odoo via leur SKU, applique les taxes configurées et gère les expéditions FBA comme FBM. D’après la page des fonctionnalités du connecteur Amazon d’Odoo, il couvre huit places de marché : les États-Unis, le Canada et le Mexique en Amérique du Nord, ainsi que la France, le Royaume-Uni, l’Allemagne, l’Italie, l’Espagne et les Pays-Bas en Europe.
- eBay. La documentation publiée par Odoo sur le connecteur eBay que j’ai pu trouver couvre les versions 14 à 17. Des utilisateurs du forum officiel d’Odoo indiquent que le connecteur eBay aurait été supprimé de la version 18 en raison d’un faible taux d’adoption. Il s’agit d’un retour d’utilisateur, et non d’une annonce officielle : vérifiez donc ce point pour votre version exacte avant de baser votre projet dessus.
- Tout le reste — création d’annonces à grande échelle, comptabilisation des règlements et des frais, retours et autres marketplaces — correspond généralement à la limite des connecteurs natifs et au début des projets d’intégration.
Les connecteurs Amazon et eBay natifs ont historiquement été des applications Odoo Enterprise, et non Community. Si vous utilisez Community en auto-hébergement, prévoyez dès le départ un module tiers ou un connecteur sur mesure, et vérifiez la situation pour votre version avant de vous engager.
Quelle solution d’intégration choisir ?
Il existe quatre façons réalistes de connecter Odoo à Amazon et eBay. Elles se distinguent moins par leurs fonctionnalités que par la personne qui devra gérer les problèmes lorsqu’une API évolue.
| Solution | Idéale pour | Ce que vous contrôlez | Risque principal |
|---|---|---|---|
| Connecteur Odoo natif (Amazon) | Vendeurs principalement présents sur Amazon, équipés d’Enterprise et recherchant un fonctionnement standard | Peu de choses : uniquement la configuration | Les cas particuliers nécessitent de toute façon du code sur mesure |
| Module tiers de l’App Store Odoo | eBay sur les versions récentes ou utilisateurs de Community | Modéré : vous pouvez lire et modifier le code | La qualité varie fortement ; vérifiez l’historique des mises à jour pour chaque version d’Odoo et l’identité du mainteneur |
| Middleware ou hub multicanal | Nombreux canaux, lancement rapide et capacités de développement limitées | Faible : le mapping et les règles de synchronisation résident dans le produit d’un tiers | Un abonnement supplémentaire, et Odoo devient le point d’arrivée du modèle de données d’un autre éditeur |
| Connecteur sur mesure avec Amazon SP-API et les API eBay | Processus non standard, volumes importants, Community ou plusieurs marketplaces au-delà de ces deux plateformes | Total | Vous devez en assurer la maintenance : versions d’API, changements d’authentification et limites de requêtes deviennent votre responsabilité |
La règle pratique est simple : plus votre processus ressemble au fonctionnement standard du fournisseur — réception des commandes et envoi des confirmations de livraison — moins vous devriez accepter de code sur mesure. Chaque écart, comme les SKU groupés, les entrepôts multiples ou la gestion spécifique des taxes d’une marketplace, vous oriente vers les deux dernières solutions.
Que couvre réellement le connecteur Amazon natif d’Odoo ?
D’après la description des fonctionnalités publiée par Odoo, le connecteur couvre le cycle allant de la commande à la livraison :
- Synchronisation planifiée des commandes Amazon vers les commandes clients Odoo.
- Association des offres aux produits via la référence SKU : une stratégie SKU propre est donc une condition préalable, et non un simple avantage.
- FBA : les mouvements de stock sont déclenchés automatiquement afin que l’inventaire Odoo reflète les produits expédiés par Amazon depuis ses propres entrepôts.
- FBM : les confirmations de livraison sont renvoyées à Amazon, avec gestion des expéditions totales ou partielles au moyen de reliquats.
- Application des taxes aux commandes synchronisées, génération des factures — individuellement ou par lot —, enregistrement des paiements et rapports de ventes.
La page d’Odoo ne précise pas les exigences liées à Enterprise, les contraintes d’hébergement ni les limitations. Considérez donc ces points comme des questions à tester lors d’un pilote, et non comme des acquis. Voici les vérifications qui détermineront si le flux standard suffit :
- Les niveaux de stock d’Odoo sont-ils renvoyés vers les annonces Amazon pour votre modèle d’exécution, ou seules les commandes sont-elles importées ?
- Pouvez-vous créer ou modifier des annonces depuis Odoo, ou pouvez-vous uniquement les associer à des annonces existantes ?
- Comment les frais Amazon, les remboursements et les versements parviennent-ils à votre comptabilité ? Les commandes et les factures ne correspondent pas aux règlements.
- Que devient une commande dont le SKU ne correspond à aucun produit Odoo : file d’erreurs, omission silencieuse ou création automatique du produit ?
Testez ces quatre points dans une base de test avec quelques commandes réelles avant de conclure que le connecteur natif suffit.
Quelles sont vos options eBay si Odoo ne propose plus de connecteur ?
Si vous utilisez la version 17 ou une version antérieure avec Enterprise, le connecteur eBay officiel existe et est documenté. Avec les versions plus récentes, trois options s’offrent à vous :
- Module tiers de l’App Store. Des modules eBay sont proposés pour les versions récentes d’Odoo. Évaluez-les selon des critères précis, et non selon leur note : date de la dernière mise à jour pour votre version exacte d’Odoo, utilisation des API eBay actuelles plutôt que d’anciennes API obsolètes, lisibilité du code source, licence et accompagnement du fournisseur lors des mises à niveau. La discussion du forum citée plus haut indique que certains utilisateurs jugent la qualité des solutions tierces inégale.
- Middleware. Cette option est pertinente si eBay fait partie de nombreux canaux et que vous ne souhaitez pas prendre en charge le code.
- Connecteur sur mesure. C’est le bon choix lorsque le traitement des commandes eBay doit respecter des règles particulières, par exemple le mapping d’annonces à variantes vers les variantes Odoo, l’affectation depuis plusieurs entrepôts ou la gestion de la fiscalité B2B.
Quelle que soit l’option retenue, ne restez pas sur une ancienne version d’Odoo uniquement pour conserver un vieux connecteur. La maintenance d’un connecteur coûte moins cher qu’un ERP figé.
Quelles données doivent être synchronisées entre Odoo, Amazon et eBay ?
La plupart des échecs d’intégration sont des problèmes de mapping, et non des problèmes d’API. Définissez le sens de circulation et le système responsable de chaque objet avant de développer ou de configurer quoi que ce soit.
| Objet | Sens habituel | Système de référence | Problème courant |
|---|---|---|---|
| Commandes | Marketplace vers Odoo | Marketplace jusqu’à l’import, puis Odoo | Importations en double après une nouvelle tentative ou un délai d’attente |
| Produits et SKU | Odoo vers la marketplace, ou association via le SKU | Odoo | SKU différents selon les canaux, packs et variantes |
| Niveaux de stock | Odoo vers la marketplace (FBM) ; marketplace vers Odoo (FBA) | Odoo pour FBM, Amazon pour FBA | Survente lorsque FBA et FBM partagent un SKU sans emplacements distincts |
| Expéditions et suivi | Odoo vers la marketplace | Odoo | Expéditions partielles non confirmées et signalements d’expédition tardive |
| Frais, remboursements et versements | Marketplace vers la comptabilité Odoo | Rapports de la marketplace | Le chiffre d’affaires correspond aux commandes, mais la trésorerie ne correspond pas au relevé bancaire |
| Retours | Marketplace vers Odoo | Marketplace jusqu’à la réception | Retour réceptionné, mais stock jamais réintégré |
La cinquième ligne est celle qui crée souvent des problèmes invisibles pour les équipes financières : importer les commandes vous donne les ventes, mais seules les données de règlement de la marketplace indiquent les montants réellement prélevés et versés.
Quels sont les pièges courants d’une intégration Odoo avec une marketplace ?
Commandes en double après de nouvelles tentatives
Les API des marketplaces peuvent expirer et votre tâche est relancée. Sans contrôle d’idempotence, la même commande est importée deux fois. La défense la plus simple consiste à enregistrer l’identifiant de commande de la marketplace avec le préfixe du canal et à refuser toute création s’il existe déjà :
def import_order(env, channel, external_id, vals):
ref = '%s:%s' % (channel, external_id)
Order = env['sale.order']
existing = Order.search([('client_order_ref', '=', ref)], limit=1)
if existing:
return existing
vals['client_order_ref'] = ref
return Order.create(vals)
En production, renforcez ce mécanisme par un index unique au niveau de la base de données sur votre propre champ dédié, plutôt que de vous fier uniquement à la recherche : deux workers peuvent tous deux passer cette étape avant que l’un ou l’autre ne crée l’enregistrement.
Un seul SKU pour FBA et FBM
Si le même SKU est expédié à la fois par Amazon et par vous, attribuez à FBA son propre emplacement de stock dans Odoo. Sinon, la quantité disponible dans Odoo inclut du stock auquel vous n’avez pas accès, et votre annonce FBM risque la survente.
Limites de requêtes et files d’attente
Les API des marketplaces limitent le nombre de requêtes. Concevez la synchronisation sous forme de tâches en file d’attente avec temporisation progressive, et non comme une boucle dans une requête HTTP ou une seule action planifiée qui échouerait entièrement à cause d’un enregistrement incorrect.
Hypothèses sur les taxes et la facturation
Les commandes des marketplaces arrivent avec une gestion fiscale qui dépend de la destination et du fait que la marketplace collecte ou non la taxe. Vérifiez avec votre comptable quelles commandes nécessitent une facture Odoo et lesquelles sont couvertes par la marketplace avant d’automatiser la génération des factures.
Identifiants et autorisation
Amazon et eBay utilisent tous deux une autorisation de type OAuth avec expiration des jetons. Surveillez l’état de l’autorisation : un jeton expiré peut se manifester par l’absence de nouvelles commandes et passer inaperçu pendant plusieurs jours.
Quelle configuration convient à votre entreprise ?
| Votre situation | Commencez par |
|---|---|
| Amazon uniquement, Odoo Enterprise et exécution standard | Le connecteur Amazon natif ; testez les quatre points de contrôle ci-dessus |
| Amazon et eBay, Odoo Enterprise sur une version récente | Le connecteur Amazon natif associé à un module eBay tiers validé ou à un module sur mesure |
| Odoo Community en auto-hébergement | Des modules tiers ou un connecteur sur mesure ; prévoyez le budget de maintenance |
| Cinq canaux ou plus | Comparez un middleware à un hub sur mesure et évaluez le coût de la prise en charge de chaque évolution d’API |
| Règles particulières : packs, entrepôts multiples ou fiscalité B2B | Un connecteur sur mesure, limité aux seules exceptions |
Si votre situation correspond aux trois dernières lignes, un service de développement et d’intégration Odoo coûte généralement moins cher que de découvrir ces lacunes après la mise en production. Dans tous les cas, commencez par rédiger le mapping objet par objet présenté dans la section précédente.
Comment déployer une intégration Odoo avec une marketplace en toute sécurité ?
- Nettoyez d’abord les SKU. Exportez vos annonces des marketplaces et vos produits Odoo, associez-les via leur SKU et corrigez les écarts avant de connecter quoi que ce soit.
- Utilisez une base de staging et connectez un seul compte de marketplace.
- Importez une période de commandes limitée et comparez les totaux avec les rapports de la marketplace.
- Testez les cas délicats : expédition partielle, annulation, remboursement et SKU inconnu.
- Mettez une seule marketplace en production, surveillez-la pendant une semaine, puis ajoutez la suivante.
- Configurez la supervision : alertes sur les tâches en échec, les autorisations expirées et l’absence inhabituelle de commandes importées.
Les équipes qui connectent tous les canaux en même temps ne peuvent pas déterminer lequel a provoqué un écart de stock. Une marketplace à la fois permet d’attribuer chaque problème avec précision.
Besoin de connecter Odoo à Amazon et eBay ?
Si vous préférez ne pas prendre vous-même en charge le code d’intégration, Netalith développe et maintient des connexions avec les marketplaces. Consultez le service d’intégration avec les marketplaces pour les projets Amazon SP-API et eBay, puis demandez un devis adapté à votre périmètre.
FAQ
Questions fréquentes
Odoo propose-t-il une intégration Amazon intégrée ?
Oui. Odoo propose un connecteur Amazon qui synchronise les commandes vers Odoo, associe les offres aux produits via leur SKU et prend en charge les expéditions FBA et FBM sur huit marketplaces en Amérique du Nord et en Europe. Il s’agit historiquement d’une application Enterprise : vérifiez donc sa disponibilité pour votre édition et votre version.
Odoo propose-t-il encore un connecteur eBay ?
La documentation publiée par Odoo sur le connecteur eBay couvre les versions 14 à 17. Des utilisateurs du forum d’Odoo indiquent qu’il aurait été supprimé de la version 18 en raison d’un faible taux d’adoption. Il s’agit d’un retour d’utilisateur et non d’une annonce officielle : vérifiez donc la situation pour votre version avant de planifier votre projet.
Puis-je intégrer Amazon et eBay à Odoo Community ?
Oui, mais pas avec les connecteurs Enterprise natifs. Utilisez un module tiers de l’App Store Odoo ou un connecteur sur mesure développé avec l’Amazon Selling Partner API et les API eBay, et prévoyez d’en assurer la maintenance.
Comment éviter la survente avec FBA et FBM ?
Conservez le stock FBA dans un emplacement distinct dans Odoo afin que la quantité disponible pour les annonces FBM ne compte que le stock que vous pouvez réellement expédier vous-même. Vérifiez également que votre connecteur met à jour les quantités des marketplaces uniquement à partir de cet emplacement.
Dois-je utiliser un middleware ou développer un connecteur Odoo sur mesure ?
Un middleware convient à de nombreux canaux utilisant des processus standard, lorsque les capacités de développement sont limitées. Un connecteur sur mesure est préférable pour des règles particulières, comme les packs, l’affectation depuis plusieurs entrepôts ou la gestion de la fiscalité B2B, lorsque vous avez besoin d’un contrôle total et acceptez le coût de maintenance.