TicketBAI es obligatorio en los tres territorios forales del País Vasco desde 2022-2024 y Odoo 19 lo incorpora de serie mediante el módulo Spain - TicketBAI. Instalarlo lleva minutos. Configurarlo correctamente para que funcione sin errores en producción es otra cosa.
La mayoría de los problemas aparecen en pasos que se suelen pasar por alto: impuestos mal clasificados, certificados con ámbito incorrecto, facturas que no pueden restaurarse a borrador porque ya están en la cadena, o la confusión entre lo que exige Bizkaia con Batuz y lo que exigen Álava y Gipuzkoa. Esta guía cubre todo el proceso sin saltarse esos detalles.
En Lógica Consultores somos especialistas en implantar TicketBAI en Odoo en empresas del País Vasco. Si al terminar de leer necesitas que alguien supervise que tu configuración fiscal y contable en Odoo es correcta, nuestra asesoría fiscal y contable con Odoo está pensada exactamente para eso.
Índice de contenidos
- Qué hace el módulo y qué necesitas antes de empezar
- Instalación del módulo y carga del certificado electrónico
- Selección de la agencia tributaria y entorno de pruebas
- Configuración de impuestos: el paso que más problemas genera
- El flujo de facturación: envío, rectificativas y anulaciones
- Bizkaia: Batuz, LROE y lo que cambia respecto a Álava y Gipuzkoa
- Preguntas frecuentes
Qué hace el módulo y qué necesitas antes de empezar
Qué hace el módulo Spain - TicketBAI
El módulo convierte cada factura emitida en un fichero XML que se firma digitalmente con el certificado electrónico de la empresa y se envía a los servidores de la Diputación Foral correspondiente. La Diputación asigna un identificador único a cada documento y lo incorpora a una cadena de hash que vincula cada factura con la anterior, garantizando que la secuencia no puede alterarse sin que quede rastro.
Una vez aceptada por la administración, la factura incorpora el código QR y el identificador TBAI obligatorios. Desde ese momento no puede modificarse, restaurarse a borrador ni eliminarse. Cualquier corrección debe hacerse mediante factura rectificativa.
Un dato que muchos desconocen: el módulo Spain - TicketBAI está disponible en Odoo Community, no solo en Enterprise. Las pymes que operen en el País Vasco pueden cumplir con TicketBAI desde la versión gratuita de Odoo.
Requisitos antes de instalar
Antes de tocar nada en Odoo conviene tener estos cuatro puntos en orden:
- Localización española instalada. El módulo depende de l10n_es (localización española) y de certificate (gestión de certificados). Ambos se instalan automáticamente junto con TicketBAI, pero si la localización española no estaba previamente configurada, es mejor instalarla primero desde los ajustes de Contabilidad para que el plan contable y los impuestos españoles queden correctamente cargados.
- NIF de la empresa configurado. El envío no funciona si la compañía no tiene NIF. El país de la compañía debe estar configurado como España.
- Certificado electrónico válido del territorio foral correspondiente (Álava, Bizkaia o Gipuzkoa). Sin él no hay firma y sin firma no hay envío.
- Plan contable español cargado. TicketBAI se apoya en los impuestos del plan contable español para construir el desglose del XML. Si el plan contable no está bien cargado, la clasificación de impuestos no funciona correctamente.
Instalación del módulo y carga del certificado electrónico
Selección de la agencia tributaria y entorno de pruebas
Seleccionar la agencia tributaria
Ve a Contabilidad → Ajustes y dentro del bloque de localización española localiza el apartado Registro de Libros connection TicketBAI. Este ajuste es específico por compañía, lo que significa que si gestionas varias empresas en la misma instancia de Odoo, cada una puede tener su propia agencia configurada.
Elige la agencia que corresponde al territorio foral donde tributa tu empresa:
- Hacienda Foral de Araba
- Hacienda Foral de Bizkaia
- Hacienda Foral de Gipuzkoa
Este paso activa TicketBAI. Mientras no selecciones ninguna agencia el sistema permanece desactivado aunque el módulo esté instalado y el certificado cargado. En cuanto seleccionas una agencia y el país de la compañía es España, las facturas empiezan a procesarse por TicketBAI.
El entorno de pruebas
El modo test viene activado por defecto. Es importante entender exactamente qué significa cada modo antes de tocarlo:
Modo test activado: los envíos van a servidores de pruebas independientes de cada Diputación Foral. No tienen validez fiscal ni oficial. Es el modo correcto para validar que toda la configuración funciona antes de operar en producción.
Modo test desactivado (producción): los envíos van a los servidores oficiales de la agencia y tienen validez fiscal real. Cada factura que envíes en este modo queda registrada en la Hacienda Foral.
No pases a producción hasta haber completado pruebas reales: facturas normales, rectificativas y anulaciones. Una vez en producción, las facturas entran en la cadena oficial y no pueden eliminarse.
La licencia, automática
No hay que introducir ninguna licencia manualmente. Odoo la muestra de forma automática en función de la agencia seleccionada y del entorno:
- En modo test cada agencia usa su propia licencia de pruebas.
- En modo producción se usa una única licencia de producción común.
Si TicketBAI no está bien configurado, Odoo muestra el aviso "TicketBAI is not configured" en la ficha de la compañía. Es la señal de que algo en los pasos anteriores no está completo.
Configuración de impuestos: el paso que más problemas genera
El flujo de facturación: envío, rectificativas y anulaciones
Cómo se envía una factura
Con todo configurado, el envío se integra en el flujo normal de facturación. Al confirmar una factura de cliente y usar Enviar e imprimir, aparece la opción adicional TicketBAI para enviar la factura electrónica a la Diputación Foral. Odoo genera el XML, lo firma con el certificado, le asigna un índice de cadena desde una secuencia sin saltos y lo envía al servicio web de la Diputación correspondiente.
Cada factura tiene un estado TicketBAI que avanza por tres fases: To Send (pendiente de enviar), Sent (enviada y aceptada) y Cancelled (anulada).
La cadena de facturas y sus implicaciones
El sistema mantiene una cadena continua de documentos. No se puede enviar un documento nuevo mientras el anterior de la cadena no haya sido aceptado por la administración. Esto garantiza la integridad de la secuencia pero tiene implicaciones prácticas importantes que conviene conocer antes de operar en producción:
Una factura que ha entrado en la cadena no puede restaurarse a borrador. Tampoco puede eliminarse: Odoo lo impide porque el documento ya tiene identificador de cadena TicketBAI. Cualquier corrección sobre una factura ya enviada debe hacerse mediante factura rectificativa o anulación, nunca modificando el documento original.
Facturas rectificativas
Al crear un abono, TicketBAI exige indicar el motivo de rectificación. Las opciones disponibles son:
- R1: Art. 80.1, 80.2, 80.6 y error fundado en derecho
- R2: Art. 80.3
- R3: Art. 80.4
- R4: Art. 80 - resto
- R5: Facturas simplificadas
Dos reglas que no admiten excepciones: en facturas simplificadas el motivo debe ser obligatoriamente R5, y en facturas no simplificadas no puede usarse R5. Además, no se puede enviar una rectificativa si el documento original todavía no ha sido enviado a la Diputación.
Anulación de facturas
La anulación se realiza enviando un XML de anulación específico a la agencia. Si la administración lo acepta, Odoo cancela la factura y registra el resultado en el historial del documento. El proceso es automático una vez iniciado desde Odoo, pero requiere que la factura original haya sido previamente aceptada por la Diputación.
Bizkaia: Batuz, LROE y lo que cambia respecto a Álava y Gipuzkoa
Preguntas frecuentes
El módulo Spain - TicketBAI está disponible en Odoo Community. No es necesaria la versión Enterprise para cumplir con TicketBAI en el País Vasco. Es uno de los puntos que más sorprende a las empresas que asumen que necesitan la versión de pago para cumplir con sus obligaciones fiscales forales.
La factura queda en estado To Send. Puedes enviarla después, pero ten en cuenta que el sistema no permite enviar un documento nuevo mientras el anterior de la cadena no haya sido aceptado por la Diputación. Si tienes facturas pendientes de enviar acumuladas, hay que resolverlas en orden antes de continuar.
No. El certificado electrónico es de la empresa, no del territorio. Lo que varía es la agencia tributaria seleccionada en los ajustes de Odoo. El mismo certificado con ámbito TBAI sirve independientemente de si tributas en Álava, Bizkaia o Gipuzkoa.
Odoo muestra el aviso "TicketBAI is not configured" en la ficha de la compañía si algo no está en orden. Antes de pasar a producción conviene validar el flujo completo en modo test: facturas ordinarias, rectificativas y anulaciones. Si algo falla en test, no pases a producción hasta resolverlo.
No. Una vez que una factura entra en la cadena TicketBAI no puede modificarse, restaurarse a borrador ni eliminarse. Cualquier corrección debe hacerse mediante factura rectificativa indicando el motivo correspondiente (R1 a R5 según el caso).
Bizkaia requiere configuración adicional: también se envían las facturas de proveedor, es obligatorio rellenar el campo Referencia en esas facturas, y si eres autónomo hay que configurar el epígrafe en los parámetros del sistema. Gipuzkoa y Álava solo exigen el envío de facturas de venta y no tienen esas capas adicionales.
¿Hablamos de tu proyecto?
Consultoría inicial sin coste. Te ayudamos a elegir, dimensionar e implementar la solución correcta para tu empresa.
Javier Ruiz Salinas
Autor
Javier Ruiz Salinas es Consultor certificado de Odoo, con más de 12 años de experiencia liderando implantaciones ERP, optimización de procesos y automatización en empresas de distintos sectores. Cuenta con un perfil híbrido funcional, financiero y técnico (contabilidad, gestión y sistemas), actuando como nexo entre negocio y tecnología para diseñar soluciones sólidas, escalables y alineadas con objetivos estratégicos.
