Module DoliBank Match
Module DoliBank Match
DoliBank Match est un module complémentaire pour Dolibarr ERP/CRM de rapprochement bancaire explicable. Il importe les relevés bancaires dans tous les formats courants, propose des correspondances avec les factures clients et fournisseurs, les salaires, les charges sociales et les notes de frais en justifiant chaque proposition, et ne comptabilise rien sans validation humaine explicite.
| Éditeur | arcchester |
|---|---|
| Licence | GPL v3 |
| Compatibilité Dolibarr | 18.0 à 24.x (validé sur 18.0.5, 20.0.4 et 24.0.0) |
| PHP | 7.4 minimum |
| Prérequis | Module Banque / Caisse actif ; MySQL ou MariaDB |
| Dépendances | Aucune — les règlements sont écrits par les classes natives de Dolibarr |
| Distribution | Fiche sur le Dolistore |
Fonctionnalités
Import de relevés
- Formats acceptés : CSV/TXT, OFX 1 et 2, QIF, ISO 20022 CAMT.052/.053/.054, MT940/STA et CODA 2.x.
- Prévisualisation avant import : le fichier est analysé, stocké côté serveur et rattaché à l'entité, à l'utilisateur et au compte bancaire ; rien n'est écrit tant que l'import n'est pas confirmé.
- Imports immuables et détection de doublons par empreinte SHA-256 : réimporter le même fichier ne crée jamais de doublon.
- Rapport des lignes rejetées : aucune ligne n'est perdue silencieusement.
Pour un fichier CSV, seules trois informations sont obligatoires : une date d'opération, un libellé, et soit une colonne de montant, soit deux colonnes débit et crédit. Les colonnes facultatives (devise, date de valeur, identifiant, référence, contrepartie, IBAN) sont reconnues sous leurs noms français et anglais usuels.
Rapprochement explicable
- Candidats proposés parmi les factures clients et fournisseurs, les avoirs et les acomptes, les salaires, les charges sociales et fiscales et les notes de frais (ces trois familles uniquement face aux débits, chacune désactivable), chaque proposition affichant les éléments de preuve qui l'ont produite.
- Preuves prises en compte : montant, date, référence fournisseur, références structurées belges OGM/VCS, ISO 11649 RF, et IBAN validé du tiers.
- Le montant exact ne suffit jamais à lui seul à déclencher une proposition — garde-fou volontaire contre les faux rapprochements.
- Règlement multi-factures : un virement affecté à plusieurs factures du même tiers ; paiements partiels pris en charge.
- Frais bancaires enregistrés via
PaymentVarious, virements internes proposés et écritures croisées. - Versements de plateformes Stripe, PayPal et Shopify Payments normalisés, avec contrôle brut / frais / remboursements / net.
- Alerte anti-fraude IBAN : un paiement fournisseur qui part vers un IBAN différent de ceux enregistrés pour ce fournisseur est signalé en rouge et ramené sous le seuil de forte confiance.
- Règles réutilisables et apprentissage IBAN — les règles proposent, elles ne comptabilisent jamais d'elles-mêmes ; l'apprentissage n'a lieu qu'après validation humaine.
Sécurité de la comptabilisation
La comptabilisation native est désactivée par défaut et exige trois conditions simultanées : la permission de rapprochement, une décision explicitement validée, et la permission dédiée de comptabilisation accompagnée du réglage correspondant du module. S'y ajoutent la protection contre les doubles comptabilisations, contre les validations concurrentes et contre les sur-allocations cumulées, l'idempotence des décisions, un état d'erreur de comptabilisation explicitement non rejouable, et une piste d'audit en ajout seul.
Interface
Tableau de bord (taux de rapprochement, temps économisé, garde-fous actifs), boîte d'opérations avec filtres avancés et indices colorés, Mode Express au clavier (→ valider, ← ignorer, ↓ passer ; un virement multi-factures se valide d'un coup), écran de rapprochement détaillé, règles, versements de plateformes, connecteurs, bordereau imprimable et export CSV comptable, page de diagnostic et widget d'accueil. Interface et documentation en français et en anglais.
Installation
- Télécharger le zip
module_dolibankmatch-x.y.z.zipdepuis le Dolistore. - Dans Dolibarr : Accueil → Configuration → Modules/Applications → Déployer/installer un module externe.
- Activer DoliBank Match (famille « Finance / Facturation »).
- Configurer un compte bancaire par défaut et les seuils de score.
- Attribuer les droits d'import et de rapprochement aux utilisateurs concernés.
- N'accorder la permission de comptabilisation qu'aux comptables autorisés, et n'activer la comptabilisation native qu'après un essai sur une copie de recette.
En cas de mise à jour, désactiver puis réactiver le module pendant une fenêtre de maintenance afin que Dolibarr enregistre les nouvelles tables, les menus, la tâche planifiée, le widget et les permissions. La désactivation ne supprime pas les tables du module.
Utilisation
- Importer un relevé et contrôler la prévisualisation avant de confirmer.
- Parcourir les propositions : chacune indique le score et les preuves retenues.
- Valider les décisions ; la comptabilisation native n'intervient qu'ensuite, et seulement si elle a été explicitement autorisée.
- Les règles permettent d'automatiser la proposition des cas récurrents, jamais leur écriture.
Périmètre des connecteurs
La couche Open Banking intégrée est livrée avec un connecteur bac à sable déterministe, pour les essais. Pour une connexion bancaire réelle (Qonto, open banking européen), voir le module complémentaire DoliBank Sync, qui alimente le moteur de rapprochement de DoliBank Match.
Les versements Stripe, PayPal et Shopify Payments acceptent aujourd'hui un JSON normalisé et relient les lignes de versement aux paiements Dolibarr par identifiant externe ; les clients d'API et webhooks temps réel de ces plateformes constituent le jalon suivant.
Historique des versions
| Version | Apports principaux |
|---|---|
| 1.5.0 | Interface redessinée ; salaires, charges sociales et notes de frais proposés et réglés nativement ; alerte anti-fraude IBAN ; Mode Express repensé (multi-factures en une validation) ; bordereau et export CSV traduits ; diagnostic ; correction de la détection CODA sur les CSV à lignes longues et des réglages sans effet |
| 1.4.0 | Suivi des fusions de tiers ; widget ROI corrigé ; libellés traduits |
| 1.3.1 | Correction d'une collision d'identifiants de module et de permissions avec DoliTax ; restauration de l'accès au tableau de bord, à l'import et à la comptabilisation lorsque les deux modules sont activés |
| 0.3.0 | Prévisualisation avant import et rapport des rejets ; formats OFX, QIF, CAMT, MT940, CODA ; cycle brouillon → validation → comptabilisation native ; règlements multi-factures, partiels, avoirs et acomptes ; frais bancaires et virements internes ; protections anti-doublon et anti-sur-allocation ; règles et apprentissage IBAN ; interface Open Banking et connecteur bac à sable ; versements Stripe / PayPal / Shopify Payments |
| 0.2.0 | Références structurées OGM/VCS et ISO 11649 RF ; référence fournisseur et IBAN dans le moteur de score ; filtres avancés ; ignorance et restauration en masse, réversibles et auditées |
| 0.1.0 | Premier socle : import CSV, normalisation, détection de doublons, propositions explicables, tableau de bord, permissions, audit, FR/EN |
Support
- Contact : support@arcchester.com
- Autres modules du même éditeur : recherche « arcchester » sur le Dolistore