Import bancaire et rapprochement pour Dolibarr

Retour index
Documentation développeur

Retour index
Documentation Utilisateur

Bank Import pour Dolibarr

Importez vos relevés bancaires, obtenez des correspondances scorées avec vos factures et créez les règlements Dolibarr natifs — après validation humaine

   Import multi-format
   Rapprochement bancaire
   Correspondances scorées
   Règlements natifs
   Validation humaine
   Anti-doublons
   CSV · OFX · QIF · CAMT.053 · MT940

Présentation

Bank Import est un module externe pour Dolibarr ERP/CRM (éditeur KSIDol) qui automatise le rapprochement bancaire, du relevé au règlement.

Il importe les écritures d'un relevé bancaire (CSV, OFX, QIF, CAMT.053, MT940), propose des correspondances scorées avec vos factures, acomptes, salaires et charges ouverts, puis crée les règlements natifs de Dolibarr — uniquement après votre validation. Le module propose, l'utilisateur décide : aucun paiement n'est créé automatiquement, aucune écriture existante n'est modifiée ni supprimée.

Le module ne modifie aucun fichier du core de Dolibarr.

Éditeur et support

Élément	Information
Éditeur	KSIDol
Spécialité	Intégrateur Dolibarr
Services	Développement sur mesure, hébergement SaaS, accompagnement Dolibarr
Site web	https://www.ksidol.io
Support	support@ksidol.io
Modules Dolistore	https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=

Informations sur le module

Information	Détail
Nom du module	Bank Import
Usage principal	Importer les relevés bancaires et créer les règlements Dolibarr après rapprochement scoré
Type	Module externe de Dolibarr
Famille	Finance / Comptabilité
Version documentée	24.0.0
Compatibilité Dolibarr	Dolibarr 18.0 à 24.x
Compatibilité PHP	PHP 8.0 ou supérieur
Modification du core de Dolibarr	Non
Licence	GNU GPLv3
Langues disponibles	Français, Anglais, Allemand, Espagnol, Italien

Liens officiels

• Vidéo de démonstration : Bank Import — démo (YouTube)
• Fiche du module : Bank Import sur KSIDol
• Démonstration en ligne : Bank Import — ouvrir la démo
• Notice du module : Bank Import — consulter la notice
• Page éditeur K.S.I sur DoliStore : Modules K.S.I sur DoliStore

Objectifs du module

Réduire le temps passé au rapprochement bancaire tout en gardant un contrôle humain sur chaque règlement :

• importer un relevé de n'importe quelle banque grâce à la reconnaissance multi-format ;
• rapprocher automatiquement chaque écriture des pièces ouvertes de Dolibarr, avec un score et des raisons ;
• valider la bonne correspondance, choisir le mode et la date, puis créer le règlement Dolibarr natif ;
• ne jamais toucher à une écriture existante : le module propose, l'humain approuve.

Pour qui ?

• TPE, PME et associations qui saisissent encore leurs encaissements à la main.
• Comptables et gestionnaires qui veulent pointer un relevé en quelques minutes, sans double saisie.
• Intégrateurs Dolibarr cherchant un rapprochement bancaire fiable, respectueux de l'inaltérabilité.

Fonctionnalités principales

• Import multi-format : CSV (délimiteur et colonnes débit/crédit détectés, encodage tolérant), OFX (blocs STMTTRN), QIF, CAMT.053 XML (entrées Ntry), MT940 (:61:/:86:). Format reconnu automatiquement ou choisi manuellement.
• Anti-doublons : empreinte calculée sur le compte, la source, la référence, les dates, le montant, le libellé normalisé et la contrepartie ; les lignes déjà importées ne sont jamais réinjectées.
• Rapprochement scoré : comparaison du montant (exact, proche, écart frais/arrondi, paiement partiel), de la référence de facture (et de ses variantes), du tiers (nom, mots, code), du sens bancaire et de la date. Chaque candidat affiche son score et ses raisons.
• Sources de correspondance : factures et acomptes clients/fournisseurs, avoirs (pointage seul), salaires non payés et charges sociales/fiscales non payées (activables), et écritures bancaires natives existantes (pointage seul, sans double paiement).
• Validation et règlement : approbation d'une ligne (ou allocation partielle), choix du mode et de la date, puis création du règlement natif Dolibarr (paiement de facture, de salaire ou de charge) et de l'écriture bancaire ; verrouillage du rapprochement.
• Détection du type de règlement : chèque, carte, virement, prélèvement, effet domicilié, espèces.
• Gestion des lots d'import : suppression d'un lot ou d'une ligne, réinitialisation des jeux de test ; les lignes pointées/payées/verrouillées sont protégées ; jamais de suppression d'un règlement Dolibarr déjà créé.
• Tableau de bord : KPI (transactions, candidats, approuvés, règlements exécutés) et filtre de flux (à traiter, approuvés à régler, rejetés, terminés).

Menus

Sous le menu principal Banque, le module ajoute :

• Tableau de bord — indicateurs de rapprochement
• Import bancaire — envoi d'un fichier de relevé
• Correspondances bancaires — écritures, candidats scorés et validation
• Lots d'import — détail, suppression, réinitialisation
• Connecteurs bancaires — profils de connecteur (administrateur)
• Configuration — paramètres du module

Configuration

Depuis Accueil → Configuration → Modules → Bank Import :

• compte bancaire par défaut (BANKIMPORT_DEFAULT_BANK_ACCOUNT_ID) ;
• mode de règlement par défaut (BANKIMPORT_DEFAULT_PAYMENT_MODE_ID) ;
• tolérance de montant (BANKIMPORT_AMOUNT_TOLERANCE, défaut 0,02) ;
• score « candidat fort » (BANKIMPORT_AUTO_APPROVE_SCORE, défaut 90) ;
• score minimum de correspondance (BANKIMPORT_MATCH_MIN_SCORE, défaut 40) ;
• nombre max. de factures analysées par transaction (BANKIMPORT_MATCH_SCAN_LIMIT, défaut 1000) ;
• candidats max. par transaction (BANKIMPORT_MATCH_TOP_PER_TRANSACTION, défaut 10) ;
• taille maximale d'un fichier importé (BANKIMPORT_IMPORT_MAX_FILESIZE_MB, défaut 20 Mo) ;
• recherche aussi dans les salaires / les charges sociales et fiscales (activées par défaut).

Permissions utilisateur

Le module définit cinq permissions :

• Lire Bank Import — tableau de bord et listes (read)
• Importer des relevés bancaires — envoi et lecture des fichiers (import)
• Générer et valider les correspondances — calcul, approbation/rejet, pointage (match)
• Créer les règlements Dolibarr — paiements natifs après validation (pay)
• Administrer Bank Import — configuration, connecteurs, lots (admin)

Flux type

1. Importez un fichier de relevé (Import bancaire).
2. Générez les correspondances (Correspondances bancaires).
3. Vérifiez le score et les raisons de chaque candidat.
4. Approuvez la bonne correspondance, choisissez le mode et la date d'encaissement.
5. Le règlement Dolibarr natif est créé, l'écriture bancaire alimentée et le rapprochement verrouillé.

Note technique

• Tables : llx_bankimport_transaction, llx_bankimport_import, llx_bankimport_match, llx_bankimport_connector.
• Standards Dolibarr respectés : droits, jetons CSRF, GETPOST, échappement.
• Les secrets de connecteur sont référencés (nom d'un secret géré hors webroot), jamais stockés en clair.
• Inaltérabilité : le module crée des règlements natifs après validation humaine ; il ne modifie ni ne supprime d'écriture comptable existante, et ne supprime jamais un règlement déjà créé.
• Aucune modification du core de Dolibarr.

Installation

1. Décompressez l'archive pour obtenir un dossier bankimport/.
2. Copiez-le dans htdocs/custom/ de votre Dolibarr.
3. Activez le module depuis Accueil → Configuration → Modules/Applications (famille Finance).
4. Ouvrez la configuration et choisissez un compte bancaire et un mode de règlement par défaut.

Mise à jour

1. Remplacez le dossier htdocs/custom/bankimport/ par la nouvelle version.
2. Rechargez une page d'administration : les tables et constantes manquantes sont créées automatiquement, de façon idempotente.
3. La mise à jour ne supprime aucune donnée existante.

Résolution des problèmes

• Aucune ligne détectée à l'import CSV : vérifiez le séparateur et la présence d'un en-tête (colonnes date, libellé, montant, devise, tiers).
• Fichier refusé : dépassement de la taille maximale configurée (BANKIMPORT_IMPORT_MAX_FILESIZE_MB).
• Pas de candidat : abaissez le score minimum, augmentez la limite d'analyse, ou vérifiez que les factures sont bien ouvertes.
• Aucun mode de règlement : activez au moins un mode de règlement dans Dolibarr.

Voir aussi

• Terminal de signature KSIDol : signature de toutes les fiches natives de Dolibarr, compatible avec tous les modules KSIDol.
• Compatibilité : Dolibarr 18.0 à 24.x — PHP 8.0+ — Licence GPLv3 — Éditeur : KSIDol.

Résumé

Bank Import importe vos relevés bancaires (CSV, OFX, QIF, CAMT.053, MT940), rapproche chaque écriture de vos factures et pièces ouvertes avec un score et des raisons, puis crée les règlements Dolibarr natifs après validation — sans jamais modifier une écriture existante ni casser l'inaltérabilité.