Software garante en Álava, Bizkaia y Gipuzkoa

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.

Lee la documentaciónGuía rápida
Entorno de test y NIF de prueba incluidos
POST /ticketbai/create
{
  "serie": "A",
  "numero": "234634",
  "fecha_expedicion": "19-11-2026",
  "tipo_operacion": "servicios",
  "importe_total": "242.00",
  …
}
200 OK · al instante
{
  "tbai": "TBAI-B05434202-021224-…",
  "estado": "Pendiente",
  "qr": "iVBORw0KGgoAAAANSUhEUgAA…"
}

Cómo funciona la API TicketBAI

  1. 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. 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. 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.

Petición · cURL
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"
  }'
Respuesta · 200
{
  "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 desarrollador

Especialistas en España

Territorio común y foral: Verifactu, TicketBAI y SII con el mismo proveedor.

Software garante en Álava, Bizkaia y Gipuzkoa

Solidez 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 AEAT

TicketBAI: 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.

TicketBAI en Álava: obligados foralesDesde 1 dic 2022
Escalonado desde el 1 de abril de 2022; el resto de contribuyentes, desde el 1 de diciembre de 2022.
En vigor
Batuz en Bizkaia (TicketBAI y LROE): todos los obligadosDesde 1 ene 2026
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.
En vigor
TicketBAI en Gipuzkoa: obligados foralesDesde 1 jun 2023
Escalonado por actividad desde el 1 de julio de 2022.
En vigor

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.

Preguntas sobre la API TicketBAI

Más preguntas sobre TicketBAI

¿Verifacti es software garante de TicketBAI?

Sí, en las haciendas forales de Álava, Bizkaia y Gipuzkoa. Tu software no necesita inscribirse.

¿Necesito una integración distinta para cada hacienda foral?

No. Hay tres TicketBAI, uno por hacienda foral, pero una sola API de Verifacti para los tres: el mismo endpoint y el mismo JSON. La hacienda de destino es la del NIF, y Verifacti genera el fichero de cada territorio y lo envía a su hacienda.

¿Necesito certificado digital para enviar a la hacienda foral?

No. Verifacti es colaborador social de la AEAT y envía con su propio certificado, una vez que el contribuyente firma el modelo de representación, el mismo para la AEAT y las haciendas forales. Se puede firmar online, sin certificado.

Si estoy en el SII, ¿tengo que cumplir con TicketBAI?

Estar en el SII no exime de TicketBAI en ninguno de los tres territorios. Qué es TicketBAI.

¿Puedo usar la misma integración si tengo clientes en territorio común?

Integras una vez la gestión de NIFs; cada NIF usa la API Verifactu o la API TicketBAI según dónde tribute, con el mismo precio.

Empieza a integrar hoy

Pruébalo gratis con el entorno de test.

Entorno de test y NIF de prueba incluidosVer precios