As faturas eletrónicas fazem parte da contabilidade moderna
A digitalização da contabilidade continua a avançar. Os formatos de fatura eletrónica são, há muito, bem mais do que um ficheiro PDF enviado por e-mail.
Uma verdadeira fatura eletrónica contém dados estruturados que podem ser processados automaticamente por sistemas de contabilidade e ERP.
Com o nosso novo projeto open source para o Odoo 19 Community, queremos atuar precisamente neste ponto.
Desenvolvemos várias extensões que disponibilizamos gratuitamente à Odoo Community.
O projeto está disponível publicamente no GitHub:
Odoo 19 Invoice E-Files no GitHub
O nosso foco está sobretudo na Áustria, mas uma parte da solução é também interessante para empresas fora da Áustria.
Três módulos para faturas eletrónicas
Atualmente, o projeto é composto por três componentes essenciais:
- ebInterface 6.1 para a Áustria
- ZUGFeRD para faturas eletrónicas
- envio automático para e-Rechnung.gv.at
Assim, reunimos num único projeto open source para o Odoo 19 Community diferentes requisitos relacionados com faturas eletrónicas.
ebInterface 6.1 – o formato de fatura austríaco
Um dos pontos fortes do nosso desenvolvimento é o ebInterface 6.1.
O ebInterface é o formato padrão austríaco para faturas eletrónicas estruturadas.
O nosso módulo
l10n_at_ebinterface
gera, a partir de uma fatura de cliente ou nota de crédito no Odoo, o respetivo XML ebInterface 6.1.
Neste processo, são transferidas para a estrutura XML, entre outras, as informações relevantes da fatura do Odoo:
- Emitente da fatura
- Destinatário da fatura
- Linhas da fatura
- Impostos
- Informações de pagamento
- Dados bancários
- Dados da fatura
O ficheiro XML gerado fica diretamente associado à fatura.
Porque desenvolvemos um módulo próprio para isto?
Durante o desenvolvimento, verificámos que, para o Odoo 19 Community, não existe atualmente nenhum módulo do núcleo do Odoo nem módulo OCA para o padrão nativo austríaco ebInterface.
Era precisamente aqui que queríamos atuar.
Em vez de desenvolver uma solução austríaca apenas para a nossa própria instalação, implementámo-la como um módulo open source independente.
Assim, o resto da comunidade Odoo também pode beneficiar dela.
ZUGFeRD automático com cada fatura
O segundo ponto central do nosso projeto é o ZUGFeRD.
O ZUGFeRD combina uma fatura em PDF com uma fatura XML estruturada.
O resultado é uma chamada fatura híbrida: para as pessoas, a fatura continua legível em PDF, enquanto o software consegue avaliar automaticamente os dados estruturados da fatura nele contidos.
Em princípio, o Odoo 19 já traz suporte para ZUGFeRD ou CII.
Na prática, porém, existem algumas limitações.
O nosso módulo
account_invoice_zugferd_ebinterface_auto
atua, por isso, precisamente neste ponto.
ZUGFeRD já não é apenas uma opção
Queríamos um processo o mais automatizado possível.
Por isso, ao enviar uma fatura de cliente, não se verifica primeiro se o respetivo cliente foi configurado individualmente para ZUGFeRD.
Em vez disso, o ZUGFeRD é utilizado automaticamente para faturas de cliente e notas de crédito.
Além disso, o XML ebInterface gerado é incluído como parte integrante da fatura.
Surge assim um processo contínuo:
Fatura Odoo → PDF → fatura eletrónica estruturada → envio
sem que o utilizador tenha de executar passos adicionais em cada fatura.
Colmatamos também lacunas do Odoo 19 Community
Durante a implementação, deparámo-nos com algumas particularidades da implementação do Odoo 19.
Entre outras, existem dependências no exportador CII que, fora de determinadas instalações nacionais, podem causar problemas.
O nosso módulo corrige várias destas limitações práticas.
Entre elas contam-se, nomeadamente:
- campos em falta para os períodos de Deferred Revenue
- a restrição por país da conversão para PDF/A-3
- dados bancários em falta ou não definidos em faturas existentes
Assim, pretende-se que o ZUGFeRD possa ser utilizado de forma fiável também por empresas fora das combinações de países originalmente previstas.
e-Rechnung.gv.at – envio direto ao Estado austríaco
O terceiro componente é particularmente interessante para empresas que emitem faturas a entidades adjudicantes públicas.
Com o
l10n_at_erechnung_gv_at
é possível enviar uma fatura ebInterface diretamente para o serviço web e-Rechnung.gv.at austríaco.
Deste modo, a simples emissão de faturas transforma-se num processo de faturação eletrónica automatizado.
O processo pode, por exemplo, ser assim:
Criar a fatura no Odoo
↓
Gerar o XML ebInterface
↓
Enviar a fatura
↓
Enviar automaticamente o ebInterface para e-Rechnung.gv.at
Assim, um processo que de outra forma seria manual fica integrado diretamente no Odoo.
Envio automático apenas para os clientes necessários
O envio para e-Rechnung.gv.at não é ativado de forma generalizada para todos os clientes.
Em vez disso, pode ser ativado em cada cliente austríaco.
Para tal, são registados no cliente os dados necessários, como, por exemplo,
- Número de fornecedor
- Grupo de compradores / número de filial
- Referência da encomenda
.
O módulo verifica também se estão reunidos os requisitos para a ativação.
Operação de teste e de produção
Para e-Rechnung.gv.at, é possível escolher entre um ambiente de teste e um ambiente de produção.
Os dados de acesso ao serviço web USP são registados nas definições do Odoo.
Assim, a integração pode ser preparada primeiro num ambiente de teste, antes de ser utilizada para o envio de faturas em produção.
Automatização em vez de trabalho adicional
O nosso objetivo no desenvolvimento não era dar mais botões ao contabilista.
Bem pelo contrário.
A ideia é:
O mínimo possível de trabalho manual.
Uma fatura é criada no Odoo.
Os formatos estruturados necessários são gerados automaticamente.
No envio, os ficheiros correspondentes são anexados automaticamente.
E, no caso de clientes austríacos configurados para o efeito, a fatura pode ainda ser enviada automaticamente para e-Rechnung.gv.at.
É precisamente esta automatização que faz a diferença entre uma simples exportação de ficheiros e uma solução de faturação eletrónica verdadeiramente integrada.
A qualidade dos dados não é simplesmente escondida
Um ponto importante da nossa implementação é, no entanto, também este:
Uma fatura eletrónica só pode ser tão boa quanto os dados a partir dos quais é gerada.
Por isso, não tentamos substituir silenciosamente dados obrigatórios em falta por valores quaisquer.
Se, por exemplo, faltarem informações obrigatórias para ZUGFeRD ou ebInterface, o Odoo deve alertar o utilizador.
Entre elas contam-se, por exemplo:
- país em falta no cliente
- informações fiscais em falta nas linhas da fatura
- dados bancários em falta
Do nosso ponto de vista, isto é preferível a enviar uma fatura eletrónica formalmente gerada, mas incorreta quanto ao conteúdo.
Open source para a Odoo Community
Também este projeto disponibilizamos gratuitamente como open source.
Porquê?
Porque nós próprios beneficiamos de software open source.
A Odoo Community oferece uma excelente base para ERP, contabilidade e processos empresariais. Quando, no trabalho diário, nos falta uma funcionalidade, desenvolvemo-la.
E, se a solução puder ser interessante também para outras empresas, disponibilizamo-la à comunidade.
Para nós, isso é open source vivido na prática.
Foco na Áustria – mas não só para a Áustria
O projeto tem um claro enfoque austríaco.
O ebInterface e o e-Rechnung.gv.at são interessantes sobretudo para empresas austríacas.
O suporte a ZUGFeRD, por outro lado, é relevante também para empresas fora da Áustria.
Assim, o projeto não é exclusivamente uma solução austríaca.
Precisamente a combinação de dados de fatura estruturados com um documento PDF/A-3 gerado automaticamente pode ser interessante também para outras instalações Odoo.
Para o Odoo 19 Community
Os módulos foram desenvolvidos para o Odoo 19 Community.
Atualmente, o repositório contém:
- l10n_at_ebinterface
- account_invoice_zugferd_ebinterface_auto
- l10n_at_erechnung_gv_at
Os módulos dependem uns dos outros, pelo que, consoante o caso de utilização, apenas é necessário instalar os componentes de que precisa.
O nosso contributo para a comunidade
Não vemos este projeto como software comercial acabado, mas como um contributo para a evolução da comunidade Odoo.
Talvez alguém precise apenas de ebInterface.
Talvez outra empresa precise de ZUGFeRD.
Talvez uma empresa tenha de enviar regularmente faturas a entidades adjudicantes públicas através de e-Rechnung.gv.at.
Nos três casos, o nosso projeto pode servir de base.
E, como o código-fonte está disponível abertamente, qualquer utilizador pode verificar, adaptar e desenvolver a solução.
Open source significa: melhorarmos em conjunto
Estamos convictos de que o open source oferece uma grande vantagem, sobretudo em sistemas ERP.
As empresas têm requisitos diferentes.
Uma solução que funciona na perfeição para uma empresa pode ter de ser adaptada para outra.
Com um código-fonte aberto, isso é possível.
Por isso, agradecemos:
- Comentários
- Relatórios de erros (bug reports)
- Sugestões de melhoria
- Pull requests
- outros casos de utilização suportados
Uma boa solução comunitária não surge necessariamente no primeiro commit.
Surge através da evolução contínua por parte de muitos utilizadores e programadores.
Utilizar o projeto gratuitamente
O código-fonte completo está disponível publicamente no GitHub:
GitHub – Odoo 19 Invoice E-Files
Aí encontra também as informações de instalação e a documentação dos vários módulos.
Para a integração do serviço web austríaco e-Rechnung.gv.at é necessária adicionalmente a biblioteca Python Zeep.
O nosso contributo para um mundo Odoo aberto
Com este projeto, queremos mostrar que também pequenos desenvolvimentos próprios podem criar valor acrescentado para toda uma comunidade.
Desenvolvemos originalmente os módulos para resolver requisitos concretos.
Agora, disponibilizamos estas soluções gratuitamente a todos os utilizadores do Odoo 19 Community.
Assim, um desenvolvimento individual pode tornar-se uma solução comunitária.
Odoo 19. Open source. Faturas eletrónicas. Áustria. E gratuito para a comunidade.
É precisamente para isso que publicámos este projeto.