Connecter Dolibarr et eBay : synchronisation automatique des prix, commandes et factures

Le probleme : la saisie manuelle multi-region

Vous vendez sur eBay. Votre ERP est Dolibarr. Chaque jour, le meme scenario se repete : vous mettez a jour un prix dans Dolibarr, puis vous ouvrez l'interface Seller Hub d'eBay pour reporter le changement annonce par annonce. Quand une commande arrive sur eBay, vous la recopiez dans Dolibarr. Vous creez la facture manuellement. Vous revenez sur eBay pour marquer la commande comme expediee et saisir le numero de suivi.

Si vous vendez sur plusieurs sites eBay — par exemple eBay Allemagne, eBay France et eBay Royaume-Uni — la situation se complique encore. Chaque region a sa propre interface, sa propre devise, et ses propres politiques de vente. Mettre a jour un prix sur trois sites prend trois fois plus de temps. Importer manuellement les commandes de trois pays vers Dolibarr est une source d'erreurs garantie.

Ce processus prend des heures chaque semaine. Les erreurs de saisie s'accumulent : un prix mal recopie, une commande oubliee, un numero de suivi inverse. Plus votre catalogue grossit, plus la situation devient intenable. A 50 produits, c'est penible. A 500, c'est un emploi a temps plein. Et a chaque variante, promotion ou nouvelle annonce, tout recommence.

Le vrai cout n'est pas seulement le temps perdu — c'est le risque. Un prix errone sur eBay pendant 24 heures peut generer des commandes a perte. Une facture oubliee fausse votre comptabilite. Un numero de suivi manquant declenche des reclamations et des cas d'Item Not Received. Et eBay est tres strict sur les delais de remise des numeros de suivi.

Ce qui rend eBay different des autres marketplaces

Si vous avez deja integre Shopify, WooCommerce ou PrestaShop avec Dolibarr, il y a plusieurs particularites a connaitre cote eBay :

OAuth au lieu d'une cle API. Avec Shopify ou WooCommerce, vous generez une cle API et la collez dans le module Dolibarr. eBay fonctionne differemment : vous cliquez sur un bouton Connecter eBay, vous etes redirige vers la page de consentement d'eBay, vous vous identifiez avec votre compte vendeur eBay habituel, et c'est tout. Aucune cle a copier-coller, aucun compte developpeur eBay a creer. ERPkit gere toute la partie credentials developpeur sur sa propre infrastructure.

Une configuration de synchronisation par region. eBay traite chaque site regional (eBay.de, eBay.fr, eBay.co.uk, etc.) comme un univers separe avec sa propre devise et ses propres politiques. Avec ERPkit, vous creez une configuration de synchronisation par region. Vous pouvez reutiliser le meme compte vendeur eBay pour vous connecter sur plusieurs regions — chaque configuration maintient son propre lien SKU / prix / stock. Cela permet aussi d'avoir des prix differents par region (en EUR pour DE/FR/IT/ES, en GBP pour UK, etc.).

Deux identifiants, un par phase. ERPkit utilise deux identifiants eBay distincts, et les confondre est la source de configuration la plus frequente. Phase 1 (push) utilise l'ID d'annonce eBay — vous le saisissez dans le champ extrafield ebay_{region}_listing_id sur chaque produit Dolibarr, et ERPkit appelle l'Inventory API d'eBay pour mettre a jour prix et stock par cet ID. Phase 2 (import) utilise le SKU — quand une commande eBay arrive, ERPkit lit le SKU de chaque ligne et cherche un produit Dolibarr dont ref correspond a ce SKU (sensible a la casse). Si le SKU de votre annonce eBay ne correspond pas a votre ref Dolibarr, la Phase 1 envoie prix/stock correctement, mais les lignes de commande eBay arrivent dans Dolibarr en texte libre sans lien produit. Regle de base : creez votre annonce eBay avec SKU = ref Dolibarr, puis saisissez l'ID d'annonce dans le champ extrafield — les deux phases fonctionnent de bout en bout.

Les Business Policies sont obligatoires. ERPkit utilise l'Inventory API d'eBay, qui exige que votre compte vendeur soit configure avec les Business Policies (politiques de paiement, livraison et retour). Si elles ne sont pas activees, la synchronisation s'arrete proprement au cycle suivant avec un avertissement not_api_compatible. C'est une configuration a faire une seule fois, en quelques minutes, dans le Seller Hub eBay.

Pas de webhook : eBay est interroge a intervalle regulier. ERPkit ne recoit pas de notification push d'eBay. A chaque cycle (toutes les 3 a 8 heures selon votre formule), ERPkit interroge eBay pour recuperer les nouvelles commandes et pousser les changements de prix. C'est conforme a la philosophie generale d'ERPkit : pas de dependance fragile aux webhooks de tiers.

Configurer ERPkit en 6 etapes

Etape 1 : activer les Business Policies sur eBay

Connectez-vous au Seller Hub Business Policies. Si vous n'avez pas encore active les Business Policies, suivez les instructions pour opter in — c'est gratuit. Creez au moins une politique de paiement, une politique de livraison et une politique de retour. eBay vous guide pas a pas lors du premier passage.

Sans cette etape, l'Inventory API d'eBay n'est pas accessible et la synchronisation ERPkit s'interrompt avec un avertissement clair des le premier cycle. Faites-la avant de continuer.

Etape 2 : installer le module Dolibarr gratuit

Telechargez le module ERPkit depuis le DoliStore (gratuit, open source GPL v3). Dans Dolibarr, allez dans Accueil > Configuration > Modules/Applications et activez le module ERPkit. Il ajoute des champs de synchronisation a vos fiches produits et une page de configuration pour vos marketplaces.

Pour eBay specifiquement, contrairement aux autres marketplaces, vous n'avez rien a saisir comme credentials dans le module Dolibarr — eBay utilise OAuth, donc le module a seulement besoin de savoir quelle(s) region(s) eBay vous allez synchroniser pour afficher les bons champs sur vos produits.

Ouvrez la page de configuration ERPkit dans Dolibarr et cochez la ou les regions eBay sur lesquelles vous vendez (par exemple eBay Allemagne). Le module cree alors trois extrafields par region selectionnee : ebay_de_listing_id, ebay_de_price, ebay_de_compare_price pour eBay Allemagne, et ainsi de suite. Si vous vendez sur trois regions, vous avez trois jeux de trois champs.

Etape 3 : creer un compte ERPkit (gratuit)

Rendez-vous sur app.erpkit.app et creez votre compte. L'offre Solo gratuite est disponible aussi pour eBay — vous pouvez tester l'integration sur une region avant de souscrire a une formule payante.

Etape 4 : creer la configuration de synchronisation eBay et connecter via OAuth

Dans le catalogue de plugins ERPkit, ouvrez la carte Connecter a eBay. Vous voyez les 10 regions disponibles (DE, FR, GB, IT, ES, US, NL, BE, AT, CH). Choisissez celle qui correspond a votre site de vente eBay. Souscrivez a la formule qui vous convient (l'offre Solo gratuite est disponible) puis cliquez sur Creer une configuration de synchronisation.

Dans l'assistant de configuration, saisissez l'URL de votre Dolibarr et votre cle API Dolibarr (cote ERPkit, c'est exactement le meme processus que pour Shopify, WooCommerce ou PrestaShop). Ensuite, sur la page de detail de la configuration, vous trouvez un panneau Connexion eBay avec un bouton Connecter eBay.

Cliquez sur ce bouton. Vous etes redirige vers la page de consentement d'eBay dans le meme onglet de navigateur. Identifiez-vous avec votre compte vendeur eBay, validez les permissions demandees (lecture inventaire, lecture commandes, ecriture expeditions, lecture des Business Policies), et cliquez sur Agree. eBay redirige votre navigateur vers ERPkit, le panneau passe au vert avec votre nom d'utilisateur eBay, et la connexion est etablie.

Ce que ERPkit a stocke : un refresh token chiffre (AES-256-GCM) avec une duree de vie de 1,5 an. eBay ne renouvelle pas automatiquement ce token, donc ERPkit affiche une banniere 14 jours avant l'expiration pour vous demander de vous reconnecter.

Etape 5 : associer vos produits (mapping automatique par SKU)

ERPkit peut associer automatiquement vos produits Dolibarr a vos annonces eBay en comparant les SKU. Ouvrez l'onglet Mapping produits, lancez le matching automatique, et verifiez les associations proposees. ERPkit remplit alors le champ ebay_{region}_listing_id (par exemple ebay_de_listing_id) avec l'ID d'annonce eBay correspondant.

Pour les cas particuliers, vous pouvez aussi saisir manuellement l'ID d'annonce eBay dans le champ extrafield de la fiche produit Dolibarr. Attention : le champ listing ID sert a l'affichage et a l'auto-mapping, mais la cle de synchronisation reelle reste le SKU. Verifiez toujours que le SKU dans Dolibarr (ref) correspond exactement au SKU dans l'annonce eBay.

Etape 6 : lancer votre premiere synchronisation

Tout est pret. Depuis le detail de votre configuration, lancez la synchronisation. ERPkit envoie les prix, les prix barres (si eligibles au Strikethrough Pricing eBay), le poids et le code-barres de Dolibarr vers eBay. Seuls les produits modifies sont envoyes grace a la sync delta intelligente — les synchronisations suivantes sont quasi instantanees.

Au premier cycle, ERPkit fait egalement les deux verifications de pre-vol : la quota de l'API eBay (5 000 appels/jour par defaut) et les Business Policies. Si tout est bon, le cycle continue. Sinon, vous voyez un avertissement explicite dans le journal de synchronisation, vous corrigez, et le cycle suivant reprend tout seul.

Et ensuite ?

Une fois la synchronisation produits en place, ERPkit gere aussi :

• Import des commandes eBay — Les commandes eBay payees arrivent automatiquement dans Dolibarr, avec correspondance des clients par email et liaison des produits par SKU. Vous pouvez choisir, depuis l'onglet Statuts de commande, lesquels des statuts eBay (PAID, PENDING, FAILED, etc.) sont importes.
• Generation des factures — Les factures Dolibarr sont creees, validees et marquees comme payees automatiquement a partir des commandes eBay importees.
• Expedition — Quand vous validez une expedition dans Dolibarr, ERPkit envoie le statut et le numero de suivi vers eBay via l'API Sell Fulfillment. La liste des transporteurs proposes est recuperee en direct depuis l'API metadata d'eBay pour votre region, donc le dropdown ERPkit reste a jour avec ce qu'eBay supporte (quelques formats de numero de suivi specifiques peuvent encore etre rejetes au cas par cas — le message d'erreur indique alors un transporteur alternatif a essayer).
• Factur-X — Generez des factures electroniques conformes (PDF/A-3 avec XML CII integre) pour anticiper les obligations europeennes de facturation electronique (en vigueur a partir de septembre 2026).

Important : ERPkit envoie uniquement les prix, le poids, le code-barres et le stock vers eBay. Les titres, descriptions, photos, item-specifics, politiques (paiement, livraison, retour), categorie et condition de vos annonces eBay ne sont jamais modifies.