Import bancaire et rapprochement pour Dolibarr: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
VisualWikitext
(Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice)
(Mise à jour des liens officiels : vidéo, fiche KSIDol, démo et notice)
Line 8: Line 8:


<div style="border:1px solid #d7e3f4; border-radius:14px; padding:22px; margin:12px 0 22px 0; background:linear-gradient(135deg,#f6faff,#ffffff); box-shadow:0 2px 10px rgba(20,60,110,0.08);">
<div style="border:1px solid #d7e3f4; border-radius:14px; padding:22px; margin:12px 0 22px 0; background:linear-gradient(135deg,#f6faff,#ffffff); box-shadow:0 2px 10px rgba(20,60,110,0.08);">
   <div style="font-size:28px; font-weight:700; color:#17365d; margin-bottom:8px;">Bank Import pour Dolibarr</div>
   <div style="font-size:28px; font-weight:700; color:#17365d; margin-bottom:8px;">Bank Import per Dolibarr</div>
   <div style="font-size:18px; color:#345; margin-bottom:14px;">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</div>
   <div style="font-size:18px; color:#345; margin-bottom:14px;">Importa i tuoi estratti conto, ottieni abbinamenti con punteggio con le tue fatture e crea i pagamenti nativi di Dolibarr — dopo validazione umana</div>
   <div style="display:flex; flex-wrap:wrap; gap:8px; margin-top:10px;">
   <div style="display:flex; flex-wrap:wrap; gap:8px; margin-top:10px;">
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Import multi-format</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Importazione multiformato</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Rapprochement bancaire</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Riconciliazione bancaria</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Correspondances scorées</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Abbinamenti con punteggio</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Règlements natifs</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Pagamenti nativi</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Validation humaine</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Validazione umana</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Anti-doublons</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">Anti-duplicati</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">CSV · OFX · QIF · CAMT.053 · MT940</span>
     <span style="background:#e8f1ff; color:#17365d; padding:6px 10px; border-radius:999px; font-weight:600;">CSV · OFX · QIF · CAMT.053 · MT940</span>
   </div>
   </div>
</div>
</div>


== Présentation ==
== Presentazione ==


'''Bank Import''' est un module externe pour '''Dolibarr ERP/CRM''' (éditeur KSIDol) qui automatise le rapprochement bancaire, du relevé au règlement.
'''Bank Import''' è un modulo esterno per '''Dolibarr ERP/CRM''' (editore KSIDol) che automatizza la riconciliazione bancaria, dall'estratto conto al pagamento.


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.
Importa i movimenti di un estratto conto bancario (CSV, OFX, QIF, CAMT.053, MT940), propone abbinamenti '''con punteggio''' con le tue fatture, acconti, stipendi e oneri aperti, poi crea i '''pagamenti nativi di Dolibarr''' — solo dopo la tua validazione. Il modulo propone, l'utente decide: nessun pagamento è creato automaticamente, nessun movimento esistente è modificato o eliminato.


Le module ne modifie aucun fichier du core de Dolibarr.
Il modulo non modifica alcun file del core di Dolibarr.


== Éditeur et support ==
== Editore e supporto ==


{| class="wikitable" style="width:100%; border-collapse:collapse;"
{| class="wikitable" style="width:100%; border-collapse:collapse;"
! style="width:24%; background:#f0f6ff;" | Élément
! style="width:24%; background:#f0f6ff;" | Elemento
! style="background:#f0f6ff;" | Information
! style="background:#f0f6ff;" | Informazione
|-
|-
| '''Éditeur'''
| '''Editore'''
| '''KSIDol'''
| '''KSIDol'''
|-
|-
| '''Spécialité'''
| '''Specialità'''
| Intégrateur Dolibarr
| Integratore Dolibarr
|-
|-
| '''Services'''
| '''Servizi'''
| Développement sur mesure, hébergement SaaS, accompagnement Dolibarr
| Sviluppo su misura, hosting SaaS, affiancamento Dolibarr
|-
|-
| '''Site web'''
| '''Sito web'''
| https://www.ksidol.io
| https://www.ksidol.io
|-
|-
| '''Support'''
| '''Supporto'''
| support@ksidol.io
| support@ksidol.io
|-
|-
| '''Modules Dolistore'''
| '''Moduli Dolistore'''
| https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=
| 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 ==
== Informazioni sul modulo ==


{| class="wikitable" style="width:100%;"
{| class="wikitable" style="width:100%;"
! style="width:24%; background:#f7f7f7;" | Information
! style="width:24%; background:#f7f7f7;" | Informazione
! style="background:#f7f7f7;" | Détail
! style="background:#f7f7f7;" | Dettaglio
|-
|-
| '''Nom du module'''
| '''Nome del modulo'''
| Bank Import
| Bank Import
|-
|-
| '''Usage principal'''
| '''Uso principale'''
| Importer les relevés bancaires et créer les règlements Dolibarr après rapprochement scoré
| Importare gli estratti conto bancari e creare i pagamenti Dolibarr dopo riconciliazione con punteggio
|-
|-
| '''Type'''
| '''Tipo'''
| Module externe de Dolibarr
| Modulo esterno di Dolibarr
|-
|-
| '''Famille'''
| '''Famiglia'''
| Finance / Comptabilité
| Finanza / Contabilità
|-
|-
| '''Version documentée'''
| '''Versione documentata'''
| 24.0.0
| 24.0.0
|-
|-
| '''Compatibilité Dolibarr'''
| '''Compatibilità Dolibarr'''
| Dolibarr 18.0 à 24.x
| Dolibarr 18.0 a 24.x
|-
|-
| '''Compatibilité PHP'''
| '''Compatibilità PHP'''
| PHP 8.0 ou supérieur
| PHP 8.0 o superiore
|-
|-
| '''Modification du core de Dolibarr'''
| '''Modifica del core di Dolibarr'''
| Non
| No
|-
|-
| '''Licence'''
| '''Licenza'''
| GNU GPLv3
| GNU GPLv3
|-
|-
| '''Langues disponibles'''
| '''Lingue disponibili'''
| Français, Anglais, Allemand, Espagnol, Italien
| Francese, Inglese, Tedesco, Spagnolo, Italiano
|}
|}


== Liens officiels ==
== Link ufficiali ==
* Vidéo de démonstration : [https://youtu.be/zm1yBnvbWJg Bank Import — démo (YouTube)]
* Video dimostrativo : [https://youtu.be/zm1yBnvbWJg Bank Import — demo (YouTube)]
* Fiche du module : [https://www.ksidol.io/fr/modules/detail?module=main_module_bankimport Bank Import sur KSIDol]
* Scheda del modulo : [https://www.ksidol.io/it/modules/detail?module=main_module_bankimport Bank Import su KSIDol]
* Démonstration en ligne : [https://www.ksidol.io/t/demo-erp/custom/bankimport/index.php?mainmenu=bank&leftmenu=bankimport Bank Import — ouvrir la démo]
* Demo online : [https://www.ksidol.io/t/demo-erp/custom/bankimport/index.php?mainmenu=bank&leftmenu=bankimport Bank Import — aprire la demo]
* Notice du module : [https://www.ksidol.io/notices/ksidol_notice_fr/bankimport.html Bank Import — consulter la notice]
* Manuale del modulo : [https://www.ksidol.io/notices/ksidol_notice_it/bankimport.html Bank Import — consultare il manuale]
* Page éditeur K.S.I sur DoliStore : [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= Modules K.S.I sur DoliStore]
* Pagina editore K.S.I su DoliStore: [https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search= Moduli K.S.I su DoliStore]


== Objectifs du module ==
== Obiettivi del modulo ==


Réduire le temps passé au rapprochement bancaire tout en gardant un '''contrôle humain sur chaque règlement''' :
Ridurre il tempo dedicato alla riconciliazione bancaria mantenendo un '''controllo umano su ogni pagamento''':


* importer un relevé de n'importe quelle banque grâce à la reconnaissance multi-format ;
* importare un estratto conto di qualsiasi banca grazie al riconoscimento multiformato;
* rapprocher automatiquement chaque écriture des pièces ouvertes de Dolibarr, avec un score et des raisons ;
* riconciliare automaticamente ogni movimento con i documenti aperti di Dolibarr, con un punteggio e delle motivazioni;
* valider la bonne correspondance, choisir le mode et la date, puis créer le règlement Dolibarr natif ;
* validare l'abbinamento corretto, scegliere la modalità e la data, poi creare il pagamento nativo di Dolibarr;
* ne jamais toucher à une écriture existante : le module propose, l'humain approuve.
* non toccare mai un movimento esistente: il modulo propone, l'essere umano approva.


== Pour qui ? ==
== Per chi? ==


* '''TPE, PME et associations''' qui saisissent encore leurs encaissements à la main.
* '''Microimprese, PMI e associazioni''' che registrano ancora i loro incassi a mano.
* '''Comptables et gestionnaires''' qui veulent pointer un relevé en quelques minutes, sans double saisie.
* '''Contabili e gestori''' che vogliono spuntare un estratto conto in pochi minuti, senza doppia registrazione.
* '''Intégrateurs Dolibarr''' cherchant un rapprochement bancaire fiable, respectueux de l'inaltérabilité.
* '''Integratori Dolibarr''' che cercano una riconciliazione bancaria affidabile, rispettosa dell'inalterabilità.


== Fonctionnalités principales ==
== Funzionalità principali ==


* '''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.
* '''Importazione multiformato''': CSV (delimitatore e colonne dare/avere rilevati, codifica tollerante), OFX (blocchi STMTTRN), QIF, CAMT.053 XML (voci Ntry), MT940 (:61:/:86:). Formato riconosciuto automaticamente o scelto manualmente.
* '''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.
* '''Anti-duplicati''': impronta calcolata su conto, sorgente, riferimento, date, importo, causale normalizzata e controparte; le righe già importate non vengono mai reinserite.
* '''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'''.
* '''Riconciliazione con punteggio''': confronto dell'importo (esatto, prossimo, scarto per commissioni/arrotondamento, pagamento parziale), del riferimento fattura (e delle sue varianti), del terzo (nome, parole, codice), del verso bancario e della data. Ogni candidato mostra il suo '''punteggio''' e le sue '''motivazioni'''.
* '''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).
* '''Sorgenti di abbinamento''': fatture e acconti clienti/fornitori, note di credito (solo spunta), stipendi non pagati e oneri sociali/fiscali non pagati (attivabili), e movimenti bancari nativi esistenti (solo spunta, senza doppio pagamento).
* '''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.
* '''Validazione e pagamento''': approvazione di una riga (o allocazione parziale), scelta della modalità e della data, poi creazione del '''pagamento nativo di Dolibarr''' (pagamento di fattura, di stipendio o di onere) e del movimento bancario; blocco della riconciliazione.
* '''Détection du type de règlement''' : chèque, carte, virement, prélèvement, effet domicilié, espèces.
* '''Rilevamento del tipo di pagamento''': assegno, carta, bonifico, addebito diretto, effetto domiciliato, contanti.
* '''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éé.
* '''Gestione dei lotti di importazione''': eliminazione di un lotto o di una riga, ripristino dei set di prova; le righe spuntate/pagate/bloccate sono protette; mai eliminato un pagamento Dolibarr già creato.
* '''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).
* '''Cruscotto''': KPI (transazioni, candidati, approvati, pagamenti eseguiti) e filtro di flusso (da elaborare, approvati da pagare, rifiutati, completati).


== Menus ==
== Menu ==


Sous le menu principal '''Banque''', le module ajoute :
Sotto il menu principale '''Banca''', il modulo aggiunge:


* '''Tableau de bord''' — indicateurs de rapprochement
* '''Cruscotto''' — indicatori di riconciliazione
* '''Import bancaire''' — envoi d'un fichier de relevé
* '''Importazione bancaria''' — invio di un file di estratto conto
* '''Correspondances bancaires''' — écritures, candidats scorés et validation
* '''Abbinamenti bancari''' — movimenti, candidati con punteggio e validazione
* '''Lots d'import''' — détail, suppression, réinitialisation
* '''Lotti di importazione''' — dettaglio, eliminazione, ripristino
* '''Connecteurs bancaires''' — profils de connecteur (administrateur)
* '''Connettori bancari''' — profili di connettore (amministratore)
* '''Configuration''' — paramètres du module
* '''Configurazione''' — parametri del modulo


== Configuration ==
== Configurazione ==


Depuis Accueil → Configuration → Modules → Bank Import :
Da Home → Configurazione → Moduli → Bank Import:


* compte bancaire par défaut (<code>BANKIMPORT_DEFAULT_BANK_ACCOUNT_ID</code>) ;
* conto bancario predefinito (<code>BANKIMPORT_DEFAULT_BANK_ACCOUNT_ID</code>);
* mode de règlement par défaut (<code>BANKIMPORT_DEFAULT_PAYMENT_MODE_ID</code>) ;
* modalità di pagamento predefinita (<code>BANKIMPORT_DEFAULT_PAYMENT_MODE_ID</code>);
* tolérance de montant (<code>BANKIMPORT_AMOUNT_TOLERANCE</code>, défaut 0,02) ;
* tolleranza d'importo (<code>BANKIMPORT_AMOUNT_TOLERANCE</code>, predefinito 0,02);
* score « candidat fort » (<code>BANKIMPORT_AUTO_APPROVE_SCORE</code>, défaut 90) ;
* punteggio «candidato forte» (<code>BANKIMPORT_AUTO_APPROVE_SCORE</code>, predefinito 90);
* score minimum de correspondance (<code>BANKIMPORT_MATCH_MIN_SCORE</code>, défaut 40) ;
* punteggio minimo di abbinamento (<code>BANKIMPORT_MATCH_MIN_SCORE</code>, predefinito 40);
* nombre max. de factures analysées par transaction (<code>BANKIMPORT_MATCH_SCAN_LIMIT</code>, défaut 1000) ;
* numero max. di fatture analizzate per transazione (<code>BANKIMPORT_MATCH_SCAN_LIMIT</code>, predefinito 1000);
* candidats max. par transaction (<code>BANKIMPORT_MATCH_TOP_PER_TRANSACTION</code>, défaut 10) ;
* candidati max. per transazione (<code>BANKIMPORT_MATCH_TOP_PER_TRANSACTION</code>, predefinito 10);
* taille maximale d'un fichier importé (<code>BANKIMPORT_IMPORT_MAX_FILESIZE_MB</code>, défaut 20 Mo) ;
* dimensione massima di un file importato (<code>BANKIMPORT_IMPORT_MAX_FILESIZE_MB</code>, predefinito 20 MB);
* recherche aussi dans les salaires / les charges sociales et fiscales (activées par défaut).
* cercare anche negli stipendi / negli oneri sociali e fiscali (attivati per impostazione predefinita).


== Permissions utilisateur ==
== Permessi utente ==


Le module définit cinq permissions :
Il modulo definisce cinque permessi:


* '''Lire''' Bank Import — tableau de bord et listes (read)
* '''Leggere''' Bank Import — cruscotto ed elenchi (read)
* '''Importer''' des relevés bancaires — envoi et lecture des fichiers (import)
* '''Importare''' estratti conto bancari — invio e lettura dei file (import)
* '''Générer et valider''' les correspondances — calcul, approbation/rejet, pointage (match)
* '''Generare e validare''' gli abbinamenti — calcolo, approvazione/rifiuto, spunta (match)
* '''Créer''' les règlements Dolibarr — paiements natifs après validation (pay)
* '''Creare''' i pagamenti Dolibarr — pagamenti nativi dopo validazione (pay)
* '''Administrer''' Bank Import — configuration, connecteurs, lots (admin)
* '''Amministrare''' Bank Import — configurazione, connettori, lotti (admin)


== Flux type ==
== Flusso tipo ==


# Importez un fichier de relevé (Import bancaire).
# Importa un file di estratto conto (Importazione bancaria).
# Générez les correspondances (Correspondances bancaires).
# Genera gli abbinamenti (Abbinamenti bancari).
# Vérifiez le score et les raisons de chaque candidat.
# Verifica il punteggio e le motivazioni di ogni candidato.
# Approuvez la bonne correspondance, choisissez le mode et la date d'encaissement.
# Approva l'abbinamento corretto, scegli la modalità e la data di incasso.
# Le '''règlement Dolibarr natif''' est créé, l'écriture bancaire alimentée et le rapprochement verrouillé.
# Il '''pagamento nativo di Dolibarr''' è creato, il movimento bancario alimentato e la riconciliazione bloccata.


== Note technique ==
== Nota tecnica ==


* Tables : <code>llx_bankimport_transaction</code>, <code>llx_bankimport_import</code>, <code>llx_bankimport_match</code>, <code>llx_bankimport_connector</code>.
* Tabelle: <code>llx_bankimport_transaction</code>, <code>llx_bankimport_import</code>, <code>llx_bankimport_match</code>, <code>llx_bankimport_connector</code>.
* Standards Dolibarr respectés : droits, jetons CSRF, <code>GETPOST</code>, échappement.
* Standard Dolibarr rispettati: diritti, token CSRF, <code>GETPOST</code>, escaping.
* Les secrets de connecteur sont '''référencés''' (nom d'un secret géré hors webroot), jamais stockés en clair.
* I segreti di connettore sono '''referenziati''' (nome di un segreto gestito fuori dal webroot), mai memorizzati in chiaro.
* '''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éé.
* '''Inalterabilità''': il modulo crea pagamenti nativi dopo validazione umana; non modifica né elimina alcuna scrittura contabile esistente, e non elimina mai un pagamento già creato.
* '''Aucune modification du core de Dolibarr.'''
* '''Nessuna modifica del core di Dolibarr.'''


== Installation ==
== Installazione ==


# Décompressez l'archive pour obtenir un dossier <code>bankimport/</code>.
# Decomprimi l'archivio per ottenere una cartella <code>bankimport/</code>.
# Copiez-le dans <code>htdocs/custom/</code> de votre Dolibarr.
# Copiala in <code>htdocs/custom/</code> del tuo Dolibarr.
# Activez le module depuis Accueil → Configuration → Modules/Applications (famille Finance).
# Attiva il modulo da Home → Configurazione → Moduli/Applicazioni (famiglia Finanza).
# Ouvrez la configuration et choisissez un compte bancaire et un mode de règlement par défaut.
# Apri la configurazione e scegli un conto bancario e una modalità di pagamento predefiniti.


== Mise à jour ==
== Aggiornamento ==


# Remplacez le dossier <code>htdocs/custom/bankimport/</code> par la nouvelle version.
# Sostituisci la cartella <code>htdocs/custom/bankimport/</code> con la nuova versione.
# Rechargez une page d'administration : les tables et constantes manquantes sont créées automatiquement, de façon idempotente.
# Ricarica una pagina di amministrazione: le tabelle e le costanti mancanti vengono create automaticamente, in modo idempotente.
# La mise à jour ne supprime aucune donnée existante.
# L'aggiornamento non elimina alcun dato esistente.


== Résolution des problèmes ==
== Risoluzione dei problemi ==


* '''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).
* '''Nessuna riga rilevata all'importazione CSV''': verifica il separatore e la presenza di un'intestazione (colonne data, causale, importo, valuta, terzo).
* '''Fichier refusé''' : dépassement de la taille maximale configurée (<code>BANKIMPORT_IMPORT_MAX_FILESIZE_MB</code>).
* '''File rifiutato''': superamento della dimensione massima configurata (<code>BANKIMPORT_IMPORT_MAX_FILESIZE_MB</code>).
* '''Pas de candidat''' : abaissez le score minimum, augmentez la limite d'analyse, ou vérifiez que les factures sont bien ouvertes.
* '''Nessun candidato''': abbassa il punteggio minimo, aumenta il limite di analisi, o verifica che le fatture siano realmente aperte.
* '''Aucun mode de règlement''' : activez au moins un mode de règlement dans Dolibarr.
* '''Nessuna modalità di pagamento''': attiva almeno una modalità di pagamento in Dolibarr.


== Voir aussi ==
== Vedi anche ==


* '''Terminal de signature KSIDol''' : signature de toutes les fiches natives de Dolibarr, compatible avec tous les modules KSIDol.
* '''Terminale di firma KSIDol''': firma di tutte le schede native di Dolibarr, compatibile con tutti i moduli KSIDol.
* Compatibilité : Dolibarr 18.0 à 24.x — PHP 8.0+ — Licence GPLv3 — Éditeur : KSIDol.
* Compatibilità: Dolibarr 18.0 a 24.x — PHP 8.0+ — Licenza GPLv3 — Editore: KSIDol.


== Résumé ==
== Riepilogo ==


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é.
Bank Import importa i tuoi estratti conto bancari (CSV, OFX, QIF, CAMT.053, MT940), riconcilia ogni movimento con le tue fatture e i documenti aperti con un punteggio e delle motivazioni, poi crea i pagamenti nativi di Dolibarr dopo validazione — senza mai modificare un movimento esistente né rompere l'inalterabilità.

Revision as of 16:07, 19 October 2026


Retour index
Documentation développeur

File Doc dev.png

Retour index
Documentation Utilisateur
File Doc user.png

Bank Import per Dolibarr
Importa i tuoi estratti conto, ottieni abbinamenti con punteggio con le tue fatture e crea i pagamenti nativi di Dolibarr — dopo validazione umana
   Importazione multiformato
   Riconciliazione bancaria
   Abbinamenti con punteggio
   Pagamenti nativi
   Validazione umana
   Anti-duplicati
   CSV · OFX · QIF · CAMT.053 · MT940

Presentazione

Bank Import è un modulo esterno per Dolibarr ERP/CRM (editore KSIDol) che automatizza la riconciliazione bancaria, dall'estratto conto al pagamento.

Importa i movimenti di un estratto conto bancario (CSV, OFX, QIF, CAMT.053, MT940), propone abbinamenti con punteggio con le tue fatture, acconti, stipendi e oneri aperti, poi crea i pagamenti nativi di Dolibarr — solo dopo la tua validazione. Il modulo propone, l'utente decide: nessun pagamento è creato automaticamente, nessun movimento esistente è modificato o eliminato.

Il modulo non modifica alcun file del core di Dolibarr.

Editore e supporto

Elemento Informazione
Editore KSIDol
Specialità Integratore Dolibarr
Servizi Sviluppo su misura, hosting SaaS, affiancamento Dolibarr
Sito web https://www.ksidol.io
Supporto support@ksidol.io
Moduli Dolistore https://www.dolistore.com/index.php?controller=search&orderby=position&orderway=desc&website=marketplace&search_query=k.s.i&submit_search=

Informazioni sul modulo

Informazione Dettaglio
Nome del modulo Bank Import
Uso principale Importare gli estratti conto bancari e creare i pagamenti Dolibarr dopo riconciliazione con punteggio
Tipo Modulo esterno di Dolibarr
Famiglia Finanza / Contabilità
Versione documentata 24.0.0
Compatibilità Dolibarr Dolibarr 18.0 a 24.x
Compatibilità PHP PHP 8.0 o superiore
Modifica del core di Dolibarr No
Licenza GNU GPLv3
Lingue disponibili Francese, Inglese, Tedesco, Spagnolo, Italiano

Link ufficiali

Obiettivi del modulo

Ridurre il tempo dedicato alla riconciliazione bancaria mantenendo un controllo umano su ogni pagamento:

  • importare un estratto conto di qualsiasi banca grazie al riconoscimento multiformato;
  • riconciliare automaticamente ogni movimento con i documenti aperti di Dolibarr, con un punteggio e delle motivazioni;
  • validare l'abbinamento corretto, scegliere la modalità e la data, poi creare il pagamento nativo di Dolibarr;
  • non toccare mai un movimento esistente: il modulo propone, l'essere umano approva.

Per chi?

  • Microimprese, PMI e associazioni che registrano ancora i loro incassi a mano.
  • Contabili e gestori che vogliono spuntare un estratto conto in pochi minuti, senza doppia registrazione.
  • Integratori Dolibarr che cercano una riconciliazione bancaria affidabile, rispettosa dell'inalterabilità.

Funzionalità principali

  • Importazione multiformato: CSV (delimitatore e colonne dare/avere rilevati, codifica tollerante), OFX (blocchi STMTTRN), QIF, CAMT.053 XML (voci Ntry), MT940 (:61:/:86:). Formato riconosciuto automaticamente o scelto manualmente.
  • Anti-duplicati: impronta calcolata su conto, sorgente, riferimento, date, importo, causale normalizzata e controparte; le righe già importate non vengono mai reinserite.
  • Riconciliazione con punteggio: confronto dell'importo (esatto, prossimo, scarto per commissioni/arrotondamento, pagamento parziale), del riferimento fattura (e delle sue varianti), del terzo (nome, parole, codice), del verso bancario e della data. Ogni candidato mostra il suo punteggio e le sue motivazioni.
  • Sorgenti di abbinamento: fatture e acconti clienti/fornitori, note di credito (solo spunta), stipendi non pagati e oneri sociali/fiscali non pagati (attivabili), e movimenti bancari nativi esistenti (solo spunta, senza doppio pagamento).
  • Validazione e pagamento: approvazione di una riga (o allocazione parziale), scelta della modalità e della data, poi creazione del pagamento nativo di Dolibarr (pagamento di fattura, di stipendio o di onere) e del movimento bancario; blocco della riconciliazione.
  • Rilevamento del tipo di pagamento: assegno, carta, bonifico, addebito diretto, effetto domiciliato, contanti.
  • Gestione dei lotti di importazione: eliminazione di un lotto o di una riga, ripristino dei set di prova; le righe spuntate/pagate/bloccate sono protette; mai eliminato un pagamento Dolibarr già creato.
  • Cruscotto: KPI (transazioni, candidati, approvati, pagamenti eseguiti) e filtro di flusso (da elaborare, approvati da pagare, rifiutati, completati).

Menu

Sotto il menu principale Banca, il modulo aggiunge:

  • Cruscotto — indicatori di riconciliazione
  • Importazione bancaria — invio di un file di estratto conto
  • Abbinamenti bancari — movimenti, candidati con punteggio e validazione
  • Lotti di importazione — dettaglio, eliminazione, ripristino
  • Connettori bancari — profili di connettore (amministratore)
  • Configurazione — parametri del modulo

Configurazione

Da Home → Configurazione → Moduli → Bank Import:

  • conto bancario predefinito (BANKIMPORT_DEFAULT_BANK_ACCOUNT_ID);
  • modalità di pagamento predefinita (BANKIMPORT_DEFAULT_PAYMENT_MODE_ID);
  • tolleranza d'importo (BANKIMPORT_AMOUNT_TOLERANCE, predefinito 0,02);
  • punteggio «candidato forte» (BANKIMPORT_AUTO_APPROVE_SCORE, predefinito 90);
  • punteggio minimo di abbinamento (BANKIMPORT_MATCH_MIN_SCORE, predefinito 40);
  • numero max. di fatture analizzate per transazione (BANKIMPORT_MATCH_SCAN_LIMIT, predefinito 1000);
  • candidati max. per transazione (BANKIMPORT_MATCH_TOP_PER_TRANSACTION, predefinito 10);
  • dimensione massima di un file importato (BANKIMPORT_IMPORT_MAX_FILESIZE_MB, predefinito 20 MB);
  • cercare anche negli stipendi / negli oneri sociali e fiscali (attivati per impostazione predefinita).

Permessi utente

Il modulo definisce cinque permessi:

  • Leggere Bank Import — cruscotto ed elenchi (read)
  • Importare estratti conto bancari — invio e lettura dei file (import)
  • Generare e validare gli abbinamenti — calcolo, approvazione/rifiuto, spunta (match)
  • Creare i pagamenti Dolibarr — pagamenti nativi dopo validazione (pay)
  • Amministrare Bank Import — configurazione, connettori, lotti (admin)

Flusso tipo

  1. Importa un file di estratto conto (Importazione bancaria).
  2. Genera gli abbinamenti (Abbinamenti bancari).
  3. Verifica il punteggio e le motivazioni di ogni candidato.
  4. Approva l'abbinamento corretto, scegli la modalità e la data di incasso.
  5. Il pagamento nativo di Dolibarr è creato, il movimento bancario alimentato e la riconciliazione bloccata.

Nota tecnica

  • Tabelle: llx_bankimport_transaction, llx_bankimport_import, llx_bankimport_match, llx_bankimport_connector.
  • Standard Dolibarr rispettati: diritti, token CSRF, GETPOST, escaping.
  • I segreti di connettore sono referenziati (nome di un segreto gestito fuori dal webroot), mai memorizzati in chiaro.
  • Inalterabilità: il modulo crea pagamenti nativi dopo validazione umana; non modifica né elimina alcuna scrittura contabile esistente, e non elimina mai un pagamento già creato.
  • Nessuna modifica del core di Dolibarr.

Installazione

  1. Decomprimi l'archivio per ottenere una cartella bankimport/.
  2. Copiala in htdocs/custom/ del tuo Dolibarr.
  3. Attiva il modulo da Home → Configurazione → Moduli/Applicazioni (famiglia Finanza).
  4. Apri la configurazione e scegli un conto bancario e una modalità di pagamento predefiniti.

Aggiornamento

  1. Sostituisci la cartella htdocs/custom/bankimport/ con la nuova versione.
  2. Ricarica una pagina di amministrazione: le tabelle e le costanti mancanti vengono create automaticamente, in modo idempotente.
  3. L'aggiornamento non elimina alcun dato esistente.

Risoluzione dei problemi

  • Nessuna riga rilevata all'importazione CSV: verifica il separatore e la presenza di un'intestazione (colonne data, causale, importo, valuta, terzo).
  • File rifiutato: superamento della dimensione massima configurata (BANKIMPORT_IMPORT_MAX_FILESIZE_MB).
  • Nessun candidato: abbassa il punteggio minimo, aumenta il limite di analisi, o verifica che le fatture siano realmente aperte.
  • Nessuna modalità di pagamento: attiva almeno una modalità di pagamento in Dolibarr.

Vedi anche

  • Terminale di firma KSIDol: firma di tutte le schede native di Dolibarr, compatibile con tutti i moduli KSIDol.
  • Compatibilità: Dolibarr 18.0 a 24.x — PHP 8.0+ — Licenza GPLv3 — Editore: KSIDol.

Bank Import importa i tuoi estratti conto bancari (CSV, OFX, QIF, CAMT.053, MT940), riconcilia ogni movimento con le tue fatture e i documenti aperti con un punteggio e delle motivazioni, poi crea i pagamenti nativi di Dolibarr dopo validazione — senza mai modificare un movimento esistente né rompere l'inalterabilità.

Retrieved from "https://wiki.dolibarr.org/index.php?title=Import_bancaire_et_rapprochement_pour_Dolibarr&oldid=68170"