Prérequis, installation dans custom/, configuration, premier test et mise à jour. Commencez sur une copie de votre base.
Dolibarr 20 à 24 avec PHP 7.4 à 8.3 et l’extension cURL (OpenSSL recommandé pour le chiffrement AES-256 des secrets). Le module Banque activé et un compte bancaire Dolibarr par compte réel. Le module Tâches planifiées activé, avec un ordonnanceur qui l’exécute réellement. Des identifiants d’API Qonto, ou un compte GoCardless Bank Account Data pour les autres banques. 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/dolibanksync). Dans Accueil → Configuration → Modules/Applications, activez le module ; il apparaît sous le nom DoliBank Sync dans le menu Banques. Attribuez les quatre droits (consulter, traiter les lignes, gérer les connexions, configurer) aux bons utilisateurs.
Banques → DoliBank Sync → Connexions bancaires → Nouvelle connexion, fournisseur « Qonto (API) ». Saisissez l’identifiant d’organisation et la clé API générée dans Qonto (Paramètres → Intégrations et partenariats → Clé API), puis testez. Les comptes de l’organisation s’affichent : associez chacun à un compte bancaire Dolibarr et cochez ceux à relever.
Dans la configuration du module, saisissez le Secret ID et la Secret Key de votre compte GoCardless Bank Account Data (créé sur bankaccountdata.gocardless.com, « User secrets ») et cliquez sur « Tester l’accès GoCardless ». Créez ensuite une connexion avec le fournisseur « Open banking », choisissez le pays et la banque, puis donnez votre consentement sur le site de la banque. De retour dans Dolibarr, associez les comptes.
Cliquez sur « Relever maintenant » sur la connexion. Le tableau de bord doit afficher le solde banque face au solde Dolibarr pour chaque compte, et la boîte de réception doit lister les nouvelles lignes. Ouvrez une ligne, rapprochez une facture ouverte ou créez une facture fournisseur réglée, et vérifiez dans Dolibarr que le règlement est lié à la ligne bancaire existante sans doublon.
Depuis une ligne traitée, créez une règle préremplie pour que la prochaine transaction semblable arrive avec sa proposition. Pour les factures à montant exact, sélectionnez jusqu’à 50 lignes et utilisez le rapprochement par lot. Laissez active la tâche horaire « DoliBank Sync - Relevé bancaire automatique » ; le contrôle quotidien des consentements vous prévient par e-mail avant l’expiration d’un consentement open banking.
Remplacez le répertoire custom/dolibanksync par la nouvelle version, puis désactivez et réactivez le module afin que Dolibarr enregistre les nouvelles tables, les menus et les tâches planifiées. Les connexions et les secrets sont conservés.
