Dolibarr est un ERP et CRM open-source largement utilisé par les entreprises pour gérer leurs processus commerciaux, financiers et administratifs. L’une de ses fonctionnalités les plus puissantes est son API REST, qui permet aux développeurs d’automatiser des tâches et d’intégrer Dolibarr avec d’autres applications.
Dans cet article, nous verrons comment utiliser l’API REST de Dolibarr pour automatiser certaines tâches courantes, telles que la gestion des clients, la création de factures, la mise à jour des produits et la synchronisation des données avec des services externes.
1. Présentation de l’API REST de Dolibarr
L’API REST de Dolibarr permet d’interagir avec le système via des requêtes HTTP. Elle est conçue pour offrir un accès sécurisé aux données et fonctionnalités de Dolibarr, facilitant ainsi l’intégration avec d’autres outils.
Principales fonctionnalités de l’API REST
- Gestion des clients et contacts (ajout, mise à jour, suppression).
- Création et mise à jour des factures et devis.
- Gestion des produits et services.
- Accès aux commandes et paiements.
- Lecture et écriture des données comptables.
2. Activer l’API REST dans Dolibarr
Avant d’utiliser l’API REST, il est nécessaire de l’activer dans Dolibarr et de configurer les autorisations d’accès.
Étapes pour activer l’API
- Se connecter en tant qu’administrateur à Dolibarr.
- Aller dans "Accueil" → "Configuration" → "Modules/Applications".
- Rechercher le module "API REST" et l’activer.
- Dans l’onglet Configuration, générer une clé API pour chaque utilisateur ou application qui doit accéder à l’API.
- Définir les permissions API pour limiter l’accès aux données sensibles.
Une fois l’API activée, elle sera accessible via l’URL suivante :
3. Authentification et Sécurité
Dolibarr utilise un mécanisme de token d’authentification pour sécuriser l’accès à son API.
Récupérer un jeton d’authentification
L’authentification se fait en envoyant une requête POST avec les identifiants API :
La réponse contiendra un jeton d’authentification que vous devrez inclure dans chaque requête API en tant qu’en-tête DOLAPIKEY :
Sécuriser l’API
- Toujours utiliser HTTPS pour éviter l’interception des données.
- Limiter les accès avec des permissions utilisateur spécifiques.
- Régénérer les clés API régulièrement.
- Surveiller les logs d’accès API pour détecter d’éventuelles tentatives malveillantes.
4. Automatiser la gestion des clients
L’API REST permet d’ajouter et de modifier des clients sans passer par l’interface de Dolibarr.
Créer un nouveau client
Voici un exemple de requête POST pour ajouter un client :
Dolibarr renverra un ID unique pour ce client, que vous pourrez utiliser pour des actions ultérieures.
Mettre à jour un client existant
Pour modifier un client, utilisez une requête PUT avec l’ID du client :
5. Automatiser la facturation
Créer une facture via l’API REST
Pour générer une facture, utilisez l’endpoint /invoices :
Dolibarr renverra l’ID de la facture, que vous pourrez utiliser pour l’envoyer par email ou la télécharger au format PDF.
6. Synchroniser Dolibarr avec d’autres outils
L’API REST de Dolibarr peut être utilisée pour synchroniser les données avec des outils externes tels que WooCommerce, Prestashop, Zapier, Google Sheets, Power BI, etc.
Exemple de synchronisation avec un site e-commerce
Si vous souhaitez récupérer la liste des produits pour un site WooCommerce, vous pouvez exécuter la requête suivante :
Cette commande renverra les informations des produits Dolibarr, que vous pourrez importer dans WooCommerce via son propre API REST.
7. Automatiser les rapports et analyses
L’API de Dolibarr permet d’extraire des données pour générer des rapports personnalisés.
Exporter les ventes du mois en cours
Pour récupérer les ventes du mois :
Ces données peuvent être intégrées dans Google Sheets, Power BI ou Excel pour une analyse avancée.
Conclusion
L’API REST de Dolibarr est un outil puissant qui permet d’automatiser de nombreuses tâches et d’intégrer Dolibarr avec d’autres systèmes. En activant et sécurisant correctement l’API, vous pouvez gérer les clients, créer des factures, synchroniser des données avec des plateformes externes et générer des rapports personnalisés.
Que ce soit pour une intégration avec un e-commerce, une application mobile ou un CRM externe, l’API REST de Dolibarr facilite l’automatisation et améliore la productivité.
Si vous souhaitez aller plus loin, explorez la documentation officielle de Dolibarr ou utilisez des outils comme Postman pour tester et optimiser vos requêtes API.