Preguntas frecuentes sobre TicketBAI, Verifactu y la API

Porque por defecto la API responde al momento y envía la factura a Hacienda en segundo plano: los servidores de las Haciendas tienen tiempos de respuesta muy variables. La respuesta inicial puede ser PENDING; en unos segundos (casi siempre menos de un minuto) la factura pasa a OK o ERROR. Si Hacienda no responde, Ticketbai WS reintenta el envío automáticamente.

Para conocer el resultado final, usa webhooks (recomendado) o consulta la factura. Si incluyes "sincrono": true, la respuesta espera a Hacienda; es útil durante la integración, pero en ese caso no hay reintentos automáticos.

El QR, la huella y la URL que devuelve la API son válidos desde el primer momento, porque se calculan al generar el fichero. Mientras el envío está pendiente, la URL de cotejo indica que la factura está pendiente de envío.

Con un webhook te avisamos cuando una factura pasa de pendiente a OK o ERROR (puedes recibir solo los errores con solo_errores). También puedes consultarla con GET /tbai/ o verla en el log del área privada.

Con un webhook te avisamos cuando una factura pasa de pendiente a OK o ERROR (puedes recibir solo los errores con solo_errores). También puedes consultarla con GET /tbai/ o verla en el log del área privada.

Sí, en parte. La API valida el formato y la coherencia de los datos (NIF, fechas, importes, tipos de IVA, código postal…) y devuelve los errores en msg antes de enviar nada. La exactitud fiscal de los datos es responsabilidad del emisor de la factura. Puedes ver estas validaciones en la terminal de pruebas.

Depende de qué haya pasado:

• Hacienda la ha rechazado: corrígela con una subsanación (zuzendu), sin cambiar la serie, el número ni el importe total.
• Hacienda la ha aceptado y hay que cambiar importes o datos: emite una factura rectificativa (por diferencias o por sustitución).
• No debía haberse emitido: anúlala con el método DELETE /tbai/.

En ejemplos tienes el JSON de rectificativas, devoluciones, subsanaciones y anulaciones.

Vuelve a enviar el JSON de la factura con los datos corregidos y el parámetro "zuzendu": true (o "subsanar": true). La factura original tiene que haberse enviado antes; si no, la API devuelve un error.

No se pueden cambiar la serie, el número ni el importe total: para eso emite una rectificativa o anula la factura. En Bizkaia la subsanación se aplica a facturas rechazadas por Batuz, se envía por el subcapítulo 1.2 del LROE y conserva la huella y el QR originales. Para cambiar una factura ya aceptada, emite una rectificativa.

Sí, 1.000 líneas por factura. Si necesitas más, divide la factura o agrupa líneas. En Verifactu y en Bizkaia no hace falta enviar el detalle de cada línea, pero sí las bases imponibles.

De forma automática, tanto en TicketBAI como en Verifactu. Solo envías los datos de la factura; Ticketbai WS calcula la huella, la encadena con la anterior y la envía.

Sí. En el área privada tienes un log de las peticiones a la API y otro de los envíos a Hacienda, con el XML generado y la respuesta de la Hacienda, para seguir cada factura y resolver incidencias. Los mismos datos están disponibles por API (consulta y listado de facturas).

Sí, para proteger el servicio hay un límite de peticiones por NIF y por IP. Si lo superas, la API responde HTTP 429: espera antes de reintentar y aumenta la espera en cada intento. Para conocer el estado de las facturas usa webhooks en lugar de consultar en bucle.

Sí, para proteger el servicio hay un límite de peticiones por NIF y por IP. Si lo superas, la API responde HTTP 429: espera antes de reintentar y aumenta la espera en cada intento. Para conocer el estado de las facturas usa webhooks en lugar de consultar en bucle.

Tus facturas no se pierden: la API las acepta, devuelve la huella y el QR, y las envía en cuanto la Hacienda vuelve a responder. Puedes ver en tiempo real cómo responden nuestra API y cada Hacienda en el estado del servicio.

Tus facturas no se pierden: la API las acepta, devuelve la huella y el QR, y las envía en cuanto la Hacienda vuelve a responder. Puedes ver en tiempo real cómo responden nuestra API y cada Hacienda en el estado del servicio.

No. Ticketbai WS genera, firma y envía los ficheros; tu aplicación solo hace peticiones HTTPS con las cabeceras Token y Nif. La única gestión es autorizarnos ante tu Hacienda (ver ¿Cómo se firman los envíos?).

No. Ticketbai WS genera, firma y envía los ficheros; tu aplicación solo hace peticiones HTTPS con las cabeceras Token y Nif. La única gestión es autorizarnos ante tu Hacienda (ver ¿Cómo se firman los envíos?).

Sí. La especificación OpenAPI 3.1 describe todos los métodos y sirve para generar clientes en cualquier lenguaje. Cada página de la documentación tiene ejemplos en cURL, PHP, Python, C++ y Java, y en ejemplos hay 22 casos de facturas listos para copiar.

Sí. La especificación OpenAPI 3.1 describe todos los métodos y sirve para generar clientes en cualquier lenguaje. Cada página de la documentación tiene ejemplos en cURL, PHP, Python, C++ y Java, y en ejemplos hay 22 casos de facturas listos para copiar.

Sí, con nuestro servidor MCP: cada método de la API es una herramienta que el asistente puede usar para emitir, consultar o anular facturas. Se autentica con el token y el NIF de la empresa, igual que la API. Empieza en el entorno de pruebas.

Sí, con nuestro servidor MCP: cada método de la API es una herramienta que el asistente puede usar para emitir, consultar o anular facturas. Se autentica con el token y el NIF de la empresa, igual que la API. Empieza en el entorno de pruebas.

La norma general es enviar cada factura al expedirla, pero cada territorio tiene su plazo y Ticketbai WS aplica estos límites a la fecha de la factura:

• Araba: facturas de las últimas 24 horas. La Diputación exige el envío simultáneo a la expedición (art. 9, BOTHA).
• Gipuzkoa: facturas de los últimos 7 días, aunque la norma también pide el envío simultáneo (art. 9, BOG).
• Bizkaia: hasta el 25 del mes siguiente al trimestre (25 de abril, 25 de julio, 25 de octubre y 31 de enero). Las grandes empresas, los grupos de IVA y quienes están en el registro de devolución mensual tienen 4 días (Batuz).

Si tu TPV se queda sin conexión, envía las facturas en cuanto vuelva, dentro de estos plazos.

Según el Real Decreto-ley 15/2025, el 1 de enero de 2027 para las empresas que tributan en el Impuesto sobre Sociedades y el 1 de julio de 2027 para el resto, incluidos los autónomos. El 5 de octubre de 2026 Hacienda anunció un nuevo aplazamiento a octubre de 2028, que aún no se ha publicado en el BOE. Mantenemos las fechas al día en qué es Verifactu.

No. Si tributas en Araba, Bizkaia o Gipuzkoa tu sistema es TicketBAI (en Bizkaia, dentro de Batuz). Verifactu es para quien tributa en territorio común. Con Ticketbai WS da igual: la misma integración envía a la Hacienda que corresponda a cada empresa.

Sí. El método es el mismo (POST /tbai/, también disponible como /verifactu/) y los datos de la factura también. Según la Hacienda configurada en la empresa, Ticketbai WS genera el registro de TicketBAI o el de Verifactu y devuelve la huella y el QR correspondientes.

Firmar el documento de representación para que Ticketbai WS presente los registros en tu nombre ante la AEAT. Puedes descargarlo y subirlo firmado desde el área privada o por API (métodos de documento de representación). También puedes usar tu propio certificado.

Porque, como en TicketBAI, el envío a la AEAT se hace en segundo plano: la factura queda aceptada con su huella y su QR y pasa a OK o ERROR en cuanto responde la AEAT. Usa webhooks para enterarte, o "sincrono": true si necesitas la respuesta en la misma petición.

Verifactu es el sistema de facturación verificable de la Agencia Tributaria para las empresas y autónomos que tributan en territorio común. Funciona de forma parecida a TicketBAI: cada factura genera un registro firmado y encadenado y lleva un código QR. Quien tributa en Araba, Bizkaia o Gipuzkoa usa TicketBAI; el resto, Verifactu.

Ticketbai WS ya envía a Verifactu con la misma API que a TicketBAI. Tienes los plazos y las diferencias en qué es Verifactu.

Según el Real Decreto-ley 15/2025, el 1 de enero de 2027 para las empresas que tributan en el Impuesto sobre Sociedades y el 1 de julio de 2027 para el resto, incluidos los autónomos. El 5 de octubre de 2026 Hacienda anunció un nuevo aplazamiento a octubre de 2028, que aún no se ha publicado en el BOE. Mantenemos las fechas al día en qué es Verifactu.

No. Si tributas en Araba, Bizkaia o Gipuzkoa tu sistema es TicketBAI (en Bizkaia, dentro de Batuz). Verifactu es para quien tributa en territorio común. Con Ticketbai WS da igual: la misma integración envía a la Hacienda que corresponda a cada empresa.

Sí. El método es el mismo (POST /tbai/, también disponible como /verifactu/) y los datos de la factura también. Según la Hacienda configurada en la empresa, Ticketbai WS genera el registro de TicketBAI o el de Verifactu y devuelve la huella y el QR correspondientes.

Firmar el documento de representación para que Ticketbai WS presente los registros en tu nombre ante la AEAT. Puedes descargarlo y subirlo firmado desde el área privada o por API (métodos de documento de representación). También puedes usar tu propio certificado.

Porque, como en TicketBAI, el envío a la AEAT se hace en segundo plano: la factura queda aceptada con su huella y su QR y pasa a OK o ERROR en cuanto responde la AEAT. Usa webhooks para enterarte, o "sincrono": true si necesitas la respuesta en la misma petición.