Comment connecter Dolibarr à votre boutique e-commerce (WooCommerce/PrestaShop)
   05/07/2026 00:00:00     Wiki Dolibarr    0 Commentaires
Comment connecter Dolibarr à votre boutique e-commerce (WooCommerce/PrestaShop)

Lorsqu'une entreprise vend en ligne, deux mondes coexistent souvent : celui de la boutique e-commerce (WooCommerce, PrestaShop, Shopify, Magento…) qui gère le front-office et les commandes web, et celui de l'ERP/CRM Dolibarr qui pilote le back-office (stocks, comptabilité, facturation, fournisseurs, RH). Tant que ces deux systèmes ne communiquent pas, vous perdez du temps, multipliez les saisies manuelles et accumulez les risques d'erreurs : surstocks, ruptures, factures incohérentes, frustrations clients.

La solution ? Connecter Dolibarr à votre boutique e-commerce pour automatiser la synchronisation des produits, stocks, commandes, clients, prix et taxes. Dans ce guide fonctionnel complet, NEXT GESTION vous explique comment réussir cette intégration avec WooCommerce et PrestaShop, les deux solutions e-commerce open source les plus utilisées en Europe. Nous aborderons les choix d'architecture, les flux à mettre en place, les bonnes pratiques métier, la sécurité et la performance, sans entrer dans le détail du code mais en restant suffisamment précis pour piloter un projet d'intégration.

Sommaire

  1. Pourquoi connecter Dolibarr à votre e-commerce ?
  2. Vue d'ensemble fonctionnelle de l'intégration
  3. Les différentes approches de connexion
  4. Prérequis et préparation du projet
  5. Choisir les flux à synchroniser
  6. Connexion à WooCommerce : les points clés
  7. Connexion à PrestaShop : les points clés
  8. Synchronisation du catalogue produits
  9. Synchronisation des stocks
  10. Synchronisation des commandes
  11. Synchronisation des clients
  12. Gestion des prix, promotions et multi-devises
  13. Gestion des taxes et de la TVA intracommunautaire
  14. Synchronisation en temps réel ou différée
  15. Sécuriser l'intégration
  16. Performance et scalabilité
  17. Pilotage, suivi et indicateurs
  18. Maintenance et évolutions
  19. Erreurs courantes et bonnes pratiques
  20. Conclusion

1. Pourquoi connecter Dolibarr à votre e-commerce ?

Avant de plonger dans la mise en œuvre, rappelons les bénéfices concrets d'une telle intégration :

  • Suppression de la double saisie : une commande passée sur WooCommerce remonte automatiquement dans Dolibarr, sans intervention humaine.
  • Fiabilité des stocks : un produit vendu en ligne décrémente immédiatement le stock dans l'ERP, et un réapprovisionnement enregistré dans Dolibarr met à jour la disponibilité affichée sur le site.
  • Facturation automatisée : les factures sont générées et numérotées dans Dolibarr selon votre plan comptable, dans le respect des obligations légales.
  • Vision client unifiée : un seul tiers Dolibarr regroupe les commandes web, magasin, téléphone et marketplace. Vous disposez enfin d'une vue 360° du client.
  • Gestion comptable conforme : la comptabilité est tenue dans Dolibarr, source de vérité légale et fiscale.
  • Scalabilité : un même Dolibarr peut piloter plusieurs boutiques (WooCommerce + PrestaShop + B2B) simultanément, et vous pouvez ouvrir un nouveau canal sans refondre votre système d'information.
  • Productivité des équipes : vos collaborateurs passent moins de temps à recopier des données et plus de temps à servir les clients, à analyser les ventes ou à animer les promotions.

L'investissement initial est rapidement amorti dès quelques dizaines de commandes par jour, et le retour sur investissement augmente avec la croissance de votre activité.

2. Vue d'ensemble fonctionnelle de l'intégration

Une intégration robuste repose sur une vision claire des flux d'information à mettre en place entre Dolibarr et la boutique. Schématiquement, deux directions de flux coexistent.

Flux Dolibarr → e-commerce (descendant)

C'est le sens où Dolibarr alimente la boutique :

  • Catalogue produits : référence, libellé, description, catégorie, photos, attributs et fiches techniques.
  • Stocks : quantités disponibles par entrepôt et par variante.
  • Prix : tarifs publics, prix par groupe client, prix dégressifs, prix promotionnels.
  • Promotions et codes de réduction.
  • Statuts de commande : passage de « préparée » à « expédiée », numéro de suivi.

Flux e-commerce → Dolibarr (ascendant)

C'est le sens où la boutique alimente Dolibarr :

  • Nouvelles commandes : lignes, options, frais de port, taxes, total, mode de paiement.
  • Nouveaux clients : comptes, adresses de facturation et de livraison.
  • Statuts de paiement : confirmé, annulé, remboursé.
  • Avoirs et retours.
  • Avis et messages clients (selon configuration).

Le rôle du connecteur

Le connecteur est la pièce centrale qui orchestre ces flux. Il peut prendre la forme d'un module installé dans Dolibarr, d'un service intermédiaire (middleware) ou d'un développement sur mesure. Quelle que soit sa forme, il doit réaliser trois missions essentielles : traduire les concepts de chaque système (un produit Dolibarr ≠ un produit WooCommerce dans son modèle de données), transporter les données de façon fiable et sécurisée, et réconcilier régulièrement les écarts qui ne manqueront pas d'apparaître.

3. Les différentes approches de connexion

Trois grandes approches s'offrent à vous selon votre volumétrie, votre budget et la complexité de vos règles métier.

Modules clés en main

Dolibarr et ses partenaires proposent des modules connecteurs disponibles sur le Dolistore. Ils existent pour WooCommerce, PrestaShop, Magento et d'autres plateformes. Avantages : installation rapide, prix accessible (souvent moins de 200 €), maintenance assurée par l'éditeur. Limites : couverture fonctionnelle parfois incomplète, peu de personnalisation possible. C'est l'approche idéale pour un projet pilote ou une boutique aux règles standards.

Middleware d'intégration

Les outils comme Make, n8n, Zapier ou Tray.io permettent de créer des scénarios de synchronisation sans développement. Ils centralisent la logique de mapping et offrent un suivi visuel des flux. Avantages : flexibilité, suivi et monitoring intégrés, possibilité de connecter d'autres outils (CRM, marketing, comptabilité). Limites : coût mensuel proportionnel au volume, dépendance à un fournisseur tiers. Approche pertinente pour les structures qui souhaitent piloter plusieurs intégrations à la fois.

Développement sur mesure

Pour les besoins très spécifiques (B2B avec catalogues différenciés, multi-marques, multi-devises avancé, règles tarifaires complexes), un connecteur dédié développé pour votre contexte reste la solution la plus flexible. Avantages : couverture fonctionnelle totale, performance optimisée, propriété du code. Limites : coût initial plus élevé, nécessité d'une maintenance continue. C'est l'approche que NEXT GESTION privilégie pour les projets exigeants.

Le bon choix dépend principalement de trois critères : le volume de commandes, la complexité de vos règles métier et votre capacité à internaliser une partie de la maintenance.

4. Prérequis et préparation du projet

Un projet d'intégration réussi commence bien avant la première ligne de configuration.

Audit fonctionnel

Posez-vous les bonnes questions : combien de produits avez-vous ? combien de commandes par jour ? quelles règles tarifaires appliquez-vous ? avez-vous des variantes (taille/couleur) ? plusieurs entrepôts ? plusieurs devises ? une activité B2B avec autoliquidation ? Listez précisément les cas particuliers et les exceptions : ce sont eux qui font basculer un projet du simple au complexe.

Choix de la source de vérité

Pour chaque type de donnée, désignez une source de vérité unique :

  • Produits : généralement Dolibarr, qui pousse les fiches vers la boutique.
  • Stocks : Dolibarr est maître, la boutique reflète ce qu'il dit.
  • Commandes : la boutique est maître, Dolibarr reçoit.
  • Clients : selon les cas, mais en général, le tiers Dolibarr est consolidé à partir des comptes boutique.
  • Comptabilité et factures : exclusivement Dolibarr.

Sans cette règle, vous courez à des conflits insolubles.

Versions et compatibilité

Vérifiez que vos versions sont à jour et compatibles entre elles. Dolibarr 19 ou 20, WooCommerce 8 ou 9, PrestaShop 8 sont les combinaisons les plus stables aujourd'hui. Toute version plus ancienne devrait être mise à jour avant le projet.

Environnements

Préparez impérativement un environnement de pré-production identique à la production : base de données copiée, données réelles anonymisées, mêmes versions, mêmes modules. Tous les tests d'intégration s'y dérouleront. Ne testez jamais un nouveau connecteur directement en production.

Cartographie des données

Documentez précisément la table de correspondance : quelle propriété WooCommerce/PrestaShop correspond à quel champ Dolibarr ? quelles transformations appliquer (conversion HT/TTC, regroupement de catégories, format de date, devise) ? Cette cartographie est la pierre angulaire du projet.

5. Choisir les flux à synchroniser

Plutôt que de tout synchroniser d'emblée, il est plus prudent de procéder par paliers. Voici un ordre de déploiement éprouvé :

  1. Catalogue produits descendant (Dolibarr → boutique) : pour s'assurer que vos références, libellés et prix sont cohérents.
  2. Stocks descendants : la boutique reflète les disponibilités réelles.
  3. Commandes ascendantes : les commandes web créent des commandes dans Dolibarr.
  4. Clients ascendants : les nouveaux comptes web créent ou enrichissent les tiers Dolibarr.
  5. Statuts de commande descendants : Dolibarr informe la boutique de l'expédition.
  6. Factures et avoirs : selon vos process, génération automatique dans Dolibarr et envoi au client.

Chaque palier est validé en pré-production avant d'être passé en production. Cette approche incrémentale réduit considérablement les risques et permet à vos équipes de monter en compétence progressivement.

6. Connexion à WooCommerce : les points clés

WooCommerce, extension de WordPress, équipe environ un tiers des sites e-commerce mondiaux. C'est une plateforme particulièrement riche grâce à son écosystème de plugins, mais cela complexifie aussi l'intégration.

Points d'attention fonctionnels

  • Permaliens WordPress : ils doivent être configurés en mode « Nom de l'article » pour que les flux fonctionnent correctement.
  • Comptes utilisateur : un compte applicatif dédié, distinct de l'administrateur, doit être créé pour le connecteur. Il porte les permissions strictement nécessaires (lecture/écriture sur les produits, commandes, clients).
  • Gestion des stocks : activez-la dans WooCommerce et choisissez le mode « par produit » ou « par variation » selon votre catalogue.
  • Classes fiscales : créez explicitement les classes correspondant à vos taux de TVA et mappez-les vers Dolibarr.
  • Statuts personnalisés : si vous utilisez des statuts de commande spécifiques (préparation, expédition partielle…), prévoyez un mapping vers les statuts Dolibarr équivalents.

Particularités à anticiper

WooCommerce gère les produits variables avec des variations attachées (taille/couleur). Le mapping avec le module Variants de Dolibarr demande une attention particulière. De même, les frais de livraison sont des lignes spécifiques sur la commande WooCommerce qu'il faut traduire correctement (article de service ou ligne libre dans Dolibarr).

Enfin, WooCommerce expose des événements que la boutique peut envoyer à Dolibarr : commande créée, commande mise à jour, client créé… Ces événements évitent d'interroger périodiquement la boutique et garantissent une mise à jour quasi instantanée.

7. Connexion à PrestaShop : les points clés

PrestaShop est une plateforme française très répandue en Europe, particulièrement adaptée aux catalogues riches et aux activités multi-boutiques.

Points d'attention fonctionnels

  • Webservice : il doit être explicitement activé dans les paramètres avancés, et une clé d'accès dédiée au connecteur doit être créée avec les droits adaptés (produits, catégories, clients, adresses, commandes, stocks, taxes, fabricants).
  • Multi-boutiques : si vous gérez plusieurs boutiques sous une même installation PrestaShop, précisez à quel id_shop chaque flux s'applique.
  • Multi-langues : les libellés produits sont multilingues. Décidez quelle langue est maîtresse dans Dolibarr et configurez le mapping avec les id_lang PrestaShop correspondants.
  • Combinaisons : équivalent des variations WooCommerce, elles correspondent aux déclinaisons d'un produit (taille, couleur). Le mapping vers les variantes Dolibarr est spécifique.
  • Carriers : les transporteurs PrestaShop doivent être mappés vers les modes d'expédition Dolibarr.

Particularités à anticiper

PrestaShop sépare strictement le client et ses adresses : un même client peut avoir plusieurs adresses de facturation et de livraison. Cette séparation se reflète bien dans Dolibarr (tiers + contacts), mais demande de bien orchestrer la création conjointe des entités lors d'une nouvelle commande.

PrestaShop applique également des règles de taxe par groupe (id_tax_rules_group) qui dépendent du pays de livraison. Le connecteur doit donc intégrer la logique OSS européenne pour les ventes intracommunautaires B2C.

8. Synchronisation du catalogue produits

Le catalogue est généralement le premier flux à mettre en place. Quelques règles d'or :

La référence produit, clé de tout

La référence interne (SKU) doit être unique et identique des deux côtés. C'est elle qui sert d'identifiant pivot. Il est recommandé de la générer dans Dolibarr selon une nomenclature cohérente (par exemple CAT-FAM-NUM) puis de la pousser vers la boutique. Si vous migrez d'un e-commerce existant, alignez d'abord les références avant tout.

Les informations enrichies

Au-delà des champs de base (nom, prix, description), pensez aux éléments qui font la qualité du catalogue en ligne :

  • Description courte et description longue (souvent en HTML).
  • Catégorie principale et catégories secondaires.
  • Marque ou fabricant.
  • Caractéristiques techniques (poids, dimensions, matière…).
  • Mots-clés SEO.
  • Photos principales et galerie d'images.
  • Documents associés (notice, fiche technique).

Tous ces éléments peuvent être gérés dans Dolibarr via les champs natifs et les champs supplémentaires (extrafields), puis poussés vers la boutique.

Cycle de vie d'un produit

Définissez clairement les statuts : un produit en brouillon dans Dolibarr ne doit pas apparaître en boutique. Un produit obsolète doit être désactivé sur le site mais conservé dans l'ERP pour l'historique. Un produit promotionnel peut avoir une période de validité.

Les images

La synchronisation des images est souvent négligée mais représente un volume de données important. Il est crucial d'optimiser les formats (WebP recommandé), de respecter les dimensions imposées par la boutique et de prévoir une montée en charge progressive lors de la première synchronisation.

9. Synchronisation des stocks

La gestion des stocks est le point critique de toute intégration e-commerce. Une rupture découverte au moment de l'expédition est l'une des principales sources de mécontentement client.

Modes de calcul du stock affiché

Plusieurs stratégies sont possibles :

  • Stock unique consolidé : la boutique reçoit la somme de tous les entrepôts. Idéal si vous expédiez depuis un seul site.
  • Stock par entrepôt : utile si vous avez plusieurs sites logistiques avec des règles d'expédition par zone géographique.
  • Stock virtuel : tient compte des commandes clients en attente et des commandes fournisseurs prévues, pour donner une vision dynamique.
  • Stock avec buffer : on retire systématiquement quelques unités du stock affiché pour absorber les latences entre les deux systèmes.

Le buffer de sécurité est particulièrement recommandé pour les produits à forte rotation, où le risque de survente est élevé.

Prévention de la survente

Pour limiter au maximum les sur-ventes :

  • Activez la réservation au panier dans WooCommerce/PrestaShop : le stock est immobilisé dès que le produit entre dans le panier.
  • Configurez la synchronisation immédiate au moment de la commande : la boutique notifie Dolibarr instantanément, et Dolibarr renvoie le nouveau stock à la boutique.
  • Mettez en place une alerte lorsqu'un produit passe sous un seuil critique (par exemple stock = 3) pour anticiper le réapprovisionnement.

Fréquence de synchronisation

Une synchronisation toutes les 5 à 15 minutes est généralement suffisante, complétée par un événement immédiat à chaque commande. Une synchronisation totale du catalogue peut être planifiée la nuit pour rattraper d'éventuelles divergences.

10. Synchronisation des commandes

C'est le flux le plus visible : chaque commande passée sur la boutique doit déclencher la création d'une commande dans Dolibarr.

Le scénario type

Lorsqu'un client valide son panier et paie, la boutique transmet à Dolibarr l'ensemble des informations de la commande : client, adresses, lignes, frais de port, remises, taxes, total, mode de paiement, statut. Dolibarr exécute alors plusieurs opérations en chaîne :

  1. Recherche ou création du tiers correspondant (par email, numéro de TVA ou identifiant boutique).
  2. Création de la commande client dans Dolibarr avec toutes ses lignes.
  3. Validation automatique ou en attente de contrôle, selon votre paramétrage.
  4. Décrément des stocks dans le bon entrepôt.
  5. Génération de la facture dès la confirmation du paiement.
  6. Création éventuelle de l'expédition lorsque la commande passe en préparation.

Mapping des modes de paiement

Chaque mode de paiement boutique (carte bancaire via Stripe, PayPal, virement, chèque, paiement à la livraison) doit être mappé vers un mode de paiement Dolibarr correspondant. Cela garantit la cohérence comptable et la lisibilité des rapports.

Mapping des statuts de commande

Les statuts WooCommerce/PrestaShop ne correspondent pas exactement aux statuts Dolibarr. Vous devez définir une table de correspondance :

  • En attente → Brouillon ou Validée selon le règlement.
  • En cours → Validée + en préparation.
  • Terminée → Livrée et facturée.
  • Annulée → Annulée.
  • Remboursée → Avoir généré.

Cas particuliers

Plusieurs situations méritent une attention particulière : les commandes mixtes (produits stock + services), les commandes avec acompte, les commandes pré-payées ou différées, les annulations partielles. Documentez chacun de ces cas dans le cahier des charges et testez-les en pré-production.

11. Synchronisation des clients

Un client e-commerce devient un tiers dans Dolibarr. Plusieurs cas se présentent.

Compte invité ou compte enregistré

Une commande peut être passée par un client qui crée un compte ou par un visiteur en mode invité. Dans les deux cas, Dolibarr doit créer un tiers, mais avec des règles différentes : un compte enregistré peut être consolidé avec ses commandes futures, tandis qu'un invité peut être considéré comme un tiers ponctuel.

Déduplication

Pour éviter les doublons, le connecteur doit chercher avant de créer. Les critères de déduplication sont en général : email exact, numéro de TVA intracommunautaire, identifiant boutique. Sans cette logique, vous accumulez des fiches dupliquées qui rendent vos analyses inopérantes.

Cas du B2B

Pour les clients professionnels, validez le numéro de TVA intracommunautaire auprès du service européen VIES. Un numéro valide ouvre droit à l'autoliquidation et donc à une facturation hors taxes. Un numéro invalide doit être rejeté ou marqué comme tel pour traitement manuel.

Adresses multiples

Dolibarr permet plusieurs contacts par tiers (facturation, livraison, contact technique…). La boutique doit nourrir ces contacts en respectant la sémantique : adresse de facturation, adresse de livraison, contacts éventuels pour les comptes professionnels. Cette finesse améliore beaucoup la qualité des bons de livraison et des factures.

Communications et marketing

Si vous synchronisez les clients, vous pouvez également pousser leurs préférences : opt-in marketing, newsletter, segments. Ces informations sont précieuses pour vos campagnes.

12. Gestion des prix, promotions et multi-devises

Tarification par groupe client

Dolibarr propose plusieurs niveaux de prix : prix par niveau (multiprices) et prix par client. Pour les exposer correctement en boutique, il faut décider quel niveau est public et quels niveaux sont réservés à des groupes spécifiques (revendeurs, professionnels, fidèles). WooCommerce et PrestaShop disposent de la notion de groupes clients qui se mappent à ces niveaux.

Promotions

Deux philosophies coexistent :

  • Promotion gérée dans Dolibarr : les remises sont définies dans l'ERP et propagées vers la boutique.
  • Promotion gérée dans la boutique : la boutique gère les codes promo et envoie le total réduit à Dolibarr lors de la commande.

La seconde approche est généralement plus simple. Le connecteur doit alors créer une ligne de remise dans la commande Dolibarr et conserver la traçabilité du code utilisé pour les analyses marketing.

Multi-devises

Si vous vendez en plusieurs devises, le module Multi-devises de Dolibarr doit être activé. Chaque commande conserve la devise d'origine et le taux de change appliqué au moment de l'achat. Cela permet de rapprocher correctement les paiements (souvent versés dans la devise de vente puis convertis) et la comptabilité (généralement tenue en euro).

13. Gestion des taxes et de la TVA intracommunautaire

Ventes B2C dans l'Union européenne

Depuis juillet 2021, le régime du guichet unique OSS impose d'appliquer le taux de TVA du pays de livraison dès que le seuil annuel de 10 000 € est dépassé. Cela signifie qu'une vente vers la Belgique applique 21 %, vers l'Allemagne 19 %, vers l'Italie 22 %, etc. Le connecteur doit donc :

  • Identifier le pays de livraison.
  • Appliquer le bon taux selon la matrice OSS.
  • Configurer dans Dolibarr les codes de taxe correspondants.
  • Préparer les déclarations OSS trimestrielles avec les montants par pays.

Ventes B2B intracommunautaires

Si le client B2B fournit un numéro de TVA intracommunautaire valide, la facture est en HT avec la mention obligatoire « Autoliquidation – Article 196 directive TVA 2006/112/CE ». Cela représente plusieurs implications fonctionnelles : validation du numéro VAT en amont, application d'un taux de TVA à 0 %, ajout automatique de la mention légale sur la facture PDF.

Ventes hors UE

Pour les exportations hors Union européenne, la facture est généralement en HT avec mention « Exportation – Article 262 ter du CGI ». Le connecteur doit gérer ces cas spécifiques en fonction de l'adresse du client.

Configuration des classes fiscales

Dans WooCommerce et PrestaShop, créez explicitement les classes fiscales correspondantes (standard, réduit, exonéré B2B, hors UE) et mappez-les avec précision vers les codes de taxe Dolibarr.

14. Synchronisation en temps réel ou différée

Approche par sondage

Dans cette approche, un programme s'exécute périodiquement (toutes les 5, 10 ou 15 minutes) et interroge les deux systèmes pour repérer les changements. C'est simple à mettre en place mais introduit une latence : un client peut commander à 14h00 et la commande n'arriver dans Dolibarr qu'à 14h10.

Approche événementielle

Dans cette approche, la boutique notifie Dolibarr immédiatement dès qu'un événement se produit (commande créée, paiement validé, produit modifié). Dolibarr réagit en temps réel. C'est plus complexe à orchestrer mais offre une expérience nettement supérieure, en particulier pour la gestion des stocks et la confirmation client.

Approche hybride

C'est la stratégie recommandée : événementiel pour les flux critiques (commandes, stocks, paiements), sondage de réconciliation toutes les 15 minutes pour rattraper les éventuels échecs et garantir la cohérence à long terme.

Files d'attente

Pour absorber les pics de trafic (ventes flash, soldes) sans saturer Dolibarr, intercalez une file d'attente entre la boutique et l'ERP. Les événements y sont déposés puis traités par un ou plusieurs travailleurs au rythme que Dolibarr peut soutenir. Cette architecture évite les pertes en cas de pic et permet de relancer automatiquement les traitements échoués.

Idempotence

Quel que soit le mode choisi, chaque événement doit être idempotent : recevoir deux fois la même notification ne doit pas créer deux commandes. Le connecteur conserve un journal des événements traités pour garantir cette propriété.

15. Sécuriser l'intégration

L'intégration ouvre un canal de communication sensible entre votre boutique et votre ERP. Sa sécurité ne doit jamais être négligée.

Authentification

Utilisez systématiquement des clés d'API dédiées pour le connecteur. Ne réutilisez jamais les identifiants administrateurs. Stockez ces clés dans des coffres-forts (HashiCorp Vault, gestionnaire de secrets cloud) ou des fichiers de configuration aux droits restreints, jamais en clair dans du code partagé.

HTTPS partout

Tous les échanges doivent passer en HTTPS avec TLS 1.2 minimum, idéalement TLS 1.3. Aucune exception, même en pré-production.

Restriction par adresse IP

Si possible, restreignez l'accès aux endpoints d'intégration aux seules adresses IP de la boutique (et inversement). Cela limite considérablement la surface d'attaque.

Signature des notifications

Chaque notification envoyée par la boutique doit être signée avec un secret partagé. Le connecteur vérifie cette signature avant de traiter la notification. Sans cela, n'importe qui pourrait injecter de fausses commandes dans Dolibarr.

Limitation de débit

Mettez en place un rate limiting côté Dolibarr pour qu'un connecteur défaillant (ou une attaque) ne sature pas le serveur. Au-delà d'un certain seuil de requêtes par minute, les nouvelles requêtes sont temporairement rejetées.

Journalisation

Tracez tous les événements : qui a appelé, quand, quel résultat, combien de temps cela a pris. Ces logs sont essentiels pour les audits, le débogage et la détection d'anomalies.

16. Performance et scalabilité

Pagination des échanges

Quand vous synchronisez de gros volumes (plusieurs milliers de produits ou de commandes), il est impératif de paginer les requêtes : récupérer les données par pages de 50 ou 100 plutôt qu'en une seule fois. Cela évite les timeouts et soulage le serveur.

Traitement par lots

Pour les imports massifs, utilisez les endpoints batch de WooCommerce et PrestaShop qui permettent de créer ou mettre à jour plusieurs entités en un seul appel. Le gain de performance est significatif.

Mise en cache

Certaines données changent rarement : taux de TVA, modes de paiement, catégories, transporteurs. Mettez-les en cache côté connecteur pour ne pas les redemander à chaque opération.

Indexation de la base

Côté Dolibarr, vérifiez que les champs utilisés pour la déduplication des tiers (email, numéro de TVA) et les références produits sont bien indexés. Sinon, chaque création de commande peut prendre plusieurs secondes lorsque la base grossit.

Scaling horizontal

Pour les très gros volumes (plus de 10 000 commandes par jour), prévoyez une architecture où plusieurs connecteurs peuvent traiter les événements en parallèle, derrière la même file d'attente. Dolibarr peut également être déployé derrière un load balancer avec sessions partagées.

17. Pilotage, suivi et indicateurs

Une intégration n'est pas un projet « one-shot ». Elle doit être pilotée au quotidien.

Tableau de bord opérationnel

Mettez en place un tableau de bord qui affiche :

  • Nombre de commandes synchronisées par heure.
  • Nombre de produits mis à jour.
  • Volume des écarts de stock détectés.
  • Latence moyenne des synchronisations.
  • Taille de la file d'attente.
  • Nombre d'événements en erreur.

Alertes proactives

Configurez des alertes pour les anomalies critiques : file d'attente bloquée, taux d'erreur supérieur à 5 %, pas de commande remontée depuis plus de 30 minutes en heure ouvrée. Ces alertes peuvent être envoyées par email, Slack ou Microsoft Teams.

Réconciliation périodique

Une fois par semaine, lancez un rapport de réconciliation qui compare les données entre Dolibarr et la boutique : produits manquants, écarts de prix, écarts de stock, commandes non remontées. C'est ce rapport qui détecte les dérives lentes avant qu'elles ne deviennent des problèmes critiques.

Reporting métier

Au-delà du suivi technique, alimentez vos tableaux de bord métier : chiffre d'affaires par canal (web vs magasin), produits les plus vendus en ligne, taux de panier abandonné, valeur moyenne des commandes web. Toutes ces analyses sont possibles dès lors que Dolibarr centralise les données.

18. Maintenance et évolutions

Les API et plateformes évoluent. WooCommerce, PrestaShop et Dolibarr publient régulièrement de nouvelles versions, parfois avec des changements impactants.

Versionner les flux

Vos flux d'intégration doivent toujours préciser la version d'API utilisée (v3 pour WooCommerce, par exemple). Un changement de version doit être validé en pré-production avant déploiement.

Tests automatisés

Mettez en place une suite de tests automatisés qui valide les principaux scénarios : création de produit, synchronisation de stock, création de commande, génération de facture. Cette suite est rejouée après chaque mise à jour pour détecter immédiatement les régressions.

Veille fonctionnelle

Suivez les annonces des éditeurs (notes de version Dolibarr, changelog WooCommerce, blog PrestaShop). Anticiper une évolution majeure plutôt que la subir économise un temps considérable.

Plan de continuité

Documentez un plan de continuité : que se passe-t-il si la boutique tombe en panne ? si Dolibarr est indisponible quelques heures ? si la file d'attente sature ? Avoir ces réponses prêtes réduit considérablement le stress lors d'incidents.

19. Erreurs courantes et bonnes pratiques

Au fil des projets, certains pièges reviennent souvent :

  • Sous-estimer la phase de cartographie des données : la moitié du travail est dans la définition précise des correspondances. Ne sautez pas cette étape.
  • Tester uniquement en production : c'est la garantie de problèmes graves. Investissez dans un environnement de pré-production réaliste.
  • Négliger la déduplication des tiers : en quelques semaines, vous accumulez des doublons qui rendent vos analyses inopérantes.
  • Oublier les frais de port : ils représentent souvent 10 % du chiffre d'affaires et doivent être correctement comptabilisés.
  • Ne pas anticiper les soldes ou ventes flash : le pic de charge peut faire vaciller un connecteur dimensionné pour le quotidien.
  • Manquer de monitoring : sans alertes, un connecteur en échec passe inaperçu pendant des heures voire des jours.
  • Confondre devise d'affichage et devise de facturation : peut créer des écarts comptables impossibles à rattraper.
  • Ignorer la formation des utilisateurs : un bon connecteur mal utilisé reste un mauvais outil.

À l'inverse, les bonnes pratiques structurantes sont : définir clairement les sources de vérité, déployer par paliers, tester systématiquement, monitorer en continu, et documenter tout ce qui sort de l'ordinaire.

20. Conclusion

Connecter Dolibarr à WooCommerce ou PrestaShop est un projet à fort retour sur investissement, mais qui exige rigueur fonctionnelle et vision claire. Bien fait, il transforme votre exploitation : automatisation des saisies, fiabilité des stocks, satisfaction client accrue, comptabilité simplifiée. Mal fait, il devient une source quotidienne de bugs et de frustrations.

Chez NEXT GESTION, nous accompagnons les entreprises e-commerce dans la conception, le déploiement et l'exploitation de connecteurs Dolibarr sur mesure ou basés sur des modules existants. Notre approche : audit fonctionnel approfondi, choix technologique adapté, déploiement itératif avec recette en pré-production, monitoring en production, support continu et accompagnement à la conduite du changement.

Vous avez un projet d'intégration Dolibarr ↔ e-commerce ? Contactez-nous à contact@nextgestion.com pour un audit gratuit. Nous saurons vous proposer la solution la plus adaptée à votre volumétrie, vos contraintes métiers et votre budget.

FAQ : Connecter Dolibarr à WooCommerce / PrestaShop

Combien coûte un connecteur Dolibarr e-commerce ? De 99 € pour un module Dolistore standard, à plusieurs milliers d'euros pour un développement sur mesure. Le ROI est généralement atteint en quelques mois grâce aux gains de productivité.

Faut-il choisir une synchronisation temps réel ou par lot ? Hybride. Temps réel pour les événements critiques (commandes, stocks), synchronisation périodique de réconciliation toutes les 15 min pour rattraper les éventuels échecs.

Peut-on connecter plusieurs boutiques à un même Dolibarr ? Oui, via le module MultiShop ou un middleware qui agrège les flux. Chaque boutique peut être identifiée pour la traçabilité et les analyses par canal.

Quel impact sur les performances de Dolibarr ? Avec une bonne architecture (file d'attente, cache, indexation), aucun impact perceptible jusqu'à plusieurs milliers de commandes par jour.

Comment gérer la transition depuis un connecteur existant ? Maintenir les deux en parallèle quelques semaines en mode lecture seule pour valider les écarts, puis basculer le sens d'écriture progressivement. Une réconciliation initiale par référence produit est indispensable.

Combien de temps dure un projet d'intégration ? Pour un connecteur clé en main avec configuration : 2 à 4 semaines. Pour un développement sur mesure complet : 2 à 6 mois selon la complexité.

Article rédigé par NEXT GESTION, expert en intégration Dolibarr ↔ e-commerce. Pour un audit ou un accompagnement, contactez-nous à contact@nextgestion.com.

Commentaires

Connectez-vous ou inscrivez-vous pour poster des commentaires