Documentation KSIDol > Modules KSIDol > Import bancaire

Notice du module Import bancaire

Guide d'utilisation non technique : a quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.

Formats bancaires importes5 : CSV, OFX, QIF, CAMT.053, MT940

Pieces rapprocheesFactures, acomptes, avoirs, salaires, charges

Reglement DolibarrCree uniquement apres validation humaine

CompatibiliteDolibarr 18+ - PHP 8+

1. Presentation du module

Import bancaire (Bank Import) est un module KSIDol qui fait entrer vos releves bancaires dans Dolibarr et vous aide a pointer chaque mouvement avec la bonne piece comptable. Vous importez un fichier issu de votre banque (ou vous preparez un profil de connecteur API), le module propose automatiquement les factures, acomptes, avoirs, salaires ou charges qui correspondent le mieux a chaque ligne, puis, apres votre validation, il cree le reglement natif Dolibarr et solde la facture. L'objectif : moins de saisie manuelle, un rapprochement plus rapide et une comptabilite tenue a jour, sans jamais laisser le module agir seul.

Il s'appuie entierement sur les objets natifs Dolibarr : comptes bancaires, factures clients et fournisseurs, acomptes, avoirs, salaires, charges sociales/fiscales et modes de reglement.
Aucune modification du coeur de Dolibarr : le module ajoute ses propres pages et ses propres tables, dans le menu Banques/Caisses.
Le controle reste humain : le reglement Dolibarr n'est jamais cree sans que vous ayez valide la correspondance.
Une fois une ecriture bancaire reglee ou pointee, elle est verrouillee et n'est plus reproposee, ce qui evite les doubles paiements.

2. Import des releves bancaires

La page Import bancaire permet de charger un fichier fourni par votre banque et de transformer chaque operation en ecriture prete a rapprocher, sur le compte bancaire Dolibarr de votre choix.

Prise en charge de 5 formats : CSV, OFX, QIF, CAMT.053 XML et MT940 (fichiers .sta), avec une option de detection automatique du format.
Lecture tolerante des exports CSV : separateurs varies, encodages Windows/ISO, dates anciennes et colonnes debit/credit separees.
Choix du compte bancaire Dolibarr de destination (un compte par defaut peut etre pre-selectionne dans la configuration).
Chaque fichier importe devient un lot d'import identifie, avec une empreinte, pour garder la trace de ce qui a ete charge.
Protection anti-doublon : le module refuse une operation deja presente (empreinte du fichier et cle metier date + compte + montant + libelle + contrepartie).
Affichage d'un diagnostic des premieres lignes en erreur pour corriger un fichier mal forme.
Controles de securite : extensions de fichier autorisees et taille maximale d'import parametrable.

3. Tableau de bord et suivi des imports

La page d'accueil du module donne une vue d'ensemble de l'activite de rapprochement et un acces rapide aux dernieres operations importees.

Quatre vignettes chiffrees et cliquables : transactions importees, correspondances proposees, lignes approuvees et reglements executes.
Panneau Derniers imports listant les lots recents : date, source, nom du fichier, compte bancaire (lien cliquable vers la fiche du compte), nombre de lignes importees/lues, doublons et statut.
Liste triable par colonne et raccourcis directs vers l'import, les correspondances et les lots d'import.

4. Rapprochement intelligent des ecritures

La page Correspondances bancaires est le coeur du module : elle compare chaque ligne bancaire aux pieces ouvertes de Dolibarr et propose les meilleures associations, sans jamais decider a votre place.

Generation automatique de propositions (candidats) pour les ecritures a traiter.
Score de pertinence calcule sur plusieurs criteres : montant (exact, proche, approximatif, ecart compatible frais/arrondi, paiement partiel), reference de facture, nom ou code du tiers, sens du mouvement et proximite de date.
Chaque proposition affiche ses raisons, appuyees par la preuve trouvee (mot du tiers, reference reperee...).
Onglets de suivi du flux de travail : A traiter, Approuves a regler, Rejetes, Termines, Tous.
Detection du type de reglement (cheque, carte, virement, prelevement, effet, especes) pour pre-remplir le mode de paiement.
Pointage guide dans une fenetre dediee : validation d'une correspondance proposee, affectation manuelle d'une facture, ou encaissement partiel avec montant a pointer.
Actions par ligne : approuver, rejeter, rouvrir un rejet, annuler une approbation, verrouiller apres reglement.
Les ecritures deja pointees, reglees ou verrouillees ne sont plus reproposees dans les nouveaux calculs.
Rapprochement possible avec des ecritures bancaires deja presentes dans Dolibarr : dans ce cas, pointage seul, jamais de second paiement.

5. Creation des reglements Dolibarr

Une fois une correspondance validee, le module cree le reglement natif Dolibarr correspondant et met la piece a jour, sous reserve d'en avoir le droit.

Facture client soldee via un paiement client natif ; facture fournisseur via un paiement fournisseur natif.
Acomptes clients et fournisseurs egalement pris en charge pour la creation du reglement.
Salaires non payes et charges sociales/fiscales : creation du paiement de salaire ou de charge natif de Dolibarr.
Le reglement genere le lien vers la facture, l'ecriture sur le compte bancaire et le passage au statut paye si la piece est soldee.
Reglement partiel possible en saisissant le montant a pointer.
Cas particulier des avoirs : ils sont uniquement pointes et verrouilles, sans creation automatique de reglement.

6. Integration aux pages Banque natives de Dolibarr

Depuis la version 1.3.0, le module s'invite directement dans les ecritures bancaires natives de Dolibarr (menu Banque, compte, ecritures), sans quitter l'ecran habituel.

Bouton « Importer un releve » sur la liste des ecritures d'un compte : il ouvre une fenetre de validation (banque concernee et releves deja importes) puis reutilise l'import du module, sans double saisie.
Colonne « Pointage » sur chaque ecriture : elle distingue d'un coup d'oeil les lignes pointees via un import Bank Import de celles rapprochees nativement dans Dolibarr.
Action « Pointer » sur une ecriture non rapprochee : elle ouvre le rapprochement du module pour relier l'ecriture a une ou plusieurs factures.
Aucun mouvement bancaire en double : le reglement est rattache a l'ecriture existante (pas de nouvelle ligne), puis le rapprochement natif est coche automatiquement une fois l'ecriture entierement affectee.
Fonctionnement bidirectionnel : les pointages et rapprochements sont partages entre le module et l'ecran Banque natif de Dolibarr.
Active des l'activation du module : apres une mise a jour, il suffit de desactiver puis reactiver le module pour l'enregistrer, sans aucune configuration manuelle. Peut etre desactivee dans la configuration du module si besoin.

7. Gestion des lots d'import

La page Lots d'import permet de revenir sur ce qui a ete charge, d'en consulter le detail et de faire le menage proprement, notamment lors des phases de test.

Liste des lots avec reference, source, fichier, date, nombre de lignes presentes et protegees, et statut.
Detail d'un lot : consultation ligne par ligne des ecritures importees.
Suppression d'un lot complet ou d'une ligne d'import.
Les lignes deja pointees ou payees sont protegees ; leur suppression forcee est reservee aux administrateurs et ne supprime jamais les reglements Dolibarr deja crees.
Utile pour reinitialiser un jeu de test avant une mise en production.

8. Connecteurs bancaires (preparation API)

La page Connecteurs bancaires permet de declarer des profils de connexion aux API bancaires, en vue d'automatiser la recuperation des ecritures.

Creation de profils de type PSD2/AISP, EBICS ou Custom JSON.
Saisie du prestataire ou de la banque, de l'URL de l'API, du compte bancaire lie et de l'etat actif.
Le secret n'est jamais stocke en clair : on renseigne une reference de secret (variable d'environnement ou secret serveur), saisie en champ protege.
Avertissement rappelant qu'une API bancaire suppose un contrat/prestataire dedie.
Point de vigilance : la synchronisation reelle necessite un adaptateur specifique a la banque ou au prestataire ; les profils preparent l'integration mais ne declenchent pas d'import automatique en standard.

9. Configuration du module

L'ecran de configuration adapte le comportement du module a votre entreprise et a votre facon de rapprocher.

Compte bancaire par defaut utilise pour les imports et les reglements.
Mode de paiement par defaut propose lors de la validation.
Tolerance de montant pour absorber les arrondis ou petits frais (0,02 par defaut).
Score candidat fort et score minimum de correspondance, pour regler la finesse des propositions.
Nombre maximum de factures analysees et nombre de candidats conserves par ecriture (performance).
Taille maximale des fichiers importes.
Options a activer/desactiver : rechercher aussi dans les salaires, rechercher aussi dans les charges sociales/fiscales, et filtrer sur l'ecart de montant (evite les propositions dont le montant n'a aucun rapport).

10. Droits d'acces (permissions)

Le module fournit des droits Dolibarr distincts pour separer la consultation, l'import, le rapprochement et l'action comptable.

Lire Bank Import : consulter le tableau de bord et les ecritures.
Importer des releves bancaires.
Generer et valider les correspondances.
Creer les reglements Dolibarr (action comptable).
Administrer Bank Import : configuration et connecteurs.
Cette separation permet, par exemple, de laisser un collaborateur importer et pointer sans l'autoriser a creer les reglements.

11. Liaisons avec Dolibarr

Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.

Comptes bancaires (Banques/Caisses) : Chaque import cible un compte bancaire Dolibarr ; au reglement, l'ecriture est portee sur ce compte via le flux natif, et le compte reste cliquable depuis le tableau de bord.
Factures clients : Les ecritures d'encaissement sont rapprochees des factures clients ouvertes ; la validation cree un paiement client natif et solde la facture si le montant est complet.
Factures fournisseurs : Les decaissements sont rapproches des factures fournisseurs ; la validation cree un paiement fournisseur natif et met la facture a jour.
Acomptes et avoirs : Les factures d'acompte clients/fournisseurs peuvent generer un reglement ; les avoirs clients et fournisseurs sont seulement pointes et verrouilles, sans reglement automatique.
Tiers (societes) : Le module reconnait le tiers dans le libelle bancaire (nom, mots-cles, code) pour proposer les bonnes pieces, en s'appuyant sur les tiers Dolibarr.
Salaires et charges sociales/fiscales : En option, les salaires non payes et les charges sociales/fiscales sont proposes ; la validation cree le paiement de salaire ou de charge natif de Dolibarr.
Modes de reglement : Le mode de paiement propose provient du dictionnaire des modes de reglement Dolibarr (c_paiement) actifs, et peut etre pre-detecte selon le type d'operation.
Comptabilite et statut des pieces : Comme les reglements sont crees par les mecanismes natifs de Dolibarr, ils alimentent la comptabilite standard et font passer les factures soldees au statut paye, avec la ligne bancaire associee.
Banque / Rapprochement : Le module s'integre a la page des ecritures bancaires natives (Banque, compte, ecritures) : bouton d'import, colonne de pointage et action « Pointer ». Les reglements crees se rattachent a l'ecriture existante et cochent le rapprochement natif de Dolibarr, sans creer de mouvement en double.