Connecteurs et API Dolibarr
pour en finir avec la double saisie
Votre boutique, votre banque, votre caisse et votre ERP qui se parlent.
Dolibarr expose une API REST complète. Je m'en sers pour relier votre ERP à WooCommerce, PrestaShop, votre banque, votre logiciel métier ou l'outil de votre expert-comptable : les données sont saisies une fois, au bon endroit, et circulent toutes seules.
Le symptôme : la même information tapée trois fois
Une commande arrive sur la boutique en ligne. Quelqu'un la recopie dans Dolibarr pour faire la facture. Puis il ajuste le stock à la main. Puis il pointe le paiement en regardant le relevé bancaire. Puis, en fin de mois, il exporte tout pour l'expert-comptable, qui ressaisit de son côté. Quatre saisies pour une vente, et une erreur à chaque étape possible.
Un connecteur fait ce travail à votre place, dans les deux sens, et signale ce qui ne colle pas au lieu de le laisser passer. Ce n'est pas un luxe de grande entreprise : c'est souvent la première chose rentable à faire après la mise en place de Dolibarr.
Cinq connecteurs Dolibarr courants
Chacun a ses pièges. Les connaître à l'avance évite les mauvaises surprises au moment de la mise en production.
Boutique en ligne : WooCommerce ou PrestaShop vers Dolibarr
Les commandes descendent dans Dolibarr avec le client, les lignes et le mode de paiement ; le stock et les prix remontent vers la boutique. Le piège classique : les doublons de clients, quand la même personne commande avec deux adresses e-mail. Le connecteur doit avoir une règle de rapprochement claire, décidée avec vous. Pour WooCommerce, cela se combine naturellement avec un site WordPress que je maintiens par ailleurs.
Banque : rapprochement des paiements
Import automatique des relevés et rapprochement avec les factures émises, par montant, référence ou nom de client. Ce qui est rapproché sans ambiguïté est pointé ; le reste vous est présenté pour décision. Le but n'est pas de tout automatiser aveuglément, mais de ne plus passer une heure par semaine à pointer ce qui est évident.
Expert-comptable : export des écritures
Génération périodique des écritures au format attendu par le cabinet, avec le plan comptable et les journaux correctement paramétrés en amont. C'est autant du paramétrage Dolibarr que du développement, et c'est le cabinet qui valide le format. Je travaille directement avec lui pour éviter les allers-retours par votre intermédiaire.
Logiciel métier : planning, caisse, GPAO, outil de terrain
Votre outil de planning crée des interventions ; Dolibarr doit en faire des factures. Votre caisse encaisse ; Dolibarr doit connaître le chiffre du jour et le stock restant. La faisabilité dépend de ce que l'autre logiciel expose : une API, un export de fichiers, ou rien du tout. Je le vérifie avant tout devis.
Webhooks et automatisations
Une facture validée déclenche un e-mail, une ligne dans un tableur partagé, une notification dans votre messagerie d'équipe, une tâche dans votre outil de projet. Dolibarr peut émettre ces événements ; je branche dessus ce que vous utilisez déjà, sans vous imposer un nouvel outil.
Ce que permet l'API REST de Dolibarr, et ce qu'elle ne permet pas
Ce qui est natif
- Une API REST documentée : tiers, produits, commandes, factures, stocks, projets, agenda, utilisateurs. Presque tout ce qui existe dans l'interface est accessible par programme, en lecture et en écriture.
- Des clés par utilisateur : chaque connecteur a son propre compte, avec uniquement les droits dont il a besoin. Une clé compromise se révoque sans toucher au reste.
- Des déclencheurs : Dolibarr sait signaler qu'un objet a été créé, validé ou modifié. C'est la base des synchronisations en temps réel.
- Une console d'exploration : l'API se teste directement depuis l'interface d'administration, ce qui rend le diagnostic rapide quand un flux échoue.
Ce qu'il faut savoir avant
- L'API ne réfléchit pas à votre place : les règles de gestion, quel client, quel entrepôt, quelle TVA, quel journal, doivent être écrites dans le connecteur. C'est là que se joue la qualité du travail, pas dans les appels techniques.
- Les erreurs doivent être visibles : un connecteur qui échoue en silence est pire que pas de connecteur. Chaque flux que je livre journalise ce qu'il fait et vous prévient quand il bloque.
- Les mises à jour de Dolibarr peuvent changer l'API : rarement, mais ça arrive. Un connecteur se teste à chaque montée de version, ce qui fait partie de la maintenance Dolibarr.
- Un module existant fait parfois l'affaire : pour WooCommerce et PrestaShop notamment, des modules publiés existent. Je les évalue d'abord ; le sur-mesure ne vient que s'ils ne couvrent pas votre cas.
Comment se construit un connecteur
1. On dessine le flux sur une feuille
Quelle donnée part d'où, arrive où, à quel moment, et que fait-on en cas de conflit. Cette feuille devient la spécification. Elle tient souvent sur une page, et c'est elle qui évite les malentendus.
2. Je vérifie la faisabilité des deux côtés
Accès à l'API de l'autre outil, formats d'export, limites de volume. Si un côté ne permet pas ce qu'on veut, on le sait avant le devis, pas après.
3. Développement sur une copie, tests avec vos vraies données
Le connecteur tourne d'abord sur une copie de votre Dolibarr, avec un échantillon réel : vos clients aux noms bizarres, vos produits à variantes, vos cas particuliers. C'est là qu'on découvre ce que la spécification n'avait pas prévu.
4. Mise en production surveillée
Bascule sur l'instance réelle, avec journalisation et alertes. Les premières semaines, je regarde les journaux régulièrement. Vous recevez la documentation du flux et le code, qui vous appartient comme tout module que je développe.
Ce qu'on me demande sur les connecteurs
Dolibarr peut-il se connecter à WooCommerce ?
Oui, dans les deux sens : commandes et clients vers Dolibarr, stocks et prix vers la boutique. Des modules publiés existent et couvrent les cas standards ; le sur-mesure intervient pour les règles particulières, comme des tarifs par client ou des produits composés.
Faut-il activer l'API dans Dolibarr ?
Oui, c'est un module à activer, puis une clé à générer pour un utilisateur dédié aux droits limités. C'est une opération de quelques minutes, mais les droits accordés méritent réflexion : un connecteur qui ne fait que lire ne doit pas pouvoir écrire.
Que se passe-t-il quand un flux échoue ?
Le connecteur journalise l'erreur, met l'élément de côté et vous prévient. Rien n'est perdu ni écrit à moitié. Vous corrigez la donnée en cause, souvent un client incomplet ou un produit inconnu, et le flux reprend.
Combien de temps prend un connecteur ?
Un flux simple à sens unique, comme un export vers le cabinet comptable, se compte en jours. Une synchronisation bidirectionnelle avec une boutique, avec gestion des doublons et des stocks, se compte en semaines. Le devis précise le périmètre et ce qui en est exclu.
Mon autre logiciel n'a pas d'API, est-ce bloquant ?
Pas forcément. Un export de fichiers planifié, même en CSV, permet souvent une synchronisation quotidienne suffisante. Si le logiciel ne sort rien du tout, je vous le dis franchement : aucun connecteur ne peut lire ce qui n'est pas exposé.
Une information que vous saisissez deux fois ?
Dites-moi d'où elle part et où elle doit arriver. Je vous réponds sur la faisabilité avant de parler de devis.
Décrire le flux à connecter