Las facturas electrónicas forman parte de la contabilidad moderna
La digitalización de la contabilidad sigue avanzando. Hace tiempo que los formatos de factura electrónica son mucho más que un archivo PDF enviado por correo electrónico.
Una verdadera 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 esta necesidad.
Hemos desarrollado varias extensiones que ponemos gratuitamente a disposición de la comunidad de Odoo.
El proyecto está disponible públicamente en GitHub:
Odoo 19 Invoice E-Files en GitHub
Nos centramos especialmente en Austria, aunque parte de la solución también resulta interesante para empresas de otros países.
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 distintos requisitos de facturación electrónica en un proyecto de código abierto para Odoo 19 Community.
ebInterface 6.1: el formato de facturación austriaco
Uno de los ejes 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 el correspondiente XML de ebInterface 6.1 a partir de una factura de cliente o una factura rectificativa en Odoo.
Se trasladan a la estructura XML, entre otros, los siguientes datos relevantes 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 se vincula directamente a la factura.
¿Por qué hemos desarrollado un módulo propio para ello?
Durante el desarrollo comprobamos que actualmente no existe ningún módulo del núcleo de Odoo ni de la OCA para Odoo 19 Community compatible con el estándar nativo austriaco ebInterface.
Ese era precisamente el problema que queríamos abordar.
En lugar de desarrollar una solución para Austria solo para nuestra propia instalación, la hemos creado como un módulo independiente de código abierto.
Así, el resto de la comunidad de Odoo también puede beneficiarse.
ZUGFeRD automáticamente en cada factura
El segundo eje de nuestro proyecto es ZUGFeRD.
ZUGFeRD combina una factura en PDF con una factura XML estructurada.
El resultado es lo que se conoce como factura híbrida: las personas pueden leer la factura en PDF, mientras que el software puede procesar automáticamente los datos estructurados que contiene.
En principio, Odoo 19 ya incluye compatibilidad con ZUGFeRD o CII.
Sin embargo, en la práctica existen algunas limitaciones.
Nuestro módulo
account_invoice_zugferd_ebinterface_auto
aborda precisamente este problema.
ZUGFeRD deja de ser solo una opción
Queríamos un proceso lo más automatizado posible.
Por eso, al enviar una factura de cliente, no se comprueba previamente si ese cliente se ha configurado individualmente para ZUGFeRD.
En su lugar, ZUGFeRD se utiliza automáticamente para las facturas de clientes y las facturas rectificativas.
Además, el XML de ebInterface generado se incluye como parte de la factura.
Así se consigue un proceso completo:
Factura de Odoo → PDF → factura electrónica estructurada → envío
sin que el usuario tenga que realizar pasos adicionales en cada factura.
También cubrimos carencias de Odoo 19 Community
Durante el desarrollo nos encontramos con algunas particularidades de la implementación de Odoo 19.
Entre otras cosas, el exportador CII tiene dependencias que pueden causar problemas en instalaciones sin determinadas localizaciones nacionales.
Nuestro módulo resuelve varias de estas limitaciones prácticas.
Entre ellas se encuentran:
- la falta de campos para los periodos de ingresos diferidos
- la restricción de la conversión a PDF/A-3 según el país
- datos bancarios ausentes o sin asignar en facturas existentes
El objetivo es que ZUGFeRD también pueda utilizarse de forma fiable en empresas con combinaciones de países distintas de las previstas inicialmente.
e-Rechnung.gv.at: envío directo al Estado austriaco
El tercer componente resulta especialmente interesante para las empresas que facturan a organismos públicos.
Con
l10n_at_erechnung_gv_at
se puede enviar una factura ebInterface directamente al servicio web austriaco e-Rechnung.gv.at.
Así, la simple creación de facturas se convierte en un proceso automatizado de facturación electrónica.
El proceso puede ser, por ejemplo, el siguiente:
Crear la factura en Odoo
↓
Generar el XML de ebInterface
↓
Enviar la factura
↓
Enviar automáticamente ebInterface a e-Rechnung.gv.at
Así se integra directamente en Odoo un proceso que, de otro modo, sería manual.
Envío automático solo para los clientes que lo necesitan
El envío a e-Rechnung.gv.at no se activa de forma general para todos los clientes.
En su lugar, puede activarse en cada cliente austriaco concreto.
Para ello, los datos necesarios, como
- número de proveedor
- grupo de compras / número de sucursal
- referencia del pedido
se guardan en la ficha del cliente.
El módulo también comprueba si se cumplen los requisitos para la activación.
Pruebas y producción
Para e-Rechnung.gv.at se puede elegir entre un entorno de pruebas y uno de producción.
Las credenciales de acceso al servicio web de USP se guardan en los ajustes de Odoo.
Así, la integración puede prepararse primero en un entorno de pruebas antes de utilizarla para enviar facturas en producción.
Automatización en lugar de más trabajo
Al desarrollar la solución, nuestro objetivo no era añadir más botones para el contable.
Todo lo contrario.
La idea es:
Reducir al mínimo el trabajo manual.
Se crea una factura en Odoo.
Los formatos estructurados necesarios se generan automáticamente.
Los archivos correspondientes se adjuntan automáticamente al enviar la factura.
Además, en el caso de los clientes austriacos con la configuración correspondiente, la factura también puede enviarse automáticamente a e-Rechnung.gv.at.
Esta automatización es precisamente lo que marca la diferencia entre una simple exportación de archivos y una solución de facturación electrónica realmente integrada.
Los problemas de calidad de los datos no se ocultan
Sin embargo, un punto importante de nuestra implementación es también este:
La calidad de una factura electrónica depende de la calidad de los datos a partir de los que se genera.
Por eso no intentamos sustituir los datos obligatorios que faltan por valores arbitrarios sin avisar.
Si, por ejemplo, falta información obligatoria para ZUGFeRD o ebInterface, Odoo debe avisar al usuario.
Por ejemplo:
- falta del país en la ficha del cliente
- falta de información fiscal en las líneas de factura
- falta de datos bancarios
Desde nuestro punto de vista, esto es mejor que enviar una factura electrónica generada correctamente en cuanto al formato, pero con datos incorrectos.
Código abierto para la comunidad de Odoo
También ponemos este proyecto a disposición de todos gratis y como código abierto.
¿Por qué?
Porque nosotros también nos beneficiamos del software de código abierto.
Odoo Community ofrece una excelente base para el ERP, la contabilidad y los procesos empresariales. Cuando echamos en falta una función en el trabajo diario, la desarrollamos.
Y, si la solución también puede resultar útil para otras empresas, la ponemos a disposición de la comunidad.
Para nosotros, eso es poner en práctica el código abierto.
Centrado en Austria, pero también útil fuera de ella
El proyecto está claramente orientado a Austria.
ebInterface y e-Rechnung.gv.at son especialmente útiles 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 una solución exclusiva para Austria.
En particular, la combinación de datos de facturación estructurados y un documento PDF/A-3 generado automáticamente también puede resultar útil 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 tienen dependencias entre sí, de modo que solo es necesario instalar los componentes que requiera cada caso de uso.
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 deba enviar periódicamente facturas a organismos públicos 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 de forma abierta, cualquier usuario puede revisar, adaptar y seguir desarrollando la solución.
Código abierto significa mejorar juntos
Estamos convencidos de que el código abierto ofrece grandes ventajas, especialmente en los sistemas ERP.
Cada empresa tiene necesidades distintas.
Una solución que funciona perfectamente en una empresa puede necesitar adaptaciones para otra.
El código abierto lo hace posible.
Por eso agradecemos:
- comentarios
- informes de errores
- sugerencias de mejora
- solicitudes de incorporación de cambios
- nuevos casos de uso compatibles
Una buena solución para la comunidad no surge necesariamente con el primer commit.
Se construye con las mejoras que aportan muchos usuarios y desarrolladores.
Utilizar el proyecto de forma gratuita
Todo el código fuente está disponible públicamente en GitHub:
GitHub – Odoo 19 Invoice E-Files
Allí también se encuentran las instrucciones de instalación y la documentación de cada módulo.
Para integrar el servicio web austriaco e-Rechnung.gv.at también se necesita la biblioteca de Python Zeep.
Nuestra contribución a un ecosistema Odoo abierto
Con este proyecto queremos demostrar que incluso los pequeños desarrollos propios pueden aportar valor a toda una comunidad.
Desarrollamos los módulos inicialmente para resolver necesidades concretas.
Ahora ponemos estas soluciones a disposición de todos los usuarios de Odoo 19 Community de forma gratuita.
Así, un desarrollo a medida puede convertirse en una solución para toda la comunidad.
Odoo 19. Código abierto. Facturación electrónica. Austria. Y gratis para la comunidad.
Precisamente por eso hemos publicado este proyecto.