Connecteur Odoo Amazon : Configuration et vente multicanal

Amazon représente près de 40 % des revenus du commerce électronique aux États-Unis, ce qui en fait un canal obligatoire pour les vendeurs de produits. La gestion des commandes, des stocks et de l'exécution Amazon séparément de votre ERP principal crée des silos de données, des problèmes de rapprochement et des erreurs d'exécution qui coûtent de l'argent réel.

Le connecteur ECOSIRE Odoo Amazon relie Odoo 19 Enterprise et Amazon Seller Central, synchronisant les produits, les commandes, les niveaux de stock et l'état d'exécution dans les deux sens. Ce guide couvre le processus d'installation complet, la configuration du mappage des données, les options de fréquence de synchronisation, la gestion des erreurs et les meilleures pratiques opérationnelles pour exécuter les ventes Amazon via Odoo.

Points clés à retenir

• Le connecteur prend en charge toutes les places de marché Amazon (États-Unis, Royaume-Uni, UE, Japon, Émirats arabes unis, etc.)
• La synchronisation des commandes s'exécute toutes les 15 minutes par défaut ; configurable jusqu'à 5 minutes
• Les niveaux de stock sont transmis automatiquement à Amazon à chaque mouvement de stock
• Les commandes FBA et FBM (Fulfilled by Merchant) sont traitées dans des flux de travail distincts
• La cartographie des produits utilise ASIN, SKU et EAN/UPC comme clés de correspondance
• Les synchronisations échouées sont enregistrées avec les détails de l'erreur et peuvent être réessayées individuellement
• Les règles de tarification peuvent remplacer les prix Amazon basés sur les listes de prix Odoo
• Le connecteur utilise Amazon SP-API (Selling Partner API), en remplacement du MWS obsolète

---

Conditions préalables et configuration d'Amazon SP-API

Le connecteur utilise l'API Selling Partner (SP-API) d'Amazon. Avant d'installer le connecteur, vous avez besoin des informations d'identification SP-API d'Amazon.

Étape 1 : Inscrivez-vous en tant que développeur sur Amazon Seller Central

1. Connectez-vous à Seller Central → Applications et services → Développer des applications
2. Cliquez sur "Ajouter un nouveau client d'application" et terminez l'enregistrement du développeur.
3. Amazon examinera votre demande (1 à 3 jours ouvrables pour l'approbation)

Étape 2 : Créer une application SP-API

Une fois approuvé :

1. Accédez à Applications et services → Développer des applications → Vos applications
2. Cliquez sur « Ajouter un nouveau client d'application »
3. Sélectionnez IAM ARN (créez d'abord un utilisateur AWS IAM) ou utilisez OAuth
4. Définissez l'URI de redirection sur votre instance Odoo : https://your-odoo.com/amazon/oauth/callback
5. Sélectionnez les étendues d'API requises :

• API des commandes
• API de rapports
• API d'annonces
• API des articles du catalogue
• API d'inventaire Expédié par Amazon
• API de flux

Étape 3 : Autorisez votre compte vendeur

Après la création de l'application, autorisez l'application sur chaque place de marché :

1. Copiez les informations d'identification LWA (Login With Amazon) de votre application
2. Accédez à l'URL d'autorisation du connecteur
3. Complétez le flux OAuth pour chaque compte Amazon Marketplace

Identifiants dont vous aurez besoin dans Odoo :

• Identifiant client LWA - Secret client LWA
• Actualiser le jeton (généré lors du flux OAuth)
• Région AWS (basée sur le marché)

---

Installation et configuration du connecteur

Installez le module ECOSIRE Amazon Connector :

Le connecteur est disponible sur la Place de marché ECOSIRE. Après l'achat :

1. Téléchargez le fichier zip du module depuis votre compte ECOSIRE
2. Téléchargez sur votre serveur Odoo : cp amazon_connector.zip /opt/odoo/addons/
3. Extrayez et installez : accédez à Applications → Mettre à jour la liste des applications → recherchez « Amazon Connector » → Installer

Configuration initiale :

Accédez à Inventaire → Configuration → Amazon Marketplaces (ou Ventes → Amazon → Configuration selon votre disposition Odoo).

Cliquez sur Créer pour ajouter une nouvelle connexion à la place de marché :

Testez la connexion :

Après avoir enregistré, cliquez sur Tester la connexion. Un test réussi renvoie votre nom de marchand et confirme l'accès à l'API. En cas d'échec, vérifiez :

• Les informations d'identification LWA sont correctes
• Le jeton d'actualisation n'a pas expiré
• La région AWS correspond à votre marché
• L'application SP-API est à l'état « Publié » (et non « Brouillon »)

---

Cartographie des produits et synchronisation du catalogue

Le connecteur mappe les produits Odoo aux ASIN Amazon en utilisant trois méthodes :

Méthode 1 : correspondance des SKU (recommandée)

Si vos références de produits internes (codes SKU) correspondent au SKU du vendeur que vous utilisez sur Amazon, activez SKU Auto-Match dans les paramètres de la place de marché. Le connecteur reliera automatiquement les produits Odoo à leurs listes Amazon.

Méthode 2 : correspondance EAN/UPC

Le connecteur interroge l'API du catalogue d'Amazon pour trouver des listes correspondant au code-barres de votre produit (EAN13 ou UPC). Cela fonctionne pour les produits de marque répertoriés dans le catalogue d'Amazon.

Méthode 3 : Mappage manuel des ASIN

Pour les produits ou offres personnalisées :

1. Accédez au formulaire produit → onglet Amazon
2. Saisissez l'ASIN pour chaque place de marché
3. Mappez les variantes sur leurs ASIN spécifiques

Importation du catalogue Amazon :

Au lieu de mapper un par un, importez votre catalogue Amazon :

1. Accédez à Amazon → Catalogue → Importer des annonces
2. Sélectionnez la place de marché
3. Le connecteur télécharge toutes vos annonces actives et crée/met à jour les produits Odoo
4. Examinez les produits importés pour vérifier l'exactitude de la cartographie sur le terrain

Configuration du mappage des champs de produit :

---

Synchronisation des commandes

Les commandes transitent automatiquement d’Amazon vers Odoo. Comprendre le cycle de vie des commandes évite toute confusion et erreurs d'exécution.

Flux de synchronisation des commandes :

Amazon Order Created (status: Pending)
        ↓ [15-minute sync interval]
Odoo receives order → creates sale.order in DRAFT
        ↓
Amazon confirms payment (status: Unshipped)
        ↓ [next sync]
Odoo sale.order auto-confirmed → delivery order created
        ↓
Warehouse picks, packs, ships
        ↓
Odoo records shipment → sends tracking to Amazon via API
        ↓
Amazon status: Shipped → Customer receives
        ↓
Amazon releases payment to seller
        ↓
Odoo invoice created and posted (auto or manual)

Paramètres de synchronisation des commandes :

Traitement des commandes annulées :

Lorsqu'Amazon annule une commande (annulation du client ou échec de paiement) :

1. Le connecteur détecte l'annulation à la prochaine synchronisation
2. Si le bon de livraison n'a pas été validé : il est automatiquement annulé
3. Si la livraison a déjà été validée : le connecteur crée un retour RMA
4. La facture est annulée ou contrepassée avec un avoir

---

Synchronisation des stocks

La précision des stocks en temps réel empêche la survente, ce qui entraîne des pénalités sur le compte du vendeur Amazon.

Inventaire poussé vers Amazon :

Chaque fois qu'un mouvement de stock Odoo se produit (livraison, réception, retour, ajustement), le connecteur envoie la quantité mise à jour à l'API Amazon Inventory :

• Produits FBM : quantité disponible d'Odoo moins tampon de stock de sécurité
• Produits Expédié par Amazon : Amazon gère l'inventaire Expédié par Amazon ; Odoo reçoit les niveaux FBA via l'API Amazon Inventory

Configuration du stock de sécurité :

Available for Amazon = On-Hand Quantity - Safety Stock Buffer - Reserved Quantity

Configurez le stock de sécurité par produit ou globalement :

• Accédez au produit → onglet Amazon → Stock de sécurité : 5
• Ou globalement dans les paramètres de la place de marché → Stock de sécurité par défaut : 2

Fréquence de synchronisation de l'inventaire :

Contrairement à la synchronisation des commandes (événementielle + planifiée), la synchronisation des stocks est basée sur des lots :

• Par défaut : toutes les 30 minutes
• Après tout mouvement de stock : dans les 5 minutes (style webhook)
• Avant les périodes de pointe : effectuez une synchronisation manuelle

Inventaire multi-entrepôts :

Si vous expédiez depuis plusieurs entrepôts :

1. Créez des configurations Amazon Marketplace distinctes pour chaque entrepôt
2. Le connecteur regroupe l'inventaire dans tous les entrepôts liés
3. Ou : utilisez la fonctionnalité d'inventaire multi-sites d'Amazon avec allocation de quantité spécifique à l'entrepôt

---

Intégration FBA (Fulfilled by Amazon)

Les commandes Expédié par Amazon sont exécutées par l'entrepôt d'Amazon, mais Odoo a toujours besoin de les connaître pour le rapprochement financier.

Flux de commande Expédié par Amazon dans Odoo :

1. Amazon reçoit et exécute la commande (Odoo n'a aucun rôle d'exécution)
2. Le connecteur crée une commande de vente dans Odoo marquée comme « FBA »
3. Le bon de livraison est auto-validé (pas de picking physique dans Odoo)
4. Un emplacement virtuel « Amazon FBA » est décrémenté
5. La facture est créée et publiée
6. Le versement Amazon est rapproché de la facture

Gestion des stocks Expédié par Amazon :

Envoyez l'inventaire à Amazon FBA via Odoo :

1. Créez un envoi FBA dans Odoo (ou dans Seller Central et associez-le)
2. Le connecteur crée un transfert de stock de votre entrepôt vers l'emplacement « Amazon FBA »
3. Validez le transfert lorsque les marchandises sont expédiées vers Amazon
4. Les quantités Expédié par Amazon sont suivies dans Odoo à des fins de reporting

Rapprochement des frais Expédié par Amazon :

Amazon déduit les frais (exécution, stockage, référence) avant d'effectuer le paiement. Configurez le connecteur pour :

• Importer les rapports de règlement Amazon
• Créer automatiquement des entrées de journal pour les frais FBA
• Rapprocher le montant net du règlement avec les factures impayées

---

Gestion des prix

Retarification automatisée :

Le connecteur prend en charge les mises à jour automatiques des prix vers Amazon en fonction des règles de liste de prix Odoo :

Amazon Price = Odoo List Price × Marketplace Multiplier + Fixed Offset

Configuration :

• Accédez aux paramètres du marché → Tarification
• Définir Source de prix : liste de prix, coût + marge ou fixe - Définissez un multiplicateur (par exemple, 1,0 pour le même prix, 1,15 pour une majoration de 15 %).
• Activer Prix de synchronisation automatique : les prix sont transmis à Amazon lorsqu'ils sont modifiés dans Odoo

Gestion des devises :

Pour les places de marché non-USD (EUR, GBP, JPY), le connecteur :

1. Lit les prix de la liste de prix spécifique au marché si elle est configurée
2. Ou convertissez à partir de votre devise de base en utilisant les taux de change quotidiens d'Odoo

---

Gestion et surveillance des erreurs

Journal des erreurs de synchronisation :

Accédez à Amazon → Journaux de synchronisation pour voir toutes les opérations de synchronisation :

• Vert : synchronisation réussie
• Jaune : synchronisation partielle (certains enregistrements ont échoué)
• Rouge : échec complet de la synchronisation

Chaque entrée d'erreur affiche :

• Horodatage et type de synchronisation (commandes, inventaire, annonces)
• Code d'erreur de l'API Amazon
• ID de l'enregistrement concerné -Message d'erreur
• Bouton Réessayer

Erreurs courantes et résolutions :

Alertes automatisées :

Configurez les alertes par e-mail pour les échecs de synchronisation :

• Accédez aux paramètres du marché → Notifications
• Ajoutez des adresses e-mail pour avertir des erreurs de synchronisation
• Définir le seuil d'alerte : notifier après 3 échecs consécutifs

---

Questions fréquemment posées

Le connecteur prend-il en charge le traitement multicanal Amazon FBA (MCF) ?

Oui. MCF vous permet d'utiliser l'inventaire Expédié par Amazon d'Amazon pour exécuter des commandes provenant d'autres canaux de vente (votre site Web, d'autres marchés). Le connecteur peut créer des demandes d'exécution MCF lorsqu'une commande client provenant d'un canal non Amazon est reçue, à condition que le produit soit stocké dans FBA. Les commandes MCF sont suivies dans Odoo avec les mouvements de localisation FBA.

Comment le connecteur gère-t-il les règles fiscales complexes d'Amazon (VAT OSS, Marketplace Facilitator) ?

Pour les marchés sur lesquels Amazon collecte et verse la taxe (règles du Marketplace Facilitator, applicables dans la plupart des États américains et dans l'UE pour les vendeurs hors UE), le connecteur crée des commandes avec une taxe de 0 $, car Amazon gère l'obligation fiscale. Pour les situations non-Facilitateur, le connecteur applique les positions fiscales configurées dans Odoo en fonction de l'adresse de livraison de l'acheteur.

Puis-je gérer plusieurs comptes Amazon (différents comptes vendeur) à partir d'une seule instance Odoo ?

Oui. Créez plusieurs configurations de place de marché, chacune avec ses propres informations d'identification SP-API. Vous pouvez avoir des configurations distinctes pour différents comptes vendeurs, différentes places de marché sous le même compte ou différentes sociétés dans une configuration Odoo multi-entreprises. Les commandes, les stocks et les prix sont gérés selon la configuration du marché.

Que se passe-t-il si Amazon modifie une commande après son importation dans Odoo ?

Le connecteur vérifie les modifications de commande à chaque cycle de synchronisation. Si Amazon met à jour une commande (par exemple, changement de quantité avant expédition, correction d'adresse), le connecteur met à jour la commande de vente Odoo correspondante si elle n'a pas encore été confirmée. Les modifications apportées aux commandes confirmées créent une alerte système pour un examen manuel.

Le connecteur gère-t-il le contenu Amazon A+ ou le contenu de marque amélioré ?

Non. La gestion de contenu A+ est un contenu marketing géré exclusivement via Seller Central. Le connecteur se concentre sur les données opérationnelles : commandes, stocks, prix et exécution. Le contenu des produits (descriptions, images) peut être transféré vers les listes de base Amazon, mais pas vers les modèles de contenu A+.

---

Prochaines étapes

Vendre sur Amazon via Odoo est nettement plus efficace que de gérer deux systèmes séparément, mais le connecteur doit être correctement configuré dès le départ. Des mappages de produits mal configurés, des paramètres de synchronisation des stocks incorrects ou des configurations fiscales incorrectes créent des problèmes qui s'aggravent avec le temps.

Le module Amazon Connector d'ECOSIRE est spécialement conçu pour Odoo 19 Enterprise, et notre équipe fournit une assistance à la configuration, une formation et une assistance continue aux vendeurs du marché qui gèrent Amazon via Odoo.

Obtenez le connecteur Amazon ECOSIRE pour Odoo 19 →

L'achat comprend la licence du module, la documentation et 30 jours d'assistance à la mise en œuvre pour que votre intégration Amazon-Odoo fonctionne correctement dès le premier jour.