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 en justifiant chaque proposition, et ne comptabilise rien sans validation humaine explicite.

Éditeur	arcchester
Licence	GPL v3
Compatibilité Dolibarr	18.0 à 24.x
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, 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.
• 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, boîte d'opérations avec filtres avancés, écran de rapprochement, règles, versements de plateformes, connecteurs, rapports. Interface et documentation en français et en anglais.

Installation

1. Télécharger le zip module_dolibankmatch-x.y.z.zip depuis le Dolistore.
2. Dans Dolibarr : Accueil → Configuration → Modules/Applications → Déployer/installer un module externe.
3. Activer DoliBank Match (famille « Finance / Facturation »).
4. Configurer un compte bancaire par défaut et les seuils de score.
5. Attribuer les droits d'import et de rapprochement aux utilisateurs concernés.
6. 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 depuis une version 0.2.x, 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 et la permission de comptabilisation. La désactivation ne supprime pas les tables du module.

Utilisation

1. Importer un relevé et contrôler la prévisualisation avant de confirmer.
2. Parcourir les propositions : chacune indique le score et les preuves retenues.
3. Valider les décisions ; la comptabilisation native n'intervient qu'ensuite, et seulement si elle a été explicitement autorisée.
4. Les règles permettent d'automatiser la proposition des cas récurrents, jamais leur écriture.

Périmètre des connecteurs

La couche Open Banking et la synchronisation incrémentale sont implémentées avec un connecteur bac à sable déterministe : un fournisseur réel demande encore le choix du prestataire, des identifiants d'API, un parcours de consentement et son renouvellement. 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.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