Las facturas electrónicas forman parte de la contabilidad moderna
La digitalización de la contabilidad sigue avanzando. Los formatos de factura electrónica son desde hace tiempo mucho más que un archivo PDF enviado por correo electrónico.
Una auténtica factura electrónica contiene datos estructurados que los sistemas de contabilidad y ERP pueden procesar automáticamente.
Con nuestro nuevo proyecto de código abierto para Odoo 19 Community queremos abordar precisamente este punto.
Hemos desarrollado varias extensiones que ponemos a disposición de la comunidad de Odoo de forma gratuita.
El proyecto está disponible públicamente en GitHub:
Odoo 19 Invoice E-Files en GitHub
Nuestro enfoque se centra sobre todo en Austria, pero una parte de la solución también resulta interesante para empresas fuera de Austria.
Tres módulos para facturas electrónicas
Actualmente el proyecto consta de tres componentes principales:
- ebInterface 6.1 para Austria
- ZUGFeRD para facturas electrónicas
- envío automático a e-Rechnung.gv.at
Así reunimos en un único proyecto de código abierto para Odoo 19 Community diversos requisitos relacionados con las facturas electrónicas.
ebInterface 6.1: el formato de factura austriaco
Uno de los pilares de nuestro desarrollo es ebInterface 6.1.
ebInterface es el formato estándar austriaco para facturas electrónicas estructuradas.
Nuestro módulo
l10n_at_ebinterface
genera a partir de una factura de cliente o de una nota de crédito en Odoo el correspondiente XML de ebInterface 6.1.
Para ello se transfieren a la estructura XML, entre otros datos, la información relevante de la factura de Odoo:
- Emisor de la factura
- Destinatario de la factura
- Líneas de factura
- Impuestos
- Información de pago
- Datos bancarios
- Datos de la factura
El archivo XML generado queda vinculado directamente a la factura.
¿Por qué hemos desarrollado un módulo propio para ello?
Durante el desarrollo comprobamos que, para Odoo 19 Community, actualmente no hay disponible ningún módulo del núcleo de Odoo ni de la OCA para el estándar nativo austriaco ebInterface.
Precisamente ahí quisimos intervenir.
En lugar de desarrollar una solución austriaca solo para nuestra propia instalación, la hemos implementado como un módulo de código abierto independiente.
Así, el resto de la comunidad de Odoo también puede beneficiarse de ella.
ZUGFeRD automático con cada factura
El segundo pilar de nuestro proyecto es ZUGFeRD.
ZUGFeRD combina una factura en PDF con una factura estructurada en XML.
El resultado es la llamada factura híbrida: para las personas la factura sigue siendo legible como PDF, mientras que el software puede evaluar automáticamente los datos estructurados de la factura que contiene.
En principio, Odoo 19 ya incorpora compatibilidad con ZUGFeRD y CII.
En la práctica, sin embargo, existen algunas limitaciones.
Nuestro módulo
account_invoice_zugferd_ebinterface_auto
actúa precisamente en este punto.
ZUGFeRD ya no es solo una opción
Queríamos un flujo lo más automatizado posible.
Por eso, al enviar una factura de cliente no se comprueba primero si el cliente en cuestión está configurado individualmente para ZUGFeRD.
En su lugar, ZUGFeRD se utiliza automáticamente para las facturas de cliente y las notas de crédito.
Además, el XML de ebInterface generado se adjunta como parte de la factura.
Así se obtiene un proceso continuo:
Factura de Odoo → PDF → factura electrónica estructurada → envío
sin que el usuario tenga que realizar pasos adicionales con cada factura.
También cubrimos carencias de Odoo 19 Community
Durante la implementación nos encontramos con algunas particularidades de la implementación de Odoo 19.
Entre otras cosas, existen dependencias en el exportador CII que pueden causar problemas fuera de determinadas instalaciones por país.
Nuestro módulo corrige varias de estas limitaciones prácticas.
Entre ellas figuran:
- campos ausentes para los períodos de ingresos diferidos (Deferred Revenue)
- la restricción por país de la conversión a PDF/A-3
- datos bancarios ausentes o no establecidos en facturas existentes
Con ello, ZUGFeRD debería poder utilizarse de forma fiable también en empresas fuera de las combinaciones de países previstas originalmente.
e-Rechnung.gv.at: envío directo al Estado austriaco
El tercer componente resulta especialmente interesante para las empresas que facturan a entidades públicas contratantes.
Con
l10n_at_erechnung_gv_at
una factura ebInterface puede enviarse directamente al servicio web e-Rechnung.gv.at austriaco.
De este modo, la simple creación de facturas se convierte en un proceso de facturación electrónica automatizado.
El flujo puede ser, por ejemplo, el siguiente:
Crear la factura en Odoo
↓
Generar el XML de ebInterface
↓
Enviar la factura
↓
Enviar ebInterface automáticamente a e-Rechnung.gv.at
Así, un proceso que de otro modo sería manual se integra directamente en Odoo.
Envío automático solo para los clientes que lo necesitan
El envío a e-Rechnung.gv.at no se activa de forma generalizada para todos los clientes.
En su lugar, puede activarse en cada cliente austriaco concreto.
Para ello se registran en el cliente los datos necesarios, como por ejemplo
- Número de proveedor
- Grupo de compradores / número de sucursal
- Referencia del pedido
en la ficha del cliente.
El módulo también comprueba si se cumplen los requisitos para la activación.
Entorno de pruebas y de producción
Para e-Rechnung.gv.at puede elegirse entre un entorno de pruebas y uno de producción.
Las credenciales de acceso al servicio web USP se guardan en los ajustes de Odoo.
Así, la integración puede prepararse primero en un entorno de pruebas antes de utilizarla para el envío productivo de facturas.
Automatización en lugar de más trabajo
Nuestro objetivo durante el desarrollo no era darle al contable más botones.
Más bien al contrario.
La idea es:
Lo menos posible de trabajo manual.
Se crea una factura en Odoo.
Los formatos estructurados necesarios se generan automáticamente.
Al enviarla, se adjuntan automáticamente los archivos correspondientes.
Y, en el caso de clientes austriacos configurados en consecuencia, la factura puede además enviarse automáticamente a e-Rechnung.gv.at.
Precisamente esta automatización marca la diferencia entre una simple exportación de archivos y una solución de facturación electrónica realmente integrada.
La calidad de los datos no se oculta sin más
Sin embargo, un punto importante de nuestra implementación es también este:
Una factura electrónica solo puede ser tan buena como los datos a partir de los cuales se genera.
Por eso no intentamos sustituir en silencio los datos obligatorios que faltan por valores cualesquiera.
Si, por ejemplo, faltan datos obligatorios para ZUGFeRD o ebInterface, Odoo debe avisar de ello al usuario.
Entre ellos figuran, por ejemplo:
- país ausente en el cliente
- información fiscal ausente en las líneas de factura
- datos bancarios ausentes
En nuestra opinión, esto es mejor que enviar una factura electrónica generada formalmente pero incorrecta en cuanto al contenido.
Código abierto para la comunidad de Odoo
También este proyecto lo ponemos a disposición gratuitamente como código abierto.
¿Por qué?
Porque nosotros mismos nos beneficiamos del software de código abierto.
Odoo Community ofrece una base excelente para ERP, contabilidad y procesos empresariales. Cuando en nuestro trabajo diario nos falta una función, la desarrollamos.
Y si la solución puede resultar interesante también para otras empresas, la ponemos a disposición de la comunidad.
Para nosotros, eso es vivir el código abierto.
Enfoque austriaco, pero no solo para Austria
El proyecto tiene un claro enfoque austriaco.
ebInterface y e-Rechnung.gv.at resultan interesantes sobre todo para las empresas austriacas.
En cambio, la compatibilidad con ZUGFeRD también es relevante para empresas fuera de Austria.
Por tanto, el proyecto no es exclusivamente una solución austriaca.
Precisamente la combinación de datos de factura estructurados y un documento PDF/A-3 generado automáticamente puede resultar interesante también para otras instalaciones de Odoo.
Para Odoo 19 Community
Los módulos se han desarrollado para Odoo 19 Community.
Actualmente el repositorio contiene:
- l10n_at_ebinterface
- account_invoice_zugferd_ebinterface_auto
- l10n_at_erechnung_gv_at
Los módulos dependen unos de otros, de modo que, según el caso de uso, solo hay que instalar los componentes necesarios.
Nuestra contribución a la comunidad
No consideramos este proyecto un software comercial terminado, sino una contribución al desarrollo de la comunidad de Odoo.
Quizá alguien solo necesite ebInterface.
Quizá otra empresa necesite ZUGFeRD.
Quizá una empresa tenga que enviar regularmente facturas a entidades públicas contratantes a través de e-Rechnung.gv.at.
En los tres casos, nuestro proyecto puede servir de base.
Y, como el código fuente está disponible abiertamente, cualquier usuario puede revisar la solución, adaptarla y seguir desarrollándola.
Código abierto significa: mejorar juntos
Estamos convencidos de que el código abierto ofrece una gran ventaja precisamente en los sistemas ERP.
Las empresas tienen requisitos diferentes.
Una solución que funciona perfectamente para una empresa quizá deba adaptarse para otra.
Con un código fuente abierto, eso es posible.
Por eso agradecemos:
- Comentarios
- Informes de errores (bug reports)
- Sugerencias de mejora
- Pull requests
- otros casos de uso compatibles
Una buena solución comunitaria no surge necesariamente con el primer commit.
Surge gracias al desarrollo continuo por parte de muchos usuarios y desarrolladores.
Usar el proyecto gratuitamente
Todo el código fuente está disponible públicamente en GitHub:
GitHub – Odoo 19 Invoice E-Files
Allí encontrará también la información de instalación y la documentación de cada uno de los módulos.
Para la integración del servicio web austriaco e-Rechnung.gv.at se necesita además la biblioteca de Python Zeep.
Nuestra contribución a un mundo Odoo abierto
Con este proyecto queremos demostrar que incluso los desarrollos propios más pequeños pueden aportar valor a toda una comunidad.
Desarrollamos originalmente los módulos para resolver necesidades concretas.
Ahora ponemos estas soluciones gratuitamente a disposición de todos los usuarios de la comunidad de Odoo 19.
Así, un desarrollo individual puede convertirse en una solución comunitaria.
Odoo 19. Código abierto. Facturas electrónicas. Austria. Y gratis para la comunidad.
Precisamente para eso hemos publicado este proyecto.