TicketBAI a Odoo: què és, calendari per territori (Araba, Bizkaia, Gipuzkoa) i mòduls OCA

Què és TicketBAI

TicketBAI (TBAI) és l'obligació de facturació dels tres territoris històrics del País Basc. No és una recomanació ni un format opcional: és un conjunt de requisits legals i tècnics que ha de complir el teu programari de facturació si tributes a Araba, Bizkaia o Gipuzkoa.

TicketBAI (d'ara endavant TBAI) és un projecte compartit entre les tres Diputacions Forals i el Govern Basc que té com a objectiu establir una sèrie d'obligacions legals i tècniques.

L'objectiu declarat és doble: ajudar el contribuent a complir les seves obligacions i prevenir el frau fiscal, garantint que totes les persones contribueixin segons la seva capacitat econòmica. A la pràctica, això es tradueix en què cada factura o tiquet s'ha de generar amb un programari que compleixi els requisits tècnics i remetre un fitxer a la Hisenda Foral corresponent.

A qui obliga

TicketBAI aplica a totes les persones físiques i jurídiques que desenvolupen una activitat econòmica i que estan subjectes a la competència normativa de les Hisendes Forals basques en IRPF o en Impost sobre Societats. És a dir: no depèn de la teva facturació ni de la teva mida, sinó d'on tributes.

totes les persones físiques i jurídiques que realitzin una activitat econòmica hauran d'utilitzar un programari de facturació que compleixi els requisits tècnics.

Com funciona tècnicament

El sistema imposa obligacions dins del mateix programari de facturació: cada factura es firma electrònicament, s'encadena amb l'anterior per garantir la integritat de la sèrie, incorpora un codi QR i un identificador TBAI, i genera un fitxer XML que es remet a la Hisenda Foral. Aquest fitxer rep una resposta de l'administració (acceptat o rebutjat, amb el seu codi d'error).

La conseqüència de disseny és important per a qualsevol implantació a Odoo: no n'hi ha prou amb emetre el PDF de la factura. Cal un component que firmi, encadeni i comuniqui, i que a més conservi la cadena encara que una factura sigui rebutjada o anul·lada.

Calendari per territori (ja vigent)

A dia d'avui (juliol de 2026) TicketBAI ja és d'aplicació general en els tres territoris. El que canvia entre ells és el calendari amb què es va arribar fins aquí, i sobretot el cas de Bizkaia, que integra TicketBAI dins d'un sistema més ampli anomenat BATUZ.

Gipuzkoa

Gipuzkoa va implantar TicketBAI de forma progressiva per sectors (segons classificació de l'IAE), començant per les assessories l'1 de juliol de 2022 i ampliant per trams al llarg de 2022 i 2023.

Des de l'1 de juny de 2023, l'obligació TicketBAI és exigible a totes les persones contribuents que exerceixin activitats econòmiques a Gipuzkoa.

Araba / Àlaba

Araba va seguir un calendari més curt durant 2022:

• ▸Voluntari des de l'01/01/2022.
• ▸Obligatori des de l'01/04/2022 per a assessories.
• ▸Obligatori des de l'01/07/2022 per al comerç al detall de medicaments, productes sanitaris i d'higiene personal.
• ▸Obligatori des de l'01/12/2022 per a la resta de contribuents.

Bizkaia (dins del sistema BATUZ)

Bizkaia és el cas especial. Allà TicketBAI no va sol: forma part de BATUZ, que a més del programari de facturació TicketBai obliga a anotar les operacions al Llibre Registre d'Operacions Econòmiques (LROE) a la seu electrònica de la Diputació. La implantació progressiva es va iniciar el gener de 2024 i es va organitzar en cinc finestres per tipologia de contribuent.

• ▸1a finestra (1 de gener de 2024): entitats de l'Impost sobre Societats que no eren microempreses ni petites o mitjanes empreses.
• ▸2a finestra (1 de juliol de 2024): persones físiques, comunitats de béns, societats civils i pimes d'activitats industrials, construcció, transport i determinades activitats professionals.
• ▸3a finestra (1 de gener de 2025): persones jurídiques pime l'activitat principal de les quals és el comerç minorista o l'hostaleria.
• ▸4a finestra (1 de juliol de 2025): persones físiques, comunitats de béns o societats civils de les activitats de la finestra anterior.
• ▸5a i última finestra (1 de gener de 2026): entitats exemptes i parcialment exemptes de l'IS, entitats sense fins lucratius, i pimes del sector primari, educació i serveis culturals.

es va establir un calendari de cinc finestres d'incorporació per tipologia de contribuent que culminarà aquest dijous, 1 de gener de 2026.

TicketBAI a Odoo: què cobreix OCA i què no

Odoo no porta TicketBAI a la seva localització espanyola de base. La solució de referència a l'ecosistema Odoo són els mòduls de l'Odoo Community Association (OCA), publicats al repositori OCA/l10n-spain sota llicència AGPL-3. Estan mantinguts principalment per Binovo i Landoo, les empreses que porten anys darrere d'aquesta integració.

Els mòduls d'OCA/l10n-spain

El conjunt s'organitza en diverses peces que s'instal·len segons el teu cas (branca 16.0, versions a data d'aquesta revisió):

• ▸l10n_es_ticketbai_api — la capa base que genera, firma i comunica els fitxers TBAI (inclou la generació del QR).
• ▸l10n_es_ticketbai — integra TicketBAI a la facturació (account.move): factures de client, rectificatives i anul·lacions. Depèn de l10n_es, l10n_es_aeat i de l'API.
• ▸l10n_es_ticketbai_pos — estén TicketBAI al TPV (Punt de Venda), sobre l10n_es_pos.
• ▸l10n_es_ticketbai_oss — cobreix el règim de finestreta única (OSS) per a vendes B2C intracomunitàries, sobre l10n_eu_oss_oca.
• ▸l10n_es_ticketbai_api_batuz i l10n_es_ticketbai_batuz — la variant específica de Bizkaia (BATUZ / LROE). Compte: el mòdul l10n_es_ticketbai_batuz està marcat com a 'Alpha' al seu manifest, un estat de maduresa inferior a la resta (majoritàriament 'Beta').

En quines branques existeix realment (i en quines encara no)

Aquest és el punt on convé ser honest abans de planificar una migració. A data d'aquesta revisió (23 de juliol de 2026), els mòduls TicketBAI d'OCA/l10n-spain existeixen a les branques 12.0, 13.0, 14.0, 15.0 i 16.0. NO estan portats encara a les branques 17.0, 18.0 ni 19.0: en aquestes branques la carpeta del mòdul no existeix (la ruta respon 404), tot i que altres mòduls de la localització espanyola sí que estan ja migrats.

Traducció pràctica: si tributes amb TicketBAI i vols estar a Odoo 17, 18 o 19, avui no pots tirar directament del mòdul OCA oficial en aquesta branca. Les opcions reals són quedar-te a 16.0 mentre es migra, portar/patrocinar la migració (és AGPL-3 i la comunitat ho agraeix), o valorar una integració de tercers homologada. Convé verificar l'estat de la migració al repositori abans de comprometre dates, perquè aquestes branques es mouen.

Community, OCA i Enterprise: on és la línia

TicketBAI a Odoo és, avui, terreny d'OCA sobre Odoo Community o Enterprise: els mòduls són AGPL-3 i funcionen sobre la comptabilitat estàndard. No necessites Enterprise per complir, però sí que necessites els mòduls OCA correctes per al teu territori (la variant BATUZ per a Bizkaia) i una branca on existeixin. La part delicada mai és 'instal·lar el mòdul', sinó els certificats, les sèries de facturació, l'encadenament i les anul·lacions/rectificatives ben fetes.

Necessites ajuda amb TicketBAI a Odoo?

A skanndar treballem Odoo per a pimes i autònoms a Espanya, amb criteri sobre el que porta Community, el que aporta OCA i el que cal construir. Si estàs a Araba, Bizkaia o Gipuzkoa i vols una auditoria honesta de la teva situació amb TicketBAI/BATUZ —inclòs si la teva versió d'Odoo està suportada o si convé esperar a la migració— escriu-nos. Et direm què és viable avui i què no, sense fum.