TicketBAI: cómo funciona paso a paso
Verificado el 22/10/2026 contra la FAQ oficial de la Hacienda Foral de Gipuzkoa y la documentación técnica de Batuz (Bizkaia).
TicketBAI no es "VeriFactu vasco": es un sistema propio de las tres Haciendas Forales (Álava, Bizkaia, Gipuzkoa) con calendario, formato XML, firma y envío distintos. Si tu domicilio fiscal está en territorio foral, este es el sistema que te obliga — no el RRSIF estatal. Aquí desglosamos el proceso técnico completo que ejecuta tu software cada vez que emites una factura.
El flujo en una frase
Cada factura → fichero XML TicketBAI → firma electrónica (certificado digital) → código identificativo + QR en el PDF/papel → envío REST a la Hacienda Foral correspondiente → respuesta XML (aceptado / errores).
1. Qué genera el software: el fichero XML TicketBAI
Cuando facturas, el programa crea un fichero XML que sigue el esquema XSD publicado por cada Hacienda (comparten estructura base, con pequeñas diferencias por territorio). Ese fichero se denomina "fichero TicketBAI" o fichero de alta.
Contenido mínimo (Anexo I de la OF 521/2020 de Gipuzkoa)
| Bloque | Qué incluye | Ejemplo de campos |
|---|---|---|
| Cabecera | Versión, identificador del software, licencia TicketBAI, marca temporal | version, softwareId, licencia, fechaHora |
| Emisor | NIF, nombre, domicilio fiscal, régimen de IVA | nif, nombreRazon, direccion, regimenIVA |
| Destinatario | NIF/CIF, nombre, domicilio (si factura completa) | nif, nombreRazon, pais |
| Detalle de líneas | Concepto, cantidad, precio unitario, % IVA, % recargo, importe | descripcion, cantidad, precioUnitario, tipoIVA |
| Totales | Base imponible, cuota IVA, recargo, total factura | baseImponible, cuotaIVA, totalFactura |
| Referencias | Factura anterior (serie, número, fecha), firma anterior truncada | facturaAnterior, firmaAnterior |
2. Firma electrónica obligatoria
El fichero XML debe firmarse electrónicamente antes de enviarse. La firma usa XAdES-BES (XML Advanced Electronic Signatures) y requiere un certificado digital válido (persona física o jurídica, no sirve certificado de dispositivo para terceros).
Requisitos clave (Anexo III de Gipuzkoa)
- El certificado debe ser válido y admitido por la Hacienda Foral (ej. FNMT, Camerfirma, etc.).
- La firma debe incluir el identificador de política
https://www.gipuzkoa.eus/ticketbai/sinaduray su hash SHA-256:4LDJbY5hqHHHX858s9QV1P8yVGzo6H23P/iNRRv+PnQ=. - El campo
SignatureValuede la firma se usa luego para construir el código identificativo TicketBAI y el QR que van en la factura visible.
3. Código identificativo TicketBAI y código QR (lo que ve el cliente)
La factura que entregas al cliente (papel o PDF) debe llevar dos elementos visibles que salen de la firma del XML:
| Elemento | Cómo se construye | Dónde va |
|---|---|---|
| Identificativo TicketBAI | TBAI + 100 primeros caracteres del SignatureValue de la firma del XML |
Última página de la factura (obligatorio); opcional en las anteriores |
| Código QR TicketBAI | Codifica: NIF emisor, número de factura, fecha, total, y hash de la firma | Última página (obligatorio); opcional en las anteriores |
El QR permite a cualquiera (cliente, Hacienda) verificar que la factura está registrada en el sistema foral leyendo el código QR con la app oficial o en la web de la Hacienda correspondiente.
4. Envío a la Hacienda Foral: servicio REST
El fichero XML firmado se envía por vía telemática mediante servicios REST (HTTPS POST con mensaje XML). Cada territorio tiene su punto de entrada:
| Territorio | Punto de entrada | Observación |
|---|---|---|
| Gipuzkoa | https://ticketbai.gipuzkoa.eus (TicketBAI Ataria) |
Envío simultáneo a la expedición de la factura |
| Bizkaia (Batuz) | https://batuz.eus / puntos de entrada TicketBAI |
Integrado en Batuz; envío inmediato |
| Álava | https://ticketbai.araba.eus |
Según OF 802/2021 y OF 260/2022 |
Respuesta del servidor (Anexo IV)
El servicio devuelve un XML de respuesta con:
- resultado: ACEPTADO / ERROR
- codigoError + descripcionError si hay fallos (validación XSD, reglas de negocio, firma, certificado caducado, duplicados, etc.)
- identificativoTicketBAI devuelto por la administración (para trazabilidad)
5. Los tres requisitos que exige la norma
La FAQ de Gipuzkoa señala: \"para cumplir la obligación TicketBAI se necesita un software o programa de facturación, conexión a Internet y un certificado digital\":
- Software de facturación que implemente los requisitos TicketBAI (debe estar inscrito en el registro del territorio).
- Conexión a Internet (el envío es inmediato/simultáneo en Gipuzkoa; en Bizkaia/Álava según su norma).
- Certificado digital válido del obligado tributario (o de su representante con poderes).
6. Diferencias clave con VeriFactu (para que no las confundas)
| Aspecto | TicketBAI (Foral) | VeriFactu / RRSIF (Estatal) |
|---|---|---|
| Ámbito | Domicilio fiscal en Álava, Bizkaia, Gipuzkoa, Navarra* | Domicilio fiscal en territorio común, Canarias, Ceuta, Melilla |
| Norma | Decretos/Órdenes Forales de cada territorio (ej. DF 32/2020, OF 521/2020 Gipuzkoa; NF 5/2020, NF 8/2023 Bizkaia; DF 48/2021 Álava) | RD 1007/2023 (modificado por RD 254/2025, RDL 15/2025) |
| Formato XML | Esquema XSD propio (TicketBAI v1.2.2) | Esquema XSD del RRSIF (FacturaE 3.2.2 adaptado) |
| Firma | XAdES-BES con política foral (sinadura) |
XAdES-BES con política AEAT |
| QR | Formato TicketBAI (incluye hash de firma) | Formato VeriFactu (incluye hash de firma) |
| Envío | REST a cada Hacienda Foral | REST a AEAT (VERI*FACTU) |
| Homologación | Inscripción en registro foral (no homologación) | Homologación por AEAT (lista pública) |
| Fechas | Ya obligatorio en los 3 territorios (2022-2023) | 01/01/2027 (Sociedades) · 01/07/2027 (resto) |
* Navarra: a 22/10/2026 no hay norma foral publicada de NaTicket; mientras no la haya, sigue el reglamento de facturación anterior. Ver nuestra guía de jurisdicciones.
7. Qué pasa si falla el envío (contingencia)
La normativa prevé supuestos de imposibilidad técnica (corte de luz, caída del servicio, certificado caducado):
- Notificas a la Hacienda Foral (en Gipuzkoa:
[email protected]). - Expedes factura en papel (o PDF sin QR/identificativo) al cliente.
- Conservas copia.
- En cuanto se restablece: generas los ficheros XML de todas las facturas pendientes correlativamente y los envías. Esas facturas pasan a considerarse duplicados a efectos de TicketBAI.
8. Anulación, regularización y modificación (servicios Zuzendu)
- Anulación: generas un fichero XML de anulación (esquema XSD distinto), lo firmas y lo envías. No hace falta factura de anulación en papel, pero puedes emitirla.
- Regularización/modificación (Zuzendu): si la Hacienda devuelve error, puedes corregir y reenviar mediante el servicio Zuzendu (tiene sus propios anexos y validaciones).
- No se puede modificar una factura ya enviada sin generar un nuevo fichero de alta (y, si procede, anular la anterior).
Tabla resumen: proceso completo factura a factura
| Paso | Acción | Quién | Salida |
|---|---|---|---|
| 1 | Introduces datos en el software | Usuario | — |
| 2 | Software genera XML TicketBAI | Software | fichero_alta.xml |
| 3 | Software firma XML con certificado | Software + Certificado | fichero_alta_firmado.xml |
| 4 | Software extrae SignatureValue → construye identificativo TBAI y QR |
Software | Strings para la factura visible |
| 5 | Software genera factura visible (PDF/papel) con TBAI + QR | Software | Factura para el cliente |
| 6 | Software envía XML firmado a Hacienda Foral (REST) | Software | Petición HTTPS |
| 7 | Hacienda valida (XSD + reglas + firma + certificado) | Hacienda Foral | XML respuesta (ACEPTADO / ERROR) |
| 8 | Si ACEPTADO: fin. Si ERROR: corriges y reenvías (Zuzendu) |
Usuario / Software | — |
Preguntas frecuentes
¿Puedo usar el mismo software para TicketBAI y para VeriFactu? Un software puede estar inscrito en TicketBAI (foral) y homologado en VeriFactu (estatal) a la vez, pero son dos procesos de certificación distintos. Pide al fabricante que te confirme por escrito para qué sistema está validado. En el directorio de software explicamos cómo verificarlo.
¿El identificativo TicketBAI y el QR son lo mismo que el código VeriFactu? No. Tienen estructura y contenido distintos. El QR TicketBAI codifica datos de la firma foral; el QR VeriFactu codifica datos de la firma estatal. No son intercambiables.
¿Qué certificado digital necesito? Uno válido y admitido por la Hacienda Foral (ej. FNMT, Camerfirma, etc.) a nombre del obligado tributario (o de su representante con poder notarial). No valen certificados de dispositivo para firmar en nombre de terceros (confirmado en FAQ Gipuzkoa).
¿Tengo que enviar la factura yo manualmente? No. El software lo hace automáticamente en el momento de facturar (Gipuzkoa: simultáneo; Bizkaia/Álava: según su calendario). Tú solo facturas; el programa genera, firma, pone el QR y envía.
¿Qué pasa si mi software no está inscrito en mi territorio? Estás incumpliendo la obligación TicketBAI. La inscripción es requisito previo. Consulta el registro de tu Hacienda Foral (Gipuzkoa, Bizkaia/Batuz, Álava) o pide al fabricante el justificante de inscripción.
¿TicketBAI me exime de la factura electrónica obligatoria B2B (Ley Crea y Crece)? No. TicketBAI regula el programa; la factura electrónica B2B regula el formato e intercambio de la factura misma. Son obligaciones independientes. Ver VeriFactu vs factura electrónica.
¿Dónde confirmo mi fecha exacta de obligatoriedad? En la sede de tu Hacienda Foral: Gipuzkoa, Bizkaia/Batuz, Álava. No te fíes de calendarios genéricos: la fecha depende de tu epígrafe IAE y colectivo.
Enlaces internos relacionados
- VeriFactu en País Vasco y Navarra: qué sistema te aplica — decide tu domicilio fiscal.
- Guía completa VeriFactu para autónomos — el sistema estatal.
- Software homologado por la Agencia Tributaria — cómo se homologa en el ámbito estatal.
- Código QR en la factura VeriFactu — comparación con el QR TicketBAI.
- Sanciones VeriFactu: multas y régimen — régimen estatal (en foral rige cada Hacienda).
Fuentes oficiales (todas abiertas en esta redacción)
- Diputación Foral de Gipuzkoa — FAQ oficiales: Cuestionas generales: líneas básicas de funcionamiento · Documentación y normativa: anexos I–V, esquemas XSD, validaciones · Portal TicketBAI.
- Diputación Foral de Bizkaia (Batuz) — Documentación técnica TicketBAI (especificaciones funcionales y técnicas, XSD v1.2.2, esquemas de anulación).
- Diputación Foral de Álava — Información general TicketBAI (OF 802/2021, OF 260/2022).
- Normativa base común: Decreto Foral 32/2020 (registro de software), Orden Foral 521/2020 (especificaciones técnicas Gipuzkoa), Norma Foral 5/2020 y 8/2023 (Batuz Bizkaia), Decreto Foral 48/2021 y Decreto Normativo Urgencia Fiscal 9/2022 (Álava).
Contenido puramente informativo. No constituye asesoramiento fiscal ni legal. La normativa foral es competencia de cada Hacienda Foral y puede cambiar; confirma siempre tu fecha, tus requisitos y las especificaciones técnicas vigentes en la sede de la administración que te corresponda. Verificado el 22/10/2026.
¿No sabes si estás obligado (ni desde cuándo)?
Haz el test de 2 minutos y sabrás tu fecha exacta y qué tienes que cambiar.
Hacer el test gratis →