Guida del modulo: Importazione bancaria

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

Formati bancari importati5: CSV, OFX, QIF, CAMT.053, MT940
Documenti riconciliatiFatture, acconti, note di credito, stipendi, oneri, note spese, donazioni
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 giusto. Importate un file fornito dalla vostra banca (o preparate un profilo di connettore API), il modulo propone automaticamente le fatture, gli acconti, le note di credito, gli stipendi, gli oneri, le note spese o le donazioni che corrispondono meglio a ogni riga, poi, dopo la vostra convalida, crea il pagamento nativo Dolibarr, salda il documento e spunta la scrittura bancaria sul suo estratto. L'obiettivo: meno inserimento manuale, una riconciliazione più rapida e una contabilità tenuta aggiornata, senza mai lasciare agire il modulo da solo.

  • Si appoggia interamente agli oggetti nativi Dolibarr: conti bancari, fatture clienti e fornitori, acconti, note di credito, stipendi, oneri sociali/fiscali, note spese, donazioni 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 Dolibarr non è mai creato senza che abbiate convalidato la corrispondenza.
  • Una volta che una scrittura bancaria è pagata o spuntata, viene bloccata e non è più riproposta, il che evita i doppi pagamenti.
  • Le scritture interamente trattate possono essere archiviate: escono dagli elenchi di lavoro pur restando consultabili e ripristinabili, senza che alcun pagamento né alcuna scrittura venga modificato.

2. Importazione degli estratti conto

La pagina Bank import permette 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 vecchie 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 conservare la traccia di ciò che è stato caricato.
  • Ogni riga importata compare anche come scrittura bancaria nativa sul conto Dolibarr: il modulo riutilizza un movimento esistente di pari importo a data vicina quando ne trova uno, altrimenti crea la scrittura — mai un movimento doppio. La spunta collegherà poi il pagamento a questa scrittura.
  • Protezione anti-doppione: il modulo rifiuta un'operazione già presente (impronta del file e chiave di merito data + conto + importo + descrizione + controparte).
  • I doppioni tra due formati di estratto (lo stesso estratto importato in OFX e poi in CSV, per esempio) sono anch'essi riconosciuti e segnalati — si veda la sezione dedicata.
  • Visualizzazione di una diagnostica 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. Dashboard e monitoraggio delle importazioni

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

  • Quattro riquadri numerici e cliccabili: transazioni importate, corrispondenze proposte, righe approvate e pagamenti eseguiti.
  • Pannello Importazioni recenti che elenca i lotti recenti: data, origine, nome del file, conto bancario (link cliccabile verso la scheda del conto), numero di righe importate/lette, doppioni e stato.
  • Elenco ordinabile per colonna e scorciatoie dirette verso l'importazione, le corrispondenze e i lotti di importazione.

4. Riconciliazione intelligente delle scritture

La pagina Bank matching è 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.
  • Documenti proposti: fatture clienti e fornitori, acconti, note di credito, stipendi, oneri sociali/fiscali, note spese approvate (sulle uscite) e donazioni convalidate non pagate (sulle entrate bancarie).
  • Punteggio di pertinenza calcolato su più criteri: importo (esatto, vicino, approssimativo, scarto compatibile con spese/arrotondamenti, pagamento parziale), riferimento della fattura, nome o codice del terzo, senso del movimento e vicinanza di data.
  • Ogni proposta mostra le sue ragioni, sostenute dalla prova trovata (parola del terzo, riferimento individuato...).
  • Un pagamento parziale è proposto solo se è corroborato da un riferimento o da un terzo riconosciuto, mai sul solo importo.
  • Schede di monitoraggio del flusso di lavoro, ciascuna con il suo contatore: Da elaborare, Approvati da pagare, Rifiutati, Completati, Tutti, cui si aggiunge la scheda Archiviate per le scritture riposte.
  • 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 un documento, o incasso parziale con importo da spuntare.
  • Assegnazione manuale sulla totalità dei documenti aperti: l'elenco copre tutti i documenti da spuntare e si filtra digitando la ragione sociale, il numero del documento o l'importo — le tre scritture correnti dell'importo sono comprese (1123,45 · 1123.45 · 1 123,45).
  • Alla selezione di un documento, l'importo da spuntare si compila automaticamente con il suo residuo dovuto, limitato all'importo della scrittura bancaria; la finestra di spunta occupa tutta la larghezza disponibile dello schermo.
  • Un bonifico unico che paga più fatture si ripartisce tra di esse: ogni assegnazione consuma la sua parte dell'importo, e la scrittura è bloccata solo una volta interamente allocata, senza sovrascrivere le assegnazioni già convalidate.
  • Avviso in caso di terzo diverso: durante un'assegnazione manuale, se la descrizione bancaria non menziona il terzo della fattura scelta, compare un avvertimento. Non impedisce nulla (un bonifico può venire da un mandatario o da una casa madre), ma rende visibile un pagamento diretto verso il terzo sbagliato prima che diventi una scrittura contabile.
  • Contrassegno « Da verificare - già pagata? »: quando una scrittura senza alcuna proposta corrisponde a una fattura già pagata fuori dal modulo, la finestra di spunta lo segnala, nomina la fattura interessata e la data del suo pagamento, e propone di archiviare la scrittura con un clic. Il contrassegno resta prudente quando più fatture potrebbero corrispondere, e nulla viene archiviato automaticamente: la decisione spetta sempre a voi.
  • Scrittura che non può più essere spuntata: la finestra di spunta mostra il motivo in chiaro e propone una via d'uscita — archiviare la scrittura, segnalarla come doppione di un'altra, o ripristinarla se era già riposta.
  • Azioni per riga: approvare, rifiutare, riaprire un rifiuto, annullare un'approvazione, bloccare dopo il pagamento.
  • Sblocco: una scrittura bloccata senza pagamento nativo può essere liberata per essere riconciliata di nuovo, conservando le assegnazioni già convalidate; una scrittura il cui pagamento è stato creato non si sblocca finché quel pagamento non è stato eliminato in Dolibarr.
  • Se la creazione del pagamento fallisce al momento della convalida, l'approvazione è annullata con essa: la scrittura torna allo stato « Puntamento » e un messaggio indica che cosa correggere — una riga non mostra mai « approvata » senza un pagamento realmente creato.
  • Le scritture già spuntate, pagate o bloccate non sono 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 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.
  • Acconti clienti e fornitori anch'essi gestiti per la creazione del pagamento.
  • Stipendi non pagati e oneri sociali/fiscali: creazione del pagamento di stipendio o di onere nativo di Dolibarr.
  • Note spese approvate: la convalida crea il rimborso nativo e la scrittura bancaria associata; la nota è contrassegnata come pagata solo una volta rimborsata fino all'ultimo euro, tenendo conto dei pagamenti già registrati.
  • Donazioni ricevute: le donazioni Dolibarr convalidate e non pagate sono proposte sulle entrate bancarie, sia in automatico sia in selezione manuale. La convalida crea il pagamento di donazione nativo, collegato al conto bancario senza doppione quando una scrittura bancaria nativa esiste già, e la donazione passa allo stato pagato solo quando il suo saldo è nullo. Una donazione non è mai proposta su un'uscita bancaria.
  • Se un pagamento creato dal modulo (cliente, fornitore o donazione) viene poi eliminato direttamente in Dolibarr, la riconciliazione corrispondente è liberata automaticamente e il documento torna spuntabile; un banner di avviso e un pulsante « Risincronizza pagamenti eliminati » recuperano le righe rimaste bloccate.
  • Ogni convalida chiede una modalità di pagamento e una data di incasso: la modalità è precompilata secondo il tipo rilevato o la modalità predefinita, la data secondo la data dell'operazione bancaria, ed entrambe restano modificabili.
  • Il pagamento genera il collegamento al documento, la scrittura sul conto bancario e il passaggio allo stato pagato se il documento è saldato.
  • Pagamento parziale possibile inserendo l'importo da spuntare.
  • La riconciliazione bancaria è posta dal modulo stesso: una scrittura interamente pagata è spuntata sul suo estratto del mese, senza spunta manuale in Dolibarr. Questa riconciliazione resta un'operazione di tesoreria reversibile, ed è posta solo quando la totalità dell'importo della scrittura è assegnata.
  • Caso particolare delle note di credito: sono solo spuntate e bloccate, senza creazione automatica di pagamento.

6. Doppioni tra due formati di estratto

Uno stesso estratto può essere importato due volte in formati diversi (in OFX e poi in CSV, per esempio): la descrizione e il riferimento differiscono allora da un formato all'altro, e la protezione anti-doppione classica non può collegarli. Il modulo riconosce questi casi grazie a una seconda chiave, volutamente limitata al conto, alla data e all'importo.

  • La scrittura doppia è importata e segnalata, mai eliminata: due movimenti realmente distinti dello stesso importo nello stesso giorno possono esistere, e solo voi potete distinguerli.
  • L'elenco porta un contrassegno « Duplicato n. x » che indica la scrittura di origine, e la riga interessata è colorata per essere individuata a colpo d'occhio.
  • La finestra di spunta mostra un avvertimento prima di qualsiasi convalida su una scrittura segnalata come doppione.
  • Un pulsante « Duplicato, archiviare » ripone la scrittura fuori dagli elenchi di lavoro, senza eliminare nulla.
  • L'abbinamento è uno a uno: ogni doppione è collegato a una sola scrittura di origine.
  • Il rapporto di importazione annuncia il numero di doppioni segnalati.
  • Le scritture già presenti in base sono recuperate automaticamente all'aggiornamento del modulo: i doppioni esistenti sono segnalati senza alcuna manipolazione.

7. Archiviazione e scheda « Archiviate »

Perché gli elenchi di lavoro non si allunghino all'infinito, le scritture interamente trattate possono essere riposte: escono dalle viste di lavoro e si ritrovano nella loro scheda « Archiviate ».

  • Una scrittura archiviata esce da tutti gli elenchi di lavoro, compresa la vista « Tutti », e resta consultabile e ripristinabile in ogni momento dalla scheda « Archiviate ».
  • L'archiviazione è una semplice marcatura di visualizzazione: nessun pagamento, nessuna scrittura bancaria né contabile viene toccata.
  • Ogni archiviazione conserva il suo motivo, per distinguere un doppione, un documento già pagato o una riconciliazione terminata.
  • Azioni di massa: ogni elenco permette di spuntare delle scritture, di spuntarle tutte in un colpo e di archiviarle insieme; la scheda « Completati » offre in più un pulsante « Archiviare tutte le scritture saldate », per riporre tutto con un solo gesto.
  • Una scrittura la cui riconciliazione non è terminata non può essere archiviata: il rifiuto è verificato lato server.
  • Una selezione mista indica quante scritture sono state lasciate da parte e perché.

8. Ricerca, ordinamento e filtri

Le tabelle del modulo si ordinano e si filtrano come gli elenchi nativi di Dolibarr, per ritrovare una riga precisa anche su un grande volume di scritture.

  • Ordinamento su ogni colonna di ogni tabella (riconciliazione bancaria, lotti di importazione, righe di un lotto, connettori), dal più piccolo al più grande e viceversa; l'ordinamento conserva i filtri in corso.
  • La ricerca riguarda la totalità delle scritture, con paginazione dei risultati, e non la sola pagina visualizzata.
  • Ricerca per importo nelle due scritture (1 234,56 o 1234.56) e con confronti: « >1000 » o « <=-500 », per esempio.
  • Ricerca per data nei formati gg/mm/aaaa, mm/aaaa e aaaa-mm-gg.
  • La ricerca per terzo esamina anche la descrizione dell'operazione: utile per gli estratti CSV dove il nome dell'ordinante compare solo nella descrizione.
  • La colonna « Azione » si filtra per isolare ciò che resta da fare: Puntamento, Saldare, Sblocca, Archiviare o Niente da puntare. Il filtro lavora su tutta la tabella e non sulla pagina visualizzata.
  • Il filtro di stato sa anche isolare i doppioni segnalati (« Duplicato ») o escluderli (« Non duplicato »).

9. Integrazione nelle pagine Banca native di Dolibarr

Il modulo si inserisce direttamente nelle scritture bancarie native di Dolibarr (menu Banca, conto, scritture), senza lasciare la schermata abituale.

  • Pulsante « Importa un estratto » sull'elenco delle scritture di un conto: apre una finestra di convalida (banca interessata ed estratti già importati) poi riutilizza l'importazione del modulo, senza doppio inserimento.
  • Colonna « Spunta » su ogni scrittura: distingue a colpo d'occhio le righe spuntate tramite un'importazione Bank Import da quelle riconciliate nativamente in Dolibarr.
  • La colonna « Spunta » si filtra realmente: il filtro si applica all'elenco intero (conteggio e pagine successive compresi), e non alla sola pagina visualizzata. La colonna compare anche nel selettore di colonne e può quindi essere nascosta come le altre.
  • Le scritture riposte si annunciano « Archiviato » nell'elenco bancario, e il filtro della colonna « Spunta » propone questo stato.
  • Azione « Spunta » su una scrittura non riconciliata: apre la riconciliazione del modulo per collegare la scrittura a uno o più documenti.
  • Il link « Da riconciliare » isola la scrittura interessata, la spunta e posiziona il cursore nel campo dell'estratto: non serve più ritrovarla a mano nell'elenco.
  • Nessun movimento bancario doppio: il pagamento è collegato alla scrittura esistente (nessuna nuova riga), poi la riconciliazione nativa è spuntata automaticamente una volta che la scrittura è interamente assegnata.
  • Corrispondenza con una scrittura già presente: quando una riga di estratto corrisponde a una scrittura bancaria che porta già il suo pagamento, il pulsante « Conferma la corrispondenza (nulla da pagare) » collega la riga a questa scrittura e la chiude, senza creare un secondo pagamento né modificare la sua riconciliazione.
  • Funzionamento bidirezionale: le spunte e le riconciliazioni sono condivise tra il modulo e la schermata Banca nativa di Dolibarr.
  • Attiva fin dall'attivazione del modulo: dopo un aggiornamento, basta disattivare e riattivare il modulo per registrarla, senza alcuna configurazione manuale. L'integrazione può essere disattivata nella configurazione del modulo se necessario.

10. Gestione dei lotti di importazione

La pagina Lotti di importazione permette di tornare su ciò che è stato caricato, di consultarne il dettaglio e di fare pulizia in modo corretto, in particolare nelle 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 prova prima di una messa in produzione.

11. Connettori bancari (preparazione API)

La pagina Bank connectors permette 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 di servizi o della banca, dell'URL dell'API, del conto bancario collegato e dello stato attivo.
  • Il segreto non è mai memorizzato in chiaro: si indica un riferimento di segreto (variabile d'ambiente o segreto del server), inserito in un campo protetto.
  • Avvertimento che ricorda che un'API bancaria presuppone un contratto/fornitore dedicato.
  • Punto di attenzione: la sincronizzazione reale richiede un adattatore specifico per la banca o il fornitore; i profili preparano l'integrazione ma non avviano alcuna importazione automatica in standard.

12. Configurazione del modulo

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

  • Conto bancario predefinito usato per le importazioni e i pagamenti.
  • Modalità di pagamento predefinita proposta alla convalida.
  • Tolleranza di importo per assorbire arrotondamenti o piccole spese (0,02 per impostazione predefinita).
  • 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, proporre le note spese, e filtrare sullo scarto di importo (evita le proposte il cui importo non ha alcun rapporto).
  • Impostazione dedicata alla riconciliazione delle donazioni ricevute: attiva o disattiva la proposta delle donazioni convalidate non pagate sulle entrate bancarie.
  • Integrazione nelle pagine Banca native: una casella attiva o disattiva il pulsante di importazione e la spunta nelle schermate Banca di Dolibarr.
  • Visualizzazione del pannello di spunta: per impostazione predefinita si carica su richiesta per la sola scrittura spuntata, il che mantiene leggero l'elenco di riconciliazione anche su un conto ad alto volume; un'opzione ripristina la vecchia visualizzazione del pannello in ogni riga.
  • Le impostazioni del modulo sono conservate anche quando viene disattivato e poi riattivato, in particolare durante un aggiornamento.

13. 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 la dashboard e le scritture.
  • Importare estratti conto.
  • Generare e convalidare le corrispondenze.
  • Creare i pagamenti Dolibarr (azione contabile).
  • Amministrare Bank Import: configurazione e connettori.
  • Questa separazione permette, per esempio, di lasciare che un collaboratore importi e spunti senza autorizzarlo a creare i pagamenti.
  • Le note spese proposte rispettano la compartimentazione nativa di Dolibarr: ogni utente vede solo le proprie note e quelle dei suoi subordinati, salvo che detenga il diritto di leggere quelle di tutti.
  • La riconciliazione delle donazioni presuppone che il modulo Donazioni di Dolibarr sia attivo e che l'utente disponga dei diritti corrispondenti.

14. 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 e ogni riga importata vi compare come scrittura bancaria nativa, senza doppione con i movimenti già presenti; al pagamento, questa scrittura è collegata tramite il flusso nativo, e il conto resta cliccabile dalla dashboard.
  • Fatture clienti : Le scritture di incasso sono riconciliate con le fatture clienti aperte; la convalida crea un pagamento cliente nativo e salda la fattura se l'importo è completo.
  • Fatture fornitori : Le uscite sono riconciliate 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 sono solo spuntate e bloccate, senza pagamento automatico.
  • Terzi (società) : Il modulo riconosce il terzo nella descrizione bancaria (nome, parole chiave, codice) per proporre i documenti giusti, appoggiandosi ai terzi Dolibarr.
  • Stipendi e oneri sociali/fiscali : In opzione, gli stipendi non pagati e gli oneri sociali/fiscali sono proposti; la convalida crea il pagamento di stipendio o di onere nativo di Dolibarr.
  • Note spese : Le note spese approvate e non rimborsate sono proposte sulle uscite; la convalida crea il rimborso nativo e salda la nota una volta rimborsata fino all'ultimo euro. Le proposte rispettano la compartimentazione nativa delle note spese: ciascuno vede solo le proprie e quelle dei suoi subordinati, salvo diritto di leggere tutto.
  • Donazioni (modulo Donazioni) : Quando il modulo Donazioni di Dolibarr è attivo e l'utente ne ha i diritti, le donazioni convalidate e non pagate sono proposte sulle entrate bancarie, mai su un'uscita. La convalida crea il pagamento di donazione nativo, collegato alla banca senza doppione se una scrittura nativa esiste già; la donazione passa allo stato pagato solo a saldo nullo, e l'eliminazione nativa del suo pagamento libera la riconciliazione nel modulo.
  • Modalità di pagamento : La modalità di pagamento proposta proviene dal dizionario delle modalità di pagamento Dolibarr (c_paiement) attive, e può essere prerilevata secondo il 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 spunta filtrabile sull'elenco intero e mascherabile tramite il selettore di colonne, stato « Archiviato », azione « Spunta » e link « Da riconciliare » che isola la scrittura, la spunta e posiziona il cursore nel campo dell'estratto. I pagamenti creati si collegano alla scrittura esistente senza movimento doppio, e la riconciliazione nativa è posta automaticamente sull'estratto del mese non appena la totalità dell'importo è assegnata — un'operazione di tesoreria che resta reversibile.
Serve aiuto? WhatsApp Telefono: 07 45 15 75 87 Telefono: 07 43 52 58 29 Email Apri il modulo