Notice du module Import bancaire

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

Formats bancaires importés5 : CSV, OFX, QIF, CAMT.053, MT940
Pièces rapprochéesFactures, acomptes, avoirs, salaires, charges, notes de frais, dons
Règlement DolibarrCréé uniquement après validation humaine
CompatibilitéDolibarr 18+ - PHP 8+

1. Présentation du module

Import bancaire (Bank Import) est un module KSIDol qui fait entrer vos relevés bancaires dans Dolibarr et vous aide à pointer chaque mouvement avec la bonne pièce comptable. Vous importez un fichier issu de votre banque (ou vous préparez un profil de connecteur API), le module propose automatiquement les factures, acomptes, avoirs, salaires, charges, notes de frais ou dons qui correspondent le mieux à chaque ligne, puis, après votre validation, il crée le règlement natif Dolibarr, solde la pièce et pointe l'écriture bancaire sur son relevé. L'objectif : moins de saisie manuelle, un rapprochement plus rapide et une comptabilité tenue à jour, sans jamais laisser le module agir seul.

  • Il s'appuie entièrement sur les objets natifs Dolibarr : comptes bancaires, factures clients et fournisseurs, acomptes, avoirs, salaires, charges sociales/fiscales, notes de frais, dons et modes de règlement.
  • Aucune modification du cœur de Dolibarr : le module ajoute ses propres pages et ses propres tables, dans le menu Banques/Caisses.
  • Le contrôle reste humain : le règlement Dolibarr n'est jamais créé sans que vous ayez validé la correspondance.
  • Une fois une écriture bancaire réglée ou pointée, elle est verrouillée et n'est plus reproposée, ce qui évite les doubles paiements.
  • Les écritures entièrement traitées peuvent être archivées : elles quittent les listes de travail tout en restant consultables et restaurables, sans qu'aucun règlement ni aucune écriture ne soit modifié.

2. Import des relevés bancaires

La page Import bancaire permet de charger un fichier fourni par votre banque et de transformer chaque opération en écriture prête à 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 détection automatique du format.
  • Lecture tolérante des exports CSV : séparateurs variés, encodages Windows/ISO, dates anciennes et colonnes débit/crédit séparées.
  • Choix du compte bancaire Dolibarr de destination (un compte par défaut peut être présélectionné dans la configuration).
  • Chaque fichier importé devient un lot d'import identifié, avec une empreinte, pour garder la trace de ce qui a été chargé.
  • Chaque ligne importée apparaît aussi comme écriture bancaire native sur le compte Dolibarr : le module réutilise un mouvement existant de même montant à date proche lorsqu'il en trouve un, sinon il crée l'écriture — jamais de mouvement en double. Le pointage rattachera ensuite le règlement à cette écriture.
  • Protection anti-doublon : le module refuse une opération déjà présente (empreinte du fichier et clé métier date + compte + montant + libellé + contrepartie).
  • Les doublons entre deux formats de relevé (le même relevé importé en OFX puis en CSV, par exemple) sont également reconnus et signalés — voir la section dédiée.
  • Affichage d'un diagnostic des premières lignes en erreur pour corriger un fichier mal formé.
  • Contrôles de sécurité : extensions de fichier autorisées et taille maximale d'import paramétrable.

3. Tableau de bord et suivi des imports

La page d'accueil du module donne une vue d'ensemble de l'activité de rapprochement et un accès rapide aux dernières opérations importées.

  • Quatre vignettes chiffrées et cliquables : transactions importées, correspondances proposées, lignes approuvées et règlements exécutés.
  • Panneau Derniers imports listant les lots récents : date, source, nom du fichier, compte bancaire (lien cliquable vers la fiche du compte), nombre de lignes importées/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 écritures

La page Correspondances bancaires est le cœur du module : elle compare chaque ligne bancaire aux pièces ouvertes de Dolibarr et propose les meilleures associations, sans jamais décider à votre place.

  • Génération automatique de propositions (candidats) pour les écritures à traiter.
  • Pièces proposées : factures clients et fournisseurs, acomptes, avoirs, salaires, charges sociales/fiscales, notes de frais approuvées (sur les décaissements) et dons validés non payés (sur les entrées bancaires).
  • Score de pertinence calculé sur plusieurs critères : montant (exact, proche, approximatif, écart compatible frais/arrondi, paiement partiel), référence de facture, nom ou code du tiers, sens du mouvement et proximité de date.
  • Chaque proposition affiche ses raisons, appuyées par la preuve trouvée (mot du tiers, référence repérée...).
  • Un paiement partiel n'est proposé que s'il est corroboré par une référence ou un tiers reconnu, jamais sur le seul montant.
  • Onglets de suivi du flux de travail, chacun avec son compteur : À traiter, Approuvés à régler, Rejetés, Terminés, Tous, auxquels s'ajoute l'onglet Archivées pour les écritures rangées.
  • Détection du type de règlement (chèque, carte, virement, prélèvement, effet, espèces) pour préremplir le mode de paiement.
  • Pointage guidé dans une fenêtre dédiée : validation d'une correspondance proposée, affectation manuelle d'un document, ou encaissement partiel avec montant à pointer.
  • Affectation manuelle sur la totalité des documents ouverts : la liste couvre tous les documents à pointer et se filtre en tapant la raison sociale, le numéro de pièce ou le montant — les trois écritures courantes du montant sont comprises (1123,45 · 1123.45 · 1 123,45).
  • À la sélection d'un document, le montant à pointer se remplit automatiquement avec son reste dû, plafonné au montant de l'écriture bancaire ; la fenêtre de pointage occupe toute la largeur disponible de l'écran.
  • Un virement unique qui règle plusieurs factures se répartit entre elles : chaque affectation consomme sa part du montant, et l'écriture n'est verrouillée qu'une fois intégralement allouée, sans écraser les affectations déjà validées.
  • Alerte en cas de tiers différent : lors d'une affectation manuelle, si l'intitulé bancaire ne mentionne pas le tiers de la facture visée, un avertissement s'affiche. Il n'empêche rien (un virement peut venir d'un mandataire ou d'une maison mère), mais rend visible un règlement dirigé vers le mauvais tiers avant qu'il ne devienne une écriture comptable.
  • Repère « À vérifier — règlement déjà effectué ? » : lorsqu'une écriture sans aucune proposition correspond à une facture déjà réglée en dehors du module, la fenêtre de pointage le signale, nomme la facture concernée et la date de son règlement, et propose d'archiver l'écriture d'un clic. Le repère reste prudent lorsque plusieurs factures pourraient correspondre, et rien n'est archivé automatiquement : la décision vous appartient toujours.
  • Écriture qui ne peut plus être pointée : la fenêtre de pointage affiche le motif en clair et propose une issue — archiver l'écriture, la signaler comme doublon d'une autre, ou la restaurer si elle était déjà rangée.
  • Actions par ligne : approuver, rejeter, rouvrir un rejet, annuler une approbation, verrouiller après règlement.
  • Déverrouillage : une écriture verrouillée sans règlement natif peut être libérée pour être rapprochée à nouveau, en conservant les affectations déjà validées ; une écriture dont le règlement a été créé ne se déverrouille pas tant que ce règlement n'a pas été supprimé dans Dolibarr.
  • Si la création du règlement échoue au moment de valider, l'approbation est annulée avec elle : l'écriture revient à l'état « Pointage » et un message indique quoi corriger — une ligne n'affiche jamais « approuvée » sans règlement réellement créé.
  • Les écritures déjà pointées, réglées ou verrouillées ne sont plus reproposées dans les nouveaux calculs.
  • Rapprochement possible avec des écritures bancaires déjà présentes dans Dolibarr : dans ce cas, pointage seul, jamais de second paiement.

5. Création des règlements Dolibarr

Une fois une correspondance validée, le module crée le règlement natif Dolibarr correspondant et met la pièce à jour, sous réserve d'en avoir le droit.

  • Facture client soldée via un paiement client natif ; facture fournisseur via un paiement fournisseur natif.
  • Acomptes clients et fournisseurs également pris en charge pour la création du règlement.
  • Salaires non payés et charges sociales/fiscales : création du paiement de salaire ou de charge natif de Dolibarr.
  • Notes de frais approuvées : la validation crée le remboursement natif et l'écriture bancaire associée ; la note n'est marquée payée qu'une fois remboursée au dernier euro, en tenant compte des règlements déjà enregistrés.
  • Dons reçus : les dons Dolibarr validés et non payés sont proposés sur les entrées bancaires, en automatique comme en sélection manuelle. La validation crée le règlement de don natif, relié au compte bancaire sans doublon lorsqu'une écriture bancaire native existe déjà, et le don ne passe à l'état payé que lorsque son solde est nul. Un don n'est jamais proposé sur une sortie bancaire.
  • Si un règlement créé par le module (client, fournisseur ou don) est ensuite supprimé directement dans Dolibarr, le rapprochement correspondant est automatiquement libéré et la pièce redevient pointable ; un bandeau d'alerte et un bouton « Resynchroniser les paiements supprimés » rattrapent les lignes restées bloquées.
  • Chaque validation demande un mode de règlement et une date d'encaissement : le mode est prérempli d'après le type détecté ou le mode par défaut, la date d'après la date de l'opération bancaire, et les deux restent modifiables.
  • Le règlement génère le lien vers la pièce, l'écriture sur le compte bancaire et le passage au statut payé si la pièce est soldée.
  • Règlement partiel possible en saisissant le montant à pointer.
  • Le rapprochement bancaire est posé par le module lui-même : une écriture entièrement réglée est pointée sur son relevé du mois, sans pointage manuel dans Dolibarr. Ce rapprochement reste une opération de trésorerie réversible, et il n'est posé que lorsque la totalité du montant de l'écriture est affectée.
  • Cas particulier des avoirs : ils sont uniquement pointés et verrouillés, sans création automatique de règlement.

6. Doublons entre deux formats de relevé

Un même relevé peut être importé deux fois sous des formats différents (en OFX puis en CSV, par exemple) : le libellé et la référence diffèrent alors d'un format à l'autre, et la protection anti-doublon classique ne peut pas les relier. Le module reconnaît ces cas grâce à une seconde clé, volontairement limitée au compte, à la date et au montant.

  • L'écriture en double est importée et signalée, jamais supprimée : deux mouvements réellement distincts du même montant le même jour peuvent exister, et vous seul pouvez les distinguer.
  • La liste porte un repère « Doublon n° x » qui indique l'écriture d'origine, et la ligne concernée est teintée pour être repérée d'un coup d'œil.
  • La fenêtre de pointage affiche un avertissement avant toute validation sur une écriture signalée comme doublon.
  • Un bouton « Doublon, archiver » range l'écriture hors des listes de travail, sans rien supprimer.
  • L'appariement est un pour un : chaque doublon est relié à une seule écriture d'origine.
  • Le rapport d'import annonce le nombre de doublons signalés.
  • Les écritures déjà présentes en base sont rattrapées automatiquement lors de la mise à jour du module : les doublons existants sont signalés sans aucune manipulation.

7. Archivage et onglet « Archivées »

Pour que les listes de travail ne s'allongent pas indéfiniment, les écritures entièrement traitées peuvent être rangées : elles quittent les vues de travail et se retrouvent dans leur propre onglet « Archivées ».

  • Une écriture archivée quitte toutes les listes de travail, y compris la vue « Toutes », et reste consultable et restaurable à tout moment depuis l'onglet « Archivées ».
  • L'archivage est un simple marquage d'affichage : aucun règlement, aucune écriture bancaire ni comptable n'est touché.
  • Chaque archivage conserve son motif, pour distinguer un doublon, une pièce déjà réglée ou un rapprochement terminé.
  • Actions de masse : chaque liste permet de cocher des écritures, de tout cocher d'un coup et de les archiver ensemble ; l'onglet « Terminés » offre en plus un bouton « Archiver toutes les écritures traitées », pour tout ranger d'un seul geste.
  • Une écriture dont le rapprochement n'est pas terminé ne peut pas être archivée : le refus est vérifié côté serveur.
  • Une sélection mélangée indique combien d'écritures ont été laissées de côté et pourquoi.

8. Recherche, tri et filtres

Les tableaux du module se trient et se filtrent comme les listes natives de Dolibarr, pour retrouver une ligne précise même sur un gros volume d'écritures.

  • Tri sur chaque colonne de chaque tableau (rapprochement bancaire, lots d'import, lignes d'un lot, connecteurs), du plus petit au plus grand et inversement ; le tri conserve les filtres en cours.
  • La recherche porte sur la totalité des écritures, avec pagination des résultats, et non sur la seule page affichée.
  • Recherche par montant dans les deux écritures (1 234,56 ou 1234.56) et avec comparaisons : « >1000 » ou « <=-500 », par exemple.
  • Recherche par date aux formats jj/mm/aaaa, mm/aaaa et aaaa-mm-jj.
  • La recherche par tiers examine aussi l'intitulé de l'opération : utile pour les relevés CSV où le nom du donneur d'ordre n'apparaît que dans le libellé.
  • La colonne « Action » se filtre pour isoler ce qui reste à faire : Pointage, Régler, Déverrouiller, Archiver ou Rien à pointer. Le filtre travaille sur toute la table et non sur la page affichée.
  • Le filtre d'état sait aussi isoler les doublons signalés (« Doublon ») ou les écarter (« Hors doublon »).

9. Intégration aux pages Banque natives de Dolibarr

Le module s'invite directement dans les écritures bancaires natives de Dolibarr (menu Banque, compte, écritures), sans quitter l'écran habituel.

  • Bouton « Importer un relevé » sur la liste des écritures d'un compte : il ouvre une fenêtre de validation (banque concernée et relevés déjà importés) puis réutilise l'import du module, sans double saisie.
  • Colonne « Pointage » sur chaque écriture : elle distingue d'un coup d'œil les lignes pointées via un import Bank Import de celles rapprochées nativement dans Dolibarr.
  • La colonne « Pointage » se filtre réellement : le filtre s'applique à la liste entière (décompte et pages suivantes compris), et non à la seule page affichée. La colonne apparaît aussi dans le sélecteur de colonnes et peut donc être masquée comme les autres.
  • Les écritures rangées s'annoncent « Archivé » dans la liste bancaire, et le filtre de la colonne « Pointage » propose cet état.
  • Action « Pointer » sur une écriture non rapprochée : elle ouvre le rapprochement du module pour relier l'écriture à une ou plusieurs pièces.
  • Le lien « À rapprocher » isole l'écriture concernée, la coche et place le curseur dans le champ du relevé : plus besoin de la retrouver à la main dans la liste.
  • Aucun mouvement bancaire en double : le règlement est rattaché à l'écriture existante (pas de nouvelle ligne), puis le rapprochement natif est coché automatiquement une fois l'écriture entièrement affectée.
  • Correspondance avec une écriture déjà présente : lorsqu'une ligne de relevé correspond à une écriture bancaire qui porte déjà son règlement, le bouton « Confirmer la correspondance (rien à régler) » relie la ligne à cette écriture et la clôture, sans créer de second règlement ni modifier son rapprochement.
  • Fonctionnement bidirectionnel : les pointages et rapprochements sont partagés entre le module et l'écran Banque natif de Dolibarr.
  • Active dès l'activation du module : après une mise à jour, il suffit de désactiver puis de réactiver le module pour l'enregistrer, sans aucune configuration manuelle. L'intégration peut être désactivée dans la configuration du module si besoin.

10. Gestion des lots d'import

La page Lots d'import permet de revenir sur ce qui a été chargé, d'en consulter le détail et de faire le ménage proprement, notamment lors des phases de test.

  • Liste des lots avec référence, source, fichier, date, nombre de lignes présentes et protégées, et statut.
  • Détail d'un lot : consultation ligne par ligne des écritures importées.
  • Suppression d'un lot complet ou d'une ligne d'import.
  • Les lignes déjà pointées ou payées sont protégées ; leur suppression forcée est réservée aux administrateurs et ne supprime jamais les règlements Dolibarr déjà créés.
  • Utile pour réinitialiser un jeu de test avant une mise en production.

11. Connecteurs bancaires (préparation API)

La page Connecteurs bancaires permet de déclarer des profils de connexion aux API bancaires, en vue d'automatiser la récupération des écritures.

  • Création 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 lié et de l'état actif.
  • Le secret n'est jamais stocké en clair : on renseigne une référence de secret (variable d'environnement ou secret serveur), saisie en champ protégé.
  • Avertissement rappelant qu'une API bancaire suppose un contrat/prestataire dédié.
  • Point de vigilance : la synchronisation réelle nécessite un adaptateur spécifique à la banque ou au prestataire ; les profils préparent l'intégration mais ne déclenchent pas d'import automatique en standard.

12. Configuration du module

L'écran de configuration adapte le comportement du module à votre entreprise et à votre façon de rapprocher.

  • Compte bancaire par défaut utilisé pour les imports et les règlements.
  • Mode de paiement par défaut proposé lors de la validation.
  • Tolérance de montant pour absorber les arrondis ou petits frais (0,02 par défaut).
  • Score candidat fort et score minimum de correspondance, pour régler la finesse des propositions.
  • Nombre maximum de factures analysées et nombre de candidats conservés par écriture (performance).
  • Taille maximale des fichiers importés.
  • Options à activer/désactiver : rechercher aussi dans les salaires, rechercher aussi dans les charges sociales/fiscales, proposer les notes de frais, et filtrer sur l'écart de montant (évite les propositions dont le montant n'a aucun rapport).
  • Réglage dédié pour le rapprochement des dons reçus : il active ou désactive la proposition des dons validés non payés sur les entrées bancaires.
  • Intégration aux pages Banque natives : une case active ou désactive le bouton d'import et le pointage dans les écrans Banque de Dolibarr.
  • Affichage du panneau de pointage : par défaut, il se charge à la demande pour la seule écriture pointée, ce qui garde la liste de rapprochement légère même sur un compte à fort volume ; une option rétablit l'ancien affichage du panneau dans chaque ligne.
  • Les réglages du module sont conservés même lorsqu'il est désactivé puis réactivé, notamment lors d'une mise à jour.

13. Droits d'accès (permissions)

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

  • Lire Bank Import : consulter le tableau de bord et les écritures.
  • Importer des relevés bancaires.
  • Générer et valider les correspondances.
  • Créer les règlements Dolibarr (action comptable).
  • Administrer Bank Import : configuration et connecteurs.
  • Cette séparation permet, par exemple, de laisser un collaborateur importer et pointer sans l'autoriser à créer les règlements.
  • Les notes de frais proposées respectent le cloisonnement natif de Dolibarr : chaque utilisateur ne voit que ses propres notes et celles de ses subordonnés, sauf s'il détient le droit de lire celles de tout le monde.
  • Le rapprochement des dons suppose que le module Dons de Dolibarr soit actif et que l'utilisateur dispose des droits correspondants.

14. 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 et chaque ligne importée y apparaît comme écriture bancaire native, sans doublon avec les mouvements déjà présents ; au règlement, cette écriture est rattachée via le flux natif, et le compte reste cliquable depuis le tableau de bord.
  • Factures clients : Les écritures d'encaissement sont rapprochées des factures clients ouvertes ; la validation crée un paiement client natif et solde la facture si le montant est complet.
  • Factures fournisseurs : Les décaissements sont rapprochés des factures fournisseurs ; la validation crée un paiement fournisseur natif et met la facture à jour.
  • Acomptes et avoirs : Les factures d'acompte clients/fournisseurs peuvent générer un règlement ; les avoirs clients et fournisseurs sont seulement pointés et verrouillés, sans règlement automatique.
  • Tiers (sociétés) : Le module reconnaît le tiers dans le libellé bancaire (nom, mots-clés, code) pour proposer les bonnes pièces, en s'appuyant sur les tiers Dolibarr.
  • Salaires et charges sociales/fiscales : En option, les salaires non payés et les charges sociales/fiscales sont proposés ; la validation crée le paiement de salaire ou de charge natif de Dolibarr.
  • Notes de frais : Les notes de frais approuvées et non remboursées sont proposées sur les décaissements ; la validation crée le remboursement natif et solde la note une fois remboursée au dernier euro. Les propositions respectent le cloisonnement natif des notes de frais : chacun ne voit que les siennes et celles de ses subordonnés, sauf droit de tout lire.
  • Dons (module Dons) : Lorsque le module Dons de Dolibarr est actif et que l'utilisateur en a les droits, les dons validés et non payés sont proposés sur les entrées bancaires, jamais sur une sortie. La validation crée le règlement de don natif, relié à la banque sans doublon si une écriture native existe déjà ; le don ne passe à l'état payé qu'à solde nul, et la suppression native de son règlement libère le rapprochement dans le module.
  • Modes de règlement : Le mode de paiement proposé provient du dictionnaire des modes de règlement Dolibarr (c_paiement) actifs, et peut être prédétecté selon le type d'opération.
  • Comptabilité et statut des pièces : Comme les règlements sont créés par les mécanismes natifs de Dolibarr, ils alimentent la comptabilité standard et font passer les factures soldées au statut payé, avec la ligne bancaire associée.
  • Banque / Rapprochement : Le module s'intègre à la page des écritures bancaires natives (Banque, compte, écritures) : bouton d'import, colonne de pointage filtrable sur la liste entière et masquable via le sélecteur de colonnes, état « Archivé », action « Pointer » et lien « À rapprocher » qui isole l'écriture, la coche et place le curseur dans le champ du relevé. Les règlements créés se rattachent à l'écriture existante sans mouvement en double, et le rapprochement natif est posé automatiquement sur le relevé du mois dès que la totalité du montant est affectée — une opération de trésorerie qui reste réversible.
Besoin d'aide ? WhatsApp Téléphone: 07 45 15 75 87 Téléphone: 07 43 52 58 29 Email Ouvrir le formulaire