Prérequis, installation dans custom/, configuration, premier test et mise à jour. Commencez sur une copie de votre base.
Dolibarr 18 à 24 avec PHP 7.4 à 8.3 et MySQL ou MariaDB. Le module Banques et caisses doit être activé. Activez Salaires, Taxes et Notes de frais si vous voulez que ces documents soient proposés. Exportez un relevé depuis votre banque en ligne (CSV ou OFX au minimum). Travaillez d’abord sur une copie de votre base.
Téléchargez l’archive depuis Dolistore et décompressez-la dans le répertoire custom/ de Dolibarr (custom/dolibankmatch). Dans Accueil → Configuration → Modules/Applications, activez DoliBank Match. Aucun paquet Composer ni bibliothèque externe n’est nécessaire.
Ouvrez la configuration du module : choisissez le compte bancaire par défaut, gardez les seuils par défaut (forte confiance 90, score minimal 40) et cochez les familles de documents souhaitées. Laissez « Autoriser la comptabilisation native » désactivée pour l’instant. Dans Utilisateurs & Groupes, attribuez « Importer des relevés » et « Analyser et valider les rapprochements » aux bons utilisateurs ; la permission distincte « Comptabiliser les décisions validées » ne va qu’aux comptables.
DoliBank Match → Importer un relevé : choisissez le compte bancaire, déposez le fichier et cliquez sur « Prévisualiser le relevé ». Contrôlez les lignes valides et rejetées, puis « Confirmer définitivement l’import ». Réimporter le même fichier doit être refusé comme doublon.
Dans Opérations bancaires, cliquez sur « Analyser jusqu’à 100 opérations ». Chaque ligne affiche désormais son meilleur candidat et ses indices. Ouvrez-en une avec « Rapprocher », cochez le document, vérifiez le montant alloué et « Préparer une décision », puis validez-la. Ou passez en Mode Express et utilisez les flèches du clavier.
Quand les décisions sont correctes sur votre copie de test, activez « Autoriser la comptabilisation native » dans la configuration. Validez une proposition en Mode Express : la facture doit afficher le nouveau règlement et la ligne bancaire doit être liée. Lancez le diagnostic de l’onglet À propos : chaque ligne doit être verte.
Remplacez le répertoire custom/dolibankmatch par la nouvelle version, puis désactivez et réactivez le module afin que Dolibarr enregistre les nouvelles tables, les menus, la tâche planifiée et les permissions. La désactivation ne supprime pas les tables du module.
