Importar extractos bancarios en Odoo é só o primeiro paso. A utilidade real só aparece cando un movemento bancario se pode asignar de forma fiable á factura de cliente, factura de provedor, nota de abono ou pagamento correctos.
Precisamente neste punto, a Odoo 19 Community carece dunha posibilidade cómoda na interface de usuario. As liñas bancarias importadas quedan así, en primeiro lugar, na conta transitoria do banco e, para o seguinte procesamento, hai que asignalas a un apuntamento aberto.
Para a nosa propia instalación de Odoo 19 Community desenvolvemos por iso o Bank Statement Matcher. Como este problema non nos afecta só a nós, poñemos o módulo de balde á disposición en GitHub baixo a licenza libre AGPL-3.
Ao proxecto en GitHub:
Odoo 19 Bank Statement Matcher
Da importación do extracto bancario á factura correcta
Co noso proxecto xa publicado Odoo 19 Bank Statement Import pódense ler distintos formatos de extracto bancario en Odoo 19 Community. Entre eles figuran, entre outros, CAMT.053, CAMT.054, OFX e SWIFT MT940.
O novo Bank Statement Matcher complementa esta importación co seguinte paso decisivo:
Que movemento bancario importado pertence a que apuntamento aberto?
O módulo busca entre as contas a cobrar e a pagar abertas, avalía os posibles resultados e mostra aos usuarios por que se propón unha determinada asignación. A proposta pódese revisar, confirmar, corrixir ou substituír por unha selección manual.
Así xorde para Odoo 19 Community un fluxo de traballo continuo:
Importar o extracto bancario
determinar as posibles asignacións
revisar as propostas en conxunto
aceptar os resultados inequívocos
tratar manualmente os casos pouco claros
O que pode facer o Odoo 19 Bank Statement Matcher
O módulo foi desenvolvido para o uso práctico na contabilidade. Admite, entre outras, as seguintes funcións:
busca de facturas, facturas de provedor, notas de abono e pagamentos axeitados
determinación automática de propostas de asignación ao crear unha liña bancaria
visualización comprensible da regra de asignación utilizada e da súa fiabilidade
nova busca nun momento posterior
asignación individual ou tratamento conxunto de varias liñas bancarias
selección manual dun apuntamento aberto cando ningunha proposta encaixa
desfacer unha asignación xa realizada
recoñecemento de varios resultados equivalentes sen decisión arbitraria
avisos sobre ofertas ou pedidos para os que aínda non existe ningún apuntamento aberto
transferencia directa opcional desde a importación de extractos bancarios de OCA á vista de asignación
tradución ao alemán cun código fonte en inglés
A vista xeral central está accesible en Odoo en Contabilidade → Contabilidade → Asignación de liñas bancarias. Alí pódense buscar e tratar en conxunto as liñas bancarias aínda abertas.
Asignación comprensible en lugar de caixa negra
Cos datos financeiros non abonda con propoñer simplemente un resultado calquera. Os usuarios deben poder recoñecer por que un movemento bancario debería corresponder a un determinado documento.
Por iso o Bank Statement Matcher traballa con regras claramente definidas e distintos niveis de confianza:
| Confianza | Regra | Significado |
|---|---|---|
| 100 | Referencia | Atopouse un número de documento, unha referencia de pagamento ou unha referencia de orixe no texto do apuntamento. |
| 80 | Socio e importe | O socio comercial e o importe aberto coinciden. |
| 60 | Importe inequívoco | O importe coincide exactamente só cun apuntamento aberto. |
| 30 | Socio | O socio coincide, pero o importe non; isto é só un aviso. |
Para cada diario pódese definir a partir de que nivel de confianza se pode aceptar unha proposta inequívoca mediante a acción masiva. Os resultados máis débiles seguen sendo visibles, pero hai que revisalos e confirmalos individualmente.
O importante aquí é: o módulo non contabiliza sen supervisión en segundo plano. Crea propostas. Unha asignación só se produce mediante unha acción deliberada do usuario, individualmente ou mediante o procesamento masivo controlado.
Tamén se teñen en conta as referencias bancarias difíciles
Os bancos non sempre transmiten as referencias de pagamento nunha forma uniforme. Un número de factura pode aparecer combinado con nomes, cifras ou outras indicacións. Os separadores poden faltar ou representarse de modo distinto ao do documento orixinal.
Por iso o matcher normaliza os valores de comparación e ten en conta tamén as transicións entre letras e cifras. Así, as referencias poden recoñecerse, por exemplo, mesmo cando se engadiron directamente a outros contidos no texto bancario.
A busca realízase deliberadamente do documento de Odoo cara ao texto bancario. Así evítase que secuencias curtas e xerais de cifras do texto do apuntamento leven a un gran número de resultados inadecuados.
As regras non se limitan a un banco concreto, nin a un país determinado, nin a un esquema de numeración fixo. Isto fai que o módulo tamén sexa interesante para outras instalacións de Odoo 19 Community.
Por que é importante unha nova busca
Non todo pagamento bancario se pode asignar xa durante a importación. Na práctica, pode entrar un pagamento antes de que a factura correspondente se cree ou se contabilice en Odoo. Tamén unha factura de provedor ou unha nota de abono pode rexistrarse só máis tarde.
Por iso as liñas bancarias pódense revisar de novo nun momento posterior con “Buscar de novo”. En canto existe o apuntamento aberto axeitado, un movemento bancario antes non asignable pode converterse nun resultado inequívoco.
Se o texto bancario menciona, por exemplo, unha oferta ou un pedido para o que aínda non existe factura e, polo tanto, ningún apuntamento aberto, o módulo ofrece un aviso útil. En vez de mostrar simplemente “ningún resultado”, advirte de que quizais primeiro hai que crear a factura.
A seguridade ten prioridade
Unha asignación automática incorrecta pode causar máis traballo na contabilidade ca unha liña bancaria aberta. Por iso o Bank Statement Matcher foi deseñado deliberadamente con cautela:
Os resultados con igual valoración non se resolven de forma arbitraria.
As propostas débiles móstranse, pero non se aceptan mediante a acción masiva.
Antes de asignar, comprobase de novo se o apuntamento aberto aínda está dispoñible.
Un apuntamento que entrementres foi compensado por outro usuario non se volve procesar.
Cada liña bancaria trátase dentro dun punto de seguranza da base de datos propio.
Un erro nunha liña bancaria non impide o procesamento de todas as demais liñas.
Por precaución, exclúense os datos antigos incompletos sen data de contabilización válida.
Así, o módulo apoia a automatización onde aforra tempo e esixe unha decisión manual onde a situación dos datos non é o suficientemente clara.
Interacción co noso Bank Statement Import
O repositorio consta de dous módulos:
| Módulo | Función |
|---|---|
| account_statement_matcher | Ofrece a busca, a avaliación, a comprobación e a asignación propiamente ditas. Só require o módulo de Odoo account. |
| account_statement_matcher_import_oca | Ponte opcional coa importación de extractos bancarios de OCA. Despois dunha importación ábrese directamente a vista de asignación coas liñas recén importadas. |
A ponte opcional instálase automaticamente cando están presentes tanto o matcher como o módulo OCA account_statement_import_file. Así, a importación de extractos bancarios e a asignación posterior encaixan directamente.
Pode atopar máis sobre a importación dos formatos bancarios admitidos na nosa publicación:
Odoo 19 Bank Statement Import – as nosas extensións para a Odoo Community
Instalación en Odoo 19 Community
A instalación realízase como nun módulo adicional de Odoo habitual:
Copiar os cartafoles dos módulos nunha ruta de addons de Odoo configurada.
Actualizar a lista de aplicacións en Odoo.
Instalar o módulo Bank Statement Matcher.
Definir para cada diario bancario se se deben buscar propostas durante a importación.
Seleccionar o valor mínimo desexado para a asignación masiva controlada.
O módulo foi desenvolvido e probado para Odoo 19.0 Community. Antes de usalo con outras versións de Odoo hai que revisar, en particular, os cambios nas funcións internas de contabilidade e conciliación.
Como con toda extensión no ámbito da contabilidade, recomendamos revisar a instalación primeiro nun contorno de proba cunha copia da propia base de datos e extractos bancarios típicos.
Gratuíto e de código aberto para a Odoo Community
En Biricon IT Services GmbH desenvolvemos solucións primeiro para requisitos concretos da nosa propia actividade. Cando disto xorde un módulo de uso xeral, non queremos ocultalo nunha única instalación.
O Odoo 19 Bank Statement Matcher está por iso dispoñible de balde como proxecto de código aberto. O código fonte pódese consultar, revisar, adaptar e seguir desenvolvendo no marco da licenza AGPL-3.
O noso obxectivo non é automatizar á cega o maior número posible de decisións de contabilización. Queremos reducir o traballo repetitivo e, ao mesmo tempo, procurar que as asignacións financeiras sigan sendo comprensibles e controlables.
Así entendemos nós un desenvolvemento de código aberto con sentido: resolver un problema real, documentar a solución de forma transparente e despois poñela á disposición da comunidade.
Proxecto, código fonte e colaboración
O código fonte completo, as indicacións de instalación e a documentación técnica están dispoñibles en GitHub:
Abrir Odoo 19 Bank Statement Matcher en GitHub
Agradecemos as experiencias prácticas, os informes de erros, as propostas de mellora e as achegas da Odoo Community.
Gratuíto. Comprensible. Código aberto. Para Odoo 19 Community.