Table des Matières

  1. Introduction

  2. Pourquoi intégrer Dolibarr à WooCommerce ?

  3. Présentation de l'architecture de Dolibarr et WooCommerce

  4. Méthodes d'intégration en 2025

  5. Choisir le bon connecteur ou module

  6. Utilisation de DoliWoo : le connecteur officiel

  7. Alternatives à DoliWoo

  8. Préparation de Dolibarr pour l'intégration de WooCommerce

  9. Préparation de WooCommerce pour l'intégration de Dolibarr

  10. Configuration de l'API dans Dolibarr

  11. Authentification des requêtes API

  12. Synchronisation des produits

  13. Synchronisation des clients

  14. Synchronisation des commandes et des factures

  15. Gestion des stocks et de l'inventaire

  16. Considérations fiscales (TVA) dans l'intégration

  17. Gestion des variations et des attributs

  18. Conseils d'automatisation : tâches Cron et déclencheurs de synchronisation

  19. Mappage des données et gestion des champs personnalisés

  20. Dépannage des problèmes courants

  21. Contrôle de sécurité et d'accès

  22. Optimisation des performances pour les magasins à volume élevé

  23. Stratégies de sauvegarde et de récupération

  24. Conformité juridique en France et dans l'UE

  25. Quand envisager d'embaucher un développeur

  26. Conclusion : rationaliser le commerce électronique avec un ERP

1. Introduction

En 2025, l'intégration fluide entre les plateformes e-commerce et les systèmes ERP est plus essentielle que jamais. Pour les entreprises utilisant Dolibarr comme ERP et WooCommerce pour leur boutique en ligne, combler l'écart entre les deux systèmes permet de gagner du temps, de réduire les erreurs et d'offrir une vue unifiée des opérations. Ce guide explique comment connecter Dolibarr à WooCommerce en toute simplicité, avec des informations exploitables.

2. Pourquoi intégrer Dolibarr à WooCommerce ?

L'intégration permet :

  • Synchronisation automatique des catalogues de produits

  • Mises à jour des stocks en temps réel entre le magasin et l'entrepôt

  • Flux de travail fluides de la commande à la facturation

  • Base de données clients unifiée

  • Exportations précises de TVA et de comptabilité

Sans intégration, vous êtes coincé dans une boucle sujette aux erreurs de saisie manuelle des données, de clients en double, d'inventaire obsolète et de traitement des commandes retardé.

3. Présentation de l'architecture de Dolibarr et WooCommerce

dolibarr est une plateforme ERP/CRM open source construite en PHP, modulaire par conception et prenant en charge les API REST.

WooCommerce est un plugin WordPress basé sur PHP et MySQL. Il prend en charge les API REST et utilise l'authentification WordPress standard.

Les deux plateformes peuvent communiquer via des API, des webhooks ou des intergiciels tiers. L'objectif est de garantir qu'elles parlent le même langage et restent synchronisées.

4. Méthodes d'intégration en 2025

Vous pouvez connecter Dolibarr et WooCommerce en utilisant :

  • Connecteurs natifs (par exemple, DoliWoo)

  • Intergiciel tiers (Zapier, Make, Integromat)

  • Scripts ou plugins PHP personnalisés utilisant des API

  • Plateformes iPaaS (Integration Platform as a Service)

Dans la plupart des cas, DoliWoo ou un connecteur personnalisé offre les meilleures performances et le meilleur contrôle.

5. Choisir le bon connecteur ou module

Recherchez des modules qui :

  • Sont compatibles avec Dolibarr 17+ et WordPress 6.x

  • Prise en charge de la synchronisation bidirectionnelle

  • Gérer les produits, les commandes, les stocks et les clients

  • Fournir des journaux et une gestion des erreurs

  • Sont activement maintenus

Lisez les avis et vérifiez l’activité GitHub si vous utilisez des modules communautaires.

6. Utilisation de DoliWoo : le connecteur officiel

DoliWoo est un plugin conçu pour relier WooCommerce directement à Dolibarr. Ses fonctionnalités incluent :

  • Synchronisation des commandes dans Dolibarr en tant que commandes clients ou factures

  • Créer des produits Dolibarr depuis WooCommerce

  • Synchronisation des niveaux de stock dans les deux sens

  • Mise à jour automatique des dossiers clients

L'installation implique :

  1. Installation du plugin DoliWoo dans WordPress

  2. Activation de l'API REST dans Dolibarr

  3. Génération des identifiants de l'API Dolibarr

  4. Mappage des champs de WooCommerce vers les modules Dolibarr

7. Alternatives à DoliWoo

Si DoliWoo ne répond pas à vos besoins, pensez à :

  • Synchronisation WooDolibarr: Léger, prend en charge la synchronisation de base

  • Zapier ou Make:Idéal pour une petite automatisation sans codage

  • Intégration PHP personnalisée:Pour un contrôle et une flexibilité totale

Chaque option présente des compromis en termes de performances, de support et de coût.

8. Préparation de Dolibarr pour l'intégration WooCommerce

Étapes de préparation :

  • Mettre à jour Dolibarr vers la dernière version stable

  • Activer le module API REST

  • Créer des clés API sous le profil utilisateur avec un accès limité

  • Définir les paramètres tiers par défaut pour les nouveaux clients

Assurez-vous que vos données produit et client sont propres et formatées de manière cohérente.

9. Préparation de WooCommerce pour l'intégration de Dolibarr

Du côté de WooCommerce :

  • Assurez-vous que les liens permanents sont activés

  • Utilisez HTTPS et un certificat SSL valide

  • Créez une clé API sous WooCommerce > Paramètres > Avancé > API REST

  • Choisissez l'accès en lecture/écriture pour l'intégration

Testez votre API WooCommerce avec Postman ou curl avant de vous connecter à Dolibarr.

10. Configuration de l'API dans Dolibarr

Accédez à Utilisateurs et groupes > Clés APIGénérez une nouvelle clé et définissez les autorisations :

  • Accès en lecture/écriture aux produits, commandes, tiers, factures, stock

  • Restreindre l'accès à une adresse IP spécifique ou utiliser des jetons en toute sécurité

Vous utiliserez cette clé lors de la connexion depuis WooCommerce.

11. Authentification des requêtes API

Les deux systèmes prennent en charge l'authentification par jeton ou l'authentification de base. Les pratiques sécurisées incluent :

  • Trafic HTTPS uniquement

  • Cycles d'expiration et de renouvellement des jetons

  • Journalisation des accès et des erreurs pour chaque requête

12. Synchronisation des produits

Définissez le SKU du produit comme identifiant unique. Choisissez :

  • Dolibarr pousse les produits vers WooCommerce

  • WooCommerce crée des produits dans Dolibarr

Meilleure pratique : définissez un système comme maître pour chaque type de données afin d’éviter les problèmes de synchronisation circulaire.

13. Synchronisation des clients

Les clients peuvent être mis en relation par :

  • Email

  • Champ d'identification ou de référence externe

Les nouveaux clients de WooCommerce doivent être créés automatiquement dans Dolibarr avec une gestion appropriée de la TVA et des informations régionales.

14. Synchronisation des commandes et des factures

Décidez de votre flux de travail :

  • La commande WooCommerce crée une commande client Dolibarr

  • Dolibarr génère automatiquement une facture lors du changement de statut de la commande

  • Facture PDF renvoyée à WooCommerce ou à l'e-mail du client

Cette étape garantit que votre ERP gère le cycle de vie des commandes, du devis à la livraison.

15. Gestion des stocks et de l'inventaire

Utilisez le module Entrepôt de Dolibarr pour gérer les niveaux de stock. L'intégration permet :

  • Déduire le stock lors de la commande WooCommerce

  • Synchronisez les stocks mis à jour chaque nuit ou en temps réel

Définissez soigneusement la fréquence de synchronisation de vos stocks pour éviter la survente.

16. Considérations fiscales (TVA) lors de l'intégration

Associez les classes de taxes WooCommerce aux taux de TVA Dolibarr. Définissez des règles pour :

  • TVA nationale vs TVA internationale

  • Calcul automatique de la TVA en fonction de l'adresse de facturation

  • Exemptions pour les clients B2B de l'UE

Testez plusieurs scénarios de facturation pour vous assurer que la taxe est appliquée correctement.

17. Gestion des variations et des attributs

WooCommerce utilise des produits variables pour la taille, la couleur, etc. Mappez-les aux variantes de produits Dolibarr ou utilisez des champs personnalisés.

Certains modules prennent en charge l'importation d'attributs ; d'autres nécessitent un développement personnalisé.

18. Conseils d'automatisation : tâches Cron et déclencheurs de synchronisation

Utilisez les tâches cron pour :

  • Synchroniser les commandes toutes les 15 minutes

  • Mettre à jour les niveaux de stock toutes les heures

  • Reconnectez les API chaque nuit si les jetons de session expirent

Testez soigneusement l'automatisation en phase de test avant de l'appliquer à la boutique en ligne.

19. Mappage des données et gestion des champs personnalisés

Certaines entreprises utilisent des champs personnalisés tels que :

  • Instructions de livraison

  • Segmentation des clients

  • Codes de fidélité

Assurez-vous que votre intégration prend en charge la transmission de ces champs ou personnalisez les points de terminaison pour les gérer.

20. Dépannage des problèmes courants

  • Les commandes ne se synchronisent pas ? Vérifier les journaux de l'API

  • Niveaux de stock incorrects ? Valider les identifiants de produits et les règles de mappage

  • Des déséquilibres fiscaux ? Vérifiez les paramètres de taxe régionaux de WooCommerce et Dolibarr

  • Délais d'attente ou erreurs ? Optimiser les limites PHP du serveur et les limites de débit de l'API

21. Sécurité et contrôle d'accès

Bonnes pratiques en matière de sécurité :

  • Utiliser HTTPS

  • Faire tourner régulièrement les clés API

  • Limiter la portée de l'accès par rôle

  • Activer la journalisation et surveiller le trafic

Protégez votre instance Dolibarr comme tout autre backend critique.

22. Optimisation des performances pour les magasins à volume élevé

Pour les magasins avec des volumes de transactions élevés :

  • Mettre en cache les réponses de l'API lorsque cela est possible

  • Utiliser des points de terminaison en masse (synchronisation par lots)

  • Décharger les tâches de synchronisation vers les travailleurs en arrière-plan

  • Optimiser les requêtes de base de données dans Dolibarr

23. Stratégies de sauvegarde et de récupération

Toujours:

  • Sauvegardez quotidiennement les bases de données Dolibarr et WooCommerce

  • Utiliser le contrôle de version pour les scripts de configuration

  • Procédures de restauration des tests trimestrielles

Cela minimise les temps d’arrêt en cas d’échec de synchronisation ou de panne du système.

24. Conformité juridique en France et dans l'UE

Assurez-vous que votre système est conforme à :

  • RGPD pour les données clients

  • Réglementation anti-fraude TVA française

  • Mandats de facturation électronique pour les relations avec les institutions publiques (via Chorus Pro)

Conservez des enregistrements clairs de toutes les transactions API à des fins d’audit.

25. Quand envisager d'embaucher un développeur

Faites appel à un professionnel si :

  • Vos besoins d'intégration sont complexes

  • Vous avez besoin d'une tarification multi-entrepôts ou B2B à plusieurs niveaux

  • Vous prévoyez de synchroniser avec plusieurs boutiques WooCommerce

  • Vous avez besoin d'une intégration de rapports ou d'analyses personnalisés

26. Conclusion : rationaliser le commerce électronique avec un ERP

Intégrer Dolibarr à WooCommerce en 2025 est non seulement possible, mais aussi intelligent. Avec le bon connecteur, une configuration claire et une planification minutieuse, vous pouvez éliminer les tâches redondantes, améliorer la précision et offrir à votre équipe une visibilité en temps réel sur chaque aspect de votre activité. Que vous soyez une start-up ou une entreprise en pleine expansion, connecter votre ERP et votre e-commerce est une étape cruciale à ne pas manquer.