Ir al contenido

Odoo 19 Community: asignación automática de pagos bancarios a facturas con nuestro Bank Statement Matcher de código abierto

14 de septiembre de 2026 por
Odoo 19 Community: asignación automática de pagos bancarios a facturas con nuestro Bank Statement Matcher de código abierto
Alexander Biringer | Biricon IT Services GmbH

Importar extractos bancarios en Odoo es solo el primer paso. La verdadera utilidad llega cuando cada movimiento bancario se puede asignar de forma fiable a la factura de cliente, factura de proveedor, factura rectificativa o pago correspondiente.

Precisamente para este paso, Odoo 19 Community carece de una opción cómoda en la interfaz de usuario. Por ello, las líneas bancarias importadas permanecen inicialmente en la cuenta transitoria bancaria y deben asignarse a una partida contable pendiente para continuar su procesamiento.

Por eso hemos desarrollado Bank Statement Matcher para nuestra propia instalación de Odoo 19 Community. Como este problema también afecta a otros usuarios, ofrecemos el módulo gratuitamente en GitHub bajo la licencia libre AGPL-3.

Proyecto en GitHub:

Odoo 19 Bank Statement Matcher

De la importación del extracto bancario a la factura correspondiente

Nuestro proyecto ya publicado Odoo 19 Bank Statement Import permite importar distintos formatos de extractos bancarios en Odoo 19 Community. Entre ellos se encuentran CAMT.053, CAMT.054, OFX y SWIFT MT940.

El nuevo Bank Statement Matcher añade a esta importación el siguiente paso fundamental:

¿A qué partida pendiente corresponde cada movimiento bancario importado?

El módulo busca entre las cuentas pendientes de cobro y de pago, evalúa las posibles coincidencias e indica a los usuarios por qué propone una determinada asignación. La propuesta se puede revisar, confirmar, corregir o sustituir por una selección manual.

Así, Odoo 19 Community dispone de un flujo de trabajo completo:

  1. importar el extracto bancario

  2. identificar posibles asignaciones

  3. revisar las propuestas en conjunto

  4. aceptar las coincidencias inequívocas

  5. gestionar manualmente los casos dudosos

Qué puede hacer Odoo 19 Bank Statement Matcher

El módulo se ha desarrollado para el trabajo diario en contabilidad. Entre otras, ofrece las siguientes funciones:

  • búsqueda de facturas de clientes, facturas de proveedores, facturas rectificativas y pagos que coincidan

  • generación automática de propuestas de asignación al crear una línea bancaria

  • indicación clara de la regla de asignación utilizada y de su nivel de confianza

  • posibilidad de repetir la búsqueda más adelante

  • asignación individual o gestión conjunta de varias líneas bancarias

  • selección manual de una partida pendiente cuando ninguna propuesta encaja

  • anulación de una asignación ya realizada

  • detección de varias coincidencias equivalentes sin elegir una arbitrariamente

  • avisos sobre presupuestos o pedidos para los que aún no existe ninguna partida contable pendiente

  • acceso directo opcional a la vista de asignación desde la importación de extractos bancarios de OCA

  • traducción al alemán a partir del texto original en inglés

La vista general central está disponible en Odoo en Contabilidad → Contabilidad → Asignación de líneas bancarias. Allí pueden buscarse y tratarse conjuntamente las líneas bancarias aún abiertas.

Asignaciones transparentes en lugar de una caja negra

Cuando se trabaja con datos financieros, no basta con proponer una coincidencia cualquiera. Los usuarios deben poder entender por qué un movimiento bancario debería corresponder a un documento concreto.

Por eso, Bank Statement Matcher utiliza reglas claramente definidas y distintos niveles de confianza:

ConfianzaReglaSignificado
100ReferenciaSe ha encontrado un número de documento, una referencia de pago o una referencia de origen en el concepto del movimiento.
80Contacto e importeEl contacto y el importe pendiente coinciden.
60Importe únicoEl importe coincide exactamente con una sola partida pendiente.
30ContactoEl contacto coincide, pero el importe no; se trata únicamente de una pista.

En cada diario se puede definir el nivel de confianza mínimo a partir del cual se permite aceptar una propuesta inequívoca mediante la acción por lotes. Las coincidencias con un nivel inferior siguen siendo visibles, pero deben revisarse y confirmarse individualmente.

Es importante tener en cuenta que el módulo no realiza asientos en segundo plano sin supervisión. Genera propuestas. La asignación solo se efectúa cuando el usuario realiza una acción explícita, ya sea individualmente o mediante el procesamiento por lotes controlado.

También se tienen en cuenta las referencias bancarias difíciles de interpretar

Los bancos no siempre transmiten las referencias de pago de manera uniforme. Un número de factura puede aparecer unido a nombres, cifras u otros datos. Los separadores pueden faltar o presentarse de forma distinta a la del documento original.

Por eso, el módulo normaliza los valores que compara y tiene en cuenta los cambios entre letras y cifras. Así puede reconocer referencias incluso cuando, por ejemplo, aparecen pegadas a otros contenidos en el concepto bancario.

La búsqueda parte deliberadamente del documento de Odoo hacia el concepto bancario. Así se evita que las secuencias numéricas cortas y genéricas del concepto generen un gran número de coincidencias incorrectas.

Las reglas no están limitadas a un banco, un país o un esquema de numeración específico. Esto hace que el módulo también resulte útil para otras instalaciones de Odoo 19 Community.

Por qué es importante poder repetir la búsqueda

No todos los pagos bancarios se pueden asignar en el momento de la importación. En la práctica, un pago puede recibirse antes de que la factura correspondiente se haya creado o contabilizado en Odoo. También puede ocurrir que una factura de proveedor o una factura rectificativa se registre más adelante.

Por eso, las líneas bancarias se pueden volver a comprobar más adelante con «Buscar de nuevo». En cuanto exista la partida pendiente correspondiente, un movimiento bancario que antes no podía asignarse puede convertirse en una coincidencia inequívoca.

Si el concepto bancario menciona, por ejemplo, un presupuesto o un pedido para el que aún no existe ninguna factura y, por tanto, tampoco ninguna partida pendiente, el módulo muestra un aviso útil. En lugar de limitarse a indicar «sin coincidencias», advierte de que quizá sea necesario crear primero la factura.

La seguridad es lo primero

Una asignación automática incorrecta puede generar más trabajo contable que una línea bancaria pendiente. Por eso, Bank Statement Matcher se ha diseñado con un criterio prudente:

  • No se elige arbitrariamente entre coincidencias con la misma valoración.

  • Las propuestas con un nivel de confianza bajo se muestran, pero no se aceptan mediante la acción por lotes.

  • Antes de realizar la asignación, se comprueba de nuevo que la partida pendiente siga disponible.

  • Una partida que otro usuario ya haya saldado no se vuelve a procesar.

  • Cada línea bancaria se procesa dentro de su propio punto de guardado de la base de datos.

  • Un error en una línea bancaria no impide procesar las demás.

  • Por precaución, se excluyen los datos antiguos incompletos que no tengan una fecha contable válida.

Así, el módulo facilita la automatización cuando permite ahorrar tiempo y exige una decisión manual cuando los datos no son lo bastante concluyentes.

Integración con nuestro Bank Statement Import

El repositorio consta de dos módulos:

MóduloFunción
account_statement_matcherProporciona las funciones de búsqueda, evaluación, comprobación y asignación. Solo requiere el módulo account de Odoo.
account_statement_matcher_import_ocaConector opcional con la importación de extractos bancarios de OCA. Tras una importación, abre directamente la vista de asignación con las líneas recién importadas.

El conector opcional se instala automáticamente cuando están presentes tanto Bank Statement Matcher como el módulo account_statement_import_file de OCA. De este modo, la importación del extracto bancario y la asignación posterior quedan integradas directamente.

Encontrará más información sobre la importación de los formatos bancarios compatibles en nuestro artículo:

Odoo 19 Bank Statement Import: nuestras extensiones para Odoo Community

Instalación en Odoo 19 Community

La instalación se realiza como la de cualquier módulo adicional de Odoo:

  1. Copiar las carpetas de los módulos en una ruta de complementos configurada en Odoo.

  2. Actualizar la lista de aplicaciones en Odoo.

  3. Instalar el módulo Bank Statement Matcher.

  4. Definir en cada diario bancario si se deben buscar propuestas durante la importación.

  5. Seleccionar el nivel mínimo deseado para la asignación por lotes controlada.

El módulo se ha desarrollado y probado para Odoo 19.0 Community. Antes de utilizarlo con otras versiones de Odoo, deben revisarse especialmente los cambios en las funciones internas de contabilidad y conciliación.

Como con cualquier extensión del ámbito contable, recomendamos probar primero la instalación en un entorno de pruebas con una copia de la base de datos propia y extractos bancarios habituales.

Gratis y de código abierto para Odoo Community

En Biricon IT Services GmbH desarrollamos soluciones, en primer lugar, para necesidades concretas de nuestra propia actividad. Cuando de ese trabajo surge un módulo que puede servir a otros, queremos compartirlo más allá de una única instalación.

Por eso, Odoo 19 Bank Statement Matcher está disponible gratuitamente como proyecto de código abierto. Su código fuente se puede consultar, revisar, adaptar y seguir desarrollando conforme a la licencia AGPL-3.

Nuestro objetivo no es automatizar a ciegas el mayor número posible de decisiones contables. Queremos reducir el trabajo repetitivo y, al mismo tiempo, garantizar que las asignaciones financieras sigan siendo comprensibles y verificables.

Así entendemos un desarrollo de código abierto útil: resolver un problema real, documentar la solución de forma transparente y ponerla después a disposición de la comunidad.

Proyecto, código fuente y colaboración

El código fuente completo, las instrucciones de instalación y la documentación técnica están disponibles en GitHub:

Abrir Odoo 19 Bank Statement Matcher en GitHub

Agradecemos las experiencias de uso, los informes de errores, las sugerencias de mejora y las contribuciones de la comunidad de Odoo.

Gratis. Transparente. De código abierto. Para Odoo 19 Community.