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

2026-09-06T12:02:08Z

Documentation du module externe DoliBank Sync (editeur arcchester)

New page

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

{| class="wikitable"
|-
! É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 ==

# '''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.
# '''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.
# '''Relevé automatique''' toutes les heures par tâche planifiée, incrémental et sans doublon.
# '''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.
# '''Règles''' du type « le libellé contient X → fournisseur Y, compte Z ». Les règles '''proposent''', l'utilisateur valide.
# '''Deux chemins d'intégration''' : seul, le module écrit dans le compte bancaire natif de Dolibarr ; avec [[Module DoliBank Match|DoliBank Match]] installé, il alimente son moteur de rapprochement explicable (candidats, scores, lettrage multi-factures, paiements partiels).
# '''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 ==

# Copier <code>dolibanksync/</code> dans <code>htdocs/custom/</code>, ou installer le zip depuis ''Accueil → Configuration → Modules/Applications → Déployer/installer un module externe''.
# Activer '''DoliBank Sync''' (famille « Finance / Facturation »).
# Attribuer les droits : consulter, traiter les lignes, gérer les connexions, configurer.
# Pour l'open banking : créer un compte sur <code>bankaccountdata.gocardless.com</code>, 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 ==

# ''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.
# Associer chaque compte remonté à un compte bancaire Dolibarr, cocher « Relever », enregistrer.
# '''« 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.
# 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 ==

{| class="wikitable"
|-
! 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 ==

* 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]]

Module DoliBank Sync - Revision history

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