TicketBAI en Odoo: qué es, calendario por territorio (Araba, Bizkaia, Gipuzkoa) y módulos OCA

Qué es TicketBAI

TicketBAI (TBAI) es la obligación de facturación de los tres territorios históricos del País Vasco. No es una recomendación ni un formato opcional: es un conjunto de requisitos legales y técnicos que debe cumplir tu software de facturación si tributas en Araba, Bizkaia o Gipuzkoa.

TicketBAI (en adelante TBAI) es un proyecto compartido entre las tres Diputaciones Forales y el Gobierno Vasco que tiene como objetivo establecer una serie de obligaciones legales y técnicas.

El objetivo declarado es doble: ayudar al contribuyente a cumplir sus obligaciones y prevenir el fraude fiscal, garantizando que todas las personas contribuyan segun su capacidad economica. En la practica, esto se traduce en que cada factura o ticket debe generarse con un software que cumpla los requisitos tecnicos y remitir un fichero a la Hacienda Foral correspondiente.

A quién obliga

TicketBAI aplica a todas las personas fisicas y juridicas que desarrollan una actividad economica y que estan sujetas a la competencia normativa de las Haciendas Forales vascas en IRPF o en Impuesto sobre Sociedades. Es decir: no depende de tu facturacion ni de tu tamaño, sino de dónde tributas.

todas las personas físicas y jurídicas que realicen una actividad económica deberán utilizar un software de facturación que cumpla los requisitos técnicos.

Cómo funciona técnicamente

El sistema impone obligaciones dentro del propio software de facturacion: cada factura se firma electronicamente, se encadena con la anterior para garantizar la integridad de la serie, incorpora un codigo QR y un identificador TBAI, y genera un fichero XML que se remite a la Hacienda Foral. Ese fichero recibe una respuesta de la administracion (aceptado o rechazado, con su codigo de error).

La consecuencia de diseño es importante para cualquier implantacion en Odoo: no basta con emitir el PDF de la factura. Hace falta un componente que firme, encadene y comunique, y que ademas conserve la cadena aunque una factura sea rechazada o anulada.

Calendario por territorio (ya vigente)

A dia de hoy (julio de 2026) TicketBAI ya es de aplicacion general en los tres territorios. Lo que cambia entre ellos es el calendario con el que se llegó hasta aqui, y sobre todo el caso de Bizkaia, que integra TicketBAI dentro de un sistema mas amplio llamado BATUZ.

Gipuzkoa

Gipuzkoa implantó TicketBAI de forma progresiva por sectores (segun clasificacion del IAE), empezando por las asesorias el 1 de julio de 2022 y ampliando por tramos a lo largo de 2022 y 2023.

Desde el 1 de junio de 2023, la obligación TicketBAI es exigible a todas las personas contribuyentes que ejerzan actividades económicas en Gipuzkoa.

Araba / Álava

Araba siguió un calendario mas corto durante 2022:

• ▸Voluntario desde el 01/01/2022.
• ▸Obligatorio desde el 01/04/2022 para asesorias.
• ▸Obligatorio desde el 01/07/2022 para el comercio al por menor de medicamentos, productos sanitarios y de higiene personal.
• ▸Obligatorio desde el 01/12/2022 para el resto de los contribuyentes.

Bizkaia (dentro del sistema BATUZ)

Bizkaia es el caso especial. Alli TicketBAI no va solo: forma parte de BATUZ, que ademas del software de facturacion TicketBai obliga a anotar las operaciones en el Libro Registro de Operaciones Economicas (LROE) en la sede electronica de la Diputacion. La implantacion progresiva se inicio en enero de 2024 y se organizó en cinco ventanas por tipologia de contribuyente.

• ▸1ª ventana (1 de enero de 2024): entidades del Impuesto sobre Sociedades que no eran microempresas ni pequeñas o medianas empresas.
• ▸2ª ventana (1 de julio de 2024): personas fisicas, comunidades de bienes, sociedades civiles y pymes de actividades industriales, construccion, transporte y determinadas actividades profesionales.
• ▸3ª ventana (1 de enero de 2025): personas juridicas pyme cuya actividad principal es el comercio minorista o la hosteleria.
• ▸4ª ventana (1 de julio de 2025): personas fisicas, comunidades de bienes o sociedades civiles de las actividades de la ventana anterior.
• ▸5ª y ultima ventana (1 de enero de 2026): entidades exentas y parcialmente exentas del IS, entidades sin fines lucrativos, y pymes del sector primario, educacion y servicios culturales.

se estableció un calendario de cinco ventanas de incorporación por tipología de contribuyente que culminará este jueves, 1 de enero de 2026.

TicketBAI en Odoo: qué cubre OCA y qué no

Odoo no trae TicketBAI en su localizacion española de base. La solucion de referencia en el ecosistema Odoo son los modulos de la Odoo Community Association (OCA), publicados en el repositorio OCA/l10n-spain bajo licencia AGPL-3. Estan mantenidos principalmente por Binovo y Landoo, las empresas que llevan años detras de esta integracion.

Los módulos de OCA/l10n-spain

El conjunto se organiza en varias piezas que se instalan segun tu caso (rama 16.0, versiones a fecha de esta revision):

• ▸l10n_es_ticketbai_api — la capa base que genera, firma y comunica los ficheros TBAI (incluye la generacion del QR).
• ▸l10n_es_ticketbai — integra TicketBAI en la facturacion (account.move): facturas de cliente, rectificativas y anulaciones. Depende de l10n_es, l10n_es_aeat y de la API.
• ▸l10n_es_ticketbai_pos — extiende TicketBAI al TPV (Punto de Venta), sobre l10n_es_pos.
• ▸l10n_es_ticketbai_oss — cubre el regimen de ventanilla unica (OSS) para ventas B2C intracomunitarias, sobre l10n_eu_oss_oca.
• ▸l10n_es_ticketbai_api_batuz y l10n_es_ticketbai_batuz — la variante especifica de Bizkaia (BATUZ / LROE). Ojo: el modulo l10n_es_ticketbai_batuz esta marcado como 'Alpha' en su manifiesto, un estado de madurez inferior al resto (mayoritariamente 'Beta').

En qué ramas existe realmente (y en cuáles todavía no)

Este es el punto donde conviene ser honesto antes de planificar una migracion. A fecha de esta revision (23 de julio de 2026), los modulos TicketBAI de OCA/l10n-spain existen en las ramas 12.0, 13.0, 14.0, 15.0 y 16.0. NO estan portados todavia a las ramas 17.0, 18.0 ni 19.0: en esas ramas la carpeta del modulo no existe (la ruta responde 404), pese a que otros modulos de la localizacion española si estan ya migrados.

Traduccion practica: si tributas con TicketBAI y quieres estar en Odoo 17, 18 o 19, hoy no puedes tirar directamente del modulo OCA oficial en esa rama. Las opciones reales son quedarte en 16.0 mientras se migra, portar/patrocinar la migracion (es AGPL-3 y la comunidad lo agradece), o valorar una integracion de terceros homologada. Conviene verificar el estado de la migracion en el repositorio antes de comprometer fechas, porque estas ramas se mueven.

Community, OCA y Enterprise: dónde está la línea

TicketBAI en Odoo es, hoy, terreno de OCA sobre Odoo Community o Enterprise: los modulos son AGPL-3 y funcionan sobre la contabilidad estandar. No necesitas Enterprise para cumplir, pero si necesitas los modulos OCA correctos para tu territorio (la variante BATUZ para Bizkaia) y una rama en la que existan. La parte delicada nunca es 'instalar el modulo', sino los certificados, las series de facturacion, el encadenamiento y las anulaciones/rectificativas bien hechas.

¿Necesitas ayuda con TicketBAI en Odoo?

En skanndar trabajamos Odoo para pymes y autonomos en España, con criterio sobre lo que trae Community, lo que aporta OCA y lo que hay que construir. Si estas en Araba, Bizkaia o Gipuzkoa y quieres una auditoria honesta de tu situacion con TicketBAI/BATUZ —incluido si tu version de Odoo esta soportada o si conviene esperar a la migracion— escribenos. Te diremos que es viable hoy y que no, sin humo.