Info > Cómo funciona
API REST · TICKETBAI · BATUZ · VERIFACTU

Cómo funciona Ticketbai WS

Tu aplicación envía los datos de la factura; Ticketbai WS la firma, la encadena y la envía a tu Hacienda, y te devuelve al momento la huella y el código QR para imprimir.

Funciona con las tres Haciendas forales (Araba, Bizkaia/Batuz y Gipuzkoa) y con la Agencia Tributaria (Verifactu), sin certificados en tu servidor y sin cambiar tu programa de facturación.

PeticiónPOST /tbai/
CabecerasToken · Nif
Respuestaresult: OK
huella · QR · URL de cotejoListos para imprimir en la factura o el ticket
01 / Esquema

De tu aplicación a Hacienda

Ticketbai WS es un servicio web intermediario entre tu software de facturación y la Hacienda que te corresponde.

Tu aplicación

Tienda online, TPV o ERP

Envía los datos de cada factura en JSON.

Ticketbai WS

Firma, encadena y envía

Genera el fichero, lo firma con nuestro certificado y lo envía.

Hacienda

Araba, Bizkaia, Gipuzkoa o AEAT

Recibe la factura por TicketBAI, Batuz o Verifactu.

02 / Paso a paso

Qué pasa con cada factura

Tu aplicación solo hace una petición por factura. Del resto se encarga Ticketbai WS.

La API responde al momento y el envío a Hacienda se hace en segundo plano, así tu tienda o tu TPV nunca esperan a los servidores de Hacienda.

01

Envías la factura

Una petición REST con los datos de la factura y las cabeceras Token y Nif de la empresa.

02

Validamos, firmamos y encadenamos

Comprobamos los datos, generamos el fichero de TicketBAI o el registro de Verifactu, lo firmamos y lo encadenamos con la factura anterior.

03

Recibes la huella y el QR

Al momento, con la URL de cotejo, para imprimirlos en la factura o el ticket.

04

Hacienda confirma

Enviamos la factura a la Hacienda que corresponde según la empresa y, si tienes un webhook, te avisamos del resultado. Si Hacienda no responde, la reenviamos automáticamente.

03 / Conexión

Cómo conectar tu negocio

Sin programar

Shopify y WooCommerce

Con la app de Shopify (también para Shopify POS) o el plugin de WooCommerce, cada pedido se factura automáticamente. Se configura en minutos desde el panel.

ShopifyShopify POSWooCommerce
Para desarrolladores

API REST

Para cualquier otro programa, TPV o ERP. Una petición por factura, con documentación, especificación OpenAPI, ejemplos listos para copiar y una terminal para probar sin cuenta.

REST + JSONOpenAPIWebhooksMCP
04 / Incluido

Lo que Ticketbai WS hace por ti

Sin certificados en tu servidor

Firmamos con nuestro certificado. Tú solo nos autorizas una vez ante tu Hacienda.

Software garante inscrito

En los registros de Araba, Bizkaia y Gipuzkoa, con la declaración responsable de Verifactu: no tienes que certificar tu programa.

Entorno de pruebas gratuito

Cada empresa tiene pruebas y producción. Para pasar a producción solo cambian la URL y el token.

Cola y reintentos

Si Hacienda no responde, tus facturas no se pierden: se envían en cuanto vuelve.

Rectificativas y subsanaciones

Rectificativas, devoluciones, subsanaciones (zuzendu) y anulaciones con la misma API.

Trazabilidad

Log de cada envío con el XML y la respuesta de Hacienda en tu área privada.

Empieza a enviar facturas

Prueba gratis en el entorno de pruebas. Si no tienes quien programe la integración, escríbenos: en Berein desarrollamos aplicaciones web y podemos ayudarte.