As facturas electrónicas forman parte da contabilidade moderna
A dixitalización da contabilidade segue avanzando. Os formatos de factura electrónica son hai tempo moito máis ca un ficheiro PDF enviado por correo electrónico.
Unha verdadeira factura electrónica contén datos estruturados que os sistemas de contabilidade e ERP poden procesar automaticamente.
Co noso novo proxecto de código aberto para Odoo 19 Community queremos actuar precisamente aquí.
Desenvolvemos varias extensións que poñemos de balde á disposición da Odoo Community.
O proxecto está dispoñible publicamente en GitHub:
Odoo 19 Invoice E-Files en GitHub
O noso foco está sobre todo en Austria, pero unha parte da solución tamén resulta interesante para empresas de fóra de Austria.
Tres módulos para facturas electrónicas
Na actualidade o proxecto consta de tres compoñentes principais:
- ebInterface 6.1 para Austria
- ZUGFeRD para facturas electrónicas
- envío automático a e-Rechnung.gv.at
Deste xeito reunimos nun único proxecto de código aberto para Odoo 19 Community diferentes requisitos en torno ás facturas electrónicas.
ebInterface 6.1 – o formato de factura austríaco
Un eixe central do noso desenvolvemento é ebInterface 6.1.
ebInterface é o formato estándar austríaco para facturas electrónicas estruturadas.
O noso módulo
l10n_at_ebinterface
xera, a partir dunha factura de cliente ou dunha nota de abono en Odoo, o correspondente XML ebInterface 6.1.
Para iso, transfírense á estrutura XML, entre outras, as informacións relevantes da factura de Odoo:
- Emisor da factura
- Destinatario da factura
- Liñas da factura
- Impostos
- Información de pagamento
- Datos bancarios
- Datos da factura
O ficheiro XML xerado vincúlase directamente á factura.
Por que desenvolvemos un módulo propio para iso?
Durante o desenvolvemento comprobamos que, para Odoo 19 Community, actualmente non hai ningún módulo do núcleo de Odoo nin módulo OCA para o estándar austríaco nativo ebInterface.
Precisamente aí queriamos actuar.
En vez de desenvolver unha solución austríaca só para a nosa propia instalación, implementámola como un módulo de código aberto independente.
Así, o resto da comunidade de Odoo tamén pode beneficiarse.
ZUGFeRD automático con cada factura
O segundo eixe do noso proxecto é ZUGFeRD.
ZUGFeRD combina unha factura en PDF cunha factura XML estruturada.
O resultado é unha chamada factura híbrida: para as persoas a factura segue sendo lexible como PDF, mentres que o software pode avaliar automaticamente os datos estruturados da factura que contén.
En principio, Odoo 19 xa inclúe compatibilidade con ZUGFeRD ou CII.
Na práctica, con todo, hai algunhas limitacións.
O noso módulo
account_invoice_zugferd_ebinterface_auto
parte, por iso, precisamente deste punto.
ZUGFeRD xa non só como opción
Queriamos un fluxo o máis automatizado posible.
Por iso, ao enviar unha factura de cliente, non se comproba primeiro se o cliente en cuestión está configurado individualmente para ZUGFeRD.
En cambio, ZUGFeRD utilízase automaticamente para as facturas de cliente e as notas de abono.
Ademais, o XML ebInterface xerado achégase como parte da factura.
Así prodúcese un proceso continuo:
Factura de Odoo → PDF → factura electrónica estruturada → envío
sen que o usuario teña que realizar pasos adicionais con cada factura.
Tamén pechamos lagoas de Odoo 19 Community
Durante a implementación atopamos algunhas particularidades na implementación de Odoo 19.
Entre outras cousas, existen dependencias no exportador CII que, fóra de determinadas instalacións por país, poden causar problemas.
O noso módulo corrixe varias destas limitacións prácticas.
Entre elas figuran, entre outras:
- campos que faltan para os períodos de ingresos diferidos (Deferred Revenue)
- a restrición por país da conversión a PDF/A-3
- datos bancarios ausentes ou non definidos en facturas existentes
Con isto pretendemos que ZUGFeRD tamén poida utilizarse de forma fiable en empresas de fóra das constelacións de países previstas orixinalmente.
e-Rechnung.gv.at – envío directo ao Estado austríaco
O terceiro compoñente é especialmente interesante para as empresas que emiten facturas a entidades contratantes públicas.
Con
l10n_at_erechnung_gv_at
pódese enviar unha factura ebInterface directamente ao servizo web austríaco e-Rechnung.gv.at.
Así, a simple creación de facturas convértese nun proceso de facturación electrónica automatizado.
O fluxo pode ser, por exemplo, así:
Crear a factura en Odoo
↓
Xerar o XML ebInterface
↓
Enviar a factura
↓
Enviar ebInterface automaticamente a e-Rechnung.gv.at
Así intégrase directamente en Odoo un proceso que doutro modo sería manual.
Envío automático só para os clientes necesarios
O envío a e-Rechnung.gv.at non se activa de forma xeral para todos os clientes.
En cambio, pódese activar no cliente austríaco correspondente.
Para iso, rexístranse as indicacións necesarias, como por exemplo
- Número de provedor
- Grupo de compradores / número de sucursal
- Referencia do pedido
no cliente.
O módulo tamén comproba se se cumpren os requisitos para a activación.
Operación de proba e produtiva
Para e-Rechnung.gv.at pódese escoller entre un contorno de proba e un produtivo.
Os datos de acceso ao servizo web USP gárdanse na configuración de Odoo.
Así a integración pódese preparar primeiro nun contorno de proba antes de utilizala no envío produtivo de facturas.
Automatización en lugar de traballo adicional
O noso obxectivo co desenvolvemento non era darlle máis botóns ao contable.
Todo o contrario.
A idea é:
O menor traballo manual posible.
Créase unha factura en Odoo.
Os formatos estruturados necesarios xéranse automaticamente.
No envío, os ficheiros correspondentes anéxanse automaticamente.
E, nos clientes austríacos configurados en consecuencia, a factura tamén se pode enviar automaticamente a e-Rechnung.gv.at.
Precisamente esta automatización marca a diferenza entre unha simple exportación de ficheiros e unha solución de facturación electrónica realmente integrada.
A calidade dos datos non se oculta sen máis
Un punto importante da nosa implementación é, ademais:
Unha factura electrónica só pode ser tan boa como os datos a partir dos que se xera.
Por iso non tentamos substituír en silencio os datos obrigatorios que faltan por valores calquera.
Se, por exemplo, faltan informacións obrigatorias para ZUGFeRD ou ebInterface, Odoo debe avisar o usuario.
Entre elas figuran, por exemplo:
- país ausente no cliente
- información fiscal ausente nas liñas da factura
- datos bancarios ausentes
Na nosa opinión, isto é mellor que enviar unha factura electrónica xerada formalmente pero incorrecta no seu contido.
Código aberto para a Odoo Community
Tamén este proxecto o ofrecemos de balde como código aberto.
Por que?
Porque nós mesmos nos beneficiamos do software de código aberto.
Odoo Community ofrece unha base excelente para ERP, contabilidade e procesos empresariais. Cando no traballo diario nos falta unha función, desenvolvémola.
E se a solución tamén pode ser interesante para outras empresas, poñémola á disposición da comunidade.
Para nós, iso é código aberto vivido.
Foco austríaco – pero non só para Austria
O proxecto ten un claro énfase austríaco.
ebInterface e e-Rechnung.gv.at son interesantes sobre todo para as empresas austríacas.
A compatibilidade con ZUGFeRD, en cambio, tamén é relevante para empresas de fóra de Austria.
Así, o proxecto non é unha solución exclusivamente austríaca.
Precisamente a combinación de datos de factura estruturados e un documento PDF/A-3 xerado automaticamente pode ser interesante tamén para outras instalacións de Odoo.
Para Odoo 19 Community
Os módulos desenvolvéronse para Odoo 19 Community.
Na actualidade o repositorio contén:
- l10n_at_ebinterface
- account_invoice_zugferd_ebinterface_auto
- l10n_at_erechnung_gv_at
Os módulos dependen uns doutros, de modo que, segundo o caso de uso, só hai que instalar os compoñentes necesarios.
A nosa achega á comunidade
Non vemos este proxecto como un software comercial acabado, senón como unha achega ao desenvolvemento continuo da comunidade de Odoo.
Quizais alguén só necesite ebInterface.
Quizais outra empresa necesite ZUGFeRD.
Quizais unha empresa deba enviar regularmente facturas a entidades contratantes públicas a través de e-Rechnung.gv.at.
En todos os tres casos, o noso proxecto pode ofrecer unha base.
E como o código fonte está dispoñible abertamente, calquera usuario pode revisar a solución, adaptala e seguir desenvolvéndoa.
Código aberto significa: mellorar xuntos
Estamos convencidos de que o código aberto ofrece unha gran vantaxe precisamente nos sistemas ERP.
As empresas teñen requisitos diferentes.
Unha solución que funciona perfectamente para unha empresa pode ter que adaptarse noutra.
Co código fonte aberto iso é posible.
Por iso agradecemos:
- Comentarios
- Informes de erros (Bug Reports)
- Propostas de mellora
- Pull Requests
- outros casos de uso compatibles
Unha boa solución comunitaria non nace necesariamente no primeiro commit.
Nace co desenvolvemento continuo por parte de moitos usuarios e desenvolvedores.
Usar o proxecto de balde
Todo o código fonte está dispoñible publicamente en GitHub:
GitHub – Odoo 19 Invoice E-Files
Alí tamén se atopan a información de instalación e a documentación de cada un dos módulos.
Para a integración do servizo web austríaco e-Rechnung.gv.at necesítase ademais a biblioteca de Python Zeep.
A nosa achega a un mundo Odoo aberto
Con este proxecto queremos mostrar que tamén os desenvolvementos propios máis pequenos poden crear valor engadido para toda unha comunidade.
Orixinalmente desenvolvemos os módulos para resolver requisitos concretos.
Agora poñemos estas solucións de balde á disposición de todos os usuarios de Odoo 19 Community.
Así, un desenvolvemento individual pode converterse nunha solución comunitaria.
Odoo 19. Código aberto. Facturas electrónicas. Austria. E de balde para a comunidade.
Precisamente para iso publicamos este proxecto.