Connecter Dolibarr et Cdiscount : synchronisation automatique des prix, de l'eco-taxe et des commandes

Le probleme : la double saisie Cdiscount

Vous vendez sur Cdiscount. Votre ERP est Dolibarr. Entre les deux, le meme rituel se repete chaque jour : vous changez un prix dans Dolibarr, puis vous ouvrez le back-office vendeur Cdiscount pour reporter le changement offre par offre. Une commande arrive sur Cdiscount, vous la recopiez dans Dolibarr. Vous creez la facture a la main. Vous retournez sur Cdiscount marquer la commande comme expediee et saisir le numero de suivi.

Cdiscount ajoute une difficulte que les autres marketplaces n'ont pas : l'eco-taxe obligatoire. Chaque offre doit porter une eco-participation (EcoTax) et, pour les produits electriques et electroniques, une taxe DEEE (DeaTax). Gerer ces montants offre par offre, en plus du prix et du stock, multiplie les occasions d'erreur.

Ce processus prend des heures chaque semaine. Les erreurs s'accumulent : un prix mal recopie, une eco-taxe oubliee, une commande non importee, 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.

Le vrai cout n'est pas seulement le temps perdu — c'est le risque. Un prix errone sur Cdiscount pendant 24 heures peut generer des commandes a perte. Une eco-taxe mal renseignee peut faire rejeter votre offre. Une facture oubliee fausse votre comptabilite. ERPkit supprime cette double saisie : Dolibarr devient la source unique de verite, et la synchronisation se fait toute seule.

Ce qui rend Cdiscount different des autres marketplaces

Si vous avez deja integre Shopify, WooCommerce ou PrestaShop avec Dolibarr, trois particularites distinguent Cdiscount :

Cdiscount fonctionne via la plateforme Octopia. Cdiscount est operee techniquement par la plateforme Octopia. ERPkit dialogue donc avec l'API Seller d'Octopia. Cote ERPkit, l'authentification est particuliere : ERPkit utilise ses propres identifiants plateforme (un Client ID et un Secret detenus sur son infrastructure, partages entre tous les vendeurs), et il agit pour votre compte grace a votre Seller ID Octopia. Concretement, vous ne saisissez ni cle API ni secret : seulement votre Seller ID, dans le module Dolibarr. C'est different d'eBay (qui passe par une connexion OAuth) et de Shopify/WooCommerce (qui demandent votre propre cle API).

L'eco-taxe est obligatoire sur chaque offre. C'est la seule marketplace ERPkit ou chaque offre porte deux lignes de taxe en plus de la TVA : EcoTax (eco-participation, emballage et recyclage) et DeaTax (taxe DEEE pour les equipements electriques et electroniques). ERPkit lit ces montants depuis deux extrafields dedies sur la fiche produit Dolibarr — erpkit_ecotax_fr et erpkit_deatax_fr — et les envoie a chaque synchronisation. Point d'attention essentiel : un champ vide est synchronise comme 0, et 0 ecrase la valeur cote Cdiscount. ERPkit affiche un rappel permanent sur la page de synchronisation, que vous pouvez replier mais jamais perdre. Renseignez ces champs avant de synchroniser. Si vous suivez deja l'eco-taxe dans un champ Dolibarr a vous, vous pouvez le mapper depuis l'onglet Tarification > Champs eco-taxe.

L'ecriture des offres est asynchrone. Contrairement aux marketplaces qui appliquent chaque mise a jour aussitot, Cdiscount fonctionne par paquets d'offres. A chaque cycle, ERPkit cree un paquet, y depose vos offres modifiees (prix, TVA, EcoTax, DeaTax, stock), soumet le paquet, puis interroge Octopia jusqu'a ce que le paquet atteigne l'etat Integrated. ERPkit lit alors les resultats offre par offre. C'est un peu plus long, mais la barre de progression vous montre l'avancement, et si un paquet n'est pas integre dans le delai, les offres concernees sont simplement reessayees au cycle suivant : aucune donnee n'est perdue.

La cle de synchronisation est votre reference produit. Pour Cdiscount, ERPkit fait correspondre la reference de votre produit Dolibarr (ref) au sellerProductId d'Octopia. Gardez les deux identiques : c'est ce qui permet de reconcilier les resultats d'offres (Phase 1) et de relier les lignes des commandes importees a vos produits (Phase 2). Le lien d'offre lui-meme se saisit dans le champ cdiscount_variant_id.

Configurer ERPkit en 6 etapes

Etape 1 : autoriser ERPkit aupres de votre compte Octopia

Cdiscount/Octopia repose sur un modele plateforme : ERPkit s'authentifie avec ses propres identifiants Octopia et agit pour votre compte grace a votre Seller ID. Vous ne creez aucune cle : vous donnez une seule fois a l'application ERPkit l'acces a votre compte vendeur. Ouvrez la page API Credentials Management d'Octopia et connectez-vous, choisissez I'm using a feed aggregator, puis My aggregator is not on this list et My aggregator provided me its clientId. Collez l'identifiant client d'ERPkit, ERPkit-Octopia, acceptez les conditions (Terms & Conditions) et confirmez avec votre identifiant Octopia. Notez le Seller ID affiche sur l'ecran de confirmation : vous en aurez besoin a l'etape 3. Le detail, en anglais : Setting up Cdiscount.

Etape 2 : creer un compte ERPkit (gratuit)

Rendez-vous sur app.erpkit.app et creez votre compte. Dans le catalogue de plugins ERPkit, ouvrez la carte Cdiscount France et souscrivez a la formule qui vous convient. L'offre Solo gratuite est disponible aussi pour Cdiscount.

Etape 3 : installer le module Dolibarr gratuit et saisir votre Seller ID

Sur la page Marketplace Sync d'ERPkit, cliquez sur Download Dolibarr Module (gratuit, open source GPL v3). Dans Dolibarr, allez dans Accueil > Configuration > Modules/Applications, envoyez le ZIP et activez le module ERPkit (guide d'installation).

Ouvrez la page de configuration ERPkit, choisissez Cdiscount dans + Ajouter une marketplace, saisissez votre Seller ID et cliquez sur Enregistrer. Le module cree alors les champs sur vos fiches produits : cdiscount_variant_id, cdiscount_price, cdiscount_compare_price, ainsi que les deux champs d'eco-taxe erpkit_ecotax_fr et erpkit_deatax_fr. Cote Dolibarr, vous ne stockez que votre Seller ID — aucun secret.

Etape 4 : creer la configuration de synchronisation Cdiscount

De retour dans ERPkit, cliquez sur Creer une configuration de synchronisation et saisissez l'URL de votre Dolibarr et votre cle API Dolibarr (cote ERPkit, c'est exactement le meme processus que pour les autres marketplaces). Il n'y a pas de bouton Connecter : Cdiscount utilise les identifiants plateforme plus votre Seller ID (saisi a l'etape 3), donc une fois la connexion Dolibarr validee, vous etes connecte.

Etape 5 : associer vos produits et renseigner l'eco-taxe

Sur chaque produit Dolibarr a synchroniser, renseignez le champ cdiscount_variant_id (l'identifiant de l'offre Octopia) et le champ cdiscount_price (le prix a publier). Verifiez que la reference Dolibarr (ref) correspond au sellerProductId d'Octopia. Enfin — etape propre a Cdiscount — renseignez l'eco-taxe : erpkit_ecotax_fr (EcoTax) et, si applicable, erpkit_deatax_fr (DeaTax). Rappelez-vous qu'un champ vide vaut 0 et ecrase la valeur Cdiscount.

Etape 6 : lancer votre premiere synchronisation

Tout est pret. Depuis le detail de votre configuration, lancez la synchronisation. ERPkit cree un paquet d'offres, y depose vos produits modifies (prix, TVA, EcoTax, DeaTax, stock), soumet le paquet et interroge Octopia jusqu'a l'integration. Seuls les produits modifies sont envoyes grace a la sync delta intelligente. La barre de progression vous montre l'avancement, et le journal de synchronisation classe chaque resultat : offre integree (succes), offre rejetee pour une raison corrigeable cote produit (avertissement, par exemple les codes 1008/1031 lies a l'eco-taxe), ou erreur systeme (reessayee automatiquement).

Et ensuite ?

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

• Import des commandes Cdiscount — Les commandes Cdiscount payees arrivent automatiquement dans Dolibarr, avec correspondance des clients par email et liaison des produits par reference. Vous choisissez, depuis l'onglet Statuts de commande, lesquels des statuts Octopia (Accepted, InPreparation, Shipped, Delivered, etc.) sont importes.
• Generation des factures — Les factures Dolibarr sont creees, validees et marquees comme payees automatiquement a partir des commandes importees.
• Expedition — Quand vous validez une expedition dans Dolibarr, ERPkit envoie le statut et le numero de suivi vers Cdiscount. La liste des transporteurs (Colissimo, Chronopost, Mondial Relay, etc.) est proposee dans l'onglet Mapping transporteurs.
• Factur-X — Generez des factures electroniques conformes (PDF/A-3 avec XML CII integre) pour anticiper les obligations europeennes de facturation electronique.

Important : ERPkit envoie uniquement le prix, la TVA, l'eco-taxe (EcoTax/DeaTax) et le stock vers Cdiscount. Les titres, descriptions, photos, attributs et categories de vos offres ne sont jamais modifies. ERPkit ne cree pas d'offres : elles doivent deja exister sur Cdiscount, vous les reliez via le champ cdiscount_variant_id.