Ves al contingut

Odoo 19 Community: associació automàtica de pagaments bancaris a factures amb el nostre Bank Statement Matcher de codi obert

14 de setembre de 2026 per
Odoo 19 Community: associació automàtica de pagaments bancaris a factures amb el nostre Bank Statement Matcher de codi obert
Alexander Biringer | Biricon IT Services GmbH

Importar extractes bancaris a Odoo és només el primer pas. La utilitat real arriba quan es pot assignar un moviment bancari de manera fiable a la factura de client, factura de proveïdor, abonament o pagament corresponent.

És just en aquest punt que a Odoo 19 Community li falta una manera pràctica de fer-ho des de la interfície d’usuari. Per això, els moviments bancaris importats queden inicialment al compte transitori bancari i s’han d’assignar a una partida comptable pendent per poder continuar processant-los.

Per això hem desenvolupat Bank Statement Matcher per a la nostra pròpia instal·lació d’Odoo 19 Community. Com que aquest problema també afecta altres usuaris, posem el mòdul a disposició de tothom gratuïtament a GitHub sota la llicència lliure AGPL-3.

Accediu al projecte a GitHub:

Odoo 19 Bank Statement Matcher

De la importació de l’extracte bancari a la factura corresponent

Amb el nostre projecte ja publicat Odoo 19 Bank Statement Import es poden importar diversos formats d’extractes bancaris a Odoo 19 Community. Entre aquests formats hi ha CAMT.053, CAMT.054, OFX i SWIFT MT940.

El nou Bank Statement Matcher afegeix a aquesta importació el pas decisiu següent:

A quina partida pendent correspon cada moviment bancari importat?

El mòdul cerca entre els comptes pendents de cobrament i de pagament, valora les possibles coincidències i mostra als usuaris per què proposa una associació determinada. La proposta es pot revisar, confirmar, corregir o substituir per una selecció manual.

Això permet disposar d'un flux de treball complet a Odoo 19 Community:

  1. importar l'extracte bancari

  2. identificar les associacions possibles

  3. revisar les propostes en conjunt

  4. aplicar les coincidències inequívoques

  5. gestionar manualment els casos dubtosos

Què pot fer Odoo 19 Bank Statement Matcher

El mòdul s'ha desenvolupat per a l'ús diari en comptabilitat. Entre d'altres, ofereix les funcions següents:

  • cerca de factures de client, factures de proveïdor, factures rectificatives i pagaments que coincideixin

  • generació automàtica de propostes d'associació en crear una línia bancària

  • indicació clara de la regla d'associació utilitzada i del seu nivell de confiança

  • possibilitat de tornar a cercar més endavant

  • associació individual o processament conjunt de diverses línies bancàries

  • selecció manual d'una partida pendent quan cap proposta és adequada

  • possibilitat de desfer una associació ja feta

  • detecció de diverses coincidències equivalents sense prendre cap decisió arbitrària

  • avisos sobre pressupostos o comandes per als quals encara no existeix cap partida comptable pendent

  • accés directe opcional des de la importació d'extractes bancaris de l'OCA a la vista d'associació

  • traducció a l'alemany amb el text d'origen en anglès

La vista general central és accessible a Odoo des de Comptabilitat → Comptabilitat → Associació de línies bancàries. Permet cercar coincidències per a les línies bancàries encara pendents i processar-les conjuntament.

Associacions amb criteris clars i traçables

Quan es tracta de dades financeres, no n'hi ha prou de proposar qualsevol coincidència. Els usuaris han de poder entendre per què es considera que un moviment bancari correspon a un document determinat.

Per això, Bank Statement Matcher treballa amb regles ben definides i diversos nivells de confiança:

ConfiançaReglaSignificat
100ReferènciaS'ha trobat un número de document, una referència de pagament o una referència d'origen al concepte bancari.
80Contacte i importEl contacte comercial i l'import pendent coincideixen.
60Import inequívocL'import coincideix exactament amb una única partida pendent.
30ContacteEl contacte coincideix, però l'import no; només és una indicació.

Per a cada diari es pot definir el nivell de confiança mínim perquè una proposta inequívoca es pugui aplicar mitjançant l'acció en bloc. Les coincidències amb menys confiança continuen visibles, però s'han de revisar i confirmar individualment.

Cal tenir present que el mòdul no comptabilitza res en segon pla sense supervisió. Genera propostes. L'associació només es fa quan l'usuari actua expressament, de manera individual o mitjançant el processament en bloc controlat.

També es tenen en compte les referències bancàries difícils d'interpretar

Els bancs no sempre transmeten les referències de pagament amb un format uniforme. Un número de factura pot aparèixer unit a noms, xifres o altres dades. Els separadors poden faltar o presentar-se de manera diferent de com apareixen al document original.

Per això, el Matcher normalitza els valors que compara i també té en compte les transicions entre lletres i xifres. Així pot reconèixer referències fins i tot quan apareixen enganxades a altres dades dins del concepte bancari.

La cerca es fa expressament des del document d'Odoo cap al concepte bancari. Així s'evita que les seqüències de xifres curtes i genèriques del concepte generin un gran nombre de coincidències irrellevants.

Les regles no es limiten a un banc, un país o un esquema de numeració determinats. Això fa que el mòdul també sigui útil per a altres instal·lacions d'Odoo 19 Community.

Per què és important tornar a cercar

No tots els pagaments bancaris es poden associar en el moment de la importació. A la pràctica, un pagament pot arribar abans que s'hagi creat o comptabilitzat la factura corresponent a Odoo. També pot ser que una factura de proveïdor o una factura rectificativa es registri més endavant.

Per això, les línies bancàries es poden tornar a comprovar més endavant amb «Torna a cercar». Quan ja existeix la partida pendent corresponent, un moviment bancari que abans no es podia associar pot passar a tenir una coincidència inequívoca.

Si el concepte bancari esmenta, per exemple, un pressupost o una comanda per als quals encara no hi ha cap factura ni, per tant, cap partida pendent, el mòdul mostra un avís útil. En lloc de limitar-se a indicar «cap coincidència», adverteix que potser primer cal crear la factura.

La seguretat és prioritària

Una associació automàtica incorrecta pot generar més feina comptable que una línia bancària pendent. Per això, Bank Statement Matcher s'ha dissenyat expressament amb criteris de prudència:

  • Si diverses coincidències obtenen la mateixa valoració, no se'n tria cap de manera arbitrària.

  • Les propostes amb poca confiança es mostren, però no s'apliquen mitjançant l'acció en bloc.

  • Abans de fer l'associació, es torna a comprovar que la partida pendent encara estigui disponible.

  • Una partida que un altre usuari ja hagi saldat mentrestant no es torna a processar.

  • Cada línia bancària es processa dins d'un punt de desament propi de la base de dades.

  • Un error en una línia bancària no impedeix processar totes les altres.

  • Per precaució, s'exclouen les dades antigues incompletes que no tenen una data comptable vàlida.

Així, el mòdul facilita l'automatització allà on estalvia temps i demana una decisió manual quan les dades no són prou concloents.

Integració amb el nostre Bank Statement Import

El repositori consta de dos mòduls:

MòdulFunció
account_statement_matcherProporciona les funcions de cerca, valoració, comprovació i associació. Només requereix el mòdul account d'Odoo.
account_statement_matcher_import_ocaMòdul pont opcional amb la importació d'extractes bancaris de l'OCA. Després d'una importació, s'obre directament la vista d'associació amb les línies acabades d'importar.

El mòdul pont opcional s'instal·la automàticament quan hi ha instal·lats tant el Matcher com el mòdul de l'OCA account_statement_import_file. Així, la importació d'extractes bancaris i l'associació posterior queden connectades directament.

Trobareu més informació sobre la importació dels formats bancaris compatibles al nostre article:

Odoo 19 Bank Statement Import: les nostres extensions per a la comunitat Odoo

Instal·lació a Odoo 19 Community

La instal·lació es fa com la de qualsevol mòdul addicional d'Odoo:

  1. Copieu les carpetes dels mòduls en un dels camins de complements configurats a Odoo.

  2. Actualitzeu la llista d'aplicacions d'Odoo.

  3. Instal·leu el mòdul Bank Statement Matcher.

  4. Definiu per a cada diari bancari si s'han de cercar propostes durant la importació.

  5. Seleccioneu el llindar mínim desitjat per a l'associació en bloc controlada.

El mòdul s'ha desenvolupat i provat per a Odoo 19.0 Community. Abans d'utilitzar-lo amb altres versions d'Odoo, cal revisar especialment els canvis en les funcions internes de comptabilitat i conciliació.

Com amb qualsevol extensió de comptabilitat, recomanem provar primer la instal·lació en un entorn de proves amb una còpia de la vostra base de dades i extractes bancaris habituals.

Gratuït i de codi obert per a la comunitat Odoo

A Biricon IT Services GmbH desenvolupem solucions, en primer lloc, per a necessitats concretes de la nostra activitat. Quan en resulta un mòdul que pot ser útil per a tothom, volem compartir-lo més enllà de la nostra instal·lació.

Per això, Odoo 19 Bank Statement Matcher està disponible gratuïtament com a projecte de codi obert. El codi font es pot consultar, revisar, adaptar i continuar desenvolupant en el marc de la llicència AGPL-3.

El nostre objectiu no és automatitzar a cegues tantes decisions comptables com sigui possible. Volem reduir les tasques repetitives i, alhora, garantir que les associacions comptables es puguin seguir i controlar.

Així entenem el desenvolupament de codi obert que aporta valor: resoldre un problema real, documentar la solució de manera transparent i posar-la a disposició de la comunitat.

Projecte, codi font i col·laboració

El codi font complet, les instruccions d'instal·lació i la documentació tècnica estan disponibles a GitHub:

Obriu Odoo 19 Bank Statement Matcher a GitHub

Agraïm les experiències d'ús, els informes d'errors, els suggeriments de millora i les contribucions de la comunitat Odoo.

Gratuït. Traçable. De codi obert. Per a Odoo 19 Community.