Connecteur eBay Odoo : référencement, commandes et synchronisation de l'inventaire

eBay reste l'une des plus grandes places de marché au monde, avec 132 millions d'acheteurs actifs dans le monde. Pour les vendeurs qui utilisent à la fois eBay et Odoo 19 Enterprise, la gestion de deux systèmes distincts pour les commandes, l'inventaire et les données clients est inefficace et sujette aux erreurs. Le connecteur eBay ECOSIRE Odoo synchronise votre boutique eBay avec Odoo, automatisant l'ensemble du flux de vente, de la création de l'annonce à l'exécution des commandes et à la comptabilité après-vente.

Ce guide couvre tout, depuis la configuration des informations d'identification de l'API eBay jusqu'à la gestion des annonces, l'automatisation des commandes, la synchronisation des stocks, la gestion des retours et la surveillance des performances du vendeur.

Points clés à retenir

• Le connecteur utilise les API eBay REST et OAuth 2.0 pour l'authentification
• Prend en charge eBay Motors, eBay Business & Industrial et les catégories de consommateurs
• Les listes à prix fixe et aux enchères sont toutes deux prises en charge (importation de commandes uniquement pour les enchères)
• La synchronisation des stocks met à jour les quantités eBay dans les 10 minutes suivant les changements de stock Odoo
• Le paramètre de rupture de stock (OOS) d'eBay est géré automatiquement lorsque la quantité atteint 0
• L'importation des commandes inclut les détails de l'acheteur, les conditions d'expédition et les montants du paiement eBay
• Les cas de retours et de garantie de remboursement eBay sont synchronisés avec le flux de travail Odoo RMA
• Prise en charge multi-boutiques : gérez plusieurs comptes de vendeur eBay à partir d'une seule instance Odoo

---

Configuration et autorisation de l'API eBay

Le connecteur utilise la suite API REST d'eBay, remplaçant l'ancienne API Trading pour la plupart des opérations.

Étape 1 : Créez un compte de développeur eBay

1. Inscrivez-vous à developer.ebay.com
2. Créez une nouvelle application sous Mon compte → Jeux de clés d'application
3. Notez votre App ID (Client ID), Dev ID et Cert ID (Client Secret)
4. Générez un RuName (nom d'URL de redirection eBay) pour le flux OAuth

Étape 2 : Configurer les étendues OAuth

Votre application a besoin des étendues OAuth suivantes :

https://api.ebay.com/oauth/api_scope
https://api.ebay.com/oauth/api_scope/sell.inventory
https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
https://api.ebay.com/oauth/api_scope/sell.fulfillment
https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly
https://api.ebay.com/oauth/api_scope/sell.account
https://api.ebay.com/oauth/api_scope/sell.account.readonly
https://api.ebay.com/oauth/api_scope/commerce.identity.readonly

Étape 3 : Générer des jetons utilisateur

Les jetons utilisateur OAuth 2.0 (et non les jetons d'application) sont requis pour les opérations du vendeur :

1. Dans la configuration du connecteur, cliquez sur Autoriser avec eBay
2. Complétez le flux de consentement eBay OAuth
3. Le connecteur stocke automatiquement le jeton d'accès et le jeton d'actualisation
4. Les jetons expirent après 18 mois ; le connecteur s'actualise automatiquement à l'aide du jeton d'actualisation

Bac à sable vs production

Testez toujours d'abord avec l'environnement sandbox d'eBay : -API Sandbox : api.sandbox.ebay.com

• Les informations d'identification Sandbox sont différentes des informations d'identification de production
• Créez des comptes vendeur et acheteur sandbox sur developer.ebay.com/sandbox

---

Installation et configuration du connecteur

Installer depuis le marché ECOSIRE :

1. Achetez le module eBay Connector auprès de Produits ECOSIRE
2. Installer via les applications → Mettre à jour la liste des applications → rechercher « Connecteur eBay » → Installer
3. Accédez à Inventaire → Configuration → Boutiques eBay ou Ventes → eBay.

Configuration du magasin :

Politiques de traitement :

Avant de mettre en vente, configurez les politiques de traitement des commandes d'eBay dans Seller Hub :

• Politique d'expédition : transporteurs, délai de livraison estimé, délai de traitement
• Politique de retour : retours sous 30 jours, frais de réapprovisionnement
• Politique de paiement : paiements gérés par eBay requis depuis 2021

Le connecteur les référence par ID de stratégie. Liez-les dans les paramètres du magasin.

---

Gestion des annonces

Le connecteur prend en charge la création et la gestion d'annonces à prix fixe directement à partir des enregistrements de produits Odoo.

Création d'une fiche à partir d'un produit Odoo :

1. Ouvrez le formulaire produit → onglet eBay
2. Cliquez sur Liste sur eBay
3. Configurez les champs de liste :

• Titre : jusqu'à 80 caractères, renseigné automatiquement à partir du nom du produit
• Catégorie : sélectionnez la catégorie eBay (recherche par mot-clé ou identifiant)
• Condition : Nouveau, utilisé, pour pièces/ne fonctionne pas, etc.
• Prix : utilise la liste de prix des produits ou remplace le prix
• Quantité : stock disponible ou quantité personnalisée
• Durée : GTC (Good 'Til Cancelled) recommandé pour un prix fixe
• Caractéristiques de l'objet : attributs requis par eBay pour la catégorie

4. Cliquez sur Publier sur eBay

Modèles de liste :

Pour les vendeurs proposant de nombreux produits dans la même catégorie, créez des modèles de fiches produits :

• Accédez à eBay → Modèles → Créer un modèle
• Configurer les champs partagés : catégorie, expédition, politique de retour, spécificités de l'article
• Appliquer des modèles à plusieurs produits simultanément

Liste groupée :

Pour les catalogues contenant plus de 100 produits :

1. Exportez la liste de produits au format CSV avec les champs eBay requis
2. Utilisez l'importation groupée dans eBay → Annonce groupée → Télécharger CSV
3. Examinez et publiez par lots

Synchronisation des annonces :

Modifications apportées dans la synchronisation Odoo avec eBay :

• Modifications de prix → Prix eBay mis à jour dans les 15 minutes
• Modifications de la description du produit → Annonce eBay mise à jour lors de la prochaine synchronisation
• Modifications des images → Images eBay mises à jour (nécessite une réinscription pour certaines modifications)

Caractéristiques de l'article de la catégorie eBay :

eBay requiert des attributs spécifiques à la catégorie (par exemple, marque, taille, couleur pour les vêtements). Le connecteur mappe les attributs des produits Odoo aux spécificités des objets eBay :

---

Synchronisation des commandes

Processus d'importation des commandes :

Les commandes transitent automatiquement d'eBay vers Odoo :

1. L'acheteur passe commande sur eBay et finalise le paiement
2. eBay crée une commande avec le statut « En attente d'expédition »
3. Le connecteur interroge l'API des commandes eBay toutes les 15 minutes (configurable)
4. Odoo crée une commande de vente avec les détails de l'acheteur d'eBay
5. Le bon de livraison est créé automatiquement
6. Warehouse exécute la commande et valide la livraison
7. Le connecteur renvoie le numéro de suivi à eBay
8. eBay marque la commande comme « Expédiée »

Mappage des données de commande :

Envoi des informations de suivi :

Lorsque vous validez une livraison dans Odoo et saisissez un numéro de suivi :

1. Le connecteur détecte le numéro de suivi sur le stock.picking
2. Il appelle l'API de traitement des commandes d'eBay pour ajouter le suivi
3. L'acheteur reçoit une notification eBay avec les détails de suivi
4. eBay met à jour le statut de la commande sur « Expédiée »

Transporteurs pris en charge pour les mises à jour automatiques du suivi : USPS, UPS, FedEx, DHL, Royal Mail, Deutsche Post et plus de 100 autres via la liste des codes de transporteur d'eBay.

---

Synchronisation des stocks

Un inventaire précis empêche les mesures de « défaut » d'eBay en cas de rupture de stock.

Mécanisme de synchronisation des stocks :

Le connecteur utilise l'API d'inventaire d'eBay avec la logique suivante :

eBay Quantity = Odoo On-Hand - Safety Stock Buffer - Odoo Reserved Quantity

Lorsque l'inventaire est synchronisé :

• Après chaque commande de livraison confirmée (immédiate)
• Après chaque réception validée (immédiat)
• Synchronisation complète programmée toutes les 30 minutes
• Synchronisation manuelle disponible à tout moment

Traitement des ruptures de stock :

Configurez ce qui se passe lorsque la quantité atteint 0 :

• Option A : mode OOS (recommandation Odoo) : gardez l'annonce active avec une quantité de 0 en utilisant l'option En rupture de stock d'eBay — l'annonce conserve son historique et ses avis.
• Option B : Mettre fin à l'annonce : supprimer l'annonce d'eBay lorsque le stock atteint 0 et remettre en vente une fois réapprovisionné
• Option C : Définir le minimum : définissez une quantité minimale (par exemple, 1) et passez à 0 dans Odoo uniquement lorsque le minimum OOS est déclenché

La fin et la remise en vente nuisent souvent au placement dans les recherches eBay. Le mode OOS est recommandé.

Inventaire multi-sites :

Si vous expédiez depuis plusieurs entrepôts :

• Définir un entrepôt principal pour eBay dans les paramètres du magasin
• Ou regrouper l'inventaire dans plusieurs entrepôts
• Configurer par produit si certains SKU sont expédiés à partir d'emplacements spécifiques

---

Traitement des retours et des remboursements

La garantie de remboursement d'eBay signifie que les vendeurs doivent accepter les retours. Le connecteur gère le workflow de retour dans Odoo.

Flux de travail de synchronisation de retour :

1. L'acheteur ouvre une demande de retour sur eBay
2. Le connecteur importe le dossier de retour dans Odoo en tant que RMA (Return Merchandise Authorization)
3. L'équipe des opérations examine le motif du retour dans Odoo
4. Si accepté : générez une étiquette d'expédition de retour (si vous fournissez des étiquettes prépayées)
5. L’acheteur renvoie l’article
6. Recevoir les marchandises retournées dans Odoo → valider la réception
7. Traiter le remboursement : créer un avoir dans Odoo → le connecteur déclenche le remboursement eBay

Statuts des dossiers de retour suivis :

---

Surveillance des performances des vendeurs eBay

eBay évalue les vendeurs sur la base de mesures qui ont un impact direct sur la visibilité des annonces. Surveillez-les dans Odoo :

Mesures clés du vendeur eBay :

Tableau de bord des performances dans Odoo :

Accédez à eBay → Performances pour voir :

• Commandes par statut au cours des 30 derniers jours
• Expéditions tardives (commandes expédiées après délai de traitement)
• Taux de retour par catégorie
• Récapitulatif des défauts avec identifiants de commande
• Niveau de vendeur projeté pour la prochaine évaluation

---

Prix et promotions

Règles de tarification automatisées :

Configurez la tarification eBay dynamique basée sur les données de coût Odoo :

eBay Price = Product Cost × (1 + Target Margin %) + eBay Fee Buffer

Exemple : Si le coût est de 10 $, la marge cible est de 40 % et les frais eBay sont généralement de 12,5 % :

eBay Price = $10 × 1.40 / (1 - 0.125) = $16.00

Promotions démarques :

Le connecteur prend en charge l'intégration d'eBay Promotions Manager :

• Créer des ventes dans Odoo → le connecteur crée les promotions eBay correspondantes
• Ventes flash, remises sur les commandes et promotions d'expédition
• Promotions programmées : dates de début et de fin configurées dans Odoo

---

Questions fréquemment posées

Le connecteur prend-il en charge les annonces d'enchères eBay ?

Le connecteur importe les commandes des listes d'enchères, tout comme les listes à prix fixe. Cependant, la création et la gestion des annonces d'enchères (définition du prix de départ, du prix de réserve, de la durée) via le connecteur sont limitées : il est préférable de gérer les enchères directement dans eBay Seller Hub. La principale capacité de gestion des annonces du connecteur concerne les annonces à prix fixe / GTC.

Comment le connecteur gère-t-il les paiements gérés par eBay (traitement des paiements eBay) ?

Depuis 2021, eBay traite tous les paiements via des paiements gérés par eBay. Le connecteur importe le total des commandes, y compris le prix de paiement d'eBay (prix de l'article + frais d'expédition). eBay verse le produit net (après frais) sur votre compte bancaire. Le connecteur prend en charge l'importation de rapports de paiement eBay pour le rapprochement, créant automatiquement des écritures de journal qui tiennent compte des frais eBay déduits des paiements.

Puis-je synchroniser les produits d'Odoo avec plusieurs boutiques eBay (différents comptes vendeur) ?

Oui. Créez plusieurs configurations de boutique eBay, chacune avec ses propres informations d'identification OAuth. Les produits peuvent être répertoriés simultanément dans plusieurs magasins avec des remplacements de prix spécifiques au magasin. L'inventaire est suivi globalement dans Odoo et alloué aux listes de chaque magasin en fonction de règles configurées.

Qu'arrive-t-il à l'historique de mes annonces eBay (avis, nombre de ventes) lorsque je mets à jour une annonce ?

Les mises à jour standard des annonces (prix, quantité, description, images) préservent l'historique des annonces et le nombre de ventes. Actions qui réinitialisent l'historique : fin et remise en vente, modification de la catégorie eBay pour certaines catégories. Le connecteur utilise le point de terminaison « offre de mise à jour » de l'API eBay Inventory pour les modifications de routine, ce qui préserve l'historique.

Comment le connecteur gère-t-il les ventes eBay internationales et les exigences douanières ?

Pour les ventes transfrontalières via eBay International Shipping ou GSP (Global Shipping Program), le connecteur marque l'ordre de vente avec le pays de l'acheteur. Vous configurez les positions fiscales et le traitement fiscal appropriés dans Odoo pour les ventes internationales. Les commandes GSP sont expédiées au centre de distribution national d'eBay ; la documentation douanière est gérée par le programme GSP d'eBay et non par vos opérations.

---

Prochaines étapes

La gestion des opérations eBay via Odoo élimine la saisie manuelle des données, évite les erreurs d'inventaire et vous offre une source unique de vérité pour tous les canaux de vente. Le connecteur ECOSIRE eBay est conçu pour Odoo 19 Enterprise et inclut une prise en charge complète des dernières API REST d'eBay.

Obtenez le connecteur eBay ECOSIRE pour Odoo 19 →

Chaque achat comprend la licence du module, la documentation d'installation et l'accès à notre équipe d'assistance à la mise en œuvre pour que votre synchronisation eBay-Odoo fonctionne correctement dès le premier jour.