KubiBAI
Menú
  • Araba
  • Bizkaia
  • Gipuzkoa

API TicketBAI para tu software, sin pelearte con cada hacienda.

KubiBAI recibe tus facturas en JSON, genera y firma el XML que pide cada hacienda foral, lo envía y te devuelve el resultado con el QR. Tu TPV, ERP o dispositivo sigue siendo tuyo.

Solicitar accesoVer documentación (abre en nueva pestaña)

KubiBAI

Ejemplo de envío a Hacienda Foral · Gipuzkoa · TicketBAI

Todo en orden

  1. Factura recibida

    Tu software envía los datos a KubiBAI.

    POST /invoicing/invoices

  2. Firmada y encadenada

    Firma TicketBAI y enlace con la factura anterior, A 2026-001.

    previous_invoice_data

  3. Aceptada por TicketBAI

    La Hacienda Foral de Gipuzkoa recibe el envío.

    tbai_post_status: success

Factura A 2026-002121,00 € · Factura ordinaria

Enviada

QR TicketBAI · TBAI-B12345674-220726-···batuz.eus/QRTBAI/?id=TBAI-···

Ejemplo con datos ficticios de la documentación pública. No se conecta con ninguna administración.
empresas con TicketBai
3.000+
operaciones cada mes
150k+
operaciones procesadas
1,8M+

Cómo funciona

Una petición, una factura en TicketBAI

Envías la factura en JSON y recibes el resultado, el identificador TBAI y el QR. Pulsa cada nota para ver de dónde sale.

Ver ejemplos de facturas (abre en nueva pestaña)
POST /invoicing/invoices
X-Qbikode-ClientApiKey: •••••••• {  "sender_data": {    "sender_full_name": "Empresa Ejemplo S.L.",    "sender_id_card_number": "B12345674"  },  "recipients": [{ "full_name": "Cliente Ejemplo S.A.", … }],  "invoice_data": {    "series_code": "A",    "invoice_number": "2026-002",    "invoice_datetime": "2026-07-22 10:30:00",    "total_amount": 12100,    "concepts": [{ "description": "Servicio de consultoría", … }]  },  "previous_invoice_data": {    "series_code": "A",    "invoice_number": "2026-001",    "signature_value": "…"  }}
200 OK · modo síncrono
{  "data": {    "series_code": "A",    "invoice_number": "2026-002",    "tbai_post_status": "success",    "has_tbai_warnings": false,    "tbai_post_response_message": "Factura registrada correctamente",    "tbai_identifier": "TBAI-B12345674-220726-…",    "batuz_qr_value": "https://batuz.eus/QRTBAI/?id=TBAI-…",    "batuz_qr_image": "iVBORw0KGgo…",    "signature_value": "…",    "signed_xml_contents": "PD94bWwg…"  }}

Territorios

Tres haciendas, un mismo formato

TicketBAI no es igual en Araba, Bizkaia y Gipuzkoa. Tú envías siempre el mismo JSON y KubiBAI se ocupa de las diferencias. Esto es lo que tienes en cada una:

Araba

Diputación Foral de Álava

  • Facturas TicketBAI (disponible)Altas, anulaciones, reenvíos y consultas, con firma, encadenamiento y QR.
  • Correcciones con Zuzendu (disponible)Corrige datos de una factura ya procesada sin cambiar su importe total.
  • FacturaE para administraciones (disponible)TicketBAI y FacturaE en la misma petición, con los centros DIR3 del destinatario.
  • LROE (no disponible)El LROE es propio de Bizkaia.

En Araba no hace falta cargar la autorización de representación de cada empresa.

Bizkaia

Diputación Foral de Bizkaia · BATUZ

  • Facturas TicketBAI (disponible)Altas, anulaciones, reenvíos y consultas, con firma, encadenamiento y QR.
  • LROE: modelos 140 y 240 (disponible)Envía los XML de gastos, facturas recibidas y operaciones de bienes; KubiBAI los valida y los remite.
  • FacturaE para administraciones (disponible)TicketBAI y FacturaE en la misma petición, con los centros DIR3 del destinatario.
  • Correcciones con Zuzendu (no disponible)Zuzendu no está disponible en Bizkaia.

El LROE requiere que el intermediario sea titular de Software Garante y tenga su propio certificado.

Gipuzkoa

Diputación Foral de Gipuzkoa

  • Facturas TicketBAI (disponible)Altas, anulaciones, reenvíos y consultas, con firma, encadenamiento y QR.
  • Correcciones con Zuzendu (disponible)Corrige datos de una factura ya procesada sin cambiar su importe total.
  • FacturaE para administraciones (disponible)TicketBAI y FacturaE en la misma petición, con los centros DIR3 del destinatario.
  • LROE (no disponible)El LROE es propio de Bizkaia.

Cada empresa carga su autorización de representación desde el panel o por API, salvo que seas titular de Software Garante.

¿Primera vez con Bizkaia? BATUZ, TicketBAI y LROE (abre en nueva pestaña)explica cómo encajan. Y si dudas entre TicketBAI y VeriFactu,la comparativa TicketBAI vs VeriFactu (abre en nueva pestaña). Para ver qué envía tu software en cada caso, los ejemplos en JSON.

Modos de envío

Tú decides cuánto esperar

Con el campo async_mode eliges qué se hace en la propia petición y qué en segundo plano. En los modos asíncronos, KubiBAI avisa a tu webhook cuando termina.

Webhooks para facturas asíncronas (abre en nueva pestaña)

  • async_mode: none

    Síncrono

    Firma y envío en la misma petición. La respuesta ya trae el resultado de la hacienda, el identificador y el QR.

    1. Firma (en la petición)
    2. Envío (en la petición)
    3. Resultado (en la petición)

    Cuando quieres el resultado al momento.

  • async_mode: lite

    Firma ya, envío después

    La factura se firma al momento y te devolvemos el identificador y el QR; el envío a la hacienda va en segundo plano.

    1. Firma (en la petición)
    2. Envío (en segundo plano)
    3. Resultado (en segundo plano)

    Para un TPV que imprime el ticket sin esperar a la hacienda.

  • async_mode: full

    Todo en segundo plano

    La petición solo confirma que la factura está en cola. Firma y envío se hacen después y el resultado llega a tu webhook.

    1. Firma (en segundo plano)
    2. Envío (en segundo plano)
    3. Resultado (en segundo plano)

    Para picos de volumen o procesos por lotes.

Para quién

Un servicio web para cada caso

Si tienes un producto o un dispositivo que necesita funcionar con TicketBAI, conéctalo a KubiBAI sin hacer ninguna gestión con las haciendas.

  • Software de facturación y ERP

    Programas de gestión de nicho (consultas médicas, automoción, formación…) y ERPs que emiten facturas en Euskadi.

  • Integración de aplicaciones

    Para equipos que quieren conectar su software de facturación o punto de venta sin construir TicketBAI desde cero.

  • Integración de dispositivos

    Para fabricantes de balanzas o TPVs que necesitan conectarse con TicketBAI.

  • Soluciones a tu medida

    Si tu caso no encaja en los anteriores, cuéntanoslo: desarrollamos la integración que necesites.

Y todo lo que pide el día a día

  • Anular facturas y reenviarlas tras un fallo técnico
  • Consultar una factura, la última procesada o sus adyacentes en la cadena
  • Facturas simplificadas, rectificativas y a clientes extranjeros
  • Recargo de equivalencia y comunidades de bienes de Bizkaia
  • Alta de empresas por API, cada una con su API key
  • Firma con el certificado de Software Garante de KubiBAI o con el tuyo

Guías para integrar

Lo que se pregunta quien conecta TicketBAI a su software

Contestamos con el detalle de la API: qué enviar, qué recibes y qué pasa cuando algo falla.

  • TicketBAI para TPV

    El QR en el ticket, el envío sin frenar la caja y qué hacer cuando la hacienda no responde.

  • TicketBAI para ERP y SaaS

    Altas de empresas, autorizaciones de representación, rectificativas y lo que cambia en cada territorio.

  • Ejemplos de la API en JSON

    El JSON de cada tipo de factura: básica, simplificada, rectificativa, extranjera, FacturaE…

  • Software Garante de TicketBAI

    Apoyarte en el de KubiBAI o ser titular del tuyo, y qué cambia en autorizaciones y en el LROE de Bizkaia.

Entornos

Prueba con la hacienda de verdad antes de facturar

El mismo contrato de API en pruebas y en producción. Cuando el flujo funciona en pruebas, solo cambian la URL base y las credenciales.

¿También facturas fuera de Euskadi?

KubiFACTU conecta tu software con Veri*Factu

El mismo equipo y la misma forma de trabajar, para la AEAT. Si tus clientes facturan en varios territorios, puedes usar las dos APIs en paralelo.

Si no tienes claro cuál te toca, la guía de KubiCODETicketBAI vs VeriFactu (abre en nueva pestaña)lo explica, y cada guía de TPV y de ERP tiene su equivalente en KubiFACTU:VeriFactu para TPV (abre en nueva pestaña) yVeriFactu para ERP (abre en nueva pestaña).

Conocer KubiFACTU (abre en nueva pestaña)

Dudas habituales

Preguntas frecuentes

¿KubiBAI es un ERP?

No. Es una API intermedia: tu ERP, TPV o software de facturación sigue siendo el sistema principal.

¿Sirve para Araba, Bizkaia y Gipuzkoa?

Sí. KubiBAI se comunica con las plataformas TicketBAI de las tres haciendas forales y genera el XML que requiere cada una a partir del mismo JSON.

¿Necesito un certificado digital?

No para emitir facturas: KubiBAI las firma con su certificado de Software Garante. Si tú eres titular de Software Garante, puedes usar tu propio certificado, y es necesario para enviar gastos y facturas recibidas al LROE de Bizkaia.

¿Puedo usar KubiBAI en un TPV?

Sí. Los tickets se envían como facturas simplificadas y, con el modo asíncrono «lite», recibes el identificador TBAI y el QR al momento para imprimirlo sin esperar a la hacienda.

¿Qué cambia si soy titular de Software Garante?

Tus facturas se firman con tu certificado, no hace falta cargar autorizaciones de representación y puedes enviar al LROE de Bizkaia gastos, facturas recibidas y operaciones de bienes. Si no lo eres, no pasa nada: KubiBAI firma por ti.

¿Qué es la autorización de representación?

El documento con el que cada empresa autoriza a KubiBAI a actuar en su nombre ante la hacienda. Se carga desde el panel o por API. No hace falta en Araba ni si eres titular de Software Garante.

¿Puedo probar antes de producción?

Sí. Las facturas que envías al entorno de pruebas se remiten a los servidores de pruebas de TicketBAI, así que validas el flujo completo sin datos reales.

¿Cuánto cuesta?

Depende de tu caso. Escríbenos a soporte@kubibai.com con el tipo de software, los territorios y el volumen, y te preparamos un presupuesto.

Empieza hoy

Conecta tu software con TicketBAI

Pídenos acceso al entorno de pruebas, integra con la documentación y pasa a producción cuando todo encaje.

Solicitar accesoVer documentación (abre en nueva pestaña)

¿Dudas antes de empezar? soporte@kubibai.com