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?

¿Por qué existen dos APIs diferentes para integrar con Verifactu y con TicketBAI?
Hemos decidido diseñar dos APIs diferenciadas, una para Verifactu y otra para TicketBAI, siguiendo en gran medida la estructura de las APIs oficiales de las administraciones.
Esto aporta varias ventajas:
  • 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.
¿Qué implica esto a la hora de integrar?
Es necesario integrar con dos APIs diferentes.
Sin embargo, en la práctica, tras integrar con Verifactu, la integración posterior con TicketBAI suele requerir solo un 10%-20% adicional de esfuerzo. Esto se debe a que varias llamadas coinciden y, cuando no lo hacen, mantienen una estructura muy similar.
Por ejemplo, al crear una factura será necesario contar con dos JSON diferentes, utilizando uno u otro según la API de destino.
Lo que sí es común es la API de gestión de NIFs (alta de NIFs, modelo de representación y webhooks): se integra una vez y vale para las dos APIs.

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?

Para cumplir con TicketBAI, el software que envía los registros de facturación debe estar inscrito en el listado oficial de Software Garante. Es decir, si un software usa Verifacti para integrarse con las Haciendas Forales, Verifacti sí debe ser software garante (y lo es), pero el software que usa Verifacti no es necesario que sea software garante.
Aunque la ley en sí no exige explícitamente que se utilice un software registrado, en la práctica es indispensable. Los archivos XML generados deben incluir datos identificativos del software conforme a su registro: nombre, versión, entidad desarrolladora y número de licencia TicketBAI. Este último se obtiene al completar el proceso de registro.
Verifacti ya ha pasado por este proceso y es software garante. El proceso de registro en el País Vasco requiere que la empresa que va a enviar los registros (Verifacti) presente una memoria técnica que acredite el cumplimiento de los requisitos de TicketBAI. Asimismo, se debe entregar una declaración responsable que confirme el cumplimiento normativo y asuma compromisos ante posibles modificaciones legales que afecten al sistema.
Puedes consultar los listados oficiales en los siguientes enlaces, en los que aparece Verifacti como software garante (Bilbabit SL):

¿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 y envío conforme a TicketBAI
Para cumplir con la normativa TicketBAI, el sistema de facturación debe generar un fichero XML por cada transacción, firmarlo digitalmente y remitirlo a la Hacienda Foral correspondiente. Nuestra API se encarga de todo: genera el XML con los datos de tu llamada, lo encadena criptográficamente con el anterior, lo firma conforme a la normativa y lo remite a la Hacienda Foral de Álava, Bizkaia o Gipuzkoa según corresponda.
No necesitas aportar ni registrar ningún certificado
Verifacti firma y envía los ficheros TicketBAI con su propio certificado electrónico cualificado, actuando como tercero que emite en nombre del contribuyente (los XML se remiten marcados como emitidos por tercero).
El único trámite: el modelo de representación
Igual que en Verifactu, antes de enviar la primera factura al entorno de producción el titular del NIF debe firmar un modelo de otorgamiento de representación que faculta a Verifacti a remitir información fiscal en su nombre. Es el mismo documento para las cuatro administraciones (AEAT, Álava, Bizkaia y Gipuzkoa) y solo se gestiona una vez por NIF: una firma completada desde un NIF de test vale también para el mismo NIF en producción.
Puede firmarse de dos maneras:
  1. 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.
  2. 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.
En ambos casos puedes gestionarlo desde la interfaz web de Verifacti (Configuración → Representación de cada NIF) o programáticamente a través de la API de gestión de NIFs.
IMPORTANTE: hasta que el estado de la representación no sea Correcto, el NIF no puede enviar facturas al entorno de producción.
Tienes más detalle sobre certificados y modelos de representación en esta pregunta frecuente.

Pruebas y precio

2 preguntas

¿Puedo probar TicketBAI con la cuenta gratuita?

Sí. La cuenta gratuita incluye el entorno de test de TicketBAI, así que puedes hacer la integración sin coste. Para el NIF de test de la hacienda foral, escribe a soporte@verifacti.com. Para enviar facturas de NIFs reales a la hacienda foral necesitas una suscripción de pago.

¿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.

En Bizkaia, ¿la API presenta el LROE de Batuz?

Sí, para las facturas emitidas: envía cada una al LROE (modelo 140 para personas físicas y modelo 240 para personas jurídicas), con alta y anulación. No envía gastos ni facturas recibidas. Más en Batuz y LROE.

Empieza a integrar hoy

Pruébalo gratis con el entorno de test.

Entorno de test y NIF de prueba incluidosVer precios