Intégration API Dolibarr : comment se connecter, configurer et suivre les bonnes pratiques

Dolibarr est un ERP et CRM open-source utilisé par les PME partout en Europe pour gérer la facturation, les clients, les produits et bien plus, le tout depuis une instance auto-hébergée. Si votre logiciel touche à la finance, à la facturation ou à la facturation client, vous connecter à Dolibarr vous donne accès aux données que vos utilisateurs y conservent déjà.

Intégrer votre produit à l'API Dolibarr vous permet de :

• Synchroniser les factures et les fiches clients dans vos flux comptables ou financiers
• Récupérer les créances ouvertes pour alimenter des fonctionnalités de trésorerie, de prévision ou de recouvrement
• Réduire la saisie manuelle et garder des données cohérentes entre vos outils
• Servir une large base de PME qui font tourner leur propre instance Dolibarr

Ce guide couvre l'API Dolibarr, sa configuration et les bonnes pratiques à suivre, le tout simplifié par l'API Unifiée Facturation de Chift.

Qu'est-ce que l'API Dolibarr ?

Dolibarr embarque une API REST native qui transforme n'importe quelle instance en fournisseur de données dès lors que le bon module est activé. C'est une interface propre et moderne pour un outil qui réunit facturation, CRM et ERP.

Voici l'essentiel :

• Type d'API : REST, avec des corps de requête et de réponse au format JSON
• Verbes HTTP : GET, POST, PUT et DELETE pour un accès complet en lecture et écriture
• Authentification : une clé API transmise dans l'en-tête DOLAPIKEY (elle peut aussi être passée en paramètre de requête api_key)
• URL de base : fournie par le client. Comme Dolibarr est open-source et auto-hébergé, chaque instance possède sa propre adresse, de la forme https://<votre-serveur>/api/index.php/
• Explorateur interactif : chaque instance embarque un explorateur Swagger à l'adresse /api/index.php/explorer, pour parcourir les routes disponibles sur cette installation précise

Comme Dolibarr est une API intégrée dans un ERP/CRM, et que chaque client fait tourner sa propre instance, l'URL de base fait partie de la configuration de connexion, ce n'est pas un endpoint fixe que vous pouvez coder en dur.

Vous pouvez explorer les routes disponibles directement dans l'explorateur Swagger livré avec chaque instance Dolibarr.

{{CTA-1}}

Exemples de cas d'usage de l'intégration API Dolibarr

S'intégrer à Dolibarr ouvre des possibilités concrètes pour enrichir votre produit et apporter de la valeur à vos utilisateurs. Voici comment les éditeurs de logiciels exploitent les données Dolibarr via l'API Unifiée Facturation de Chift.

Synchroniser factures et clients vers un logiciel comptable

Des plateformes comptables comme Inqom et MyUnisoft utilisent déjà le connecteur Dolibarr de Chift pour récupérer automatiquement les factures et les fiches clients depuis les instances Dolibarr de leurs utilisateurs, et garder une comptabilité exacte et à jour. Fini les exports manuels laborieux : moins d'erreurs, et une meilleure collaboration entre les dirigeants et leurs comptables.

Suivi des factures en temps réel dans les portails clients

Affichez l'historique des factures et le statut de paiement directement dans votre application destinée aux clients. Donner aux utilisateurs un accès en libre-service à leurs documents de facturation réduit les demandes de support et améliore l'expérience, sans avoir à se connecter séparément à Dolibarr.

Prévision de trésorerie à partir des factures ouvertes

Les outils de gestion de trésorerie peuvent récupérer les factures impayées depuis Dolibarr pour établir des projections de créances précises. Analyser les délais et les habitudes de paiement aide vos utilisateurs à anticiper sereinement les mouvements de trésorerie. Agicap, par exemple, utilise les intégrations de facturation de Chift pour ce type de flux de trésorerie.

Automatiser le recouvrement avec les créances ouvertes

Les plateformes de recouvrement peuvent se connecter à Dolibarr via Chift pour récupérer automatiquement les créances ouvertes et déclencher les processus de relance. Plus de suivi manuel, et une action rapide sur les factures impayées. Recovr, par exemple, s'appuie sur les intégrations de facturation de Chift pour automatiser ce type de recouvrement.

Pour plus d'exemples de la façon dont les intégrations de facturation peuvent améliorer votre produit, parcourez nos études de cas Chift.

Configurer votre intégration API Dolibarr

Préparer une instance Dolibarr demande quelques étapes dans le panneau d'administration, puis une configuration de connexion rapide. Voici comment procéder :

1. Activez le module API REST. Dans l'administration Dolibarr, allez dans Configuration → Modules et activez le module Web services (API REST). Une fois actif, l'instance devient automatiquement un fournisseur REST.
2. Générez une clé API. Ouvrez la fiche de l'utilisateur concerné (Fiche utilisateur → Clé API) et générez la clé. C'est le DOLAPIKEY utilisé pour authentifier chaque requête.
3. Configurez la connexion. Deux champs sont requis :
   • url — l'URL de base Dolibarr du client
   • token — le DOLAPIKEY généré
4. Authentifiez vos appels. Transmettez la clé dans chaque requête via l'en-tête DOLAPIKEY :

python

  headers = {"DOLAPIKEY": token}

5. Gérez les instances multi-sociétés. Si le client utilise une configuration multi-sociétés, activez l'option multicompany et choisissez le bon folder (entité). La connexion envoie alors un en-tête DOLAPIENTITY pour limiter chaque requête à cette entité.

L'API en elle-même est facile à prendre en main. Mais une intégration de qualité production, c'est plus que quelques appels : il faut sécuriser les identifiants, valider les URL auto-hébergées, gérer la pagination, cibler les requêtes multi-sociétés et rester robuste face aux nombreuses versions et configurations de modules de vos utilisateurs. C'est là que ça devient lourd, et là que Chift vous aide.

Bonnes pratiques pour l'intégration API Dolibarr

Pour construire une intégration Dolibarr fiable, gardez ces recommandations en tête :

• Stockez les identifiants en sécurité. Le DOLAPIKEY est une clé à longue durée de vie liée à toutes les permissions d'un utilisateur. Conservez-la dans des variables d'environnement ou un coffre sécurisé, jamais dans le code ou les logs.
• Validez l'URL de base. Comme l'hôte est fourni par le client et auto-hébergé, normalisez et vérifiez l'url, et exigez le HTTPS pour que la clé ne transite jamais en clair.
• Paginez les résultats. Utilisez page (indexé à partir de 0) et limit. Dolibarr plafonne les réponses (par défaut autour de 100 enregistrements), ne supposez donc jamais qu'un seul appel renvoie tout.
• Ciblez toujours les requêtes multi-sociétés. Sur les instances multi-sociétés, ajoutez l'en-tête DOLAPIENTITY à chaque appel. Sans lui, lectures et écritures risquent de viser la mauvaise entité.
• Gérez les erreurs et les différences de version. Vérifiez soigneusement les codes de statut HTTP. Les endpoints disponibles et le comportement varient selon la version de Dolibarr et les modules activés du client : prévoyez la variabilité plutôt qu'une configuration unique.

Connectez-vous à Dolibarr, Odoo, Zoho Invoice et bien plus avec une seule intégration

Construire une connexion directe à Dolibarr demande du temps, des efforts et une maintenance continue, surtout dès que vous devez aussi prendre en charge d'autres outils de facturation et CRM, chacun avec ses particularités et ses configurations auto-hébergées.

Avec l'API Unifiée Facturation de Chift, vous vous connectez une seule fois et accédez à Dolibarr, Odoo, Zoho Invoice, Sellsy et bien d'autres via un modèle de données cohérent.

• Une seule intégration pour des dizaines d'outils de facturation et CRM
• Gestion native de l'authentification, de la pagination et du multi-tenant
• Des données unifiées et standardisées
• Synchronisation en temps réel et monitoring avancé
• Une expérience fluide pour vos utilisateurs

Quand la configuration Dolibarr d'un client change ou qu'un nouvel outil doit être connecté, on s'en occupe. Votre équipe livre plus vite, et votre produit évolue sans la charge des intégrations.

Réservez une démo!

FAQ API Dolibarr

Quels endpoints sont disponibles dans l'API Dolibarr ?

Le connecteur Dolibarr de Chift expose un ensemble d'endpoints standardisés, notamment (sans s'y limiter) :

• Factures /invoices
• Clients / contacts /clients
• Produits et services /products
• Paiements /payments

Consultez notre documentation API Dolibarr pour la liste complète des routes disponibles.

Quelle est la limite de débit de l'API Dolibarr ?

Dolibarr n'impose aucune limite de débit au niveau de l'API. Comme chaque instance est auto-hébergée, le débit dépend entièrement de la configuration du serveur, de PHP et du serveur web du client, pas d'un quota documenté par Dolibarr. En bonne pratique, évitez les écritures parallèles trop nombreuses, traitez les requêtes de manière séquentielle quand c'est possible, et ajoutez une logique de retry pour qu'une instance plus lente ne casse pas votre synchronisation.

Dolibarr est-il dans le cloud ?

Dolibarr est auto-hébergé par défaut, sur site ou sur le cloud ou VPS du client. Une option SaaS managée (Dolibarr Cloud / Dolicloud) existe, mais même dans ce cas, chaque client fait tourner sa propre instance avec sa propre URL. C'est pourquoi l'URL de base fait toujours partie de la configuration de connexion.