Para nós, código aberto significa: compartir coñecemento e solucións
Non desenvolvemos software só para os nosos propios requisitos: queremos poñer á disposición da comunidade solucións que tamén poidan axudar a outros usuarios de Odoo.
Por este motivo publicamos os nosos módulos de importación bancaria para Odoo 19 Community como proxecto de código aberto.
Todo o proxecto está dispoñible gratuitamente en GitHub:
Odoo 19 Bank Statement Import en GitHub
O noso obxectivo é moi sinxelo:
Crear unha forma funcional e o máis sinxela posible de importar extractos bancarios en Odoo 19 Community, sen que sexa necesaria para iso unha extensión de pago.
Por que un proxecto propio?
En principio, Odoo dispón de amplas posibilidades para a contabilidade e o tratamento de movementos bancarios. Con todo, precisamente na importación de extractos bancarios é decisivo que formatos pon a disposición cada banco.
Na práctica atópanse, entre outros, formatos como:
- CAMT.053
- CAMT.054
- OFX
- SWIFT MT940
Non todos estes formatos están dispoñibles do mesmo xeito en todas as versións de Odoo.
Ao pasar a Odoo 19, en particular, detectamos lagoas que poden ser moi relevantes para as instalacións existentes.
En vez de resolver estes problemas só para a nosa propia instalación, decidimos por iso ofrecer a solución de forma pública e gratuíta.
Odoo 19 Community – importar extractos bancarios
O noso repositorio baséase nos compoñentes OCA correspondentes para Odoo 19 e complétaos con funcións que se necesitan para o uso práctico.
O proxecto contén, entre outras cousas, a infraestrutura básica para extractos bancarios e a importación de ficheiros, así como analizadores para distintos formatos bancarios.
Isto pode usarse, por exemplo, para procesar os seguintes formatos:
| & Formatar | Colabora |
|---|---|
| CAMT.053 | Continuar e facer caso omiso da advertencia_BAR_Si |
| CAMT.054 | Continuar e facer caso omiso da advertencia_BAR_Si |
| OFX | Continuar e facer caso omiso da advertencia_BAR_Si |
| OFX con asignación ACCTID | Continuar e facer caso omiso da advertencia_BAR_Si |
| SWIFT MT940 | Continuar e facer caso omiso da advertencia_BAR_Si |
Así, o proxecto abrangue gran parte dos formatos clásicos de extractos bancarios.
Soporte OFX para Odoo 19
Un punto especial do noso proxecto é o soporte OFX.
OFX estaba dispoñible en versións antigas de Odoo/OCA, pero foi eliminado da rama OCA 19.0. O noso proxecto reúne esta función para Odoo 19 cos outros módulos de importación.
Isto é especialmente interesante para as empresas cuxo banco segue ofrecendo ficheiros OFX para extractos bancarios electrónicos.
Non queriamos desenvolver sen máis unha solución completamente nova e illada.
En vez diso, seguimos empregando a base de código aberto existente e compoñémola de maneira axeitada para Odoo 19.
Ademais: SWIFT MT940
Outra función do noso proxecto é a importación de SWIFT MT940.
MT940 é un formato consolidado para extractos bancarios electrónicos e segue empregándose, sobre todo, en bancos e en integracións bancarias máis antigas.
Para as versións actuais de Odoo, segundo a documentación do noso proxecto, non existe unha solución OCA equivalente.
Por iso desenvolvemos para isto un módulo propio:
account_statement_import_mt940
Así tamén se poden procesar ficheiros MT940 directamente en Odoo 19.
Estrutura modular
Quixemos de maneira deliberada non crear unha extensión monolítica.
As funcións están repartidas en módulos Odoo individuais:
- account_statement_base
- account_statement_import_base
- account_statement_import_file
- account_statement_import_camt
- account_statement_import_camt54
- account_statement_import_ofx
- account_statement_import_ofx_by_acctid
- account_statement_import_mt940
Deste xeito, os usuarios poden instalar exactamente os compoñentes que realmente necesitan.
Isto tamén corresponde ao espírito do código aberto: unha solución non debe volverse innecesariamente complicada só porque cada usuario teña requisitos distintos.
Gratuíto para a Odoo Community
O máis importante, quizais:
O software está dispoñible gratuitamente.
Poñemos as extensións que desenvolvemos á disposición da Odoo Community.
Non hai ningunha taxa de licenza polo uso das nosas extensións.
O código fonte está publicamente dispoñible en GitHub e pódese consultar, empregar, adaptar e seguir desenvolvendo alí.
O proxecto está baixo a licenza AGPL-3, en consonancia coa base OCA empregada.
Por que o facemos?
O código aberto só funciona a longo prazo se non todos se limitan a tomar, senón que tamén devolven algo.
A Odoo Community Association (OCA) segue precisamente esta idea e pon a disposición como código aberto numerosas extensións para Odoo. Tamén no ámbito da importación de extractos bancarios existe unha ampla colección de módulos da comunidade.
Queremos facer a nosa parte.
Nós mesmos nos beneficiamos de proxectos de código aberto.
Así que nós tamén devolvemos algo.
Un desenvolvemento de código aberto non ten por que ser sempre un framework xigantesco nin un sistema ERP completamente novo.
Ás veces abonda cunha pequena extensión que resolva un problema concreto.
Se esta solución aforra traballo despois a dez, cen ou mil usuarios máis de Odoo, o desenvolvemento xa mereceu a pena.
Para Odoo Community, non só para a nosa propia instalación
Un punto importante no desenvolvemento foi para nós non adaptar os módulos especificamente ao noso propio contorno.
Queremos que o repositorio tamén resulte interesante para outras instalacións de Odoo 19 Community.
Por iso os módulos atópanse xuntos nun repositorio de acceso público e poden empregarse con independencia da nosa propia instalación de Odoo.
Por suposto, un banco pode ter particularidades distintas segundo o formato de exportación. Por iso tamén nos alegramos de recibir comentarios, informes de erros e melloras da comunidade.
O código aberto vive da participación
O proxecto non está concibido, de forma expresa, como un desenvolvemento rematado.
Se alguén atopa un erro, ten un caso de uso adicional ou quere achegar unha mellora, pode participar directamente no proxecto.
Esa é unha das grandes vantaxes do código aberto:
Unha solución non ten por que quedarse co seu desenvolvedor orixinal.
Un usuario pode chegar a ser desenvolvedor.
Un desenvolvedor pode achegar unha mellora.
E esta mellora queda despois de novo á disposición de todos os demais.
Instalación e código fonte
O código fonte completo, a estrutura dos módulos e as instrucións de instalación atópanse en GitHub:
GitHub – Odoo 19 Bank Statement Import
Para a importación de OFX e MT940 son necesarias ademais as bibliotecas de Python correspondentes. As dependencias concretas tamén están documentadas no repositorio.
A nosa achega á Odoo Community
Con este proxecto queremos dar un pequeno sinal:
O software non sempre ten que venderse para que o seu desenvolvemento teña valor.
Ás veces o maior beneficio está en que unha solución sexa de acceso libre e a poida empregar e seguir desenvolvendo o maior número posible de persoas.
Desenvolvemos o software en primeiro lugar porque nós mesmos necesitamos unha solución.
Se desta ao final sae unha extensión útil para outros usuarios de Odoo, poñémola con gusto á disposición da comunidade.
Precisamente por iso publicamos o Odoo 19 Bank Statement Import Module.
Gratuíto. Código aberto. Para a Odoo Community.
Proxecto en GitHub
Ao proxecto de GitHub: Odoo 19 Bank Statement Import
Agradecemos os comentarios, as incidencias (issues), as propostas de mellora e, por suposto, tamén as achegas da comunidade.
O código aberto funciona mellor cando traballamos xuntos.