Preguntas frecuentes de la API TicketBAI
Respuestas sobre cómo cumplir TicketBAI en Álava, Bizkaia y Gipuzkoa con la API TicketBAI de Verifacti: software garante, integración, pruebas, envío a cada hacienda foral, correcciones y Batuz. Lo que dice la norma de cada territorio está en la página de TicketBAI.
Integración
2 preguntas
¿Debo realizar una nueva integración para TicketBAI o es una misma integración para TicketBAI y Verifactu?
- Consistencia: los endpoints, campos y mensajes de error que presentamos a nuestros usuarios son prácticamente los mismos que en las APIs de las administraciones.
- Facilidad en consultas fiscales: esta similitud elimina interpretaciones o sesgos derivados de una API intermedia, lo que agiliza la comunicación con asesores y con las propias administraciones.
Si estoy en el SII, ¿tengo que cumplir TicketBAI?
Estar en el SII no exime de TicketBAI en ninguno de los tres territorios: son obligaciones distintas. Qué obliga a cada contribuyente y desde cuándo está en la página de TicketBAI.
Software garante y representación
3 preguntas
¿Si utilizo la API de TicketBAI debo convertirme en software garante?
¿Es Verifacti software garante en los tres territorios?
Sí. Verifacti está inscrito como software garante en las haciendas forales de Álava, Bizkaia y Gipuzkoa. La inscripción es un registro, no una homologación: ninguna hacienda homologa ni certifica software. Detalle por territorio en TicketBAI en Álava, TicketBAI en Bizkaia y TicketBAI en Gipuzkoa.
¿Cómo se gestionan los certificados y la representación con TicketBAI?
- Firma online (solo personas físicas / autónomos): el titular del NIF verifica su identidad por vídeo y firma desde el navegador, sin necesidad de certificado digital. Tiene un coste de 2,90 € + IVA por proceso de firma. Puedes ver el proceso paso a paso en la guía Firma online del modelo de representación.
- Firma con certificado digital (personas físicas y jurídicas): se descarga el PDF ya cumplimentado, se firma con el certificado digital del NIF emisor y se sube a Verifacti. Es gratuito.
Pruebas y precio
2 preguntas
¿Puedo probar TicketBAI con la cuenta gratuita?
¿El precio incluye TicketBAI?
Sí. TicketBAI tiene el mismo precio que Verifactu, por NIF activo en producción: cada NIF usa la API TicketBAI o la API Verifactu según dónde tribute, sin coste adicional. Un NIF dado de alta en dos haciendas cuenta como dos NIFs. Tarifas en precios y más detalle en ¿Los precios incluyen TicketBAI?.
Envío y correcciones por territorio
4 preguntas
¿A qué hacienda envía la API cada factura?
A la del NIF emisor. Al dar de alta un NIF eliges la hacienda a la que se vincula (alava, vizcaya o guipuzcoa), y la API TicketBAI envía sus facturas a esa hacienda foral. El endpoint es el mismo en los tres territorios. Un mismo NIF puede darse de alta en varias haciendas, cada una con su propia API key (ver la documentación de la API de gestión de NIFs).
¿La respuesta trae el QR y el código TicketBAI?
Sí, al instante. La respuesta de POST /ticketbai/create incluye el QR en Base64 (qr), su URL (url) y el código TicketBAI (tbai), que van impresos en la factura. Campos completos en la documentación.
¿Puedo subsanar una factura rechazada?
En Álava y Gipuzkoa, sí: con la acción SUBSANAR de PUT /ticketbai/modify. En Bizkaia, no: la API no ofrece modificación ni subsanación, pero sí anulación con /ticketbai/cancel. Ejemplos en subsanación y anulación.
Empieza a integrar hoy
Pruébalo gratis con el entorno de test.