Aujourd’hui, la plupart des PME et des associations utilisent Dolibarr pour gérer leurs ventes, stocks, factures, contacts… Mais savez‑vous que l’outil gagne encore en puissance lorsqu’il est couplé à Zapier ? Dans cet article, nous vous montrent‑nos comment intégrer les deux solutions, quelles bonnes pratiques adopter et vous fournissons des exemples concrets pour passer de la théorie à la mise en œuvre immédiatement.
1. Pourquoi associer Dolibarr et Zapier ?
| Besoin fréquent | Solution native de Dolibarr | Apport de Zapier |
|---|---|---|
| Automatiser la création de factures dès qu’une commande est validée dans le CRM ou le service client | Factures créées manuellement ou via l’API interne | Déclencheur instantané dès qu’un « devis » est passé à « accepté », génération de facture, envoi par email et archivage |
| Synchroniser les stocks avec un ERP/logistique externe | Gestion des stocks intégrée | Mise à jour en temps réel d’un tableau Google Sheets ou d’un logiciel de WMS (Warehouse Management System) lorsqu’un lot est sorti ou rentré |
| Notifier les équipes (service client, logistic, direction) lorsqu’un événement critique survient | Envoi d’emails ou SMS manuels | Alertes Slack/Telegram, création de tickets Jira ou Asana, appels téléphoniques automatiques |
| Exporter des rapports périodiquement | Rapports PDF/CSV générés manuellement | Planification de rapports automatisés (ex. chiffre d’affaires mensuel) et diffusion aux parties prenantes |
En résumé : Zapier agit comme le « cerveau » qui relie Dolibarr à des milliers d’applications (CRM, comptabilité, messagerie, messagerie instantanée, outils de BI…) — sans écrire une ligne de code.
2. Prérequis avant de déclencher le premier Zap
| Étape | Détails |
|---|---|
| Version de Dolibarr | 20.x ou supérieure (les modules API sont stables dès cette branche). |
| Extension API | Activer le “Webservices / API” dans Configuration → Dépôt → API et créer une clé d’API dédiée (ex. zapi-dolibarr) avec les droits read/write sur les modules nécessaires (customers, invoices, products, …). |
| Zapier | Compte actif (plan Free suffit pour tester) et accès à la fonction “Webhooks”. |
| Sécurité | Stocker la clé API dans les “Environnement variables de Zapier” ou un “Secret” afin d’éviter la fuite dans les logs. |
| Environnement de test | Préparer un sous‑ensemble de données (ex. 10 devis, 10 clients) dans un sandbox Dolibarr ou un environnement de dev pour valider le flux avant le passage en prod. |
3. Bonnes pratiques à adopter
3.1. Modéliser votre flux avant d’automatiser
- Dessinez le parcours (ex. « Devis → Validation → Facture → Envoi »).
- Identifiez les points de rupture (délai, erreur, responsabilité).
- Définissez les déclencheurs (événement Exact, changement de statut, date).
- Listez les actions attendues (création, mise à jour, envoi, archivage).
- Documentez les champs transférés (nom du client, montant TTC, numéro de commande).
Astuce : Utilisez un tableau partagé (Google Sheets, Miro, Notion) pour co‑construire le flux avec toutes les parties prenantes (sales, finance, logistique).
3.2. Sécuriser les données sensibles
- Masquage des champs : Ne pas faire passer des données personnelles (numéro de client, email privé) dans le corps du Zap si vous avez des contraintes RGPD.
- Limitation des droits API : Créez des clés API avec le minimum de privilèges (ex. lecture uniquement sur
customers, écriture uniquement surinvoices). - Chiffrement : Si le flux passe par des Webhooks HTTP, activez le SSL/TLS obligatoire et ne stockez jamais les clés en clair dans le code Zapier.
3.3. Gestion des erreurs et de la reprise
| Technique | Description |
|---|---|
| Path (chemin conditionnel) | Si le nombre de devis trouvés = 0 → stop avec notification Slack. |
| Retry / Delay | Ajouter un délai de 5 min avant la prochaine tentative en cas de réponse HTTP 5xx. |
| Log de chaque étape | Stocker dans un fichier Google Drive ou dans Zapier > History les input/output et les codes d’erreur. |
| Alerting | Créez un Zap « Monitoring » qui surveille le taux de succès des autres Zaps (ex. si > 5 échecs sur 24 h, envoyer un mail à l’admin). |
3.4. Versionner vos Zaps
- Nommage explicite : préfixez chaque Zap avec le domaine fonctionnel (ex.
DOLIBARR_Invoice_Create_v1). - Versioning : Dupliquez un Zap avant de le modifier de façon non réversible et conservez les anciennes versions dans un dossier de sauvegarde.
- Documentation interne : Ajoutez une description détaillée dans le champ “Notes” de Zapier (objectifs, champs clés, points de vigilance).
4. Exemple concret : De la création d’un devis à la génération automatique d’une facture
4.1. Le scénario métier
Lorsqu’un devis passe au statut « Accepté » dans Dolibarr, on veut :
- Créer automatiquement une facture avec les mêmes lignes.
- Envoyer la facture par email à la chaîne de commercial.
- Archiver la facture dans un dossier Google Drive.
4.2. Construction du Zap
| Étape | Trigger / Action | Application | Détails |
|---|---|---|---|
| 1 | New or Updated Record | Dolibarr (Webhooks by Zapier) | Événement : “Record Updated” – Filtre sur le module Invoices/Estimates + condition status = “Accepted”. |
| 2 | Find Record | Dolibarr | Chercher le Estimate ID qui vient d’être mis à “Accepted”. |
| 3 | Create Invoice | Dolibarr | Création d’une facture en copiant les lignes du devis (montant, TVA, description). |
| 4 | Email by Zapier | Envoi à {{invoice.customer_email}} avec le PDF généré en pièce jointe. |
|
| 5 | Google Drive – Upload File | Google Drive | Sauvegarder le PDF dans le dossier #Invoices/{{invoice_number}}/. |
| 6 | Slack – Send Message | Slack | Notification à #comptabilite : “🧾 Facture {{invoice_number}} créée pour le client {{customer_name}}”. |
| 7 | Filter / Path | Zapier | Si la génération de facture échoue, envoyer un message d’alerte dans Slack. |
Diagramme simplifié
[Dolibarr – New/Updated Estimate] --> (Filter: status = Accepted)
↓
[Dolibarr – Find Estimate] --> (Create Invoice)
↓
[Email by Zapier] --> (Send PDF) --> [Google Drive] --> [Slack Notification]
↓
[Path – Error] --> (Send Alert)4.3. Mapping des champs (extraits)
| Champ Dolibarr (source) | Champ Zapier (cible) | Commentaire |
|---|---|---|
est_id |
estimate_id |
Utilisé pour retrouver le devis. |
customer_email |
invoice.customer_email |
Copié tel quel. |
invoice_total_ht |
invoice.amount_ht |
Calculé à partir du total du devis. |
invoice_vat_percent |
invoice.vat_rate |
20 % par défaut, mais configurable. |
invoice_number |
invoice_number |
Généré par Zapier : INV-{{date.now|format("YYYYMMDD")}}-{{random(1000)}}. |
Astuce technique : Dans la configuration du module “Create Invoice”, activez l’option “Copy fields from source record” pour éviter de redéfinir manuellement chaque valeur.
4.4. Testez en production contrôlée
- Environnement : Utilisez le même compte Zapier avec un Sandbox Dolibarr (version de test).
- Run : Créez un devis fictif, changez-le en « Accepted ».
- Vérifiez :
- Facture créée (vérifiez le
invoice_number). - Email reçu.
- PDF présent dans le dossier Drive.
- Message Slack publié.
- Facture créée (vérifiez le
- Monitoring : Laissez le Zap History active pendant 24 h, puis passez aux logs.
5. Trois autres cas d’usage “prêts à l’emploi”
5.1. Synchronisation en temps réel des stocks avec Google Sheets
- Trigger : New Sale (module Orders) dans Dolibarr.
- Action 1 : Find Product par SKU.
- Action 2 : Update Row dans Google Sheets (module Sheets) – diminuer la colonne Stock du produit.
- Bonus : Ajouter un Path qui envoie un email à l’équipe logistique si le stock passe sous le seuil de réapprovisionnement (défini dans le sheet).
Exemple : Après la vente de 3 unités d’un article “PROD‑A”, la ligne du sheet passe de 12 à 9 unités.
5.2. Création automatique de tickets Jira lorsqu’un litige client apparaît
- Trigger : Record Updated – champ
statusde ticket support passe à “Open” dans Dolibarr. - Action : Create Issue dans Jira (projet SUP).
- Payload : Copie du champ
subject,description,customer_name. - Result : Un ticket Jira “INC-2025‑00123” est créé automatiquement, avec l’assignee « support‑team ».
5.3. Notification Slack instantanée lorsqu’un paiement est reçu (Webhook externe)
- Trigger : Webhooks by Zapier (recevoir le POST de votre PSP, ex. Stripe).
- Action : Filter – si
payment_status = "captured"alors Slack – Send Message : “✅ Paiement reçu de {{customer_name}} – {{amount}} €”.
Note : Le webhook doit renvoyer un payload JSON contenant les champs de Dolibarr liés (client ID, montant). Vous pouvez alors mapper directement ces données vers le message Slack.
6. Checklist avant de passer en production
| ✅ | Vérification |
|---|---|
| API Dolibarr | Clé API fonctionnelle, droits limités, test de connexion depuis Zapier. |
| Zap déclenché | Pas de latence supérieure à 30 s (exclut les appels très lourds). |
| Gestion des doublons | Ajout d’une étape “Find Record” pour éviter la création multiple d’une facture. |
| Conformité RGPD | Aucun champ personnel transmis en clair dans les logs Zapier. |
| Monitoring | Log de chaque step, alerte via Slack/Email en cas d’échec. |
| Documentation | Diagramme du flux + tableau des champs transposés partagés avec l’équipe métier. |
| Plan de reprise | Procédure à suivre si un Zap s’arrête (ex. réinitialiser le trigger, vérifier les quotas). |
7. Conclusion
Intégrer Dolibarr avec Zapier, c’est transformer votre ERP/CRM en véritable moteur d’automatisation : vous pouvez déclencher des actions en quelques clics, sans écrire de code, tout en conservant la traçabilité et la sécurité de vos données.
- Commencez petit (ex. le devis → facture) et ajoutez progressivement d’autres flux (stocks, tickets, rapports).
- Mettez en place une gouvernance : qui crée les Zaps ? Qui les valide ? Qui surveille les erreurs ?
- Exploitez les bonnes pratiques : versionning, monitoring, sécurité des clés.
Avec ces fondations, votre organisation pourra gagner en réactivité, réduire les tâches manuelles et offrir une meilleure expérience client tout en gardant le contrôle sur les processus critiques.
À vous de jouer ! Créez votre premier Zap, testez‑le sur un jeu de données réaliste, puis laissez le moteur Zapier faire le travail de fourmi qui libérera le temps de vos équipes pour des missions à plus forte valeur ajoutée.
Sources :
- Documentation officielle Dolibarr – “Webservices / API” (v20.3).
- Zapier Help Center – “Webhooks”, “Filters”, “Paths”.
- Études de cas interne (2024‑2025) – Entreprises de distribution et associations culturelles.
Bonne automatisation ! 🌟