Documentazione KSIDol > Moduli KSIDol > Importazione bancaria

Guida del modulo: Importazione bancaria

Guida d'uso non tecnica: a cosa serve il modulo, come utilizzarlo e come si integra con Dolibarr.

Formati bancari importati5: CSV, OFX, QIF, CAMT.053, MT940

Documenti riconciliatiFatture, acconti, note di credito, stipendi, oneri

Pagamento DolibarrCreato solo dopo convalida umana

CompatibilitàDolibarr 18+ - PHP 8+

1. Panoramica del modulo

Importazione bancaria (Bank Import) è un modulo KSIDol che fa entrare i vostri estratti conto in Dolibarr e vi aiuta a spuntare ogni movimento con il documento contabile corretto. Importate un file della vostra banca (o preparate un profilo di connettore API), il modulo propone automaticamente le fatture, gli acconti, le note di credito, gli stipendi o gli oneri che corrispondono meglio a ogni riga e poi, dopo la vostra convalida, crea il pagamento nativo di Dolibarr e salda la fattura. L'obiettivo: meno inserimento manuale, una riconciliazione più rapida e una contabilità sempre aggiornata, senza mai lasciare che il modulo agisca da solo.

Si basa interamente sugli oggetti nativi di Dolibarr: conti bancari, fatture clienti e fornitori, acconti, note di credito, stipendi, oneri sociali/fiscali e modalità di pagamento.
Nessuna modifica al cuore di Dolibarr: il modulo aggiunge le proprie pagine e le proprie tabelle, nel menu Banche/Casse.
Il controllo resta umano: il pagamento di Dolibarr non viene mai creato senza che abbiate convalidato la corrispondenza.
Una volta che una scrittura bancaria è pagata o spuntata, viene bloccata e non viene più riproposta, il che evita i doppi pagamenti.

2. Importazione degli estratti conto bancari

La pagina Importazione bancaria consente di caricare un file fornito dalla vostra banca e di trasformare ogni operazione in una scrittura pronta da riconciliare, sul conto bancario Dolibarr di vostra scelta.

Supporto di 5 formati: CSV, OFX, QIF, CAMT.053 XML e MT940 (file .sta), con un'opzione di rilevamento automatico del formato.
Lettura tollerante delle esportazioni CSV: separatori vari, codifiche Windows/ISO, date remote e colonne dare/avere separate.
Scelta del conto bancario Dolibarr di destinazione (un conto predefinito può essere preselezionato nella configurazione).
Ogni file importato diventa un lotto di importazione identificato, con un'impronta, per tenere traccia di ciò che è stato caricato.
Protezione anti-duplicati: il modulo rifiuta un'operazione già presente (impronta del file e chiave gestionale data + conto + importo + descrizione + controparte).
Visualizzazione di una diagnosi delle prime righe in errore per correggere un file mal formato.
Controlli di sicurezza: estensioni di file consentite e dimensione massima di importazione configurabile.

3. Cruscotto e monitoraggio delle importazioni

La pagina iniziale del modulo offre una visione d'insieme dell'attività di riconciliazione e un accesso rapido alle ultime operazioni importate.

Quattro riquadri con cifre e cliccabili: transazioni importate, corrispondenze proposte, righe approvate e pagamenti eseguiti.
Pannello Ultime importazioni che elenca i lotti recenti: data, origine, nome del file, conto bancario (link cliccabile alla scheda del conto), numero di righe importate/lette, duplicati e stato.
Elenco ordinabile per colonna e scorciatoie dirette all'importazione, alle corrispondenze e ai lotti di importazione.

4. Riconciliazione intelligente delle scritture

La pagina Corrispondenze bancarie è il cuore del modulo: confronta ogni riga bancaria con i documenti aperti di Dolibarr e propone le migliori associazioni, senza mai decidere al posto vostro.

Generazione automatica di proposte (candidati) per le scritture da trattare.
Punteggio di pertinenza calcolato su più criteri: importo (esatto, vicino, approssimativo, scarto compatibile con spese/arrotondamento, pagamento parziale), riferimento della fattura, nome o codice del terzo, verso del movimento e prossimità di data.
Ogni proposta mostra le sue motivazioni, supportate dalla prova trovata (parola del terzo, riferimento individuato...).
Schede di monitoraggio del flusso di lavoro: Da trattare, Approvati da pagare, Rifiutati, Completati, Tutti.
Rilevamento del tipo di pagamento (assegno, carta, bonifico, addebito diretto, effetto, contanti) per precompilare la modalità di pagamento.
Spunta guidata in una finestra dedicata: convalida di una corrispondenza proposta, assegnazione manuale di una fattura o incasso parziale con importo da spuntare.
Azioni per riga: approvare, rifiutare, riaprire un rifiuto, annullare un'approvazione, bloccare dopo il pagamento.
Le scritture già spuntate, pagate o bloccate non vengono più riproposte nei nuovi calcoli.
Riconciliazione possibile con scritture bancarie già presenti in Dolibarr: in questo caso, solo spunta, mai un secondo pagamento.

5. Creazione dei pagamenti Dolibarr

Una volta convalidata una corrispondenza, il modulo crea il pagamento nativo di Dolibarr corrispondente e aggiorna il documento, a condizione di averne il diritto.

Fattura cliente saldata tramite un pagamento cliente nativo; fattura fornitore tramite un pagamento fornitore nativo.
Sono supportati anche gli acconti clienti e fornitori per la creazione del pagamento.
Stipendi non pagati e oneri sociali/fiscali: creazione del pagamento di stipendio o di onere nativo di Dolibarr.
Il pagamento genera il collegamento alla fattura, la scrittura sul conto bancario e il passaggio allo stato pagato se il documento è saldato.
Pagamento parziale possibile inserendo l'importo da spuntare.
Caso particolare delle note di credito: vengono solo spuntate e bloccate, senza creazione automatica di un pagamento.

6. Integrazione con le pagine Banca native di Dolibarr

Dalla versione 1.3.0, il modulo compare direttamente nelle scritture bancarie native di Dolibarr (Banca, conto, scritture), senza lasciare la schermata abituale.

Pulsante «Importa un estratto» nell'elenco delle scritture di un conto: apre una finestra di conferma (la banca interessata e gli estratti gia importati) e riutilizza l'importazione del modulo, senza doppio inserimento.
Colonna «Riconciliazione» su ogni scrittura: distingue a colpo d'occhio le righe puntate tramite un lotto Bank Import da quelle riconciliate nativamente in Dolibarr.
Azione «Punta» su una scrittura non riconciliata: apre la riconciliazione del modulo per collegare la scrittura a una o piu fatture.
Nessun movimento bancario duplicato: il pagamento viene collegato alla scrittura esistente (nessuna nuova riga), poi la riconciliazione nativa viene spuntata automaticamente quando la scrittura e interamente allocata.
Funzionamento bidirezionale: le puntature e le riconciliazioni sono condivise tra il modulo e la schermata Banca nativa di Dolibarr.
Attiva non appena il modulo e abilitato: dopo un aggiornamento, basta disattivare e riattivare il modulo per registrarla, senza configurazione manuale. Puo essere disattivata nella configurazione del modulo se necessario.

7. Gestione dei lotti di importazione

La pagina Lotti di importazione consente di rivedere ciò che è stato caricato, consultarne il dettaglio e fare pulizia correttamente, in particolare durante le fasi di test.

Elenco dei lotti con riferimento, origine, file, data, numero di righe presenti e protette, e stato.
Dettaglio di un lotto: consultazione riga per riga delle scritture importate.
Eliminazione di un lotto completo o di una riga di importazione.
Le righe già spuntate o pagate sono protette; la loro eliminazione forzata è riservata agli amministratori e non elimina mai i pagamenti Dolibarr già creati.
Utile per reinizializzare un set di test prima di una messa in produzione.

8. Connettori bancari (preparazione API)

La pagina Connettori bancari consente di dichiarare profili di connessione alle API bancarie, in vista di automatizzare il recupero delle scritture.

Creazione di profili di tipo PSD2/AISP, EBICS o Custom JSON.
Inserimento del fornitore o della banca, dell'URL dell'API, del conto bancario collegato e dello stato attivo.
Il segreto non viene mai memorizzato in chiaro: si indica un riferimento di segreto (variabile d'ambiente o segreto del server), inserito in un campo protetto.
Avviso che ricorda che un'API bancaria presuppone un contratto/fornitore dedicato.
Punto di attenzione: la sincronizzazione reale richiede un adattatore specifico della banca o del fornitore; i profili preparano l'integrazione ma non attivano un'importazione automatica di serie.

9. Configurazione del modulo

La schermata di configurazione adatta il comportamento del modulo alla vostra azienda e al vostro modo di riconciliare.

Conto bancario predefinito utilizzato per le importazioni e i pagamenti.
Modalità di pagamento predefinita proposta al momento della convalida.
Tolleranza di importo per assorbire arrotondamenti o piccole spese (0,02 predefinito).
Punteggio candidato forte e punteggio minimo di corrispondenza, per regolare la finezza delle proposte.
Numero massimo di fatture analizzate e numero di candidati conservati per scrittura (prestazioni).
Dimensione massima dei file importati.
Opzioni da attivare/disattivare: cercare anche negli stipendi, cercare anche negli oneri sociali/fiscali e filtrare sullo scarto di importo (evita le proposte il cui importo non ha alcun rapporto).

10. Diritti di accesso (permessi)

Il modulo fornisce diritti Dolibarr distinti per separare la consultazione, l'importazione, la riconciliazione e l'azione contabile.

Leggere Bank Import: consultare il cruscotto e le scritture.
Importare estratti conto bancari.
Generare e convalidare le corrispondenze.
Creare i pagamenti Dolibarr (azione contabile).
Amministrare Bank Import: configurazione e connettori.
Questa separazione consente, ad esempio, di lasciare che un collaboratore importi e spunti senza autorizzarlo a creare i pagamenti.

11. Collegamenti con Dolibarr

Il modulo non funziona in modo isolato: si integra con i blocchi nativi di Dolibarr.

Conti bancari (Banche/Casse) : Ogni importazione punta a un conto bancario Dolibarr; al pagamento, la scrittura viene registrata su tale conto tramite il flusso nativo, e il conto resta cliccabile dal cruscotto.
Fatture clienti : Le scritture di incasso vengono riconciliate con le fatture clienti aperte; la convalida crea un pagamento cliente nativo e salda la fattura se l'importo è completo.
Fatture fornitori : Gli esborsi vengono riconciliati con le fatture fornitori; la convalida crea un pagamento fornitore nativo e aggiorna la fattura.
Acconti e note di credito : Le fatture di acconto clienti/fornitori possono generare un pagamento; le note di credito clienti e fornitori vengono solo spuntate e bloccate, senza pagamento automatico.
Terzi (aziende) : Il modulo riconosce il terzo nella descrizione bancaria (nome, parole chiave, codice) per proporre i documenti corretti, basandosi sui terzi di Dolibarr.
Stipendi e oneri sociali/fiscali : Facoltativamente, vengono proposti gli stipendi non pagati e gli oneri sociali/fiscali; la convalida crea il pagamento di stipendio o di onere nativo di Dolibarr.
Modalità di pagamento : La modalità di pagamento proposta proviene dal dizionario delle modalità di pagamento Dolibarr (c_paiement) attive, e può essere pre-rilevata in base al tipo di operazione.
Contabilità e stato dei documenti : Poiché i pagamenti sono creati dai meccanismi nativi di Dolibarr, alimentano la contabilità standard e fanno passare le fatture saldate allo stato pagato, con la riga bancaria associata.
Banca / Riconciliazione : Il modulo si integra nella pagina delle scritture bancarie native (Banca, conto, scritture): pulsante di importazione, colonna di puntatura e azione «Punta». I pagamenti creati vengono collegati alla scrittura esistente e spuntano la riconciliazione nativa di Dolibarr, senza creare un movimento duplicato.