Dolibarr + Stripe : n8n sans casser l’existant

Introduction

Dolibarr, l’ ERP open source populaire chez les TPE/PME, et Stripe, le géant des paiements en ligne, forment un duo puissant. Mais leur intégration directe peut s’avérer complexe, risquée pour la stabilité de votre système, ou nécessiter des développements coûteux.
Et si vous pouviez connecter ces deux outils sans modifier une seule ligne de code de Dolibarr ? C’est là que n8n, la plateforme d’automatisation low-code, change la donne. Découvrons comment créer un pont sécurisé et évolutif entre Dolibarr et Stripe.

Le défi : Pourquoi une intégration « sans casser l’existant » ?

Beaucoup d’entreprises utilisent Dolibarr pour la gestion des factures, des clients et des contrats. Lorsqu’elles souhaitent ajouter des paiements en ligne via Stripe, deux écueils apparaissent :

  1. Modifier Dolibarr directement : risky. Une mauvaise manipulation peut bloquer votre activité.

  2. Développer une extension sur mesure : coûteux en temps et en maintenance.

  3. Utiliser des connecteurs tiers peu fiables : souvent limités ou obsolètes.

n8n propose une troisième voie : automatiser en externe, en laissant chaque système faire ce qu’il fait de mieux, tout en synchronisant les données via des workflows visuels.

Comment ça marche ? L’architecture en 3 couches

  1. Dolibarr (source de vérité)
    Gère les factures, les clients, les contrats. On interroge son API REST.

  2. Stripe (moteur de paiement)
    Traite les transactions, les remboursements, les abonnements. On utilise son API robuste.

  3. n8n (le chef d’orchestre)
    Crée des workflows qui catalysent les données entre les deux, sans les altérer.

Exemple concret :
Lorsqu’une facture est créée dans Dolibarr → n8n génère automatiquement un lien de paiement Stripe et l’ajoute à la facture → Le client paie → Stripe notifie n8n → n8n met à jour le statut de la facture dans Dolibarr.

Cas d’usage typique : Synchronisation des paiements

Objectif : Toute transaction Stripe (paiement, échec, remboursement) se reflète automatiquement dans Dolibarr.

Workflow n8n suggéré :

  1. Déclencheur : Webhook Stripe ( événement payment_intent.succeeded, payment_intent.payment_failed, etc.)

  2. Étape 1 : Récupérer la facture Dolibarr liée (via l’ID client ou métadonnées stockées dans Stripe).

  3. Étape 2 : Mettre à jour le statut de la facture Dolibarr via l’API (en "payée", "en retard", etc.).

  4. Étape 3 (optionnel) : Envoyer un email au client depuis Dolibarr avec la confirmation.

Astuce : Stockez l’ID de la facture Dolibarr dans les metadatas de Stripe lors de la création du paiement. Cela permet un lien fiable entre les deux systèmes.

Avantages clés de l’approche n8n

✅ Non-intrusif : Dolibarr et Stripe restent inchangés. Mise à jour d’un côté n’impacte pas l’autre.
✅ Évolutif : Ajoutez d’autres automations (ex: créer un contact dans Dolibarr lors d’un nouvel abonné Stripe).
✅ Maintenable : Les workflows sont visuels, documentés, et modifiables par un non-développeur formé.
✅ Journalisation : n8n loggue chaque étape. En cas d’erreur, on sait où cela a coincé.
✅ Gratuit (self-hosted) : n8n Community Edition suffit pour commencer. Version Cloud payante pour plus de confort.

Mise en garde : Ce qu’il faut surveiller

⚠️ Sécurité des clés API : Stockez-les dans les credentials n8n, jamais en dur dans les workflows.
⚠️ Gestion des erreurs : Prévoyez des étapes "catch" dans vos workflows pour les timeouts ou erreurs API.
⚠️ Idempotence : Évitez les doublons (ex: deux webhooks pour le même événement). Utilisez des IDs uniques.
⚠️ Performances : n8n s’exécute en tâche planifiée ou webhook. Vérifiez les limites d’API de Dolibarr/Stripe.

Commencer en 4 étapes

  1. Installez n8n (Docker, npm, ou cloud.n8n.io).

  2. Connectez Dolibarr : utilisez le connecteur HTTP Request ou le nœud Dolibarr communautaire (vérifiez la compatibilité de votre version).

  3. Connectez Stripe : utilisez le connecteur officiel Stripe dans n8n (très complet).

  4. Construisez votre premier workflow en following le schéma ci-dessus, testez en mode "manuel" avant d’activer le webhook.

Conclusion : L’automatisation au service de la sérénité

Lier Dolibarr et Stripe via n8n, c’est choisir l’agilité sans risque. Vous gardez vos systèmes éprouvés, vous ajoutez de l’intelligence de connexion en périphérie, et vous gagnez en temps opérationnel tout en réduisant les erreurs manuelles.

Que vous soyez une petite structure voulant encaisser en ligne ou une entreprise avec des besoins de synchronisation complexes (abonnements, notes de frais, etc.), cette approche low-code/no-break mérite d’être explorée.

Prochaines étapes :

  • Testez un workflow simple de création de lien de paiement Stripe depuis une facture Dolibarr.

  • Surveillez les logs n8n les premiers jours.

  • Élargissez progressivement à d’autres événements (remises, taxes, etc.).

L’intégration parfaite n’existe pas ? Avec n8n, vous la construisez vous-même, brique par brique, sans jamais toucher aux fondations. 🧱✨

Article inspiré de retours d’administrateurs Dolibarr et de pratiques d’agences digitales. n8n et Dolibarr étant des projets open source, vérifiez la compatibilité des versions et testez toujours en pré-production.

Publications similaires