Importare gli estratti conto bancari in Odoo è solo il primo passo. Il vero vantaggio nasce soltanto quando un movimento bancario può essere abbinato in modo affidabile alla fattura cliente, alla fattura fornitore, alla nota di credito o al pagamento corretti.
Proprio a questo punto a Odoo 19 Community manca una soluzione comoda nell'interfaccia utente. Le righe bancarie importate rimangono quindi inizialmente sul conto transitorio della banca e, per l'ulteriore elaborazione, devono essere assegnate a una scrittura contabile aperta.
Per la nostra installazione di Odoo 19 Community abbiamo quindi sviluppato il Bank Statement Matcher. Poiché questo problema non riguarda solo noi, mettiamo il modulo a disposizione gratuitamente su GitHub con la licenza libera AGPL-3.
Al progetto su GitHub:
Odoo 19 Bank Statement Matcher
Dall'importazione dell'estratto conto alla fattura giusta
Con il nostro progetto già pubblicato Odoo 19 Bank Statement Import è possibile importare in Odoo 19 Community diversi formati di estratto conto bancario. Tra questi, tra l'altro, CAMT.053, CAMT.054, OFX e SWIFT MT940.
Il nuovo Bank Statement Matcher integra questa importazione con il successivo passaggio decisivo:
Quale movimento bancario importato appartiene a quale partita aperta?
Il modulo esamina i crediti e i debiti aperti, valuta i possibili riscontri e mostra agli utenti perché viene proposto un determinato abbinamento. La proposta può essere verificata, confermata, corretta o sostituita da una selezione manuale.
In questo modo per Odoo 19 Community nasce un flusso di lavoro continuo:
Importare l'estratto conto
individuare i possibili abbinamenti
verificare le proposte in blocco
accettare i riscontri univoci
elaborare manualmente i casi poco chiari
Cosa sa fare l'Odoo 19 Bank Statement Matcher
Il modulo è stato sviluppato per l'uso pratico in contabilità. Supporta, tra l'altro, le seguenti funzioni:
ricerca di fatture, fatture fornitore, note di credito e pagamenti corrispondenti
individuazione automatica di proposte di abbinamento al momento della creazione di una riga bancaria
visualizzazione comprensibile della regola di abbinamento utilizzata e del suo grado di affidabilità
nuova ricerca in un momento successivo
abbinamento singolo o elaborazione congiunta di più righe bancarie
selezione manuale di una partita aperta quando nessuna proposta è adatta
annullamento di un abbinamento già effettuato
riconoscimento di più riscontri equivalenti senza decisioni arbitrarie
indicazioni su preventivi o ordini per i quali non esiste ancora una scrittura contabile aperta
passaggio diretto opzionale dall'importazione degli estratti conto OCA alla vista di abbinamento
traduzione in tedesco con codice sorgente in inglese
La panoramica centrale in Odoo è raggiungibile da Contabilità → Contabilità → Abbinamento righe bancarie. Lì è possibile cercare ed elaborare insieme le righe bancarie ancora aperte.
Abbinamento tracciabile invece di una scatola nera
Con i dati finanziari non basta proporre un riscontro qualsiasi. Gli utenti devono poter capire perché un movimento bancario dovrebbe corrispondere a un determinato documento.
Il Bank Statement Matcher lavora quindi con regole definite con chiarezza e diversi livelli di affidabilità:
| Affidabilità | Regola | Significato |
|---|---|---|
| 100 | Riferimento | Nel testo di registrazione è stato trovato un numero di documento, un riferimento di pagamento o un riferimento di origine. |
| 80 | Partner e importo | Il partner commerciale e l'importo aperto coincidono. |
| 60 | Importo univoco | L'importo corrisponde esattamente a una sola partita aperta. |
| 30 | Partner | Il partner corrisponde, ma l'importo no; si tratta solo di un'indicazione. |
Per ogni registro è possibile stabilire da quale livello di affidabilità una proposta univoca può essere accettata tramite l'azione collettiva. I riscontri più deboli restano visibili, ma devono essere verificati e confermati singolarmente.
È importante: il modulo non registra senza supervisione in background. Crea proposte. Un abbinamento avviene solo tramite un'azione consapevole dell'utente – singolarmente o tramite l'elaborazione collettiva controllata.
Vengono considerati anche i riferimenti bancari difficili
Le banche non trasmettono sempre i riferimenti di pagamento in una forma uniforme. Un numero di fattura può essere associato a nomi, cifre o altre indicazioni. I separatori possono mancare o essere rappresentati in modo diverso rispetto al documento originale.
Il Matcher normalizza quindi i valori di confronto e considera anche i passaggi tra lettere e cifre. In questo modo i riferimenti possono essere riconosciuti anche quando nel testo bancario sono stati accodati direttamente ad altri contenuti.
La ricerca avviene volutamente dal documento Odoo verso il testo bancario. In questo modo si evita che brevi sequenze numeriche generiche del testo di registrazione portino a un gran numero di riscontri non pertinenti.
Le regole non sono limitate né a una determinata banca, né a un determinato paese, né a uno schema di numerazione predefinito. Questo rende il modulo interessante anche per altre installazioni di Odoo 19 Community.
Perché una nuova ricerca è importante
Non ogni pagamento bancario può essere abbinato già al momento dell'importazione. Nella pratica un pagamento può arrivare prima che la relativa fattura sia stata creata o registrata in Odoo. Anche una fattura fornitore o una nota di credito può essere registrata solo in seguito.
Per questo le righe bancarie possono essere riesaminate in un momento successivo con «Cerca di nuovo». Non appena è presente la partita aperta corrispondente, un movimento bancario prima non abbinabile può diventare un riscontro univoco.
Se il testo bancario cita ad esempio un preventivo o un ordine per cui non esiste ancora né una fattura né, quindi, una partita aperta, il modulo fornisce un'indicazione utile. Invece di mostrare semplicemente «nessun riscontro», segnala che forse occorre prima creare la fattura.
La sicurezza ha la precedenza
Un abbinamento automatico errato può causare in contabilità più lavoro di una riga bancaria aperta. Il Bank Statement Matcher è stato quindi progettato volutamente con prudenza:
I riscontri con la stessa valutazione non vengono risolti in modo arbitrario.
Le proposte deboli vengono mostrate, ma non accettate tramite l'azione collettiva.
Prima dell'abbinamento si verifica di nuovo se la partita aperta è ancora disponibile.
Una partita nel frattempo compensata da un altro utente non viene elaborata di nuovo.
Ogni riga bancaria viene elaborata all'interno di un proprio savepoint del database.
Un errore in una riga bancaria non impedisce l'elaborazione di tutte le altre righe.
Per precauzione vengono esclusi i vecchi dati incompleti privi di una data di registrazione valida.
In questo modo il modulo supporta l'automazione dove fa risparmiare tempo e richiede una decisione manuale dove i dati non sono sufficientemente chiari.
Interazione con il nostro Bank Statement Import
Il repository è composto da due moduli:
| Modulo | Funzione |
|---|---|
| account_statement_matcher | Fornisce la vera e propria ricerca, valutazione, verifica e abbinamento. Richiede soltanto il modulo Odoo account. |
| account_statement_matcher_import_oca | Ponte opzionale verso l'importazione degli estratti conto OCA. Dopo un'importazione si apre direttamente la vista di abbinamento con le righe appena importate. |
Il ponte opzionale si installa automaticamente quando sono presenti sia il Matcher sia il modulo OCA account_statement_import_file. L'importazione degli estratti conto e il successivo abbinamento si integrano così direttamente.
Maggiori informazioni sull'importazione dei formati bancari supportati sono disponibili nel nostro articolo:
Odoo 19 Bank Statement Import – le nostre estensioni per Odoo Community
Installazione in Odoo 19 Community
L'installazione avviene come per un normale modulo aggiuntivo di Odoo:
Copiare le cartelle dei moduli in un percorso addons di Odoo configurato.
Aggiornare l'elenco delle app in Odoo.
Installare il modulo Bank Statement Matcher.
Stabilire per ogni registro bancario se durante l'importazione debbano essere cercate proposte.
Selezionare il valore minimo desiderato per l'abbinamento collettivo controllato.
Il modulo è stato sviluppato e testato per Odoo 19.0 Community. Prima di un utilizzo con altre versioni di Odoo occorre verificare in particolare le modifiche alle funzioni interne di contabilità e riconciliazione.
Come per ogni estensione in ambito contabile, consigliamo di verificare l'installazione prima in un ambiente di test con una copia del proprio database e con estratti conto tipici.
Gratuito e open source per la community di Odoo
In Biricon IT Services GmbH sviluppiamo soluzioni innanzitutto per esigenze concrete della nostra attività. Se ne nasce un modulo utilizzabile in generale, non vogliamo nasconderlo in una singola installazione.
L'Odoo 19 Bank Statement Matcher è quindi disponibile gratuitamente come progetto open source. Il codice sorgente può essere consultato, verificato, adattato e sviluppato ulteriormente nell'ambito della licenza AGPL-3.
Il nostro obiettivo non è automatizzare ciecamente il maggior numero possibile di decisioni di registrazione. Vogliamo ridurre il lavoro ripetitivo e allo stesso tempo fare in modo che gli abbinamenti finanziari restino tracciabili e controllabili.
Questo è il nostro modo di intendere uno sviluppo open source sensato: risolvere un problema reale, documentare la soluzione in modo trasparente e poi metterla a disposizione della community.
Progetto, codice sorgente e collaborazione
Il codice sorgente completo, le istruzioni di installazione e la documentazione tecnica sono disponibili su GitHub:
Apri Odoo 19 Bank Statement Matcher su GitHub
Ci fa piacere ricevere esperienze pratiche, segnalazioni di errori, suggerimenti di miglioramento e contributi dalla community di Odoo.
Gratuito. Tracciabile. Open source. Per Odoo 19 Community.