Para nós, código aberto significa: partilhar conhecimento e soluções

Não desenvolvemos software apenas para os nossos próprios requisitos – queremos disponibilizar à comunidade soluções que também possam ajudar outros utilizadores do Odoo.

Por este motivo, publicámos os nossos módulos de importação bancária para o Odoo 19 Community como projeto de código aberto.

Todo o projeto está disponível gratuitamente no GitHub:

Odoo 19 Bank Statement Import no GitHub

O nosso objetivo é muito simples:

Criar uma forma funcional e o mais simples possível de importar extratos bancários para o Odoo 19 Community – sem necessidade de uma extensão paga.

Porquê um projeto próprio?

O Odoo dispõe, em princípio, de amplas possibilidades para a contabilidade e o processamento de movimentos bancários. No entanto, na importação de extratos bancários, é decisivo saber que formatos o respetivo banco disponibiliza.

Na prática, encontram-se, entre outros, formatos como:

• CAMT.053
• CAMT.054
• OFX
• SWIFT MT940

Nem todos estes formatos estão disponíveis de igual forma em todas as versões do Odoo.

Ao migrar para o Odoo 19, em particular, detetámos lacunas que podem ser bastante relevantes para instalações existentes.

Em vez de resolvermos estes problemas apenas para a nossa própria instalação, decidimos por isso disponibilizar a solução de forma pública e gratuita.

Odoo 19 Community – importar extratos bancários

O nosso repositório baseia-se nos componentes OCA correspondentes para o Odoo 19 e complementa-os com funcionalidades necessárias para a utilização prática.

O projeto contém, entre outros, a infraestrutura básica para extratos bancários e importação de ficheiros, bem como analisadores (parsers) para diversos formatos bancários.

Desta forma, é possível processar, por exemplo, os seguintes formatos:

Desta forma, o projeto abrange uma grande parte dos formatos clássicos de extratos bancários.

Suporte para OFX no Odoo 19

Um ponto especial do nosso projeto é o suporte para OFX.

O OFX estava disponível em versões mais antigas do Odoo/OCA, mas foi removido do ramo OCA 19.0. O nosso projeto volta a reunir esta função para o Odoo 19, juntamente com os restantes módulos de importação.

Isto é particularmente interessante para empresas cujo banco continua a disponibilizar ficheiros OFX para o extrato bancário eletrónico.

Não queríamos simplesmente desenvolver uma solução totalmente nova e isolada.

Em vez disso, continuámos a utilizar a base de código aberto existente e compilámo-la para o Odoo 19.

Adicionalmente: SWIFT MT940

Outra função do nosso projeto é a importação de SWIFT MT940.

O MT940 é um formato consolidado para extratos bancários eletrónicos e continua a ser utilizado, sobretudo, em bancos e em integrações bancárias mais antigas.

Para as versões atuais do Odoo, segundo a documentação do nosso projeto, não existe uma solução OCA correspondente.

Por isso, desenvolvemos um módulo próprio para o efeito:

account_statement_import_mt940

Assim, também é possível processar ficheiros MT940 diretamente no Odoo 19.

Construção modular

Quisemos, deliberadamente, não criar uma extensão monolítica.

As funções estão divididas em 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

Assim, os utilizadores podem instalar exatamente os componentes de que realmente necessitam.

Isto corresponde também ao espírito do código aberto: uma solução não deve ser desnecessariamente complicada só porque alguns utilizadores têm requisitos diferentes.

Gratuito para a Odoo Community

Talvez o mais importante:

O software está disponível gratuitamente.

Disponibilizamos as extensões por nós desenvolvidas à Odoo Community.

Não existe qualquer taxa de licença para a utilização das nossas extensões.

O código-fonte está disponível publicamente no GitHub, onde pode ser consultado, utilizado, adaptado e desenvolvido.

O projeto está sob a licença AGPL-3, de acordo com a base OCA utilizada.

Porque fazemos isto?

O código aberto só funciona a longo prazo se nem todos se limitarem a receber, mas também derem algo em troca.

A Odoo Community Association (OCA) defende exatamente esta ideia e disponibiliza numerosas extensões para o Odoo como código aberto. Também na área da importação de extratos bancários existe uma vasta coleção de módulos da comunidade.

Queremos dar o nosso contributo.

Nós próprios beneficiamos de projetos de código aberto.

Por isso, também damos algo em troca.

Um desenvolvimento de código aberto não tem de ser sempre uma enorme framework ou um sistema ERP totalmente novo.

Por vezes, basta uma pequena extensão que resolva um problema concreto.

Se esta solução poupar depois trabalho a dez, cem ou mil outros utilizadores do Odoo, o desenvolvimento já valeu a pena.

Para o Odoo Community – não apenas para a nossa própria instalação

Um ponto importante no desenvolvimento foi, para nós, não adaptar os módulos especificamente ao nosso próprio ambiente.

Queremos que o repositório seja também interessante para outras instalações do Odoo 19 Community.

Por isso, os módulos encontram-se juntos num repositório de acesso público e podem ser utilizados independentemente da nossa própria instalação Odoo.

Naturalmente, um banco pode ter particularidades diferentes consoante o formato de exportação. Por isso, agradecemos também comentários, relatórios de erros e melhorias da comunidade.

O código aberto vive da participação

O projeto não foi expressamente pensado como um desenvolvimento concluído.

Se alguém encontrar um erro, tiver um caso de utilização adicional ou quiser contribuir com uma melhoria, pode participar diretamente no projeto.

Esta é uma das grandes vantagens do código aberto:

Uma solução não tem de ficar apenas com o seu programador original.

Um utilizador pode tornar-se programador.

Um programador pode contribuir com uma melhoria.

E essa melhoria fica depois novamente à disposição de todos os outros.

Instalação e código-fonte

O código-fonte completo, a estrutura dos módulos e as instruções de instalação encontram-se no GitHub:

GitHub – Odoo 19 Bank Statement Import

Para a importação de OFX e MT940 são ainda necessárias as respetivas bibliotecas Python. As dependências concretas estão igualmente documentadas no repositório.

A nossa contribuição para a Odoo Community

Com este projeto, queremos dar um pequeno sinal:

O software não tem de ser sempre vendido para que o seu desenvolvimento tenha valor.

Por vezes, o maior benefício é uma solução ser de livre acesso e poder ser utilizada e desenvolvida pelo maior número possível de pessoas.

Desenvolvemos o software, em primeiro lugar, porque nós próprios precisamos de uma solução.

Se disso resultar uma extensão útil para outros utilizadores do Odoo, teremos todo o gosto em a disponibilizar à comunidade.

É precisamente por isso que publicámos o Odoo 19 Bank Statement Import Module.

Gratuito. Open source. Para a Odoo Community.

Projeto no GitHub

Ir para o projeto no GitHub: Odoo 19 Bank Statement Import

Agradecemos comentários, issues, sugestões de melhoria e, naturalmente, contributos da comunidade.

O open source funciona melhor quando trabalhamos em conjunto.