Par [Votre Nom] – 3 Novembre 2025
1. Introduction
Vous avez déjà un site WordPress gestionnaire de contenu (CMS) qui diffuse vos produits, vos actualités ou vos services. Vous avez aussi besoin d’un ERP/CRM léger pour suivre les devis, factures, stocks, contacts, ou les tâches internes ? Dolibarr est exactement ce qu’il vous faut : une suite Open‑Source qui regroupe gestion commerciale, comptabilité, stocks, ressources humaines… Mais Dolibarr n’est pas une « extension WordPress » ; il s’agit d’une application web autonome. Pour combiner la souplesse de WordPress (design, éditorial, SEO) avec la puissance fonctionnelle de Dolibarr, vous pouvez :
- Intégrer les deux systèmes via des API, des web‑hooks ou des plugins dédiés.
- Utiliser WordPress comme façade (portail client, blog, SEO) tout en laissant Dolibarr gérer les processus back‑office. * Synchroniser données et flux (clients, devis, factures, stocks) afin d’éviter la duplication et les erreurs de saisie.
Cet article vous propose une roadmap détaillée pour intégrer Dolibarr à votre site WordPress. Nous détaillons les étapes clés, les bonnes pratiques et les alternatives selon la taille de votre projet (petite entreprise, PME, ou grande organisation).
2. Pourquoi coupler WordPress & Dolibarr ? | Besoin | Solution WordPress | Solution Dolibarr | Apport de l’intégration |
|——–|———————-|——————-|————————–|
| Vente | Bouton « Ajouter au panier », pages produits WooCommerce | Devis & factures | Générer automatiquement un devis à partir du panier WooCommerce, puis facturer via Dolibarr. |
| Gestion des contacts | Plugin CRM léger | CRM complet (clients, fournisseurs) | Synchroniser les contacts du CRM WordPress avec les fiches clients Dolibarr. |
| Gestion des stocks | Extension WooCommerce stock | Stock & mouvements | Mettre à jour les quantités Dolibarr quand une commande WooCommerce est confirmée. |
| Facturation | Plugin facturation (ex. : WooCommerce PDF Invoices) | Factures, comptes‑clients, comptabilité | Générer la facture finalisée par Dolibarr et l’uploader sur le site WordPress pour archivage. |
| Marketing & communication | Newsletter, pages de destination | Campagnes Email (non intégré) | Utiliser Dolibarr pour segmenter les clients (ex: « Clients premium ») et envoyer des newsletters ciblées via WordPress. |
| Search & SEO | Excellent | Limité | La visibilité SEO passe par WordPress ; les processus internes restent centralisés dans Dolibarr. |
Bénéfice global : vous conservez un interface utilisateur moderne et SEO‑optimisée côté front‑office, tout en profitant d’un ERP complet côté back‑office, sans devoir basculer entre deux solutions disparates.
3. Prérequis techniques
| Élément | Version recommandée | Justification |
|---|---|---|
| WordPress | 6.6 (ou plus) | Compatibilité avec les plugins REST API et WP‑Cron. |
| PHP | 8.2+ | Dolibarr nécessite PHP ≥ 7.4 ; les nouvelles versions offrent meilleure performance et sécurité. |
| MySQL / MariaDB | 10.4+ (ou équivalent) | Dolibarr utilise MySQL. |
| Apache / Nginx | 2.4+ | Nécessaire pour les réécritures d’URL. |
| Extensions PHP | pdo_mysql, gd, intl, zip |
Obligatoires pour Dolibarr. |
| HTTPS | Oui | Sécurise les échanges via API et évite les problèmes de mixed‑content. |
| Accès admin WordPress | Permissions « Administrateur » | Pour installer plugins et configurer OAuth/Tokens. |
| Serveur de base de données | Accès séparé (ou bases distinctes) | Préférez des bases dédiées pour éviter les collisions. |
Astuce : déployez WordPress et Dolibarr sur deux sous‑domaines différents (
shop.mondomaine.cometerp.mondomaine.com) et partagez le même serveur de base de données via des schémas séparés.
4. Roadmap d’intégration (phase par phase)
Phase 1 – Audit et définition du périmètre
| Action | Détails | Durée |
|---|---|---|
| 1.1 Analyse des processus métiers | Recenser les flux : commande → devis → facture → stock → comptabilité. | 1–2 j |
| 1.2 Recensement des exigences fonctionnelles | Quels modules Dolibarr sont nécessaires ? (CRM, stocks, comptabilité…) | 1 j |
| 1.3 Définition des points de synchronisation | Exemple : création de client, paiement reçu, passage de commande. | 1 j |
| 1.4 Choix de l’architecture | WordPress ↔️ Dolibarr (API directe, intermédiaire (ex. : Zapier/Make), micro‑service interne). | 1 j |
| Livrable | Document de spécifications fonctionnelles (PDF). | — |
Phase 2 – Installation & configuration de base
| Étape | Action | Points d’attention |
|---|---|---|
| 2.1 Installation WordPress | wp-admin → Installation (optimisez avec un cache (WP‑Rocket) et SSL). |
Utilisez le même certificat que Dolibarr. |
| 2.2 Installation Dolibarr | Téléchargementlatest, décompression, configuration de la base. | Activez le mode « HTTPS only » dans les paramètres. |
| 2.3 Création des comptes | Un compte WordPress admin, un compte Dolibarr admin + comptes métier (ex. : « commercial »). | Restreindre les droits (principe du moindre privilège). |
| 2.4 Activation d’une API REST de base | WordPress : plugin WP REST API (déjà intégré). Dolibarr : native REST API (activer dans Config → HTTP Request). |
Vérifier que les réponses sont en JSON et que le CORS est configuré. |
Phase 3 – Mise en place du schéma de synchronisation
3.1 Architecture du flux de données
sequenceDiagram
participant WP as WordPress (Front)
participant API as API Gateway
participant DOL as Dolibarr (Back)
WP->>API: POST /clients (données JSON)
API->>DOL: POST /client/create
DOL-->>API: 201 Created + ID
API-->>WP: 201 ID
DOL->>API: POST /facture/generate?client_id={ID}
API->>WP: Retour URL facture PDF- Core : Utilisez WP‑REST API pour exposer des endpoints côté WordPress.
- Gateway : Vous pouvez passer par Make (ex‑Integromat) ou par votre propre script PHP/Node.js qui orchestre les appels.
- Back‑end : Dolibarr possède déjà une API REST (
/birds/ajax.php?mode=...) ou vous pouvez créer un module API dédié.
3.2 Exemples de synchronisations
| Fonctionnalité | Trigger (WordPress) | Action Dolibarr | Schema de synchronisation |
|---|---|---|---|
| Création d’un client | Formulaire « Contactez‑nous » → wp_insert_user |
clientdb (table Dolibarr) |
POST /dolibarr/api/createClient |
| Validation d’une commande WooCommerce | order.completed → webhook |
Création devis | POST /dolibarr/api/createQuote avec les lignes du panier |
| Paiement reçu (Stripe/PayPal) | Webhook → WC_Payment_Gateway::process_payment |
Génération facture | POST /dolibarr/api/createInvoice |
| Mise à jour de stock | Order fulfillment | productstoclient |
PATCH /dolibarr/api/updateStock |
| Export de rapports | Page « Statistiques » WordPress | Rapports comptables | GET /dolibarr/api/reports?... |
BONUS : Si vos besoins sont ponctuels (ex. : seulement synchroniser les contacts), un simple webhook WordPress → Zapier peut suffire (Zapier > 100 actions gratuites par mois).
Phase 4 – Développement API & Mapping des données
| Étape | Détails techniques |
|---|---|
| 4.1 Modélisation des DTO (Data Transfer Objects) | Créez des classes PHP/JS qui normalisent les champs (ex. : id_client, nom, email, adresse, statut). |
| 4.2 Authentification sécurisée | Utilisez OAuth2 ou Bearer Token entre les deux plateformes. Vous pouvez créer un endpoint /wp/v2/auth qui délivre un token JWT, puis Dolibarr le valide via un simple secret partagé. |
| 4.3 Gestion des erreurs & retries | Implémentez un système de back‑off exponentiel (ex. : 1 s, 2 s, 4 s…) en cas de 5xx. |
| 4.4 Tests unitaires & end‑to‑end | Utilisez PHPUnit pour les appels API, Cypress ou Playwright pour les scénarios WordPress. |
| 4.5 Mise en production** | Déployez sur un environnement de staging, puis déployez en bleu‑vert (2 serveurs) pour éviter le downtime. |
Phase 5 – UX / Design & SEO
| Action | Pourquoi |
|---|---|
| Uniformiser le thème | Appliquez le même palette de couleurs et typographies pour que les formulaires Dolibarr incorporés (via iFrame) ressortent naturellement dans le design WordPress. |
| Utiliser des iFrames sécurisés | Emboîte les pages de Dolibarr (ex. : formulaire de devis) dans vos pages via <iframe src="https://erp.mondomaine.com/...">. Ajoutez sandbox pour plus de sécurité. |
| Optimiser la vélocité | Chargement différé des contenus Dolibarr (lazy‑load) pour ne pas impacter le Speed Index de WordPress. |
| SEO | Redirigez les URLs de Dolibarr via un canonical vers des landing pages WordPress enrichies (ex. : /devis/nom-produit). Cela évite le contenu dupliqué. |
| Analytics unifiée | Ajoutez le même Google Tag Manager (GTM) sur les pages WordPress et sur les sous‑domaines Dolibarr (via GTM snippet injecté dynamiquement). |
Phase 6 – Tests fonctionnels & formation
| Test | Scénario | Outils |
|---|---|---|
| Fonctionnel | Création d’un client dans WordPress → apparaît dans Dolibarr et inversement. | Postman / API‑Tester |
| Calendrier | Paiement en temps réel → génération de facture et mise à jour du statut. | Cypress (simulation de paiement) |
| Charge | 100 commandes simultanées via WooCommerce → vérif. pas de latence > 300 ms. | Apache JMeter |
| Sécurité | Scan de vulnérabilités (OWASP ZAP) sur les endpoints REST. | OWASP ZAP, SonarQube |
| Formation | Sessions de 30 min pour les équipes commerciales et comptables sur l’interface Dolibarr. | Documentation interne (Confluence) |
Phase 7 – Déploiement & suivi continu
| Action | Fréquence |
|---|---|
| Déploiement progressif | 10 % → 50 % → 100 % des utilisateurs avec monitoring. |
| Monitoring des health‑checks | Cron qui vérifie que les API répondent (200 OK). Alertes via Slack ou PagerDuty. |
| Mise à jour de sécurité | WordPress + plugins + Dolibarr → toutes les 2 semaines ou dès patch critique. |
| Amélioration continue | Retours utilisateurs → backlog de ticket → sprint de 2 semaines. |
| Sauvegarde automatisée | Base MySQL + dossiers uploads/ de Dolibarr → snapshot quotidien sur S3 avec rotation de 30 jours. |
5. Exemples concrets d’utilisation
5.1 Petit commerce en ligne (Boutique WooCommerce)
- Création d’un produit dans WordPress → le produit est synchronisé avec le catalogue Article de Dolibarr.
- Ajout au panier → sur checkout, le webhook
order.createdcrée un devis dans Dolibarr (via API). 3. Paiement refusé → le client est redirigé vers une page WordPress avec message d’erreur ; aucune facture n’est créée. - Paiement accepté → déclenche la génération de facture et l’envoi du PDF à l’email client via Dolibarr + notification WordPress.
- Mise à jour stock → le statut du produit dans Dolibarr passe à En stock = 0 dès que la commande est confirmée.
Résultat : le commercial voit le devis en temps réel depuis le back‑office, le comptable a la facture prête à être archivée, et le client bénéficie d’un parcours d’achat fluide.
5.2 Agence de communication (gestion des projets)
| Besoin | Solution intégrée |
|---|---|
| Contacts (clients) | Synchronisation bidirectionnelle des fiches clients WordPress ↔️ Dolibarr. |
| Devis & factures | Création d’un devis WordPress → passage à la facture Dolibarr dès validation par le directeur (via formulaire). |
| Gestion des tâches | Utilisation du module Tickets de Dolibarr, accessible depuis WordPress via un embed iFrame. |
| Reporting | Tableau de bord WordPress (Google Data Studio) qui consomme les KPI exposés par l’API Dolibarr. |
6. Bonnes pratiques & pièges à éviter
| Good practice | Pourquoi |
|---|---|
| Utiliser des environnements séparés (dev, test, prod) pour les appels API. | Éviter les conflits de données. |
Stocker les secrets (API keys, JWT) dans des variables d’environnement (ex. : .env ou Vault). |
Sécurité contre le leakage. |
Versionner vos scripts d’API (ex. : Git tag v1.2.0). |
Traçabilité des évolutions. |
| Limitation du taux d’appel (rate‑limit) côté WordPress. | Prévenir les DDoS internes. |
| Chiffrer les communications (HTTPS + HSTS). | Protection contre les interceptions. |
| Tester le fallback (ex. : ne pas bloquer la commande si l’API Dolibarr est indisponible). | Continuité de service. |
| Documenter chaque endpoint (Swagger/OpenAPI). | Facilite la maintenance et la collaboration. |
| Common pitfalls | Comment les éviter |
|---|---|
| Synchronisation en double → deux enregistrements identiques. | Implémenter un idempotence key (ex. : client_id+email unique). |
| Conflits de mise à jour (ex. : modification simultanée par deux utilisateurs). | Utiliser le mécanisme optimistic locking (version field). |
| Performance lente (latence > 1 s). | Mettre en cache les réponses GET avec WP‑Cache; passer les appels lourds en queue (WP‑Cron). |
| Mauvaise gestion des droits (ex. : tout le monde peut créer des factures). | Définir rôles dans Dolibarr et les mapper à des capabilities WordPress. |
| SEO dupliqué (pages Dolibarr indexées). | Ajouter des balises <meta name="robots" content="noindex"> ou désactiver l’indexation via robots.txt. |
7. Alternatives & compléments
| Solution | Points forts | Quand les choisir |
|---|---|---|
| WordPress + WooCommerce + Dolibarr (via Zapier/Make) | Rapide à mettre en place, aucune programmation. | Petites activités sans besoin de synchronisation temps réel. |
| Micro‑services Node.js (ou Laravel) | Architecture scalable, logique métier centralisée. | Projets à fort volume de transactions ou besoin d’un moteur de workflow avancé. |
| ERP intégré WordPress (ex. : ERPNext via plugin) | Solution tout‑en‑un, mais plus lourde. | Si vous souhaitez remplacer complètement WordPress par un site basé sur frappe/ERPNext. |
| Extension native « Dolibarr WordPress Bridge » (projet open‑source) | Couplage direct (pas d’API intermédiaire). | Si vous avez les compétences de dev et que vous voulez éviter la surcharge de webhook. |
8. Conclusion
Intégrer Dolibarr avec WordPress est une démarche stratégique qui vous permet de :
- Conserver l’expérience utilisateur moderne, SEO‑optimisée et facilement personnalisable de WordPress.
- Bénéficier des fonctionnalités complètes d’un ERP/CRM (gestion commerciale, stocks, comptabilité) sans avoir à construire tout depuis zéro.
- Automatiser les flux critiques (commande → devis → facture → stock) pour éliminer la saisie manuelle et réduire les erreurs.
La roadmap présentée, de l’audit à la mise en production, vous donne un cadre méthodique pour planifier, développer et sécuriser chaque étape. En suivant les bonnes pratiques listées, vous éviterez les écueils les plus fréquents (duplication de données, problèmes de sécurité, performance) et vous assurerez une continuité de service durable.
Prochaine étape : lancez votre phase d’audit et rédigez le cahier des charges. Vous serez alors en mesure de choisir l’architecture (API directe, middleware, micro‑service) la plus adaptée à vos besoins.
Bonne intégration, et n’hésitez pas à revenir vers moi pour des conseils de développement plus techniques ou une feuille de route détaillée selon votre contexte métier !
Vous avez aimé cet article ?
- Partagez-le sur vos réseaux professionnels.
- Abonnez‑vous à notre newsletter pour ne manquer aucune astuce ERP/CRM.
- Contactez‑nous pour un audit gratuit de votre architecture actuelle.
À très vite dans la réussite de votre transformation digitale !