Validador de Código TicketBAI (España)
Valide la estructura, formato y dígitos de control de códigos TicketBAI y URLs de código QR.
¿Cómo funciona la validación?
TicketBAI es el sistema tributario antifraude obligatorio impulsado por el Gobierno Vasco y las Haciendas Forales de Álava, Bizkaia (Batuz) y Gipuzkoa.
Cada factura genera un XML firmado digitalmente encadenado a la factura anterior, un código TBAI de 37 caracteres y un código QR de verificación.
Anatomía y Estructura del Código TicketBAI (País Vasco)
El identificador TicketBAI (TBAI) consta de 5 bloques reglamentados por las Haciendas Forales:
| Posición | Campo | Longitud | Significado Foral | Ejemplo |
|---|---|---|---|---|
| Bloque 1 | Prefijo | 4 letras | Prefijo normativo obligatorio 'TBAI'. | TBAI |
| Bloque 2 | NIF Emisor | 9 chars | NIF con código de provincia (48=Bizkaia, 20=Gipuzkoa, 01=Álava). | B48159227 |
| Bloque 3 | Fecha Emisión | 6 dígitos | Fecha de expedición en formato DDMMAA. | 240826 |
| Bloque 4 | Firma CRC | 8 chars hex | Primeros 8 caracteres hexadecimales de la firma del software garante. | D156961E |
| Bloque 5 | Dígitos Control | 2 dígitos | Checksum calculado por Módulo 97 sobre el código de firma. | 65 |
Algoritmo de Dígitos de Control TicketBAI (Módulo 97)
El bloque final de 2 dígitos valida la integridad de la firma:
DV = (Σ ASCII(CRC8[i])) % 97
- 1. Extracción de Firma: se extraen los 8 caracteres hexadecimales de la firma.
- 2. Suma de Valores ASCII: se suman los valores ordinales ASCII de los 8 caracteres.
- 3. Módulo 97: se divide la suma entre 97 para obtener el resto.
- 4. Formato de 2 Dígitos: se formatea el resultado con cero inicial (00 a 96).