Synchronisation Dolibarr ERP/CRM et WordPress / WooCommerce

DoliCommerce Bridge : synchronisez Dolibarr et WooCommerce, sans double saisie

Votre boutique vend sur WooCommerce, votre entreprise se gère dans Dolibarr ? Fini la ressaisie des commandes, les stocks faux en ligne et les tarifs tenus à deux endroits. DoliCommerce Bridge relie votre ERP/CRM Dolibarr à une ou plusieurs boutiques WordPress / WooCommerce grâce à un véritable moteur de synchronisation, fiable, traçable et entièrement piloté depuis Dolibarr.

Présentation

Édité par NextGestion et diffusé sous licence GPL v3 ou ultérieure, DoliCommerce Bridge 1.0 couvre toute la chaîne e-commerce : clients et contacts, catalogue avec variations, catégories, attributs et images, stocks et prix, commandes, factures, paiements, remboursements et avoirs, expéditions et suivi de colis, taxes et coupons.

L'intégration est volontairement non intrusive : aucune modification du cœur de Dolibarr, de WordPress ou de WooCommerce, et aucun plugin WordPress à installer. Le module utilise uniquement les interfaces officielles : API REST WooCommerce v3 (wc/v3), API REST WordPress (wp/v2) et webhooks WooCommerce signés. Côté Dolibarr, il s'appuie sur les triggers standard, le module Travaux planifiés et ses propres tables.

Tout se pilote depuis le menu Commerce Sync, et un onglet « WordPress / WooCommerce » enrichit les fiches produit, tiers, commande et facture avec l'état de synchronisation et un bouton « Synchroniser maintenant ».

Bénéfices clés

• Fin de la double saisie : les commandes WooCommerce arrivent dans Dolibarr avec lignes, taxes, frais de port, facture et règlement selon vos règles.
• Vendez uniquement ce que vous avez : les mouvements de stock Dolibarr sont répercutés sur la boutique en quelques minutes, avec stock de sécurité si besoin.
• Comptabilité saine : clés d'idempotence contre les doublons, contrôle des montants, avoirs pour les remboursements, aucun remboursement bancaire automatique.
• Vous décidez qui fait foi : sens de synchronisation et source de vérité par famille de données et même par champ.
• Résistant aux incidents : boutique indisponible, clé expirée, webhook perdu ou CRON arrêté, les tâches attendent, sont relancées ou placées en file des échecs rejouable.
• Transparence totale : tableau de bord, journaux avec identifiant de corrélation, diagnostic et reporting par site.
• Multi-boutiques : un Dolibarr, autant de sites WooCommerce que nécessaire.
• Mise en service sereine : assistant en 14 étapes conclu par une simulation qui n'écrit rien.

Fonctionnalités détaillées

Clients et contacts

• Clients WooCommerce synchronisés avec les tiers Dolibarr, contacts de facturation et de livraison.
• Dédoublonnage par identifiant distant, e-mail, référence et numéro de TVA ; une correspondance ambiguë n'est jamais choisie automatiquement.
• Commandes invitées : un tiers par e-mail (clé hachée) ou un tiers générique.
• Détection B2B lorsque le champ société est renseigné ; correspondance des rôles WordPress vers type de tiers, groupe, niveau de prix et catégorie.

Catalogue et variations

• Produits simples, services (en produits virtuels), produits variables et variations (module Variantes ou mode « produits séparés »).
• Arborescence des catégories, étiquettes (en catégories Dolibarr dédiées), attributs globaux et termes.
• Images principale, galerie et variation, avec empreinte SHA-256 pour éviter les renvois inutiles et téléchargement sécurisé à l'import.
• Poids et dimensions avec conversion d'unités ; codes-barres EAN/GTIN (WooCommerce 9.2 ou supérieur).
• Produits groupés, externes, téléchargeables, ventes additionnelles et croisées conservés en métadonnées : aucune perte de données.
• Gestion paramétrable des produits supprimés, sans jamais de suppression automatique dans Dolibarr.

Stocks multi-entrepôts et prix

• Envoi du stock selon trois modes : entrepôt unique, somme des entrepôts ou calcul personnalisé (coefficient et stock de sécurité).
• Le stock reçu de WooCommerce crée un véritable mouvement de stock Dolibarr.
• Prix réguliers en HT ou TTC selon le réglage de taxes WooCommerce.
• Prix promotionnels via un champ complémentaire dédié ou un niveau de prix ; tarifs par rôle via un adaptateur de plugin B2B détecté.

Commandes, factures, paiements et remboursements

• Import des commandes par webhook, complété par un rattrapage différentiel toutes les 5 minutes, filtré par statut et date minimale.
• Lignes complètes : produits, variations, SKU, quantités, prix unitaires, taxes, remises, frais de port, frais et coupons.
• Correspondance des statuts de commande paramétrable dans les deux sens.
• Création automatique de la facture selon le déclencheur choisi : création, paiement, en cours, terminée, expédiée ou jamais.
• Règlements issus de la commande (date, identifiant de transaction, passerelle associée à un mode de paiement et un compte bancaire).
• Remboursements totaux ou partiels (quantités, port, frais, taxes, motif) transformés en avoirs, avec réintégration du stock en option.
• Devise et montants d'origine conservés, taux multidevise Dolibarr appliqué.
• Totaux Dolibarr et WooCommerce comparés (tolérance de 0,02 par défaut) : tout écart ouvre un conflit financier, jamais une validation silencieuse.

Expéditions et suivi de colis

• La validation ou la clôture d'une expédition Dolibarr passe la commande WooCommerce en « terminée » lorsque tout est expédié.
• Numéro de suivi transmis à Shipment Tracking, Advanced Shipment Tracking ou, à défaut, en métadonnée avec note client.

Taxes et coupons

• Import des taux et classes de taxe WooCommerce sous forme de suggestions de correspondance TVA.
• Correspondance des méthodes de livraison par instance de zone.
• Coupons appliqués convertis en remises de lignes, définitions de coupons conservées dans une table miroir.

Correspondances et sources de vérité

• Sens par famille : Dolibarr maître, WooCommerce maître, bidirectionnel, manuel ou désactivé.
• Source de vérité par champ : Dolibarr, WooCommerce, le plus récent ou toujours manuel. Par défaut, Dolibarr fait foi pour le catalogue, les stocks et les prix, WooCommerce pour les clients et les commandes.
• Moteur de correspondances éditable (statuts, taxes, paiements, livraison, entrepôts, champs, rôles) et moteur de règles SI conditions ALORS actions.
• Champs complémentaires Dolibarr associés aux métadonnées WordPress avec conversion de type.

Centre de conflits

Quand un objet est modifié des deux côtés, une fusion à trois voies compare chaque champ au dernier état synchronisé. Les changements d'un seul côté sont appliqués ; les changements concurrents suivent la source de vérité ou arrivent dans le centre de conflits, où un utilisateur habilité conserve la valeur Dolibarr, la valeur WooCommerce ou ignore l'écart.

File d'attente, relances, webhooks et CRON

• Chaque changement (trigger Dolibarr, webhook signé, delta planifié, action manuelle) devient une tâche dans une file persistante avec priorités et regroupement.
• Un worker exécuté par les Travaux planifiés de Dolibarr traite la file : aucun appel distant pendant l'enregistrement d'une fiche ou la réception d'un webhook.
• Relances à délai exponentiel, limiteur de débit, disjoncteur par connexion, reprise des tâches bloquées.
• File des échecs avec modification du contenu et remise en file ; cinq barrières anti-boucle.
• Webhooks signés, enregistrés et réparés automatiquement, dédoublonnés par identifiant de livraison.
• Réconciliation nocturne : objets manquants, correspondances cassées, écarts de stock, de prix et de montants.

Tableau de bord, journaux, diagnostic et reporting

• Tableau de bord WordPress Commerce Sync Center avec indicateurs de santé et notifications.
• Journaux détaillés avec identifiants de corrélation et masquage des données personnelles.
• Page de diagnostic organisée en quinze groupes de contrôles.
• Reporting multi-sites avec exports et synchronisation de masse.

Assistant de première synchronisation et simulation

Un assistant en 14 étapes guide la mise en service : connexion et test, paramètres généraux, sens et sources de vérité, correspondances de statuts, taxes, paiements et livraison, entrepôts, filtres et règles, rapprochement des données existantes. Il se conclut par une simulation à blanc qui n'écrit rien, ni dans Dolibarr, ni dans WooCommerce, et indique pour chaque objet : création, mise à jour, inchangé, conflit ou ignoré.

Multi-sites

Connectez autant de boutiques WooCommerce que nécessaire à une entité Dolibarr, avec prise en charge du multi-sociétés. Chaque connexion dispose de ses identifiants, périmètre de catalogue, entrepôts, devise, langue, niveau de prix, correspondances, règles, file, journaux, webhooks et planifications. Le test de connexion détecte les versions, HTTPS, permaliens, devise, taxes, HPOS, statuts, passerelles et méthodes de livraison.

Sécurité et RGPD

• Secrets chiffrés en AES-256-GCM, masqués à l'écran et jamais journalisés.
• Vérification HMAC des webhooks, protection CSRF et contrôle des droits Dolibarr fins par fonction.
• Données personnelles masquées dans les journaux, purge des journaux après 90 jours et des tâches terminées après 14 jours.
• Clients invités regroupés par e-mail haché ; l'effacement côté WordPress reste réalisé avec ses outils de confidentialité natifs.

Récapitulatif des synchronisations

Prérequis

• Dolibarr 17 ou supérieur, avec les modules Tiers, Produits et Travaux planifiés (ainsi que Stocks, Commandes, Factures, Expéditions, Variantes, Multidevise selon vos besoins).
• PHP 7.4 à 8.4 avec les extensions curl, json, openssl et mbstring.
• MySQL ou MariaDB.
• WordPress avec WooCommerce et son API REST v3 ; HTTPS fortement recommandé.
• Une clé API WooCommerce en lecture/écriture appartenant à un gestionnaire de boutique ou administrateur ; un mot de passe d'application WordPress (WordPress 5.6+) pour l'envoi des images.
• Une tâche cron système exécutant les travaux planifiés de Dolibarr chaque minute.

Installation

1. Dans Dolibarr, Accueil > Configuration > Modules, déployez l'archive du module (ou décompressez-la dans htdocs/custom/).
2. Activez DoliCommerce Bridge, le module Travaux planifiés et les modules Dolibarr nécessaires.
3. Attribuez les droits du module aux utilisateurs concernés.
4. Configurez la tâche cron système appelant le script des travaux planifiés de Dolibarr chaque minute.
5. Dans WooCommerce, créez une clé API REST en lecture/écriture et, si besoin, un mot de passe d'application WordPress.
6. Ouvrez le menu Commerce Sync, lancez l'assistant, saisissez l'URL et les clés puis testez la connexion.
7. Suivez les étapes de paramétrage, lancez la simulation et analysez le rapport.
8. Passez en production : l'assistant planifie la synchronisation initiale, enregistre les webhooks et active la connexion.

Compatibilité

En toute transparence : la version 1.0 est couverte par une suite de tests automatisés (PHP 8.3, SQLite, doublures de Dolibarr et WooCommerce, transport HTTP simulé). Aucun test n'a encore été réalisé sur une installation réelle de Dolibarr, WordPress ou WooCommerce. Le module est conçu pour Dolibarr 17 à 22, PHP 7.4 à 8.4 et l'API REST WooCommerce v3 (avec ou sans HPOS), mais nous vous recommandons vivement de le valider sur une copie de préproduction avant de l'utiliser sur votre boutique en production. Les anciennes API WooCommerce v1/v2 et les versions de Dolibarr antérieures à 17 ne sont pas compatibles ; PrestaShop, Shopify et Magento ne sont pas pris en charge en version 1.0.

Langues de l'interface

Français, anglais, espagnol, allemand et italien.

Contenu du pack

• Le module DoliCommerce Bridge 1.0 pour Dolibarr (archive prête à déployer).
• La documentation utilisateur et technique (architecture, compatibilité, matrice de synchronisation).
• Le manuel de formation en français (PDF).

Questions fréquentes

Faut-il installer un plugin sur WordPress ?
Non. Le module utilise l'API REST WooCommerce v3, l'API REST WordPress et les webhooks standard. Il suffit de créer une clé API et, pour les images, un mot de passe d'application.

La synchronisation est-elle en temps réel ?
Quasi temps réel : webhooks et triggers créent immédiatement des tâches, traitées chaque minute par le worker. Des rattrapages planifiés (5 minutes pour les commandes, 10 pour les stocks par défaut) récupèrent ce qu'un webhook aurait manqué.

Puis-je connecter plusieurs boutiques à un seul Dolibarr ?
Oui, sans limite, chaque connexion ayant sa propre configuration complète.

Un webhook reçu deux fois peut-il créer une facture en double ?
Non. Commandes, factures, paiements, avoirs et expéditions sont protégés par des clés d'idempotence, et les livraisons de webhooks sont dédoublonnées.

Le module rembourse-t-il automatiquement mes clients ?
Non. Un remboursement WooCommerce devient un avoir Dolibarr. Un remboursement réel via la passerelle est désactivé par défaut et exige une configuration explicite.

Comment sont gérés plusieurs entrepôts ?
WooCommerce n'ayant qu'un stock par produit, vous choisissez un entrepôt unique, la somme des entrepôts ou un calcul personnalisé avec coefficients et stock de sécurité.

Que se passe-t-il si ma boutique est indisponible ?
Les erreurs réseau sont relancées avec délai progressif et le disjoncteur suspend les appels. En cas d'identifiants invalides, les tâches passent en file des échecs avec une alerte critique, prêtes à être rejouées.

Puis-je tester avant la mise en production ?
Oui : la simulation de l'assistant n'écrit aucune donnée. Nous recommandons en complément une recette complète sur une copie de préproduction.

Support NextGestion

DoliCommerce Bridge est conçu, maintenu et supporté par NextGestion, spécialiste des solutions Dolibarr. Pour toute question avant ou après achat, une aide à la mise en service ou un besoin spécifique, contactez-nous sur www.nextgestion.com.

Démo du module DoliCommerce Bridge (WordPress / WooCommerce)
Login : demo
Mot de passe : demo