API TicketBAI para tu software de facturación
La API TicketBAI de Verifacti conecta tu software de facturación con las haciendas forales de Álava, Bizkaia y Gipuzkoa: envías cada factura en JSON, Verifacti genera, firma y encadena el fichero TicketBAI y te devuelve al instante el QR y el código TicketBAI para imprimirlos en la factura, y después envía el fichero a la hacienda foral. Verifacti es software garante de TicketBAI en los tres territorios.
Entorno de test y NIF de prueba incluidos{
"serie": "A",
"numero": "234634",
"fecha_expedicion": "19-11-2026",
"tipo_operacion": "servicios",
"importe_total": "242.00",
…
}{
"tbai": "TBAI-B05434202-021224-…",
"estado": "Pendiente",
"qr": "iVBORw0KGgoAAAANSUhEUgAA…"
}Cómo funciona la API TicketBAI
- 1
Envías la factura en JSON
Tu software llama a la API con los datos de la factura y la API key del NIF emisor. Es el mismo endpoint para los tres territorios.
- 2
Verifacti genera el fichero y te devuelve el QR
Generamos el fichero TicketBAI, lo firmamos y lo encadenamos. El código TicketBAI y el QR salen de ese fichero firmado: la respuesta los trae al instante, en Base64, para imprimirlos en la factura.
- 3
Verifacti envía el fichero a la hacienda foral
Enviamos el fichero, en segundo plano, a la hacienda foral que corresponde a cada NIF; en Bizkaia, dentro del LROE de Batuz.
El resultado te llega por webhook o consultando el estado del registro.
Ejemplo: crear una factura con la API TicketBAI
Una factura contra el entorno de test.
curl -X POST https://api.verifacti.com/ticketbai/create \
-H "Authorization: Bearer $VERIFACTI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"serie": "A",
"numero": "234634",
"fecha_expedicion": "19-11-2026",
"simplificada": false,
"nif": "A15022510",
"nombre": "Empresa de ejemplo SL",
"direccion": "Calle Mayor 15",
"cp": "48992",
"descripcion": "Descripción de la factura",
"tipo_operacion": "servicios",
"lineas": [{
"descripcion": "Línea 1",
"cantidad": "2",
"importe_unitario": "100.00",
"importe_total": "242.00"
}],
"desglose_iva": [{
"base_imponible": "200",
"tipo_impositivo": "21",
"cuota_impuesto": "42"
}],
"importe_total": "242.00"
}'{
"uuid": "ea6eae92-bac6-48c3-baa4-2bbf6b5ee562",
"tbai": "TBAI-B05434202-021224-mwUG7NRo2ZNxp-010",
"estado": "Pendiente",
"url": "https://…/qrtbai/?id=TBAI-B05434202-021224-…",
"qr": "iVBORw0KGgoAAAANSUhEUgAA…"
}Qué incluye la API TicketBAI
Software garante en los tres territorios
Verifacti está inscrito como software garante en Álava, Bizkaia y Gipuzkoa. El software que llama a la API no necesita inscribirse.
Validación antes de enviar
Cada factura se valida antes de enviarla y, si hay un error, vuelve con un código (catálogo de códigos). Por defecto comprobamos también que el NIF del cliente esté identificado en la AEAT, porque si no la hacienda foral rechaza el envío.
QR y código TicketBAI al instante
En la respuesta, listos para imprimir en la factura.
Rectificativas, anulación y subsanación
Rectificativas (R1–R5) con el mismo endpoint de creación y anulación con
/ticketbai/cancel. La modificación y la subsanación de ficheros rechazados (/ticketbai/modify) solo existen en Álava y Gipuzkoa.Consulta, listado y exportación
Estado de cada factura, listados, exportación y descarga del XML (
/status,/list,/export,/downloadXML).Bizkaia: envío al LROE de Batuz
En Bizkaia, cada factura emitida se registra en el LROE: modelo 140 para personas físicas con actividad económica y modelo 240 para entidades, con alta y anulación. TicketBAI en Bizkaia.
Sin certificado digital
El mismo modelo de representación vale para la AEAT y las tres haciendas forales, y se puede firmar online.
Tus datos, en la UE y exportables
Los datos se alojan en la Unión Europea y puedes exportar las facturas cuando quieras. El SLA está en los términos de uso.
Una integración por normativa sobre la API de gestión de NIFs
Integras una vez la API de gestión de NIFs: alta, activación y baja de NIFs, representación y webhooks. Cada normativa añade su propia integración de envío, pegada a la API de la administración de destino. Si un NIF tributa en territorio común, usa la API Verifactu con la misma gestión de NIFs y el mismo precio.
Por qué Verifacti para TicketBAI
Pensado para quien integra
Documentación pública con ejemplos por llamada, guía rápida, colecciones Postman, llms.txt y cuenta gratuita con entorno de test.
Integración habitual: de uno a tres días de un desarrolladorEspecialistas en España
Territorio común y foral: Verifactu, TicketBAI y SII con el mismo proveedor.
Software garante en Álava, Bizkaia y GipuzkoaSolidez demostrable
Cientos de empresas y fabricantes de software en producción con Verifacti. Datos alojados en la UE y SLA en los términos de uso.
Colaborador social de la AEATTicketBAI: territorios, fechas y a quién aplica
TicketBAI es el sistema de las haciendas forales de Álava, Bizkaia y Gipuzkoa para controlar la facturación. Sustituye a Verifactu en esos territorios, y estar en el SII no exime de él.
| Quién | Fecha | Estado | Norma |
|---|---|---|---|
| TicketBAI en Álava: obligados forales Escalonado desde el 1 de abril de 2022; el resto de contribuyentes, desde el 1 de diciembre de 2022. | Desde 1 dic 2022 | En vigor | NF 13/2021 y DF 48/2021 · FAQ 1.9 · calendario |
| Batuz en Bizkaia (TicketBAI y LROE): todos los obligados Sociedades que no son pymes, desde el 1 de enero de 2024; el resto, en ventanas el 1 de julio de 2024, el 1 de enero de 2025, el 1 de julio de 2025 y el 1 de enero de 2026. | Desde 1 ene 2026 | En vigor | NF 8/2023 · Batuz |
| TicketBAI en Gipuzkoa: obligados forales Escalonado por actividad desde el 1 de julio de 2022. | Desde 1 jun 2023 | En vigor | NF 3/2020 · DF 32/2020 |
Esta información no es asesoramiento: cada contribuyente determina lo que le aplica con su asesor.
Precio de la API TicketBAI
Desde
14,99 €
/mes por NIF activo en producción, sin IVA
Ver todos los precios- El precio por NIF baja con cada tramo de NIFs.
- Hasta 3.000 registros de facturación al mes por NIF.
- Firma online del modelo de representación: 2,90 € + IVA.
- Entorno de test y NIF de prueba gratuitos.
- Plan anual con un 10 % de descuento, sin costes de instalación.
- El mismo precio que la API Verifactu: cada NIF usa una u otra según dónde tribute.
- Plan Startup para empresas de menos de 12 meses, con menos de 100.000 € de facturación y menos de 200.000 € de financiación.
Todo lo que necesitas para integrar TicketBAI
Preguntas sobre la API TicketBAI
Más preguntas sobre TicketBAI¿Verifacti es software garante de TicketBAI?
¿Necesito una integración distinta para cada hacienda foral?
¿Necesito certificado digital para enviar a la hacienda foral?
Si estoy en el SII, ¿tengo que cumplir con TicketBAI?
¿Puedo usar la misma integración si tengo clientes en territorio común?
Sigue leyendo
Empieza a integrar hoy
Pruébalo gratis con el entorno de test.