API Dolibarr : multi-société Retour d’expérience avec intégrations modernes

Introduction
Dolibarr, l’ERP open source et modulaire, s’est imposé comme une solution robuste pour les TPE/PME et les groupes multi-sociétés. Sa fonctionnalité multi-sociétés (ou multi-entités juridiques) permet de gérer plusieurs entreprises, holdings, ou filiales au sein d’une même installation, avec des partages de données sélectifs et une consolidation financière simplifiée. Mais aujourd’hui, la vraie valeur se crée lorsqu’on couple cette capacité native aux intégrations modernes via API. Voici un retour d’expérience concret surcomment exploiter pleinement ce tandem.

1. Le multi-société dans Dolibarr : comment ça marche ?

Concepts clés

  • Entité juridique : Chaque "société" dans Dolibarr est une entité indépendante (compte bancaire, taxe, planning, base clients/fournisseurs) mais partageable.

  • Partage de données : Possibilité de partager des produits, des tiers (clients/fournisseurs), des projets ou des utilisateurs entre sociétés.

  • Consolidation : Génération de rapports consolidés (balance, résultat) à partir des données de plusieurs entités.

  • Sécurité : Accès restreint par société pour les utilisateurs, avec rôles personnalisables.

Cas d’usage typique

  • Un groupe avec une holding et 3 filiales (chacune avec sa comptabilité propre).

  • Une association gérant plusieurs activités distinctes avec des financements séparés.

  • Une société de services avec des établissements multiples (B2B / B2C) nécessitant une facturation différente.

2. Limites natives et besoin d’intégration

Dolibarr gère nativement le multi-société, mais certaines opérations restent manuelles ou peu flexibles :

  • Synchronisation bi-directionnelle lente entre sociétés.

  • Absence de workflows automatisés cross-sociétés (ex: transfert d’une commande d’une filiale à une autre).

  • Intégration limitée avec des outils externes modernes (CRM, plateformes e-commerce, outils de paie spécialisés).

C’est là que l’API RESTful de Dolibarr (disponible depuis la version 10+) devient centrale.

3. Intégrations modernes : notre retour d’expérience

Nous avons accompagné plusieurs groupes dans la mise en place de solutions connectées à leur Dolibarr multi-sociétés. Voici les architectures qui fonctionnent.

A. Intégration avec un CRM externe (ex: Salesforce, HubSpot)

  • Scénario : Les forces de vente saisissent les opportunités dans le CRM, mais la facturation et la gestion des stocks se font dans Dolibarr (par société).

  • Solution technique :
    API Dolibarr → Webhook sur création de facture → synchronisation automatique du numéro de facture et du statut dans le CRM.
    Avantage : Pas de double saisie, chaque société garde son propre flux commercial dans le CRM tout en consolidant la facturation dans Dolibarr.

B. E-commerce multi-boutiques (ex: PrestaShop, Shopify)

  • Scénario : Chaque boutique en ligne correspond à une société Dolibarr différente (pour gérer des TVA, des stocks, des modes de livraison distincts).

  • Solution technique :

    • Création d’un micro-service d’orchestration (en Node.js/Python) qui lit les commandes via l’API Shopify.

    • Celui-ci détermine, via un règles métier, à quelle société Dolibarr (quel entity_id) envoyer la commande.

    • Appel de l’API /invoices ou /orders de Dolibarr avec le bon header DOL-Entity-Id.

    • Synchronisation des stocks en temps réel via /products/{id}/stock.
      Résultat : Une seule plateforme e-commerce, plusieurs back-offs Dolibarr autonomes mais consolidables.

C. Automatisation des transferts inter-sociétés

  • Problème : Une filiale A achète un produit, le transforme, et le vend via la filiale B. Comment tracer les flux et les marges ?

  • Solution :

    1. Création d’un commande fournisseur interne dans la société B envers la société A via l’API (enregistrement comme une vente interne).

    2. Génération automatique d’une facture intra-groupe (avec un modèle spécifique).

    3. Extraction des données consolidables via l’API /reports (ou script SQL sur la base unique).
      Bénéfice : Traçabilité complète, élimination des excels de reconciliation.

D. Connectivité bancaire et paiements (ex: Stripe, Lemonway, banques via API)

  • Scénario : Chaque société a un compte bancaire distinct. Les paiements en ligne (site web, abonnements) doivent être affectés à la bonne entité.

  • Solution :

    • Le système de paiement (Stripe) envoie un webhook à un endpoint métier.

    • Celui-ci identifie la société cible (via un metadata dans la session client) et crédite le bon compte via l’API /bankaccounts.

    • Reconciliation automatique des transactions.
      Économie : Fin des rapprochements manuels par société.

4. Points de vigilance techniques

  1. Gestion des identifiants API :

    • Créer un utilisateur API par société (ou un utilisateur avec des permissions limitées à une entité) pour éviter les erreurs de routage.

    • Stocker les clés API de manière sécurisée (variables d’environnement, vault).

  2. Performances :

    • Dans un contexte multi-sociétés, la base de données peut être sollicitée. Prévoir des index sur entity et optimiser les requêtes API (filtres, pagination).

  3. Error handling & logging :

    • Toute intégration doit logger l’entity_id concernée en cas d’erreur. Un échec sur une société ne doit pas bloquer les autres.

  4. Tests :

    • Tester les flux en environnement pré-production avec plusieurs sociétés. Simuler des scénarios croisés (ex: creation d’un produit partagé dans la société A, utilisé dans la société B).

5. Bénéfices mesurés

Nos retours d’expérience montrent :

  • Réduction de 70% du temps de consolidation mensuelle.

  • Élimination des erreurs de imputation inter-sociétés.

  • Visibilité en temps réel sur la performance de chaque entité.

  • Coûts informatiques réduits : une seule instance Dolibarr, un seul socle d’intégration.

6. Recommandations pour démarrer

  1. Commencez simple :
    Identifiez un processus récurrent (ex: import des commandes e-commerce) et connectez-le à une seule société via l’API avant de généraliser.

  2. Documentez vos règles métier :
    Quels sont les seuils de partage ? Qui peut vendre à qui ? Ce document guidera vos développements d’intégration.

  3. Utilisez les webhooks de Dolibarr (si disponibles) plutôt quedu polling.

  4. Surveillez les quotas : L’API Dolibarr peut être limitée en nombre d’appels. Privilégiez les batchs pour les synchronisations massives.

Conclusion

Le couple Dolibarr multi-société + API moderne transforme un ERP traditionnel en hub opérationnel unifié pour des groupes aux entités juridiques séparées. Cela permet de garder l’autonomie comptable de chaque société tout en bénéficiant d’une vision globale et d’une automatisation poussée des flux.

La clé du succès réside dans une architecture middleware (Zapier, n8n, ou développement sur mesure) qui fait le lien entre Dolibarr et vos outils métiers, en respectant scrupuleusement le périmètre de chaque entité.

Dolibarr prouve ainsi qu’un ERP open-source, bien architecturé et connecté, peut rivaliser avec des solutions propriétaires haut de gamme sur le terrain du multi-sociétés et de l’intégration moderne.

À propos de l’auteur : Retour basé sur des missions en cabinet de conseil et chez des clients finaux (groupes industriels, réseaux de franchises, coopératives) depuis 2021.

Publications similaires