TicketBAI — Pays basque (Bizkaia, Gipuzkoa, Araba)

Les trois territoires foraux du Pays basque ont devance l'Espagne sur la traceabilite anti-fraude des factures : TicketBAI (TBAI) impose depuis 2022-2024, selon le territoire, une chaine de hash SHA-256 signee XAdES et un QR code de verification publique sur chaque facture, transmis en temps reel a la Hacienda Foral.

Genese : 3 territoires foraux, 1 dispositif convergent

Le Pays basque dispose, en vertu du Concierto Economico de 1981, d'une autonomie fiscale propre : les Diputaciones de Bizkaia, Gipuzkoa et Araba collectent tous les impots directs et indirects sur leur territoire, et les versent partiellement a l'Etat espagnol via le "cupo". Cette autonomie a permis a chaque territoire de devancer la legislation nationale en matiere de digitalisation fiscale.

# Trois territoires foraux du Pays basque
# Chaque diputacion gere son propre service mais le format TBAI est commun

Bizkaia (Biscaye, BFA / Bizkaiko Foru Aldundia)
  - Application : BATUZ (TicketBAI + LROE Libro Registro de Operaciones Economicas)
  - URL service : www.batuz.eus
  - Universalisation : 1 janvier 2024 (apres deploiement progressif depuis 2022)
  - Specifite : LROE integre, suivi double sens (emission ET reception)

Gipuzkoa (Guipuzcoa, GFA / Gipuzkoako Foru Aldundia)
  - Application : TicketBAI Gipuzkoa
  - URL service : www.gipuzkoa.eus/tbai
  - Universalisation : 1 janvier 2024
  - Specifite : double mode envoi-direct ou envoi-batch nocturne

Araba (Alava, AFA / Arabako Foru Aldundia)
  - Application : TicketBAI Araba
  - URL service : web.araba.eus/es/tbai
  - Universalisation : 1 janvier 2024
  - Specifite : portail consolide avec liens vers Bizkaia/Gipuzkoa
            pour les contribuables actifs dans plusieurs territoires

Les trois territoires ont mis en place TicketBAI a des rythmes legerement differents (Bizkaia ouvrant le bal en 2022 sous le nom BATUZ), mais avec un format XML commun et des regles cryptographiques identiques. Cette convergence a ete actee par l'Orden Foral conjunta (decret conjoint des trois Diputaciones) de 2020.

La chaine TBAI : SHA-256 et XAdES

Le XML TicketBAI suit un schema XSD propre — distinct du Facturae espagnol et du EN 16931 — concu pour le suivi technique de la facture plutot que pour son contenu commercial. Chaque XML porte :

1. L'identification du contribuable emetteur (NIF, raison sociale).
2. Les donnees de la facture (serie, numero, date, montant total — sans le detail ligne, qui est porte par le format commercial associe).
3. L'encadenamiento (chainage) avec la facture precedente : serie, numero, date, et SignatureValue de la facture precedente.
4. L'identification du logiciel emetteur (licence delivree par la Hacienda Foral, NIF developpeur, nom, version).
5. Une signature XAdES-EPES (XML Advanced Electronic Signature - Explicit Policy Electronic Signature) basee sur un certificat qualifie eIDAS du contribuable, avec horodatage qualifie.

<?xml version="1.0" encoding="UTF-8"?>
<T:TicketBai xmlns:T="urn:ticketbai:emision"
             xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
  <Cabecera>
    <IDVersionTBAI>1.2</IDVersionTBAI>
  </Cabecera>
  <Sujetos>
    <Emisor>
      <NIF>B12345678</NIF>
      <ApellidosNombreRazonSocial>Atelier Donostia SL</ApellidosNombreRazonSocial>
    </Emisor>
    <Destinatarios>
      <IDDestinatario>
        <NIF>B87654321</NIF>
        <ApellidosNombreRazonSocial>Cooperativa Vitoria SCoop</ApellidosNombreRazonSocial>
      </IDDestinatario>
    </Destinatarios>
  </Sujetos>
  <Factura>
    <CabeceraFactura>
      <SerieFactura>T-2026</SerieFactura>
      <NumFactura>00042</NumFactura>
      <FechaExpedicionFactura>20-04-2026</FechaExpedicionFactura>
    </CabeceraFactura>
    <DatosFactura>
      <ImporteTotalFactura>1210.00</ImporteTotalFactura>
    </DatosFactura>
  </Factura>
  <HuellaTBAI>
    <EncadenamientoFacturaAnterior>
      <SerieFacturaAnterior>T-2026</SerieFacturaAnterior>
      <NumFacturaAnterior>00041</NumFacturaAnterior>
      <FechaExpedicionFacturaAnterior>19-04-2026</FechaExpedicionFacturaAnterior>
      <SignatureValueFirmaFacturaAnterior>9C1185...</SignatureValueFirmaFacturaAnterior>
    </EncadenamientoFacturaAnterior>
    <Software>
      <LicenciaTBAI>BI-X-99999-2025</LicenciaTBAI>
      <EntidadDesarrolladora>
        <NIF>A99999999</NIF>
      </EntidadDesarrolladora>
      <Nombre>Atelier ERP</Nombre>
      <Version>4.7.2</Version>
    </Software>
  </HuellaTBAI>
  <ds:Signature>
    <!-- XAdES-EPES signature with timestamp -->
  </ds:Signature>
</T:TicketBai>

Le QR TicketBAI : verification publique

Chaque facture conforme TicketBAI doit porter un QR code visible encodant l'URL de verification publique aupres de la Diputacion competente. La specification est tres prescriptive : taille minimum, correction d'erreur, texte visible "TBAI" sous le QR.

# TicketBAI QR specification (Hacienda Foral)
# Format de l'URL encodee selon le territoire :

# Bizkaia
https://batuz.eus/QRTBAI?id=TBAI-B12345678-200426-000042-9C1185&cr=07

# Gipuzkoa
https://tbai.prep.gipuzkoa.eus/qr/?id=TBAI-B12345678-200426-000042-9C1185&cr=07

# Araba (Alava)
https://ticketbai.araba.eus/tbai/qrcode/?id=TBAI-B12345678-200426-000042-9C1185&cr=07

# Format ID TBAI :
#   TBAI-<NIF emetteur>-<DDMMYY>-<numero facture>-<5 premiers chars du hash XAdES>
# Format cr (control redundancy) :
#   2 chiffres Luhn modulo 16, valides cote serveur

Le QR pointe sur trois URL distinctes selon le territoire — chaque Diputacion gere son propre service de verification, mais le format de l'identifiant TBAI est commun : TBAI-NIF-date-numero-hash5. Cela permet, en cas de contribuable inter-territoires, de scanner le QR et d'etre redirige vers la Diputacion competente.

Reception par la Hacienda Foral

Deux modes de transmission sont prevus selon la taille du contribuable :

• Mode online (temps reel) — l'XML signe est transmis a la Diputacion dans les minutes suivant l'emission de la facture, par web service SOAP avec authentification par certificat qualifie. Obligatoire au-dela d'un certain chiffre d'affaires.
• Mode offline (batch quotidien) — les XML sont accumules localement puis transmis en lot avant 24 h apres l'emission. Reserve aux activites sans connexion permanente (taxis, marches, certaines activites ambulantes).

L'API SOAP renvoie immediatement un accuse de reception (AcuseRecibo) qui contient :

• L'identifiant TBAI definitif
• Le timestamp de reception cote Hacienda
• Le statut : Correcto, Anulado ou rejet avec code d'erreur

BATUZ et l'integration LROE en Bizkaia

La Diputacion de Bizkaia est allee plus loin que ses voisines en creant le dispositif BATUZ : la combinaison de TicketBAI (emission) et du Libro Registro de Operaciones Economicas (LROE) — le livre comptable detaille des operations economiques, soumis trimestriellement.

BATUZ ajoute donc :

• LROE Modelo 140 — pour les autonomos (entrepreneurs individuels) : declaration trimestrielle des operations sur compte propre.
• LROE Modelo 240 — pour les societes : declaration trimestrielle plus detaillee, incluant les ventes, les achats, les operations intracommunautaires et les operations avec des paradis fiscaux.

La combinaison TicketBAI + LROE permet a la Hacienda Foral de Bizkaia de pre-remplir entierement les declarations d'IVA trimestrielles (modeles 303 et 390) des assujettis sous BATUZ. Ce dispositif n'existe pas (encore) a Gipuzkoa et Araba, qui se limitent a TicketBAI.

Sanctions specifiques basques

Le regime de sanctions TicketBAI est porte par les Normas Forales de chaque territoire (Bizkaia : NF 5/2020, Gipuzkoa : NF 1/2020, Araba : NF 11/2020). Il est plus severe que le regime national :

• Logiciel sans licence TBAI : 2 % du chiffre d'affaires annuel de l'editeur en Pays basque, plafonne a 20 000 EUR par produit, repete chaque annee.
• Emission sans QR ou avec chainage rompu : 1 % du chiffre d'affaires annuel du contribuable, plancher 3 000 EUR plafond 20 000 EUR par exercice.
• Manipulation de la chaine cryptographique : sanction de 150 % du montant des factures alterees, plus action penale (faux en ecriture, fraude fiscale) au titre du Code penal espagnol art. 305.

Liens transverses

• Hub Espagne — vue d'ensemble du mandat e-invoicing
• Verifactu — equivalent national hors Pays basque
• SII — reporting AEAT temps quasi-reel
• Facturae — format commercial accompagnant TBAI
• BATUZ — portail Hacienda Foral de Bizkaia
• Hacienda Foral de Gipuzkoa — TicketBAI
• Hacienda Foral de Araba
• TicketBAI.eus — portail commun