API de integración: envía las ventas de tu programa a TicketBAI y a Vectura
Tu software —un TPV de otra marca, un kiosko, una tienda online, un ERP o el programa de un hotel— manda cada venta a Vectura con una llamada JSON. Vectura emite el ticket o la factura, la firma con TicketBAI o Veri*Factu, la envía a Hacienda y te devuelve el QR para imprimirlo. Sin librerías, sin instalar nada y con una clave por programa.
Cuenta de demostración
Datos ficticios, sin envíos a Hacienda ni por correo. Se restablece cada noche.
{
"seriefactura": "KIOSKO1",
"numfactura": "105",
"fechaexpedicionfactura": "2026-11-06",
"importetotalfactura": "3,50",
"baseimponible": "2,89",
"tipoimpositivo": "21",
"cuotaimpuesto": "0,61"
}
{
"error": "0",
"leyenda": "TicketBAI",
"fiscal_estado": "aceptado",
"qr_url": "https://batuz.eus/QRTBAI/?id=…"
}
Integrar es así de sencillo
Genera una clave
En tu zona de usuario, en Configuración → API e integraciones, creas una clave para cada programa. Se puede eliminar en cualquier momento.
Envía la venta
Tu programa hace un POST con el JSON de la venta. Sin NIF sale un ticket simplificado; con NIF, una factura completa.
Imprime el QR
Vectura firma y envía a Hacienda, y responde con el QR y la leyenda para imprimirlos en el ticket.
Qué incluye
Una llamada por venta
Tu programa envía un JSON con el NIF (opcional), el importe y el IVA. Sin NIF se emite un ticket simplificado; con NIF, una factura completa a ese cliente.
Firma y envío a Hacienda
Vectura firma con tu certificado y envía a la Hacienda Foral (TicketBAI en Bizkaia, Gipuzkoa y Álava) o a la Agencia Tributaria (Veri*Factu en el resto de España).
El QR, listo para imprimir
La respuesta trae la dirección del QR y su leyenda (TicketBAI o VERI*FACTU), y puedes pedirle a Vectura la imagen del QR.
Reintentos seguros y tu numeración
Respetamos la serie y el número de tu programa. Si repites una venta con la misma serie y número, Vectura devuelve la original sin crear otra: un corte de red nunca duplica una factura.
Anular, consultar y rectificar
Anula un ticket, consulta el estado fiscal de una venta o corrige una factura con una rectificativa, todo por la misma API.
Facturas completas, cobros y presupuestos
Con líneas, varios tipos de IVA, cliente, cobro y envío del PDF por correo; facturas pendientes de cobro, presupuestos y consulta de documentos.
Para programas que solo dejan archivos
Si tu software no sabe hacer llamadas web, un script de PowerShell sube solo los archivos JSON de una carpeta y escribe la respuesta con el QR. Sin programar.
Manual y claves en tu zona de usuario
Genera una clave por programa y consulta el manual de la API, con ejemplos en curl, PHP, C#, JavaScript y Python y la lista de errores.
Preguntas frecuentes
¿Qué necesito para empezar?
Una cuenta de Vectura Suite y los datos fiscales de tu empresa. Para firmar de verdad hace falta tu certificado electrónico (y, con TicketBAI, la licencia de software, que configura nuestro soporte). Mientras ensayas, la empresa está en modo pruebas.
¿Funciona con TicketBAI y con Veri*Factu?
Sí. Según el régimen de tu empresa, Vectura firma con TicketBAI (Bizkaia, Gipuzkoa y Álava) o genera el registro de Veri*Factu; el programa que llama no tiene que distinguirlos.
¿Puedo probar sin enviar nada a Hacienda?
Sí. Mientras la empresa está en modo pruebas, todo se firma y se envía al entorno de pruebas de Hacienda y los QR no tienen validez legal. Cuando todo funciona, se pasa a real.
¿Qué pasa si se corta la conexión a mitad de una venta?
Reintentas con la misma serie y número (o la misma referencia): Vectura devuelve la venta original sin duplicarla.
¿Hay un límite de llamadas?
Sí: 120 peticiones por minuto, de sobra para un comercio. Si te pasas, la API responde 429 y reintentas pasado un momento.
¿Dónde está la documentación?
Dentro de Vectura Suite, en tu zona de usuario: Ayuda → Manual de la API. Incluye una guía de inicio, cada punto de la API con ejemplos en curl, PHP, C#, JavaScript y Python, y la lista de errores. Puedes verla con la prueba gratuita.
¿Quién ve mi clave?
Nadie: se muestra una sola vez al crearla y Vectura solo guarda una huella. Si la pierdes, la eliminas y creas otra; eliminar una clave no afecta a las demás.
¿Puedo conectar el programa de un hotel?
Sí: además de las ventas, hay puntos de la API para habitaciones ocupadas y cargos a habitación, que el programa del hotel consulta y liquida.
¿Lo probamos con tu negocio?
Crea tu cuenta y pruébalo con tus propios datos, sin tarjeta y sin compromiso.