Software TicketBAI para haciendas forales del País Vasco
BATUZ Bizkaia con firma XAdES-BES. Gipuzkoa y Araba en beta. Detección automática de territorio por código postal.
TicketBAI es el sistema de facturación electrónica de las tres haciendas forales del País Vasco (Bizkaia, Gipuzkoa y Araba), ya obligatorio en cada territorio según calendario. Frihet implementa el pipeline completo BATUZ Bizkaia en producción y los endpoints de firma de Gipuzkoa y Araba en beta.
¿Qué es TicketBAI?
TicketBAI es el sistema de facturación electrónica obligatorio en las tres Haciendas Forales del País Vasco: Bizkaia (Diputación Foral, sistema BATUZ-LROE), Gipuzkoa (Diputación Foral, sinadura.gipuzkoa.eus) y Araba/Álava (Diputación Foral, ticketbai.araba.eus). Cada hacienda tiene su propia normativa foral, pero todas requieren los mismos elementos técnicos comunes: generación de un fichero XML con la información de la factura, firma electrónica XAdES-BES sobre el XML con certificado del contribuyente, encadenamiento por hash SHA-256 con la factura anterior del mismo contribuyente, código QR con URL de validación de la hacienda foral correspondiente, identificador único de factura (TBAI Identifier), y envío inmediato al servicio web de la hacienda foral. Los plazos de obligación están vigentes en cada territorio. En Bizkaia, la integración con BATUZ-LROE va más allá: además de TicketBAI, exige el reporte de libros LROE (Libro Registro de Operaciones Económicas) en tiempo cuasi real. Frihet implementa BATUZ Bizkaia con cadena chained y first-in-chain, firma XAdES-BES con certificado PEM cifrado AES-256-GCM, generación de QR desde IdentificadorTBAI real, y endpoints Gipuzkoa y Araba en beta para los próximos clientes que aporten certificado de producción.
Cómo Frihet te ayuda con TicketBAI
Frihet detecta el territorio fiscal del contribuyente por código postal (48xxx Bizkaia, 20xxx Gipuzkoa, 01xxx Araba) y aplica el endpoint y la política de firma correspondiente.
- BATUZ Bizkaia: pipeline LROE completo con chained + first-in-chain en producción
- Gipuzkoa: firma XAdES-BES contra sinadura.gipuzkoa.eus en beta
- Araba/Álava: firma XAdES-BES contra ticketbai.araba.eus en beta
- Detección automática del territorio por código postal del emisor
- Generación del QR desde IdentificadorTBAI real (sin fabricación)
- App Check obligatorio en todos los callables (Trust Area)
Plazos y obligación de presentación
TicketBAI ya es obligatorio en los tres territorios forales. El calendario por sector ha completado su despliegue.
Cómo usar Frihet, paso a paso
- 1
Importa tu certificado digital en Frihet
Sube tu PEM en Ajustes → TicketBAI. Frihet lo cifra con AES-256-GCM y detecta tu territorio (Bizkaia, Gipuzkoa o Araba) por código postal.
- 2
Configura el modo sandbox o producción
Empieza en sandbox para verificar el flujo. En Bizkaia, BATUZ tiene sandbox propio; valida antes de pasar a producción.
- 3
Emite facturas con TicketBAI activado
Cada factura genera el XML firmado XAdES-BES, hash SHA-256 encadenado y QR desde el IdentificadorTBAI real.
- 4
Reporta LROE en Bizkaia (si aplica)
En Bizkaia, Frihet reporta automáticamente los libros LROE además del TicketBAI. Verifica el panel BATUZ tras cada envío.
Preguntas frecuentes
¿En qué territorios aplica TicketBAI?
TicketBAI aplica en las tres Haciendas Forales del País Vasco: Bizkaia (BATUZ), Gipuzkoa y Araba/Álava. Cada territorio tiene su propia normativa foral y endpoint de firma. Frihet detecta el territorio por código postal del emisor.
¿Qué diferencia hay entre TicketBAI y VeriFactu?
TicketBAI es exclusivo del País Vasco (haciendas forales). VeriFactu es para el resto de territorio común (AEAT). Ambos son sistemas de registro inmediato de facturación, pero técnicamente diferentes: TicketBAI usa XAdES-BES y envía XML firmado en tiempo real; VeriFactu usa hash SHA-256 y QR sin firma obligatoria.
¿Qué es BATUZ en Bizkaia?
BATUZ es la estrategia global de la Hacienda Foral de Bizkaia que combina TicketBAI con LROE (Libro Registro de Operaciones Económicas). Exige no solo firmar y enviar TicketBAI, sino también reportar los libros LROE en tiempo cuasi real. Frihet integra ambos en producción.
¿Necesito un certificado digital específico para TicketBAI?
Sí. TicketBAI requiere certificado electrónico del contribuyente o representante para la firma XAdES-BES. Frihet acepta certificado PEM con encriptación AES-256-GCM en Firestore. Si tu certificado está caducado o no coincide con el NIF emisor, Frihet te avisa.
¿Frihet genera el QR de TicketBAI desde el IdentificadorTBAI real?
Sí. Frihet genera el QR desde el IdentificadorTBAI real devuelto por la hacienda foral (BATUZ, Gipuzkoa o Araba), nunca desde un placeholder. Si el servicio rechaza el envío, Frihet lanza un error tipado y no fabrica el identificador.
Empieza con Frihet hoy
Plan gratis para siempre. Sin tarjeta de crédito. Cumplimiento fiscal integrado.