API sencilla y robusta para cumplir con los requisitos legales y técnicos de Verifactu

Verifacti es una solución diseñada para desarrolladores y equipos técnicos que necesitan adaptar su software a los requisitos fiscales establecidos por la Agencia Tributaria (Veri*Factu) y/o las Haciendas Forales Vascas (Ticketbai). Verifacti es la solución ideal para:1. Comercializadores y distribuidores de software de facturaciónCualquier proveedor de software que contenga funcionalidad de facturación deberá asegurar el cumplimiento de los requisitos de Veri*Factu y Ticketbai. Entre los softwares sujetos a cumplimiento hay ERPs, CRMs, softwares de facturación, softwares de tipo SAAS, y en general cualquier software que incluya entre sus funcionalidades la emisión de facturas.2. Empresas o autónomos con sistemas informáticos de facturación propios.Veri*Factu será obligatorio también para obligados tributarios que usen un software propio para la emisión de facturas.

Sí. Puedes crear una cuenta en segundos y acceder a una empresa de prueba desde la cual puedes hacer ya mismo llamadas de prueba al entorno de test de la administración. Podrás hacer parte o incluso toda tu integración desde nuestra cuenta gratuita.

Sí. Desde Verifacti también te ayudamos a cumplir con Ticketbai. Con muy poco trabajo de integración extra podrás cumplir con los requisitos de cualquiera de las haciendas forales del País Vasco. API para Ticketbai aquí.

La API de Verifacti para Veri*Factu está diseñada para facilitar el envío de información fiscal a la Agencia Tributaria, proporcionando una solución accesible a los desarrolladores de software de facturación. En lugar de integrarse directamente con la API de la administración, los desarrolladores pueden realizar sus peticiones a la API de Verifacti, evitando así complejidades tecnológicas y barreras técnicas.Facilidad y rapidezLa API de Verifacti está diseñada para ofrecer una integración sencilla y rápida gracias a:

• Documentación clara y concisa, con ejemplos y colecciones Postman.
• Uso de JSON como formato de comunicación.
• Sin límites de tiempo o número de llamadas a la API.
• Eliminación de necesidad de certificados propios, utilizando certificados de representación de Verifacti.
• Soporte técnico dedicado, especialmente en la fase de integración.

El flujo de funcionamiento de la API Verifacti sigue este esquema:

1. Cuando se emite una nueva factura en el software de facturación, se envía una petición a la API de Verifacti con:
• Una API key específica de la empresa emisora (NIF contribuyente).
• Un JSON con los datos de la factura (base imponible, IVA, total, etc.).
2. La API de Verifacti responde de inmediato con un QR en formato Base64, listo para ser incluido en la factura y entregado al destinatario.
3. La API de Verifacti genera de manera inmediata el registro de facturación (fichero XML) cumpliendo con todos los requisitos (inmediatez, encadenamiento, formato, inalterabilidad, integridad, trazabilidad, etc).
4. En los siguientes segundos/minutos, Verifacti envía la información a la API de la administración, que emite un XML de respuesta.
5. Se debe confirmar la respuesta de la AEAT para verificar si la factura fue aceptada o requiere correcciones:
• se puede hacer via webhook
• se puede realizar una llamada posterior al endpoint estado de registro

API Verifacti como reflejo fiel de Veri*FactuVerifacti ha diseñado su API para ser un reflejo fiel de la API de la administración, replicando:

• Los endpoints.
• La estructura de las llamadas.
• Los mensajes de error devueltos por la administración.

Esto significa que cualquier error devuelto por la API de Verifacti proviene, salvo excepciones, directamente de la administración. Esto permite a los desarrolladores identificar problemas con mensajes originales de la Agencia Tributaria y corregirlos sin intermediarios.Al no actuar como un intérprete de los requisitos de Hacienda, Verifacti asegura una integración transparente y alineada con los criterios oficiales, permitiendo a los desarrolladores centrarse en la implementación sin incertidumbres.

Verifacti ofrece un sandbox o cuenta gratuita con una empresa de prueba para que puedas probar la API y realizar la integración.1. Crear cuenta gratuita en VerifactiRegístrate en pocos segundos en Verifacti. Solo tienes que acceder a Verifacti, hacer clic en Crear Cuenta, ingresar tu email y una contraseña. Tras este paso, estarás listo para explorar la plataforma.2. Accede a la empresa de pruebaTu cuenta gratuita incluye una empresa de prueba, que te permite realizar llamadas al entorno de prueba de la administración. Para acceder:

• Dirígete a la sección de Empresas.
• Haz clic sobre la empresa de prueba para ingresar a su panel de control.
• Esta empresa de prueba está incluida en el plan gratuito y es suficiente para la mayoría de los casos de integración con Verifacti.

3. Realiza tus primeras llamadas desde la terminalDentro del panel de tu empresa de prueba:

• Haz clic en Terminal en el menú lateral.
• Desde aquí podrás realizar llamadas a los distintos endpoints de la administración a través de Verifacti.
• Selecciona un tipo de llamada en el desplegable.
• Envía la llamada de prueba a la administración haciendo clic en Enviar.
• Si pruebas el endpoint de Crear factura, recibirás una respuesta inmediata con el QR listo para pegar en la factura.

4. Explora la sección de registrosTras realizar una llamada al endpoint de Crear factura, dirígete a la sección de Registros para consultar la información de la petición:

• Imagen del QR y su link asociado.
• JSON generado en la petición.
• XML enviado a la administración por Verifacti.
• XML de respuesta de la administración.

5. Utiliza la API keyEn la sección de Configuración, encontrarás la API key de tu cuenta de prueba. Utilízala para realizar llamadas a la API directamente desde tu propio código.

El QR en el sistema Veri*Factu es una URL codificada, única para cada factura, que se encuentra en la web de la Agencia Tributaria. Esta URL permite verificar si la factura ha sido recibida por la administración a través del sistema Veri*Factu. La administración espera que todas las facturas emitidas por contribuyentes sujetos al sistema Veri*Factu incluyan este QR. Así, cualquier receptor de una factura con un QR puede acceder fácilmente a la URL desde su dispositivo móvil y comprobar que la factura ha sido comunicada a la Agencia Tributaria.El QR se genera a partir de los siguientes 5 campos de la factura:

• NIF emisor
• Serie
• Número
• Fecha de expedicion
• Importe

Cuando se hace una llamada de factura nueva a la API de Verifacti la respuesta síncrona instantánea incluye el QR en formato imagen Base64.

La declaración responsable es una autocertificación en la cual el SIF confirma que cumple con la normativa. El requisito de "certificación" que establece la Ley Anti-Fraude (de dónde proviene Veri*Factu) queda satisfecho con esta "autocertificación" que cada software de facturación debe publicar, y que la AEAT puede exigir en caso de inspección.Para cumplir con Veri*Factu no hay requisitos de homologación externa ni verificación por parte de la AEAT. Sencillamente, cada software de facturación debe incorporar este documento, regulado en el Capítulo IV de la Orden Ministerial.En un caso de arquitectura mixta como el que resulta de usar una API como Verifacti, tanto el software de facturación como el propio Verifacti deben contar con su declaración responsable. La nuestra está disponible:

• A través de un link
• Vía endpoint

Hay un apartado completo en las preguntas frecuentes de la AEAT sobre este documento y sus requisitos. Aquí solo destacamos dos aspectos muy importantes de este document:

1. Emplazamiento de la declaración responsable - Debe ser visible para los usuarios del software y, en caso de comercialización, también para los compradores. Se sugiere que esté accesible en la sección de ayuda en los softwares de tipo web.

1. Numeración del software - La declaración responsable debe referirse al número de software correspondiente. Cada proveedor debe contar con una declaración para cada numeración de software creada después de la entrada en vigor de Veri*Factu. Solo debe estar disponible la declaración vigente, correspondiente a la numeración de software en uso, aunque en caso de inspección la AEAT podría solicitar todas las anteriores.

Verifacti utiliza su propio certificado digital para remitir información a la AEAT en nombre de terceros. La AEAT exige la firma de un modelo de representación por parte de los obligados tributarios.Certificado de Verifacti como colaborador socialVerifacti emplea un certificado digital propio de representación para enviar la información fiscal a la administración en nombre de los obligados tributarios. Se evita así la necesidad de solicitar certificados y contraseñas a los usuarios de Verifacti, reduciendo riesgos de seguridad y evitando el rechazo de los usuarios a compartir credenciales sensibles. Para ello, Verifacti opera dentro del marco de la colaboración social, una figura previa a Veri*Factu muy extendida para multitud de usos de asesoramiento fiscal. En concreto, Verifacti ha firmado el convenio 017 con la AEAT, creado específicamente para dar cobertura a la figura de la colaboración social en el ámbito de Veri*Factu. Verifacti aparece listado (Bilbabit SL) en el listado oficial de entidades con acuerdo de la AEAT.Modelos de representaciónSiempre que no sea el propio obligado tributario el que remita su información a la AEAT, la norma exige que los contribuyentes firmen un modelo de representación en el que facultan a Verifacti a enviar información fiscal en su nombre. Estos modelos de representación fueron publicados en el BOE en diciembre de 2024 (ver Anexos I, II y III).Verifacti ofrece a sus clientes dos caminos diferentes para agilizar la firma de estos modelos de representación:

1. Desde la interfaz web de Verifacti, siguiendo los pasos indicados en la sección Configuración → Representación para cada NIF.
2. Programáticamente, a través de la API de gestión de NIFs.

Es muy importante destacar que el modelo de representación solo debe gestionarse una única vez por NIF. Es decir, si se quiere tener el mismo NIF dado de alta 2 veces en test y en producción, bastaría hacer esta gestión una sola vez en test para que valga también para el NIF de producción, incluso si este no ha sido creado todavía. Por lo tanto, la cronología adecuada para gestión de representación podría ser la siguiente:

1. Crear NIF en test
2. Gestionar representación para ese NIF
3. Crear NIF en producción (la representación ya estará gestionada sin necesidad de volverlo a hacer).

No existe un listado de softwares homologados para Veri*Factu por la AEAT. La obligación de certificación que establece la ley antifraude se resuelve mediante una autocertificación, es decir, una declaración responsable (ver otras preguntas frecuentes relacionadas). Aunque algunos proveedores y softwares de facturación afirman estar homologados por la AEAT, tal homologación no existe. Se trata de una estrategia comercial sostenida sobre una afirmación inexacta e, incluso engañosa.En Ticketbai, el sistema de las haciendas forales vascas, sí existe el concepto de software homologado por la Administración “software garante”. Nosotros también cubrimos Ticketbai y somos “software garante” es decir software homologado por la Administración en las tres provincias del País Vasco. Incluimos aquí el listado de softwares garantes de Vizcaya a modo de ejemplo.

En modo Veri*Factu, no existe la obligación de conservar los registros de facturación enviados a la Agencia Tributaria, ni para el software de facturación ni para el contribuyente, puesto que dichos registros ya han sido remitidos previamente. La administración es clara a este respecto: la obligación de conservación de registros de facturación solo existe en el modo No-Veri*Factu.Por registro de facturación, la administración entiende los ficheros XML que genera Verifacti a partir de las llamadas recibidas, y que se remiten a la AEAT. Se trata, por tanto, de los ficheros XML de petición a la administración y de respuesta de la administración. En modo Veri*Factu, no existe la obligación de conservar dichos ficheros.Dicho esto, Verifacti facilita endpoints para descargar los registros de facturación para aquellos usuarios que deseen guardarlos.Endpoint exportar XMLsEndpoint descargar XMLAsimismo, Verifacti guardará esta información para todos los NIFs activos en producción y un tiempo corto después (ver términos de uso).Lo anterior no debe confundirse con la obligación de conservación de facturas derivada del Reglamento de Facturación u otras normas tributarias o contables. Cualquier obligación que el software o sus usuarios (los contribuyentes) tuvieran antes de la aparición del sistema Veri*Factu sigue vigente. Sí existe por lo tanto obligaciones de conservación en lo relativo a las facturas, tal y como ya venía sucedienco antes de la normativa de Veri*Factu.