Software garante TicketBAI en Gipuzkoa, por API
La API TicketBAI de Verifacti conecta tu software de facturación con la Hacienda Foral de Gipuzkoa: envías cada factura en JSON, recibes al instante el QR y el código TicketBAI, y Verifacti genera, encadena y envía el fichero TicketBAI. Verifacti es software garante de TicketBAI en Álava, Bizkaia y Gipuzkoa, con el mismo endpoint para 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 en Gipuzkoa
- 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.
- 2
Recibes el QR y el código TicketBAI
Al instante, para imprimirlos en la factura.
- 3
Verifacti envía el fichero a la Hacienda Foral de Gipuzkoa
Lo genera, lo encadena y lo envía en segundo plano.
El resultado te llega por webhook o consultando el estado del registro.
Ejemplo: crear una factura TicketBAI para Gipuzkoa
Es el mismo endpoint para los tres territorios: la hacienda de destino sale del NIF. En Gipuzkoa, direccion y cp del cliente son obligatorios, salvo en facturas simplificadas.
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": "20001",
"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 en Gipuzkoa
Software garante en Gipuzkoa
Verifacti es software garante aquí y en los otros dos territorios. El software que llama a la API no necesita inscribirse en el registro de software garante.
Envío a la Hacienda Foral de Gipuzkoa
Cada factura, con el QR y el código TicketBAI al instante en la respuesta.
Rectificativas, anulación y subsanación
Rectificativas (R1–R5) con
/ticketbai/create; modificación y subsanación de ficheros rechazados con/ticketbai/modify, y anulación con/ticketbai/cancel.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.
Sin certificado digital
El titular firma una vez el modelo de representación, también online.
El mismo endpoint para los tres territorios
Cada NIF tiene asignada su hacienda al darlo de alta; la llamada a
/ticketbai/createes igual en Álava, Bizkaia y Gipuzkoa.
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 cliente 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 en Gipuzkoa
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 en Gipuzkoa: fechas y fuente oficial
En Gipuzkoa, TicketBAI lo regula el Decreto Foral 32/2020 y su implantación se completó el 1 de junio de 2023.
| Quién | Fecha | Estado | Norma |
|---|---|---|---|
| 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.
- 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 TicketBAI en Gipuzkoa
Más preguntas sobre TicketBAI¿Verifacti es software garante de TicketBAI en Gipuzkoa?
¿Mi software tiene que inscribirse como software garante?
¿Puedo subsanar una factura rechazada?
/ticketbai/modify: accion SUBSANAR si el fichero fue rechazado y MODIFICAR si se aceptó con errores.¿Necesito certificado digital?
¿Cuánto cuesta?
Sigue leyendo
Empieza a integrar hoy
Pruébalo gratis con el entorno de test.