Module DoliBank Match - Revision history

Arcchester: Version 1.5.0 : salaires, charges et notes de frais, alerte anti-fraude IBAN, Mode Express repensé, compatibilité validée 18/20/24

2026-09-25T13:23:24Z

Version 1.5.0 : salaires, charges et notes de frais, alerte anti-fraude IBAN, Mode Express repensé, compatibilité validée 18/20/24

← Older revision		Revision as of 13:23, 25 September 2026
Line 1:		Line 1:
	== 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.		'''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.

	{\| class="wikitable"		{\| class="wikitable"
Line 9:		Line 9:
	! Licence \|\| GPL v3		! Licence \|\| GPL v3
	\|-		\|-
	! Compatibilité Dolibarr \|\| 18.0 à 24.x		! Compatibilité Dolibarr \|\| 18.0 à 24.x (validé sur 18.0.5, 20.0.4 et 24.0.0)
	\|-		\|-
	! PHP \|\| 7.4 minimum		! PHP \|\| 7.4 minimum
Line 33:		Line 33:
	=== Rapprochement explicable ===		=== 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'''.		* 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.		* 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.		* Le '''montant exact ne suffit jamais''' à lui seul à déclencher une proposition — garde-fou volontaire contre les faux rapprochements.
Line 39:		Line 39:
	* '''Frais bancaires''' enregistrés via <code>PaymentVarious</code>, '''virements internes''' proposés et écritures croisées.		* '''Frais bancaires''' enregistrés via <code>PaymentVarious</code>, '''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.		* '''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.		* '''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.

Line 47:		Line 48:
	=== Interface ===		=== 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.		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 ==		== Installation ==
Line 58:		Line 59:
	# 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.		# 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.'''		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 ==		== Utilisation ==
Line 69:		Line 70:
	== Périmètre des connecteurs ==		== 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 [[Module DoliBank Sync\|DoliBank Sync]], qui alimente le moteur de rapprochement de DoliBank Match.		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 [[Module DoliBank Sync\|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.		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.
Line 78:		Line 79:
	\|-		\|-
	! Version !! Apports principaux		! 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		\| 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

Arcchester: Documentation du module externe DoliBank Match (editeur arcchester)

2026-09-06T12:01:59Z

Documentation du module externe DoliBank Match (editeur arcchester)

New page

== 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.

{| class="wikitable"
|-
! É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 || [https://www.dolistore.com/product.php?id=3319 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 <code>PaymentVarious</code>, '''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 ==

# Télécharger le zip <code>module_dolibankmatch-x.y.z.zip</code> depuis 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 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 ==

# 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 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 [[Module DoliBank Sync|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 ==

{| class="wikitable"
|-
! 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 : [https://www.dolistore.com/recherche?controller=search&search_query=arcchester recherche « arcchester » sur le Dolistore]

[[Category:Modules complémentaires]]