Module DoliBank Sync

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Module DoliBank Sync

DoliBank Sync est un module complémentaire pour Dolibarr ERP/CRM qui fait arriver vos relevés bancaires tout seuls dans Dolibarr : connexion directe à Qonto et, via l'open banking, aux banques européennes couvertes par GoCardless Bank Account Data. Chaque ligne est dédoublonnée, proposée au rapprochement, et peut devenir une dépense en un clic.

Connecteur indépendant, non affilié à Qonto ni à GoCardless.

Éditeur arcchester
Licence GPL v3
Compatibilité Dolibarr 20.0 à 24.x (testé sur 20.0.4 et 24.0.0, PHP 8.2)
PHP 7.4 à 8.3
Prérequis Module Banque actif ; module Cron recommandé pour les relevés automatiques
Dépendances Aucune (cURL pur)

Le besoin traité

Relever le compte automatiquement, rapprocher les factures et créer les dépenses depuis le relevé est le deuxième besoin exprimé sur le forum Dolibarr francophone, après la facture électronique. Aujourd'hui, il faut exporter un fichier depuis sa banque, l'importer, puis pointer à la main.

Fonctionnalités

  1. Connexion Qonto en deux champs : identifiant d'organisation et clé secrète. Tous les comptes de l'organisation sont remontés, avec les pièces jointes des transactions récentes.
  2. Connexion open banking (GoCardless Bank Account Data) : choix de la banque, consentement sur le site de la banque, retour dans Dolibarr, et renouvellement guidé avant expiration du consentement.
  3. Relevé automatique toutes les heures par tâche planifiée, incrémental et sans doublon.
  4. Boîte de réception des lignes nouvelles : rapprocher avec une facture client ou fournisseur, créer une facture fournisseur réglée, enregistrer un paiement divers, lier un virement interne, ignorer, ou laisser une règle proposer l'action.
  5. Règles du type « le libellé contient X → fournisseur Y, compte Z ». Les règles proposent, l'utilisateur valide.
  6. Deux chemins d'intégration : seul, le module écrit dans le compte bancaire natif de Dolibarr ; avec DoliBank Match installé, il alimente son moteur de rapprochement explicable (candidats, scores, lettrage multi-factures, paiements partiels).
  7. Contrôle de solde : solde de la banque comparé au solde Dolibarr, compte par compte, tout écart étant signalé.

Interface et documentation en français et en anglais.

Installation

  1. Copier dolibanksync/ dans htdocs/custom/, ou installer le zip depuis Accueil → Configuration → Modules/Applications → Déployer/installer un module externe.
  2. Activer DoliBank Sync (famille « Finance / Facturation »).
  3. Attribuer les droits : consulter, traiter les lignes, gérer les connexions, configurer.
  4. Pour l'open banking : créer un compte sur bankaccountdata.gocardless.com, générer les « User secrets » et les saisir dans Configuration → DoliBank Sync.

L'usage de l'open banking suppose un compte chez le fournisseur d'agrégation, dont les conditions et les éventuels frais lui sont propres.

Utilisation

  1. Banque → DoliBank Sync → Connexions bancaires → Nouvelle connexion : Qonto (identifiant + clé secrète), open banking (choix de la banque puis consentement sur son site), ou bac à sable pour essayer sans compte.
  2. Associer chaque compte remonté à un compte bancaire Dolibarr, cocher « Relever », enregistrer.
  3. « Relever maintenant » ou attendre la tâche horaire. Les lignes apparaissent dans la boîte de réception, et dans le compte bancaire Dolibarr (mode natif) ou dans DoliBank Match.
  4. Depuis une ligne : rapprocher une facture, créer une facture fournisseur réglée, un paiement divers, lier un virement interne, ou ignorer. Les règles pré-remplissent l'action proposée.

Mode natif : traitement des lignes bancaires

À l'import, chaque transaction devient une ligne du compte bancaire, dite ligne provisoire. Rapprocher une facture crée le règlement natif et le lie à cette ligne — aucune ligne n'est créée en double. Un paiement divers crée sa propre ligne : la ligne provisoire, si elle n'est pas encore rapprochée, est remplacée. Un virement interne relie les deux lignes existantes.

Historique des versions

Version Apports principaux
1.0.0 Version initiale : connecteurs Qonto et open banking GoCardless, relevé horaire incrémental et dédoublonné, boîte de réception avec six actions, règles de proposition, intégration native ou via DoliBank Match, contrôle de solde, FR/EN

Support