Le connecteur Amazon d'Odoo : vendre sur Amazon sans ressaisie
Vendre sur Amazon tout en gardant Odoo comme tour de contrôle de votre activité, c'est précisément ce que permet le connecteur natif. Encore faut-il comprendre ce qu'il automatise réellement — et ce qui reste à votre main.
Le module sale_amazon d'Odoo 19 Enterprise relie votre compte vendeur Amazon (Seller Central) à votre ERP. Il importe les commandes, déclenche les confirmations d'expédition et tient vos quantités en stock à jour, le tout via l'Amazon Selling Partner API (SP-API), l'interface officielle d'Amazon. Dans cet article, je détaille son fonctionnement avec des schémas, de la configuration initiale jusqu'à la supervision au quotidien.
1. À quoi sert le connecteur
L'objectif est simple : faire d'Amazon un canal de vente intégré à Odoo, sans double saisie. Concrètement, le connecteur importe automatiquement les commandes Amazon, et pour les produits que vous expédiez vous-même, il renvoie à Amazon les confirmations d'expédition et les quantités disponibles.
Toute cette synchronisation est planifiée et automatique : il n'existe pas de notification en temps réel d'Amazon vers Odoo. Odoo interroge Amazon à intervalles réguliers ; en pratique, une nouvelle commande apparaît dans Odoo en moins d'une heure.
FBA ou FBM : deux modes de traitement
Chaque article vendu sur Amazon relève de l'un des deux modes de « fulfillment », et le comportement d'Odoo en dépend directement :
| Mode | Qui expédie ? | Ce que fait Odoo |
|---|---|---|
| FBA Fulfillment by Amazon |
Amazon, depuis ses entrepôts | Enregistre la vente et génère automatiquement le mouvement de stock (entrepôt Amazon → client). Aucune action manuelle. |
| FBM Fulfillment by Merchant |
Vous, depuis votre stock Odoo | Crée un bon de livraison à préparer. Vous expédiez, puis Odoo confirme l'expédition à Amazon et y pousse vos quantités en stock. |
2. Vue d'ensemble : les flux entre Odoo et Amazon
Trois flux de données principaux circulent entre les deux systèmes, auxquels s'ajoute l'authentification. Les commandes descendent d'Amazon vers Odoo ; les confirmations de livraison et les mises à jour de stock (FBM uniquement) remontent d'Odoo vers Amazon.
Vue synoptique des échanges entre Odoo et Amazon
Point important pour la sécurité : l'authentification ne transite jamais en direct. Elle passe par un proxy Odoo (service IAP) qui dialogue avec Amazon. Vos identifiants Amazon ne sont donc pas stockés dans Odoo.
3. Le flux des commandes
Toutes les 60 minutes, Odoo demande à Amazon la liste des commandes nouvelles ou modifiées depuis la dernière synchronisation, puis récupère le détail de chaque article. Pour chaque commande éligible, Odoo crée une commande client complète : le client et son adresse, les lignes d'articles, et le calcul des taxes selon votre configuration Odoo.
Parcours d'une commande, de sa création sur Amazon à son traitement dans Odoo
Deux points de bifurcation structurent ce parcours :
- Le SKU est-il connu ? Si l'article n'est pas encore relié à un produit Odoo, le connecteur crée automatiquement l'offre correspondante. Sinon, il réutilise l'offre existante.
- FBA ou FBM ? En FBA, la vente est simplement enregistrée et le stock mouvementé automatiquement. En FBM, un bon de livraison est créé et attend votre préparation.
À retenir — une commande importée est verrouillée : ne la modifiez pas manuellement dans Odoo, au risque de désynchroniser les deux systèmes. Notez aussi que seules les annulations de commandes FBM remontent dans Odoo ; les annulations FBA ne sont pas répercutées, le stock étant géré par Amazon.
4. Produits, offres et stock
Le connecteur ne synchronise pas directement vos produits Odoo avec Amazon : il s'appuie sur la notion d'offre. Une offre est le lien entre un SKU Amazon (l'identifiant d'une annonce) et un produit Odoo, pour une marketplace donnée (Amazon.fr, Amazon.de…).
Création des offres (SKU ↔ produit) et synchronisation du stock FBM
Comment les offres se créent
- Automatiquement : lors de la première commande contenant un SKU inconnu, Odoo crée l'offre et détecte le type de produit ainsi que le canal (FBA/FBM).
- Manuellement : via Ventes ▸ Configuration ▸ Amazon ▸ Offres, en renseignant le compte, la marketplace, le SKU exact, le produit Odoo et le canal.
La synchronisation du stock (FBM uniquement)
Si la synchronisation du stock est activée pour le compte et pour l'offre, Odoo pousse vers Amazon, toutes les 30 minutes, la quantité disponible du produit (stock réel diminué des réservations). Amazon met alors à jour la disponibilité affichée sur l'annonce. En FBA, le stock est géré par Amazon : Odoo n'envoie aucune quantité.
Bon à savoir — lorsqu'une offre bascule de FBM vers FBA, Odoo force la quantité à 0 afin de retirer l'annonce du stock vendeur.
5. Mettre le connecteur en service
Côté pré-requis : Odoo Enterprise avec le module sale_amazon installé (il dépend des modules Ventes et Expédition / stock_delivery), un compte Amazon Seller Central actif avec accès à la SP-API, et les droits d'administrateur des ventes dans Odoo. L'ensemble du paramétrage se fait depuis Ventes ▸ Configuration ▸ Amazon ▸ Comptes :
- Créer le compte Amazon : renseignez la société, la marketplace principale, le vendeur responsable et l'équipe commerciale.
- Connecter le compte : Odoo vous redirige vers Amazon Seller Central. Après autorisation, la connexion s'établit et le compte passe à l'état « connecté ».
- Récupérer les marketplaces disponibles via « Update Available Marketplaces ».
- Activer les marketplaces à synchroniser (Amazon.fr, Amazon.de…).
- Activer la synchro de stock FBM si vous le souhaitez.
- Vérifier les tâches planifiées dans Paramètres techniques ▸ Automatisation ▸ Actions planifiées.
6. Au quotidien : le cycle de vie des commandes
Commande FBM : là où vous intervenez
C'est le cas qui demande une action de votre part. Le schéma suit une commande FBM, du paiement sur Amazon jusqu'à la confirmation de livraison.
Cycle de vie d'une commande FBM (expédiée par le vendeur)
Votre intervention se situe à l'étape « Opérateur » : préparer la commande, renseigner le transporteur et le numéro de suivi, puis valider le bon de livraison. Le reste est automatique. Trois points de vigilance :
- le transporteur et le numéro de suivi sont obligatoires avant de valider ;
- tous les articles d'une même ligne de commande doivent être expédiés ensemble (pas d'expédition partielle) ;
- ne modifiez pas la commande, qui est verrouillée.
Commande FBA : entièrement automatique
Les commandes FBA sont gérées de bout en bout par Amazon : aucune action n'est requise dans Odoo, qui se contente d'enregistrer la vente et de générer les écritures de stock correspondantes.
Cycle de vie d'une commande FBA (expédiée par Amazon)
Récupérer une commande manuellement
Si une commande n'a pas été synchronisée automatiquement (délai, erreur passée), vous pouvez la récupérer à la demande : ouvrez le compte concerné, cliquez sur « Recover Order » et saisissez la référence Amazon au format 123-1234567-1234567.
7. Superviser et corriger
Depuis la fiche d'un compte Amazon, plusieurs boutons déclenchent une synchronisation immédiate sans attendre la prochaine tâche planifiée :
| Bouton | Effet |
|---|---|
| Sync Orders | Récupère les commandes depuis le dernier point de contrôle. |
| Sync Deliveries | Envoie à Amazon les confirmations de livraison en attente. |
| Sync FBM Inventory | Pousse vers Amazon les quantités disponibles (FBM). |
| Sync Feeds Status | Vérifie l'état des envois (« feeds ») en cours de traitement. |
En cas de problème, Odoo journalise les erreurs et envoie un courriel d'alerte au vendeur responsable du compte. Une erreur fréquente est le code 429 (trop de requêtes vers l'API) : elle se résout généralement d'elle-même au cycle suivant, Amazon limitant le débit des appels. Pour les autres erreurs, corrigez la cause (offre manquante, adresse incomplète…) puis relancez la synchronisation concernée.
8. Sécurité et accès
Comme évoqué, aucun identifiant Amazon n'est stocké dans Odoo : l'authentification repose sur le proxy IAP, qui gère les jetons d'accès à durée de vie courte (renouvelés automatiquement). Seul un jeton de rafraîchissement, nécessaire pour maintenir la connexion, est conservé. Côté Odoo, l'accès à la configuration Amazon est réservé au groupe « Ventes / Administrateur ».
Les limites à connaître
Le connecteur natif couvre l'essentiel des besoins, avec quelques limites à garder en tête :
- pas de notifications en temps réel : la synchronisation repose sur des interrogations planifiées (jusqu'à 60 min de délai sur les commandes) ;
- la quantité FBM envoyée ne tient pas compte d'une logique multi-canal sans développement spécifique ;
- environ 450 transporteurs sont reconnus ; les autres basculent sur un transporteur générique ;
- pas d'expédition partielle ;
- un compte Amazon est rattaché à une seule société Odoo.
Le connecteur Amazon d'Odoo couvre la grande majorité des scénarios de vente marketplace sans ajout. Lorsque les limites ci-dessus deviennent bloquantes — multi-canal, expéditions partielles, transporteurs spécifiques — c'est généralement le signe qu'un connecteur étendu ou un module sur mesure devient pertinent. Mais pour démarrer et fiabiliser un canal Amazon, l'outil natif est largement suffisant.