Page mise à jour le
Ce que l'API permet
Ce que Dolibarr expose réellement
Repris de la documentation publique de l'éditeur, pas d'une plaquette commerciale. Le lien vers cette documentation est en bas de page.
Tiers, produits et factures, si les modules le sont
L'explorateur officiel, une fois le module d'API activé, liste les actions disponibles pour le jeton fourni. Tiers, produits, factures, commandes, propositions : chacun n'apparaît que si le module correspondant est allumé. On lit, on crée, on valide une commande. Un agent qui « crée une facture » sur une instance où le module facture est éteint échoue, et c'est le diagnostic le plus fréquent — avant même de parler d'automatisation.
Une clé par utilisateur, des droits d'utilisateur
Chaque utilisateur Dolibarr peut avoir une clé d'API. Les appels s'exécutent avec ses droits, y compris le cloisonnement multi-sociétés si le module est là. Un agent branché sur un compte magasinier ne facture pas. C'est la même discipline qu'à l'écran, et c'est ce qui rend Dolibarr utilisable en atelier : on ne donne pas la clé de l'administrateur « parce que c'est plus simple ». On crée un utilisateur dédié, on lui donne ce qu'il faut, rien d'autre.
Commandes et factures en deux temps, pas en un
Le wiki développeur le dit : créer une commande avec ses lignes en un seul appel n'est pas le chemin supporté. On crée la commande, on récupère son identifiant, on ajoute les lignes, on valide. C'est plus lent à écrire, et c'est le seul enchaînement qui ne casse pas. Un agent impatient qui envoie tout d'un bloc obtient une commande vide ou une erreur. On suit le wiki, pas un exemple trouvé ailleurs.
Module Web Services API REST — wiki Dolibarr (nouvel onglet) — Consultée le 21-08-2026. Activation du module, explorateur, clé utilisateur, exemples factures / tiers / commandes. L'explorateur de démo est sur demo.dolibarr.org.
Trois automatisations concrètes
Ce qu'on met en place avec
Trois situations réelles, décrites comme du travail plutôt que comme de la technique.
Créer le tiers une seule fois, depuis le premier devis
Un nouveau client arrive par un formulaire ou un mail. L'agent cherche le tiers par nom, par SIRET s'il est là, puis le crée avec le code client en génération automatique. Le devis ou la commande se rattache à cet identifiant, pas à une ligne de tableur. Les homonymes se signalent. Dolibarr a déjà trop de tiers fantômes dans la plupart des dossiers qu'on ouvre ; on n'en ajoute pas un à chaque mail.
Passer de la commande validée à la facture, sans l'oublier
L'agent liste les commandes validées non facturées, prépare la facture, et vous la présente avant validation. Une commande partiellement livrée se facture pour ce qui est livré, ou attend, selon votre règle — une seule, écrite. Dolibarr permet les deux ; l'agent ne choisit pas. Le vendredi, la liste des commandes oubliées n'est plus une surprise, c'est un brouillon.
Tenir le catalogue quand la boutique vit ailleurs
Si les commandes naissent sur un site, l'agent crée ou met à jour le produit Dolibarr — référence, libellé, prix TTC ou HT selon le paramétrage, TVA. Il n'invente pas une référence déjà prise. Un écart de prix entre la boutique et Dolibarr remonte, il n'est pas écrasé en silence. La facture Dolibarr doit pouvoir se justifier face au ticket client, pas l'inverse.
Limites
Ce que cette intégration ne fera pas
Les contraintes qu'on rencontre pour de vrai. Les découvrir maintenant coûte une lecture ; les découvrir en cours de projet coûte le projet.
Pas de module, pas d'API pour ce module
L'explorateur d'une instance minimale est pauvre. Beaucoup d'échecs d'intégration Dolibarr sont des modules éteints, pas des bugs. Avant de chiffrer, on ouvre l'explorateur avec le jeton prévu, on coche ce qui manque, on mesure l'écart. Promettre la compta analytique sur une instance qui n'a pas le module, c'est un devis mensonger.
Vous hébergez, vous maintenez
Dolibarr est souvent auto-hébergé. L'API est alors derrière *votre* serveur, *votre* certificat, *votre* sauvegarde. Une mise à jour majeure peut changer un champ. Un agent en production a besoin d'une instance de test, d'une sauvegarde avant écriture massive, et de quelqu'un qui sait restaurer. Ce n'est pas inclus dans « on se branche ». C'est le coût réel d'un ERP libre.
La compta n'est pas le cœur documenté de l'API
Le wiki insiste sur les tiers, produits, factures, commandes. Les écritures du module comptable sont un autre sujet, moins uniformément exposé selon les versions. Si votre besoin est un grand livre piloté de l'extérieur, on le vérifie sur *votre* version, dans l'explorateur, avant de le vendre. Dolibarr n'est pas Pennylane. Le prendre pour tel est la confusion la plus chère.
Ce que brancher Dolibarr demande vraiment
On active le module d'API, on crée un utilisateur dédié, on génère sa clé, on ouvre l'explorateur, on teste une lecture de tiers puis une création sur une fiche jetable. Ensuite seulement on écrit le workflow. Sur une instance de production sans copie de test, on n'écrit pas en lot. Le reverse-proxy, chez ceux qui sont en auto-hébergé, se vérifie : une API mal routée renvoie du HTML, pas une erreur lisible, et on perd une journée à chercher ailleurs.
Vos questions
Dolibarr est-il plus simple à brancher qu'Odoo ?
Plus simple à allumer, oui : un module, une clé, un explorateur. Plus simple à tenir, non, dès que vous hébergez vous-même. Odoo cloud vous vend un contrat et une limite d'offre. Dolibarr vous vend une liberté et une maintenance. L'automatisation suit ce choix. Une TPE sans administrateur système s'épuisera sur les mises à jour. Une TPE qui a déjà Dolibarr en production, et quelqu'un pour le soigner, y gagne un branchement direct, sans palier Custom.
Faut-il développer un module Dolibarr en plus ?
Seulement si le geste n'existe pas dans l'API standard — un calcul de prix métier, un enchaînement de validation, un champ obligatoire maison. Le wiki décrit comment ajouter un service. C'est du développement dans Dolibarr, pas un agent à côté. On le fait quand la règle est stable. On ne le fait pas pour contourner un module éteint : on allume le module.
Peut-on pointer l'agent sur la démo Dolibarr ?
Pour découvrir l'explorateur, oui, l'éditeur en publie une. Pour construire, non : la démo n'a ni vos modules, ni vos champs, ni vos droits. Chaque instance Dolibarr est un dossier. Un scénario qui marche sur la démo et échoue chez vous n'est pas un bug de l'agent, c'est le produit. On développe contre une copie de votre base, ou on ne développe pas.
Une idée en tête ?
Réservez un rendez-vous ou écrivez-nous — réponse sous 24 h.