API REST de Dolibarr : connecter son ERP au site et à la boutique en ligne

Ce que l'API REST change dans le quotidien d'une PME

Une commande arrive sur la boutique en ligne. Quelqu'un la recopie dans Dolibarr, crée le client s'il n'existe pas, puis ajuste le stock à la main. Une faute de frappe sur une adresse, un oubli de ligne, et la livraison part mal. L'API REST de Dolibarr supprime ces gestes. Elle expose les objets de l'ERP (tiers, produits, devis, commandes, factures, contacts, projets) sous forme d'adresses web que d'autres logiciels peuvent lire ou modifier, en échangeant des données au format JSON. Votre site, votre boutique ou un outil interne parlent alors directement à Dolibarr, sans passer par une saisie humaine. L'API ne remplace pas l'interface : elle travaille en parallèle, avec les mêmes droits et les mêmes règles de gestion. Le gain tient moins à la vitesse qu'à la fiabilité : une donnée est saisie une fois, à la source, puis circule.

Activer l'API et préparer un accès dédié

L'API est fournie sous forme de module. Vous l'activez depuis la liste des modules de Dolibarr, comme n'importe quel autre, puis vous vérifiez que le serveur web laisse passer les appels vers le point d'entrée de l'API. Sur un hébergement géré, c'est souvent déjà prêt. Sur un serveur interne, la réécriture d'adresses est le point qui bloque le plus souvent. Ensuite, ne branchez jamais vos outils sur le compte d'un employé. Créez un utilisateur technique par application connectée, par exemple un pour la boutique et un pour le site. Chacun reçoit sa propre clé d'accès, personnelle à ce compte. Vous saurez ainsi qui a écrit quoi dans l'historique, et vous pourrez couper un accès sans gêner les autres. Si vous hésitez sur l'installation, notre équipe d'implémentation prépare ce socle avec vous.

Sécuriser les échanges avant le premier appel

Une API ouverte est une porte supplémentaire sur vos données commerciales. Quelques règles évitent l'essentiel des problèmes. Exposez-la uniquement en HTTPS, jamais en clair, car la clé circule à chaque requête. Donnez à chaque utilisateur technique le strict nécessaire : une boutique qui crée des commandes n'a pas besoin de supprimer des factures. Conservez les clés dans la configuration des applications, pas dans une page publique ni dans un fichier partagé par courriel. Changez une clé dès qu'un prestataire quitte le projet. Si les adresses IP des outils appelants sont stables, restreignez l'accès au niveau du serveur. Gardez aussi Dolibarr à jour : les correctifs de sécurité comptent autant que les réglages. Notre article sur la sécurisation d'une instance en production détaille ces points côté serveur.

Tester avant de brancher quoi que ce soit

Ne connectez jamais directement la production. Dupliquez votre base sur une instance de test, créez-y un utilisateur technique et faites vos premiers essais avec un outil de requêtes classique. Commencez par une lecture simple, par exemple la liste des produits. Puis tentez une création : un tiers fictif, une commande de test. Observez la réponse. Les codes d'erreur de l'API sont explicites et vous disent si la clé est refusée, si un champ obligatoire manque ou si l'objet n'existe pas. Dolibarr fournit aussi une page d'exploration de l'API, qui liste les points d'accès disponibles selon les modules actifs. Utilisez-la comme référence plutôt que de deviner les noms de champs. Une fois les scénarios validés sur la copie, vous rejouez les mêmes appels en production, avec une clé distincte.

• Dupliquer la base de production sur une instance de test.
• Créer un utilisateur technique avec des droits limités.
• Lire une liste, puis créer un objet fictif.
• Provoquer volontairement une erreur pour voir la réponse.
• Rejouer le scénario validé en production avec une autre clé.

Quels échanges automatiser en premier

Visez d'abord les flux qui reviennent chaque jour et qui coûtent cher quand ils se trompent. Premier candidat : les commandes de la boutique vers Dolibarr, avec création ou rapprochement du client. Deuxième : les stocks et les prix, dans le sens inverse, pour que le catalogue en ligne reflète la réalité. Troisième : les demandes de contact et de devis du site, qui deviennent des tiers et des opportunités sans ressaisie. Plus tard viendront les statuts de livraison et de paiement renvoyés vers le client. Un flux à la fois, validé pendant quelques semaines, vaut mieux qu'un grand chantier simultané. Si votre activité est surtout commerciale, notre page solutions pour le commerce montre comment ces échanges s'insèrent dans le reste de la gestion.

Les pièges qui reviennent sur le terrain

Le premier piège est le doublon. Sans identifiant commun, une même personne devient trois tiers. Choisissez une clé de rapprochement stable, comme l'adresse de messagerie ou une référence externe, et appliquez-la partout. Deuxième piège : les flux dans les deux sens. Si le site et l'ERP modifient le même champ, le dernier qui écrit gagne. Désignez une source de référence par donnée : le stock vient de Dolibarr, la description marketing vient du site. Troisième piège : l'absence de reprise sur erreur. Une requête qui échoue la nuit doit être rejouée et signalée, pas perdue. Prévoyez un journal et une alerte. Enfin, pensez aux volumes : des milliers d'appels simultanés peuvent ralentir l'interface des utilisateurs. Étalez les synchronisations et évitez les relectures complètes du catalogue à chaque minute.

Passer à l'action : cadrer votre premier flux

Prenez une heure avec la personne qui ressaisit le plus de données. Listez les outils concernés, le sens de chaque échange, le champ qui sert d'identifiant et la fréquence souhaitée. Choisissez un seul flux, en général les commandes de la boutique. Si vous préférez déclencher des actions dès qu'un événement survient dans Dolibarr, le module DolicraftWebhook envoie des notifications vers des outils d'automatisation, en complément de l'API. Pour un cadrage technique de votre cas, des connecteurs sur mesure ou une revue de sécurité, contactez Dolicraft en décrivant vos outils actuels. Nous vous indiquerons ce qui relève du paramétrage et ce qui demande un développement.