Lorsqu'une facture est échue et que personne ne relance
Vous ouvrez votre boîte : plusieurs accusés de réception sans réponse, une facture échue, des relances envoyées trop tard — et personne ne peut rapidement dire si un paiement est arrivé. De telles situations quotidiennes coûtent du temps et affectent la trésorerie. Une solution simple pour y remédier est une liaison directe on‑premise entre votre système Debentra et la comptabilité financière interne (FiBu) — sans prestataire cloud.
Pourquoi un connecteur local ?
Un connecteur on‑prem relie Debentra et votre FiBu via le réseau interne (LAN). Avantages en bref :
- Pleine souveraineté des données : pas de prestataires tiers, pas de stockage intermédiaire dans le cloud.
- Échange de données direct : détection des paiements plus rapide et moins de retouches manuelles.
- Contrôle fin : vous conservez la main sur les validations, par ex. pour les relances de paiement.
Options d'architecture – trois modèles praticables
Choisissez la variante adaptée selon l'infrastructure existante et les règles de sécurité :
1) Export de fichiers basé sur SFTP
Debentra exporte régulièrement des fichiers CSV/JSON sur un serveur SFTP interne, que le logiciel FiBu importe automatiquement.
- Avantages : simple à mettre en œuvre, compatible avec de nombreux outils FiBu.
- Inconvénients : latence due au traitement par lots (p. ex. toutes les 5–15 minutes).
2) Webhook interne via LAN
Debentra envoie, lors d'événements (p. ex. nouvelles créances, encaissement), des HTTP‑POSTs vers une adresse interne protégée que votre FiBu reçoit.
- Avantages : notification en temps réel, délai réduit.
- Inconvénients : nécessite un point de terminaison constamment joignable et une couche d'authentification.
3) Passerelle API locale (middleware)
Une petite passerelle auto‑hébergée lit les exports ou les endpoints API de Debentra et transforme les données au format FiBu ; souvent exécutée dans un conteneur Docker.
- Avantages : flexibilité maximale pour le mapping et les règles de validation.
- Inconvénients : effort de développement plus important, mais évolutif à long terme.
Préparation : exigences et vérifications
Avant de commencer, clarifiez ces points :
- Quelles possibilités d'export propose votre système Debentra ? (export de fichiers, webhook d'événements, API locale)
- Quelles méthodes d'import accepte votre FiBu ? (ingestion SFTP, API HTTP, import manuel de fichiers)
- Politiques de sécurité : segmentation VLAN, règles de pare‑feu, méthodes d'authentification (clé SSH, mTLS, clés API).
- Responsabilités : qui approuve les relances de paiement ? Qui vérifie les transferts échoués ?
Réalisation pratique : étape par étape
1. Définir le cas d'utilisation et le mapping des données
Définissez quels événements et quels champs doivent être transmis. Champs typiques :
- ID de facture, numéro client
- Date de facture, date d'échéance
- Montant ouvert, paiements partiels / état des échéances
- Statut de paiement et référence de comptabilisation
- ID de documents ou chemin PDF (pour archivage dans la FiBu)
Créez un document de mappage : Champ Debentra → Champ FiBu. Ajoutez des règles de validation (par ex. champs obligatoires, valeurs autorisées pour les codes de statut).
2. Exemple : configuration SFTP (export basé sur des fichiers)
Étapes en bref :
- Créez un utilisateur système dédié sur le serveur SFTP interne (par ex. debentra_sync), imposez l'authentification par clé SSH.
- Configurez Debentra pour qu'il dépose périodiquement (par ex. toutes les 5 minutes) des fichiers CSV/JSON contenant les postes ouverts dans un dossier défini sur le SFTP.
- Dans la FiBu, créez un job d'import qui consomme les nouveaux fichiers, les valide et les comptabilise. Les fichiers échoués sont déplacés dans un dossier de quarantaine et signalés par mail à l'équipe.
Conseils pratiques :
- Générer la clé SSH sur l'hôte Debentra : ssh-keygen -t ed25519 -f /var/lib/debentra/keys/debentra_sync
- Inscrire la clé publique sur le serveur SFTP dans ~/.ssh/authorized_keys de l'utilisateur debentra_sync.
- Permissions : dossier cible inscriptible uniquement par debentra_sync, droit de lecture pour le processus d'import de la FiBu.
3. Exemple : webhook interne (temps réel via LAN)
Étapes :
- La FiBu expose via une interface interne (par ex. http://fibu-internal.local/api/sync) un point de terminaison.
- Debentra configure un webhook qui envoie des payloads à ce point de terminaison pour les événements définis.
- Sécurisez le canal : mTLS ou une clé API forte, liste d'adresses IP autorisées et courte durée de vie des tokens.
Conseil de conception : implémentez dans la FiBu un traitement idempotent (par ex. basé sur l'ID de facture) afin que des appels webhook répétés n'engendrent pas de doublons.
4. Exemple : API‑Bridge locale (middleware)
Concept :
- Déployez une petite application bridge (par ex. Node.js, Python) dans votre LAN en tant que conteneur Docker.
- La bridge récupère les exports Debentra ou appelle les endpoints API, mappe les champs et appelle l'API de la FiBu ou dépose des fichiers.
- Intégrez journalisation, tentatives de reprise (retries) et une file de lettres mortes (Dead‑Letter‑Queue, DLQ) pour les cas d'erreur.
Composants d'exemple :
- Scheduler / écouteur d'événements
- Module de mappage avec validation
- Module de transport (client SFTP, client HTTP avec mTLS)
- Monitoring : statistiques d'export et alertes d'erreur par e‑mail/Teams
Sécurité et exploitation
- Réseau : n’autorisez que des IP internes et appliquez des règles de pare‑feu aux points sensibles.
- Authentification : clés SSH, mTLS, tokens API à courte durée de vie.
- Journaux & conservation : conservez les logs d’export et les protocoles de transfert au moins aussi longtemps que vos politiques internes l’exigent.
- Sauvegardes : versionnez les configurations et les templates de mapping, archivez les containers Bridge sous forme d’image.
- Supervision : contrôles de disponibilité des composants du connecteur et notifications automatisées en cas d’erreur.
Intégration au processus : garder les validations et le contrôle
Même avec l’automatisation, le contrôle reste entre les mains de l’utilisateur. Définissez des règles déclenchant une validation manuelle avant l’envoi de relances (par ex. pour des montants élevés ou des postes litigieux). Debentra permet de préparer des relances et de les soumettre à la validation des personnes responsables — votre solution de connecteur doit transmettre et respecter cette information de validation.
Cas d’erreur et récupération
Prévoyez les problèmes typiques :
- Panne réseau : mise en file d’attente dans l’export Debentra ou dans la Bridge, nouvelle tentative automatique.
- Erreur de mapping : quarantaine avec notification à l’équipe comptable.
- Doublons : traitement idempotent basé sur des identifiants uniques.
Exemple pratique en bref
Une entreprise de taille moyenne utilise Debentra. Elle choisit la variante SFTP : Debentra exporte toutes les 10 minutes les postes ouverts au format JSON dans /outgoing/openitems/. Un timer systemd sur le serveur de la comptabilité récupère les nouveaux fichiers, les valide et enregistre automatiquement ou marque pour vérification manuelle. En cas de postes litigieux, le fichier est déplacé dans un dossier de quarantaine et transmis via ticket à l’équipe. Ainsi, le travail de rapprochement manuel diminue et la comptabilité conserve la maîtrise complète des données.
Conclusion
Une connexion comptable on‑prem entre Debentra et votre logiciel de comptabilité est techniquement réalisable et améliore la transparence ainsi que la sécurité des processus, sans transférer de données vers des clouds tiers. Choisissez l’architecture (SFTP, webhook interne, passerelle API locale) adaptée à vos besoins et documentez les mappings, règles de sécurité et scénarios de panne. Important : automatisez, mais conservez des points de validation pour les actions critiques.
Intéressé par une solution qui réunit vue centrale, pilotage des processus et souveraineté des données ? Debentra est disponible en self‑hosted dans les éditions BASIS, PRO et PREMIUM — PRO réduit les rapprochements manuels, PREMIUM offre des intégrations comptables supplémentaires. Choisir une édition
Prochaine étape
Essayer Debentra
Vue centrale et pilotage des processus pour les postes ouverts et les paiements avec souveraineté totale des données ; réduction du travail de rapprochement manuel (PRO) et possibilité d’intégration comptable (PREMIUM) ; modèles d’installation et de licences au choix.