Importazione bancaria e riconciliazione per Dolibarr

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

Collegamenti ufficiali

Video dimostrativo: Bank Import — demo (YouTube)
Negozio: KSIDol.io
Scheda del modulo: ksidol.io/it
Pagina editore K.S.I su DoliStore: Moduli K.S.I su DoliStore

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).

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

Importa un file di estratto conto (Importazione bancaria).
Genera gli abbinamenti (Abbinamenti bancari).
Verifica il punteggio e le motivazioni di ogni candidato.
Approva l'abbinamento corretto, scegli la modalità e la data di incasso.
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

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

Aggiornamento

Sostituisci la cartella htdocs/custom/bankimport/ con la nuova versione.
Ricarica una pagina di amministrazione: le tabelle e le costanti mancanti vengono create automaticamente, in modo idempotente.
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.

Riepilogo

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à.