Preguntas frecuentes

Verifacti es una solución diseñada para desarrolladores de software que necesitan adecuar sus sistemas de facturación a Veri*Factu, Ticketbai en el País Vasco y próximamente NaTicket en Navarra. Verifacti ofrece actualmente tres APIs diferenciadas y una plataforma web intuitiva y sencilla.👉 Ver Demo Online de VerifactiAPI Veri*FactuLa API Veri*Factu permite cumplir con la normativa del sistema Veri*Factu de la Agencia Tributaria española. Se trata de una API REST en la nube que opera en tres pasos fundamentales:

1. Recepción de petición con los datos de una factura en formato JSON.
2. Devolución inmediata de una respuesta con el código QR correspondiente a la factura.
3. Generación inmediata del registro de facturación (XML) y remisión a la API de la administración, garantizando el cumplimiento de todos los requisitos normativos.

API TicketbaiLa API Ticketbai permite la adaptación al sistema Ticketbai exigido por las Haciendas Forales Vascas. Actualmente, existen tres sistemas Ticketbai distintos, uno para cada provincia del País Vasco. Con la API Ticketbai de Verifacti, se logra la adecuación a cualquiera de estas tres haciendas mediante una única integración.API de Gestión de NIFsLa API de Gestión de NIFs simplifica la creación, activación y desactivación de NIFs dentro de Verifacti, configuración de webhooks y gestión de modelos de representación automatizada. Esta API es especialmente beneficiosa para softwares con centenares o miles de obligados tributarios.Próximamente: Factura Electrónica y NaTicket

Verifacti continuará evolucionando con mejoras clave en el futuro:

• Factura electrónica: Cumplirá con los requisitos de la factura electrónica una vez se establezca el marco reglamentario necesario.
• Hacienda Navarra: Verifacti desarrollará una API específica para el sistema Navarro NaTicket cuando se establezca el marco reglamentario necesario.

Te explicamos cuáles son las exigencias esenciales de la normativa Veri*Factu y cómo Verifacti te ayuda a cumplirlos (dentro del modo Veri*Factu):

• Generación del QR - Las facturas emitidas por tu software deben llevar el QR Veri*Factu => Cuando nos haces una llamada para comunicarnos la emisión de una factura, nuestra API te devuelve el QR de manera instantánea para que lo puedas pegar a la factura.

• Generación y remisión del registro de facturación - Cuando emites una factura, debe generarse (en el mismo momento) un fichero de tipo XML según los requisitos de la AEAT (el famoso "registro de facturación") y debe remitirse a la AEAT sin demora => Cuando nos haces una llamada para comunicarnos la emisión de una factura generamos el XML de manera síncrona instantánea, y remitimos a la AEAT dicho fichero con nuestro propio certificado digital.

• Comprobación de la respuesta de la AEAT - Una vez la factura ha sido enviada a la AEAT (proceso que puede durar unos pocos minutos) es importante comprobar la respuesta de la AEAT para descartar / arreglar errores => Verifacti facilita webhooks y endpoints específicos para conocer y gestionar las respuestas de la AEAT.

• Declaración responsable - Debes tener una declaración responsable accesible en un lugar visible para tus usuarios / clientes. => Verifacti te facilita una plantilla y materiales para completar este documento.

• Modelos de representación - Antes de enviar la primera factura de un obligado tributario que usa tu software a la AEAT debes gestionar la firma por parte del obligado tributario de un formulario muy sencillo que la AEAT publicó en el BOE en diciembre => Verifacti te facilita los formularios pre-rellenados con instrucciones claras para la firma, así como mecanismos sencillos para que puedas hacernos llegar el formulario (manualmente o vía endpoint).

👉 https://www.youtube.com/watch?v=45bMYOmRT4w&list=PLf7jmt87ZrAOKXjwwXmk-39T599EAd7NL&index=4

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.👉 Ver vídeo corto: qué es Verifacti, para quién es y para qué sirve

En la mayor parte de los casos la integración queda realizada con el trabajo de un solo desarrollador en uno a tres días a tiempo completo, y posteriormente unos días adicionales a tiempo parcial.

A ojos de la AEAT, una arquitectura que se apoya en una API como la de Verifacti es una arquitectura mixta con 2 componentes:

• CPF (Componente Principal de Facturación): tu SIF desde el cual se emiten las facturas.
• CEF (Componente Externo de Facturación): nuestra API.

Hay aspectos de la adecuación a Veri*Factu y responsabilidades que son ineludibles para el CPF (tu software), y que una solución como la nuestra os ayuda a cumplir pero que en última instancia dependen de nosotros. Te menciono algunos ejemplos:

• Envío en tiempo real de las facturas con datos correctos - Nosotros no sabemos cuando vuestros usuarios interactúan con vuestro software, os corresponde a vosotros el envío correcto en tiempo real.
• Publicación de la declaración responsable - Si bien nosotros os damos una plantilla y os guiamos, sois vosotros quienes debéis completar y asegurar la correcta publicación de la misma en vuestro software.
• Inclusión del QR en la factura - Si bien os facilitamos el QR, sois vosotros quienes debéis aseguraros de que se pega en la factura.

El principal motivo para utilizar una API como la de Verifacti es ahorrar innumerables horas de desarrollo en fases de integración y mantenimiento.Al utilizar la API de Verifacti, se evitan los principales retos de la integración directa con la administración, tales como:

• Documentación confusa e insuficiente.
• Uso obligatorio de XML como formato de comunicación.
• Restricciones de tiempo y frecuencia en las llamadas a la API de la administración.
• Firma obligatoria con certificado.
• Encadenamiento obligatorio de los registros de facturación.
• Generación y verificación de huellas/hash.

Verifacti destaca como una solución inmejorable para el reto Veri*Factu que te reducirá al mínimo el número de horas de desarrollo y consultas para solucionar este reto:

• Soporte dedicado y personalizado para asegurar una integración fácil y correcta
• Documentación API sencilla y clara
• Sección de ejemplos de llamadas y peticiones y
• Sección de preguntas frecuentes hiperdetallada
• Sirve también para Ticketbai y próximamente Navarra

* API de gestión de NIFs para alta y baja programática de tus usuarios

• Sistema de gestión automatizada de la representación vía API
• Webhooks para conocer las respuestas de la AEAT
• Sistema de validación de errores inteligente para evitar errores en la AEAT
• Comprobación destinatarios facturas para evitar errores en la AEAT
• Arquitectura serverless basada en contenedores, lo que permite un escalado automático en función de la carga

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

Puedes ver logos y testimonios de clientes en nuestra Home (página de inicio).

Nos distinguimos por ayudar activamente a nuestros clientes y usuarios a adecuar su software a Veri*Factu tanto en las fases de integración como en el posterior mantenimiento.Ante cualquier duda debéis seguir los siguientes pasos:

1. Consultad nuestras 🛟 Preguntas frecuentes, el 90% de las dudas ya están resueltas ahí.
2. Para dudas comerciales, escribid a ventas@verifacti.com
3. Para cualquier otro tipo de duda, escribid a soporte@verifacti.com. Vuestro email lo leen varias personas y obtendréis respuesta con rapidez.
4. Agendaremos una llamada en caso de que sea necesario.

Te facilitamos una demo online ya grabada para consultar cuando quieras. Dura unos 30 minutos, y en ella cubrimos los aspectos más importantes de cómo Verifacti ayuda a cualquier software a adaptarse a Veri*Factu, incluidas las dudas más frecuentes sobre certificados, representación, declaración responsable, plazos y más cosas.Si prefieres una demo personalizada, solicita una demo aquí.

De cara a valorar la necesidad de hacer una llamada, os pedimos a nuestros usuarios y clientes que nos contactéis primero por email con vuestras dudas concretas y específicas.

• Si podemos resolver vuestras dudas por email, así lo haremos.
• En caso de que sea necesario os enviaremos un link para agendar una video llamada.

Este enfoque tiene una ventaja importante: mayor rapidez. Por lo general, tardamos menos en contestar a un email que en agendar una llamada ya que el 95% de las dudas entre usuarios y clientes se repiten mucho, y ya contamos con recursos explicativos optimizados en formato escrito o de video que os enviaremos.

Dispones de una serie de recursos clave para acelerar la adecuación de tu software y minimizar errores que te animamos a consultar:

• Guía rápida: te explicamos paso a paso cómo adecuar tu software.
• Documentación API sencilla y clara de las 3 APIs que componen Verifacti: Veri*Factu, Ticketbai y gestión NIFs.
• Ejemplos de llamadas: te mostramos cómo estructurar tus llamadas para todo tipos de facturas.
• Sección de preguntas frecuentes hiper detallada, con un buscador en la parte superior.
• Demo online en donde te contamos cómo funciona Verifacti y resolvemos las dudas más habituales.
• Tutorial Veri*Factu con una serie de vídeos cortos que cubren todos los aspectos clave del cumplimiento.

Estos recursos se consumen en su totalidad en unas dos o tres horas, y recomendamos a nuestros usuarios que los revisen con atención ya que evitarán bloqueos y dudas innecesarios.

Tenemos una sección con ejemplos de llamadas y peticiones para todo tipo de facturas:

• Factura simplificada
• Factura normal
• Factura múltiples IVAs
• Factura a ciudadano extranjero
• Factura a empresa intracomunitaria
• Factura exenta de IVA
• Factura operación no sujeta
• Factura con IGIC
• Factura con IPSI
• Factura suplidos y retención
• Factura de abono
• Factura de canje
• Factura rectificativas
• Factura rectificativas por sustitución
• Factura rectificativas por diferencias
• Factura recargo de equivalencia
• Factura emitida por terceros
• Factura emitida por destinatario
• Factura anulación
• Factura subsanación

El 2 de diciembre de 2025 estos plazos han sido ampliados. Planteamos debajo los nuevos plazos, que la AEAT explica aquí.

1. Plazos para software de uso propioSi tu software de facturación es para uso propio (para la emisión de tus propias facturas), entonces tu fecha sería:

• 1 de enero de 2027 si estás sujeto al impuesto de sociedades.
• 1 de julio de 2027 para los demás (autónomos principalmente)

2. Plazos para productores o comercializadores de software

Si eres productor o comercializador de software, tu software debe estar adaptado a Veri*Factu desde el pasado día 29 de julio de 2025. La AEAT ha insistido en que todo software vendido hoy en día debe de estar adaptado. Este plazo no ha cambiado, y puede confirmarse en la propia FAQ de la AEAT aquí.Excepción: software ya vendidos con contrato plurianual de mantenimiento, el plazo se alarga a los plazos de 2027 (ver arriba)

La expectativa de la AEAT es que las facturas se remitan en tiempo real, no siendo posible enviar las facturas al final del día o de un periodo de tiempo sea cual sea.

Incentivos para fabricantes, comercializadores y distribuidores de software

• Obligatoriedad legal - Desde el 29 de julio de 2025 solo se puede vender en España software de facturación adaptado a Veri*Factu. Vender software no adaptado expone al SIF a sanciones muy importantes. Esta obligación legal no ha cambiado a raíz del aplazamiento de Veri*Factu del 2 de diciembre de 2025, que solo afecta a obligados tributarios individuales con su propio software.
• Ventaja competitiva - Los sucesivos anuncios de la AEAT y su cobertura mediática han tenido el efecto de asegurar la concienciación sobre la norma entre los obligados tributarios. El cliente de software dará durante 2027 previsiblemente un valor mayor a aquellas soluciones de software que les resuelvan el reto Veri*Factu. Cualquier oferta de software que se produzca de ahora en adelante que no incorpore Veri*Factu estará en desventaja competitiva respecto a aquellos que puedan asegurar el cumplimiento normativo.
• Incentivos fiscales - En el País Vasco, con el sistema Ticketbai, se ofrecieron incentivos fiscales que fomentaron la adopción voluntaria temprana, y lo mismo ha sucedido en otros países con sistemas similares. Es previsible anuncios en este sentido, que acelerarán la adopción, y favorecerán a los proveedores que ofrezcan Veri*Factu con garantías.

Incentivos para empresas individuales

El principal argumento para obligados tributarios individuales para sumarse a Veri*Factu pronto es el de los incentivos fiscales. En el País Vasco, con el sistema Ticketbai, se ofrecieron incentivos fiscales que fomentaron la adopción voluntaria temprana, y lo mismo ha sucedido en otros países con sistemas similares. Es previsible anuncios en este sentido, que acelerarán la adopción, y favorecerán a los proveedores que ofrezcan Veri*Factu con garantías.

Registro de facturación y factura no es lo mismo.

Los registros de facturación son los XML que genera Verifacti a partir de las llamadas realizadas a la API. Por cada llamada realizada a la Agencia Tributaria hay un XML (registro de facturación).Una factura puede tener uno o varios registros de facturación.

• En un primer momento, al crearse una factura nueva, habría un único registro para esa factura.
• Si posteriormente se hacen otras llamadas relacionadas con la misma factura (por ejemplo, una llamada al endpoint de subsanación) habría más de un registro para la misma factura.

A ojos de la Administración Tributaria un ticket de compra equivale a una factura simplificada y las facturas simplificadas deben ser comunicadas a través del sistema Veri*Factu. En otras palabras, todos los tickets deben ser comunicados por el sistema Veri*Factu como facturas simplificadas

Al usar Verifacti se consolidan todas las facturas de series diferentes en una misma cadena, por lo que de manera efectiva siempre se tiene un único SIF. Esta arquitectura está descrita en las preguntas frecuentes para desarrolladores aquí (página 10).

La administración ofrece dos caminos para cumplir con el sistema Veri*Factu: el modo Veri*Factu y el modo No-Veri*Factu.

• El modo Veri*Factu consiste en el envío en tiempo real a la administración de los registros de facturación.
• En el modo No-Veri*Factu los registros sí se deben generar en tiempo real, pero no se envían a la AEAT, quedan conservados por el software de facturación

El modo No-Veri*Factu no está cubierto por la API debido a la nula demanda que hemos recibido de esta manera de cumplir con la normativa. Estos son algunos de los inconvenientes del modo No-Veri*Factu:

1. Obligación de conservación: En el modo No-Veri*Factu, el contribuyente no envía las facturas a la administración en tiempo real, lo que genera una obligación de conservación de los registros de facturación. Esto implica que el software de facturación debe estar preparado para enviar toda la información fiscal del contribuyente en caso de requerimiento por parte de la Agencia Tributaria.
2. Requisitos adicionales: ir por este camino implica requisitos técnicos adicionales como la necesidad de contar con un registro de eventos.
3. Inspecciones Fiscales: La administración ha indicado que los contribuyentes que opten por el modo No-Veri*Factu tendrán una mayor probabilidad de sufrir inspecciones fiscales.
4. Opción Temporal: La administración ha expresado que el modo No-Veri*Factu es una opción temporal destinada a desaparecer en el futuro.

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.👉 Ver video corto: Veri*Factu vs No Veri*Factu, y la obligación de conservación de los XML Registro de Facturación

No, las empresas acogidas al Suministro Inmediato de Información (SII) no tienen la obligación de adecuarse al sistema VERI*FACTU. Para obtener una confirmación oficial y específica para su caso, se recomienda consultar directamente con la Agencia Tributaria (AEAT) a través del correo electrónico verifactu@correo.aeat.es.

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.👉 Ver vídeo corto: funcionamiento de nuestra API (Parte 1) - Explicación y primeros pasos 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 usando una API key específica de la empresa emisora (NIF contribuyente). Se envían los datos de la factura en formato JSON.
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 o realizar una llamada posterior al endpoint estado de registro.

API Verifacti como reflejo fiel de Veri*Factu

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

Contamos con un recurso esencial que es imprescindible leer en detalle y que contiene los pasos necesarios para una integración exitosa: guía rápida.

La API Verifacti se encarga de generar el Registro de Facturación (XML) y todo lo que va incluido y depende del mismo: huella hash y encadenamiento.El software que se integra con Verifacti únicamente debe asegurarse de hacer peticiones con la API Key única del emisor y el JSON con los datos de la operación de facturación a nuestra API.A partir de tu llamada, nosotros nos encargamos del resto:

• generamos el XML.
• te devolvemos el código QR para que lo puedas pegar en la factura.
• remitimos el XML a la AEAT con nuestro propio certificado digital.
• te facilitamos la respuesta de la AEAT mediante webhooks o mediante el endpoint estado de registro.

El requisito de trazabilidad exigido por Veri*Factu se refiere a la obligatoriedad del encadenamiento de registros de facturación (XML). Cada XML nuevo generado debe hacer referencia al XML anterior, generando así una cadena que permite saltar de un XML a otro hasta llegar al primero de la cadena.La cadena de registros constituye por lo tanto un encadenamiento de todos los registros de facturación (XMLs) generados y enviados por un software informático de facturación en orden cronológico de creación, independientemente de que los registros hagan referencia a creación de facturas u otras operaciones (como por ejemplo anulación o subsanación), e independientemente también de los números y series de las facturas emitidas.Al trabajar con la API Verifacti la trazabilidad queda asegurada por la propia API, que es la que genera los ficheros XML a partir de las llamadas de los usuarios. Así, al realizarse una llamada al endpoint de Crear Factura y recibir un código 200, puede darse por hecho que Verifacti ha generado a partir de los datos de la llamada el fichero XML y que este está correctamente encadenado al anterior.La trazabilidad no debe ser confundida con el requisito de la normativa de facturación que establece la obligatoriedad de secuencialidad de la numeración de una factura dentro de la misma serie. Este requisito de secuencialidad es un requisito que Veri*Factu no tiene en cuenta (no da error cuando no se cumple la secuencialidad) y que no tiene nada que ver con la trazabilidad.

En el caso de Veri*Factu la administración ha impuesto unos límites a la cantidad y tiempos de las peticiones que se puede realizar a la AEAT y es frecuente que una petición realizada a nuestra API tarde hasta 100 o 200 segundos en ser remitida a la administración. Por ese motivo nuestra API devuelve el QR de manera inmediata y posteriormente tarda uno o dos minutos en hacer llegar el registro de facturación a la administración. Esto es correcto y es la manera que ha elegido la AEAT para gestionar las peticiones a su API.En el caso de Ticketbai la respuesta es inmediata e incluye tanto el QR como la huella.

Estas son algunas capacidades y funcionalidades de la API:

• Generación de QR
• Generación de XML (incluyendo encadenamiento y huella)
• Gestión de certificados
• Lógica de reintento si la API de AEAT está inactiva
• Transmisión por lotes
• Cumplimiento de la API de Ticketbai incluido en el precio
• Validación inteligente para evitar el envío de XMLs que generen errores, evitando la necesidad de peticiones posteriores para corregir errores
• Verificación del destinatario de la factura para evitar errores con la AEAT
• API de gestión de NIF para el registro y baja programática de usuarios
• Webhooks para recibir respuestas de la AEAT
• Sistema de gestión de representación automatizada a través de API
• Arquitectura sin servidor basada en contenedores, permitiendo escalado automático según la carga
• Documentación de API simple y clara

Verifacti se puede integrar con cualquier stack tecnológico. El único requisito técnico es que tu stack sea capaz de realizar llamadas a una API REST en la nube. Esto es algo muy común y ampliamente soportado en cualquier lenguaje o framework moderno (y también en los más antiguos).Si no sabes cómo hacerlo, encontrarás fácilmente recursos en la web, en ChatGPT o en YouTube con tutoriales que explican cómo realizar llamadas a una API REST desde prácticamente cualquier tecnología. Es un procedimiento estándar, totalmente seguro y habitual en la integración de software.Además, tenemos clientes que ya han integrado Verifacti con éxito desde multitud de lenguajes, frameworks y ERPs. Entre ellos, destacan ejemplos como:

• Lenguajes de programación: Python, Java, C#, Visual Basic .NET, PHP, Ruby on Rails, Go, Rust, Kotlin, Swift, Objective-C, C++, Perl.
• Entornos JavaScript y frameworks: Node.js, Express, NestJS, React, Angular, Vue.js, Next.js, Nuxt.js, Svelte.
• Frameworks y stacks backend: Django, Flask, Spring Boot, Laravel, Symfony, CodeIgniter, ASP.NET Core, Grails.
• Entornos de integración empresarial / ERP: Odoo (módulos personalizados), Dolibarr, SAP, Microsoft Dynamics, Sage, Zoho, Oracle NetSuite.
• Sistemas de facturación y contabilidad: Holded, A3 Software, Factusol, ContaPlus.
• Automatización e integraciones: Zapier, Integromat (Make), n8n.
• Bases de datos y conectores: MySQL, PostgreSQL, SQL Server, MongoDB, Firebase, Redis.
• Otros entornos comunes: WordPress (con plugins), Magento, Shopify, WooCommerce, Prestashop.

En resumen, da igual si trabajas con tecnologías clásicas o modernas: Verifacti es compatible con cualquier stack tecnológico.

Para empresas con múltiples tiendas o TPVs y series de facturación diferentes, si utilizan un componente externo como Verifacti para encadenar todas sus facturas, se considera que todas estas ubicaciones constituyen un único Software de Facturación Independiente (SIF).La AEAT argumenta que la definición de SIF se refiere al software de facturación independiente más pequeño. Dada la arquitectura de nuestra solución, las facturaciones de las diferentes tiendas no son independientes entre sí, por lo que forman un único SIF y un único encadenamiento.Este método es totalmente válido y cumple con la normativa, ofreciendo una alternativa a otros modelos que, si bien también son correctos, no son la única forma de operar.

Verifacti no ofrece un plugin directo para Excel o Google Sheets. Sin embargo, desde Google Sheets es posible realizar llamadas a APIs externas, lo cual sería necesario para interactuar con la API de Verifacti y enviar las facturas a la AEAT.

Sí. En la documentación de las APIs encontrarás las colecciones de Postman para descargar.

• API Veri*Factu
• API Ticketbai
• API de gestión de NIFs

Para un seguimiento eficaz de las facturas enviadas a través de la API, recomendamos guardar los siguientes campos en tu base de datos:

• De la respuesta de Crear factura: el uuid, el string Base64 del qr, y la huella.
• De la respuesta de Estado factura: fecha_expedicion y el estado actual de la factura. Adicionalmente, para un control y depuración de errores, es muy útil guardar el estado y mensaje_error que se obtienen en esta consulta.
• De la respuesta de Descargar XML: xlm_req (XML de la solicitud) y xlm_res (XML de la respuesta) para fines de auditoría y referencia.

Las URLs de los endpoints no cambian, son las mismas para los entornos de test y de producción. Lo que determina qué entorno se usa es la API key que se utilice.Cada API key tiene un entorno asociado: test o producción.

• En entorno de test, la API key de la empresa empieza por vf_test_
• En entorno de producción, la API key de la empresa empieza por vf_prod_

No debes incluir el identificador del SIF en tus llamadas a Verifacti porque:

1. Generación del XML: Verifacti se encarga de generar el XML necesario para la comunicación con la AEAT.
2. Incorporación del SIF: Es en este XML donde se incluye el identificador del SIF, asegurando que la información se envía correctamente a la AEAT.

Al dejar que Verifacti maneje este proceso, se minimizan errores y se garantiza el cumplimiento con las normativas de Veri*Factu y Ticketbai.

La API de Verifactu soporta de TLS 1.2 en adelante. No es compatible con SSLv3.

Verifacti funciona con un modelo de suscripción con pagos recurrentes mensuales o anuales según tu plan.El coste (mensual o anual) de la API Verifacti depende fundamentalmente del número de NIFs que tengas activos en el entorno de producción (número de contribuyentes reales).Para un número bajo de NIFs, los precios son públicos:

1. Navega en la página de precios.

1. Elige tu número de NIFs (obligados tributarios que van a emitir facturas con tu software)

Para un número elevado de NIFs podemos hacerte una propuesta en función de tus necesidades (usar para ello el formulario de contacto). De cara a enviarte información relevante y una propuesta ajustada así como para resolver tus dudas, necesitamos conocer los siguientes datos:

1. ¿El software que vas a integrar es para uso propio de tu empresa o es un software que vendes/distribuyes a terceros?
2. ¿Cuál es el número aproximado de NIFs emisores de facturas con tu software? (número de obligados tributarios que emiten facturas con vuestro software)
3. ¿Cuál es el número aproximado de facturas emitidas con tu software? (por ejemplo, rango de número de facturas emitidas aproximado por mes o por año por NIF)

Tienes una cuenta gratuita para realizar la totalidad o la mayor parte de la integración. Sólo comenzarás a pagar cuando comiences a enviar facturas al entorno real de producción de la AEAT.

En Verifacti hablamos de manera indistinta de NIF, empresa, contribuyente u obligado tributario. Cada NIF dentro de Verifacti representa un contribuyente cuya información fiscal (facturas) quiere enviarse a la administración.Cuando hablamos de número de NIFs, nos referimos al número de usuarios obligados tributarios de vuestro software de facturación:

• Si vendéis software o lo implantáis, se refiere a los usuarios de vuestro software de facturación, es decir, a aquellos usuarios vuestros que emiten facturas usando vuestro software (número de contribuyentes individuales que emiten facturas con vuestro software).
• Si se trata de adecuar vuestro propio software interno, con el que emitís vuestras propias facturas, entonces sería un único NIF (el vuestro propio), o varios NIFs si sois un grupo de empresas.

Un caso especial es el de la emisión de facturas en nombre de destinatario (autofactura) o terceros. En estos casos, el número de NIFs coincide con los obligados tributarios sujetos pasivos del IVA, es decir, aquellos que venden un producto o un servicio.

Todos los planes de Verifacti incluyen un límite de seguridad muy elevado de facturas por NIF y por mes.

• Se trata de límite de seguridad, pensado para que no se sobrepase nunca o casi nunca.
• Para los planes anunciados en la página de precios, el límite actual es de 3000 facturas por NIF y por mes. Para planes customizados, el límite puede ser diferente.
• En caso de superarse esta cifra, la operativa no se interrumpe, sencillamente se añade a la factura de Verifacti una cantidad variable por las facturas adicionales no cubiertas por el plan. Este coste es para los planes anunciados en la página de precios de 2 Euros por cada 1000 facturas adicionales.
• En caso de que este límite no sea suficiente para ti, contáctanos y te haremos una oferta personalizada.

El primer NIF en Verifacti es el más caro. Esto afecta especialmente a los softwares para uso propio, que únicamente necesitan un NIF, y lo pagan a un precio por NIF más caro que usuarios con varios NIFs.El motivo de estructurar así los precios es que para Verifacti hay un coste elevado asociado a cada cliente independientemente del número de NIFs contratados. Nos esforzamos por monitorizar y ayudar a cada cliente independientemente del tamaño, y este compromiso con un buen soporte y una buena asistencia nos obliga a reflejarlo en un precio que tiene un mínimo independientemente del número de NIFs.Esta estructura de precios garantiza que podremos resolver dudas de integración y mantenimiento con cualquier cliente, incluso con aquellos que solamente tienen un NIF.

La dinámica de pagos a medida que se crean / activan o desactivan NIFs es la siguiente.Para planes MENSUALES

- Primero hay que generar una suscripción de pago eligiendo la opción "Mes". En ese momento se os cobra por un único NIF. Pongamos que es el día 15 de septiembre.

• A partir de ahí, cada 15 de cada mes se cobrará el mismo importe equivalente a 1 NIF.
• Cuando crees tu primer NIF en producción no se te cobra nada, porque ya estás pagándolo.
• Cuando crees tu segundo NIF en producción, entonces no se te cobra nada en ese momento, pero en el siguiente día 15 se te cobrará el tiempo consumido por ese segundo NIF en el mes anterior (pago a posteriori por el consumo realizado de ese NIF prorrateado) y un mes completo por adelantado (pago a priori de un mes completo)
• A partir de ahí se os cobrarían 2 NIFs cada mes (pre-pago)
• Misma dinámica con cada aumento de NIFs
• Si en cualquier momento desactivas un NIF, sencillamente cuando llegue el momento del siguiente cobro no se cobrará ese NIF. No hay devolución por el importe pagado y no utilizado por ese NIF.

Para planes ANUALES

• Primero hay que generar una suscripción de pago eligiendo la opción "Año". En ese momento se os cobra por un único NIF por todo el año. Pongamos que es el día 15 de septiembre.
• Cuando se den de alta NIFs adicionales, entonces se cobrará en el momento del alta el importe total anual prorrateado por el tiempo que queda hasta el siguiente 15 de septiembre. Es decir, si el alta de un NIF se produce el 15 de marzo, quedarían 6 meses para completar el ciclo de un año, y se cobrarían 6 meses por adelantado por el derecho a usar ese NIF durante los 6 meses siguientes.
• El siguiente 15 de septiembre se cobrará el importe anual total de todos los NIFs activos en producción en ese momento.

Si pagas por adelantado un año de uso, entonces hay unos descuentos del 10%. Esto exige el prepago por adelantado de los 12 meses para cada NIF que añadas. El año se contaría desde la fecha en la cual creaste tu suscripción anual (fecha en la cual te convertiste en cliente de pago), o desde la última fecha de renovación de tu plan anual.

No. Pagarás solamente lo que uses y el tiempo que lo uses. No tendrás que pagar ningún coste de instalación y podrás dejar de usar el servicio cuando quieras.

No. Los precios de Verifacti son por contribuyente (NIF) e independientes del número de TPVs y/o locales desde los cuales se emitan las facturas. Somos una API en la nube que no requiere instalación local de software de ningún tipo.

Sí. Contamos con una API para gestionar la activación y desactivación de NIFs, webhooks y gestión automatizada de modelos de representación. Todo ello está incluido en el precio.

Sí. Cuando pagas por un NIF en producción puedes elegir si ese NIF va por la vía de Ticketbai o Veri*Factu sin que afecte al coste.

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 prueba

Tu 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 terminal

Dentro 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 registros

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

No necesariamente. El plan gratuito cuenta con una empresa ya creada en el entorno de test desde la cual puede hacerse la integración sin coste.Sin embargo, hay algunas funcionalidades muy útiles (especialmente para clientes con volúmenes altos de NIFs) que requieren una suscripción de pago:

• API de gestión de NIFs
• Webhooks
• Gestión automatizada de modelos de representación
• Creación de múltiples NIFs en entorno de test

Es posible acceder a todas estas funcionalidades creando una suscripción de pago por el precio simbólico equivalente a un NIF en producción. Una vez generada la suscripción de pago toda esa funcionalidad pasa a estar disponible.

Sí. El entorno de test de la AEAT está destinado únicamente a integración y validación, y su uso debe estar limitado tanto en volumen como en el tiempo. La AEAT establece límites al número de facturas enviadas y monitoriza que no se haga un uso continuado y permanente del entorno de test.Si no estás integrando activamente, es necesario interrumpir los envíos hasta retomar el proceso de integración. Por este motivo, en Verifacti contamos con sistemas de alerta que avisan cuando una integración se acerca a estos límites.

El NIF de prueba gratuito tiene esa limitación: al ser un NIF compartido por muchos de nuestros usuarios hemos capado el acceso a ese endpoint para impedir que se compartan datos entre usuarios.

Para trabajar con Ticketbai, es necesario crear una suscripción de pago y crear un NIF nuevo marcando la opción Ticketbai.

Los registros de facturación en entorno de test, al igual que en producción, no se pueden borrar. Esto tiene sentido: el modo test funciona exactamente igual que el modo prod, en el cual no se pueden borrar registros de facturación.Sí sería posible anular todas las facturas con el endpoint de anulación, pero eso no eliminaría los registros, y esos números de factura no podrían ser reutilizados.

Las siguientes funcionalidades requieren una suscripción de pago equivalente al coste de un único NIF en producción.:

• API de gestión de NIFs
• Webhooks
• Gestión automatizada de modelos de representación
• Creación de múltiples NIFs en entorno de test

Es posible acceder a todas estas funcionalidades creando una suscripción de pago por el precio simbólico equivalente a un NIF en producción. Una vez generada la suscripción de pago toda esa funcionalidad pasa a estar disponible.Para poder crear NIFs en entorno de producción también hace falta crear una suscripción de pago. Al aumentar el número de NIFs en producción la factura subirá.

La AEAT no permite realizar pruebas con CIFs ficticios, lo que obliga a utilizar CIFs reales para las pruebas, aunque estos envíos se marquen como de prueba y no tengan validez fiscal.

El prefijo se añade al número de factura únicamente cuando se utiliza el NIF de prueba proporcionado por Verifacti. Esto se hace para evitar posibles colisiones en la numeración entre diferentes usuarios que están probando la plataforma simultáneamente.Este prefijo no estará presente en las facturas generadas con NIFs dados de alta para entornos de prueba o producción.

Sí, es posible eliminar NIFs registrados, tanto en el entorno de prueba como en producción. La eliminación es permanente e irreversible: borra el NIF y toda la información asociada (incluidos los registros de facturación) de forma inmediata y definitiva. No incluye el modelo de representación. Ten en cuenta que esto es contrario al propósito de Veri*Factu de conservar los registros, por lo que conviene hacerlo con cautela.Puedes eliminar un NIF de dos maneras:

1. Manualmente, desde el panel de empresas.
2. Via endpoint, con el endpoint de eliminación permanente de NIFs.

Un NIF eliminado no puede reactivarse ni reutilizarse. Sí puedes volver a crearlo, pero se tratará como un NIF completamente nuevo, con su propia cadena de facturación independiente.

Para softwares con varios obligados tributarios, en la mayor parte de los casos Verifacti es contratado como proveedor por el desarrollador del software de facturación. Este desarrollador da de alta a los obligados tributarios en Verifacti, por lo que lo normal es que los obligados tributarios no interactúen con Verifacti para nada.En lo relativo a cómo trasladar el coste a los obligados tributarios, esto es una decisión exclusiva del software de facturación. En este sentido hemos visto todo tipo de enfoques por parte de nuestros clientes:

• absorber el coste
• repercutir el coste
• incluir margen

Muy excepcionalmente tenemos softwares de facturación que optan por pedir a sus obligados tributarios que nos contraten directamente. En estos casos:

• Es recomendable que el software de un camino fácil al obligado tributario para introducir su API Key única.
• Los precios podrían resultar más caros, puesto que no habría descuento por volumen alto de NIFs.

Si has recibido una oferta por email, contacta a la persona que te envió la propuesta por email.Si no has recibido una oferta por email, entonces los pasos a seguir son los siguientes:

1. Acceder a la plataforma con usuario y contraseña
2. Navegar a esta página
3. Hacer click en "Comprar primer NIF" y seguir los pasos.

• Asegurarse de marcar el checkbox de "empresa" y meter datos de empresa (nombre, NIF, etc).
• Introducir datos de pago: se cobrará el coste de un NIF en producción en ese momento

A partir de ese momento ya seréis clientes de pago:

• Se os seguirá cobrando el coste equivalente al primer NIF al mes a partir de ese momento
• Si activáis el primer NIF en producción no se os cobrará nada
• Si activáis más NIFs en producción entonces vuestra factura irá aumentando en función del número de NIFs activados
• A medida que añadís NIFs, el coste unitario por NIF va bajando (el primero es el más caro, luego bajan rápidamente)

Verifacti, al igual que la mayoría de servicios de tipo SAAS en la nube, tiene unos términos de uso a los cuales los clientes quedan adheridos al suscribir un plan de pago. Estos términos detallan los derechos y obligaciones legales de las partes, así como el SLA, DPA y otros elementos legales.También contamos con nuestra "declaración responsable" pública, que establece nuestras responsabilidades dentro de la arquitectura mixta que conformamos junto a nuestros clientes.

El sistema de Verifacti está diseñado para que la compra inicial sea de una licencia. A medida que añada NIFs de producción a su cuenta, la factura se ajustará automáticamente para reflejar el número real de licencias en uso.

Las razones comunes por las que una suscripción puede aparecer como no activa son:

1. Problemas con el estado de pago (tarjeta caducada, fondos insuficientes o un error en la transacción).
2. Fin del periodo de suscripción sin renovación automática.
3. Activación manual pendiente tras el registro o el pago inicial.

Para identificar la causa exacta y resolverlo, revisa los siguientes puntos en tu cuenta de Verifacti:

• Accede a tu panel de control y verifica la sección de Suscripciones o Facturación. Allí deberías poder ver el estado actual de tu plan y la fecha de vencimiento.
• Comprueba si hay alguna notificación o mensaje pendiente relacionado con pagos en tu cuenta.

Si después de revisar estos puntos sigues sin encontrar la causa o necesitas asistencia adicional, contacta con el equipo de soporte (soporte@verifacti.com).

Sí, cualquier persona o entidad puede contratar Verifacti, sea persona física o persona jurídica.

Puedes consultar nuestro DPA en nuestros términos de uso.

Verifacti tiene un SLA que está publicado en los términos de uso.

Si su empresa está ubicada en Canarias y debe aplicarse el IGIC o una exención fiscal en la suscripción de Verifacti, debe comunicarse con nuestro equipo soporte@verifacti.com. Ajustaremos su cuenta para que esté exenta de impuestos, permitiéndole proceder con la activación de la suscripción sin aplicar ningún tipo de gravamen.

Tras el aplazamiento de la entrada en vigor obligatoria de Veri*Factu hasta 2027, la gestión de la suscripción de pago en Verifacti depende del tipo de usuario.1. Obligados tributarios que emiten sus propias facturas

Si utilizas tu propio software de facturación, tienes estas opciones:

• Mantener la suscripción en producción: puedes seguir enviando facturas a la AEAT, al entorno de producción o de pruebas. Durante el periodo transitorio no hay repercusiones y sirve para validar que la integración funciona correctamente. La AEAT ha confirmado que es posible abandonar Veri*Factu y volver a un software no adaptado en cualquier momento.
• Cancelar la suscripción: puedes dar de baja la suscripción, pasar a coste cero y reactivarla más adelante cuando lo necesites. Consulta la FAQ de cancelación para conocer el procedimiento y sus efectos.

2. Fabricantes, comercializadores y distribuidores de softwarePara este colectivo sigue vigente la obligación, desde el 29 de julio de 2025, de que todo software de facturación vendido en España sea software adaptado, obligación confirmada por la AEAT tras el aplazamiento. Lo explicamos en la FAQ relativa a plazos. Como mínimo, un software adaptado debe incluir una opción de activación de Veri*Factu, ya sea voluntaria o diferida antes de 2027.Si eres fabricante, comercializador o distribuidor de software, tienes las siguientes opciones:

• Puedes valorar desactivar NIFs en producción para no pagar por ellos.
• Puedes reactivar esos NIFs fácilmente más adelante, cuando los necesites.

Nuestra recomendación es no cancelar la suscripción de pago, puesto que tienes la obligación de contar con un software adaptado. Seguirás pagando por el coste equivalente a un NIF en producción.

Cómo solicitar la cancelación de mi suscripción de pagoPara solicitar la cancelación de tu suscripción de pago a Verifacti sigue los siguientes pasos:

1. Navega a la sección de facturación.
2. Haz click en "cancelar".
3. Sigue los pasos hasta confirmar la cancelación.

Cuáles son las consecuencias de cancelar mi suscripción de pago

Consideraciones importantes en caso de cancelarse la suscripción de pago en Verifacti:

• Una vez has solicitado la cancelación de tu suscripción podrás seguir usando Verifacti hasta que termine tu ciclo de facturación (mensual o anual). Una vez terminado el plazo, se materializará la cancelación de tu suscripción de manera automática.
• Desactivar los NIFs no equivale a cancelar la suscripción. Incluso aunque todos los NIFs que has creado queden desactivados, se te seguirá cobrando el precio equivalente a 1 NIF en producción, lo cual te dará derecho a usar funcionalidad como la capacidad de crear NIFs en entorno de test, los webhooks y la API de gestión de NIFs. Para dejar de pagar es necesario cancelar la suscripción de pago.
• Una vez canceles tu suscripción, automáticamente quedarán desactivados los NIFs y webhooks que hayas creado.
• En caso de que trates de realizar envíos con API Keys de NIFs creados por ti y que han quedado desactivados como resultado de la cancelación de la suscripción, estos envíos darán error y no podrán realizarse.
• Recuerda que una vez se cancele tu suscripción cualquier registro de facturación (XML) generado por Verifacti será eliminado a los 30 días, a excepción del último de todos (necesario para continuar con tu cadena de XMLs en caso de retomar los envíos a la AEAT).
• Si quieres conservar los XMLs recuerda usar el endpoint exportar XMLs para obtener los XMLs antes de cancelar la suscripción y así evitar perderlos.

Las facturas que Verifacti emite a su empresa por los servicios o suscripciones contratadas están disponibles en la sección de Facturación.

Cuando se elige la domiciliación bancaria como método de pago, la factura se genera cuando el pago llega a la cuenta bancaria de destino, y eso suele tardar unos días en materializarse desde el momento del cobro (entre 3 y 5 días hábiles normalmente desde el momento en el cual se hace el cobro).Esta es la manera habitual de funcionar de la plataforma de pagos que utilizamos (Stripe), y no es algo que esté en la mano de Verifacti modificar.

Enviamos las facturas automáticamente al email indicado en la sección de Facturación. Dicho email se puede editar y puede ser diferente del email que se usa para iniciar sesión.

Te indicamos cómo asegurarte de que tus datos fiscales aparecen en la factura que Verifacti te emite a ti. Puedes introducir tus datos de facturación de dos maneras diferentes.Desde el área de Facturación

1. Entra en Verifacti con tu cuenta y navega a Facturación
2. Haz click en Acceder a tu portal de facturación
3. En el apartado Datos de facturación haz click en Actualizar datos

Este cambio solo afectará a facturas emitidas con posterioridad al cambio. Las facturas emitidas con anterioridad no recogerán los datos de facturación.

Al comprar tu suscripción

En el proceso de compra, tras elegir el método de pago, deberías de ver un checkbox que dice "Soy empresa". Haz click ahí y podrás introducir tus datos de facturación.

Para cambiar tu método de pago (de tarjeta a domiciliación bancaria o viceversa) sigue los siguientes pasos:

1. Navega al panel de facturación
2. Haz click en "Acceder a tu portal de facturación"
3. Busca la sección de métodos de pago y cambia tu método de pago, tienes dos opciones: tarjeta bancaria y domiciliación bancaria SEPA.

No es posible cambiar la periodicidad de facturación (de mensual a anual) directamente desde el dashboard de Verifacti. Para realizar este cambio, por favor, contacte con nuestro equipo en soporte@verifacti.com para que puedan gestionarlo por usted.

Verifacti emite una única factura por cada cuenta registrada. Si su cuenta tiene varios NIFs asociados, todos los servicios se agruparán en esa sola factura. Para recibir facturas separadas por cada NIF o sociedad, es necesario crear una cuenta de Verifacti independiente para cada una de ellas.

Verifacti ofrece a sus usuarios una plataforma web que permite:

• Explorar Verifacti e integrar el software utilizando una cuenta gratuita.
• Crear, activar y desactivar empresas (NIFs).
• Realizar llamadas desde la terminal.
• Acceder a documentación, preguntas frecuentes y recursos de integración.
• Consultar facturas y registros de facturación.

En la pantalla de inicio se pueden ver todos los NIFs creados, más el de test que venía incluido en la cuenta gratuita, separados en pestañas: test vs. producción.Pinchando en un NIF se accede a su panel de control individual:

• Inicio: Visualización de gráficos con información sobre la facturación del NIF.
• Facturas: Consulta de todas las facturas emitidas para el NIF, en una tabla filtrable por fecha y otros criterios.
• Registros: Acceso a todos los registros de facturación enviados a la Agencia Tributaria, incluyendo cualquier petición realizada a la administración a través de Verifacti.
• Terminal: Realización de llamadas a la administración para este NIF, con ejemplos de peticiones en el lado izquierdo y la respuesta de la API en el lado derecho.
• Configuración: Introducción de datos de la empresa y acceso a la API Key, necesaria para realizar peticiones para este NIF.

Con estas funcionalidades, la plataforma Verifacti facilita la gestión y automatización de los procesos de facturación con la administración tributaria.

Verifacti no ofrece funcionalidad para invitar a miembros del equipo a una cuenta. Solamente hay unas credenciales por cuenta en Verifacti.

En el caso de comercializadores y distribuidores de software, Verifacti no está pensado para compartir el acceso con los obligados tributarios, puesto que con un acceso podría verse la información privada de otros obligados tributarios.Sin embargo, sería muy fácil replicar las pantallas de registros o facturas en el propio software usando la información de la propia base de datos del software y/o endpoints que facilitan el acceso a la información ahí disponible:

• Listar facturas
• Exportar XMLs

Verifacti es una plataforma y API que permite a los usuarios enviar y gestionar sus facturas de forma automatizada.No proporcionamos servicios de facturación manual a partir de documentos como recetas o imágenes.

La solución de Verifacti se basa en una API REST que puede ser integrada con plataformas como OpenCart y PrestaShop.No obstante, actualmente no disponemos de soluciones específicas o plugins pre-construidos para estas plataformas.

En Verifacti hay dos tipos de API Keys que se obtienen de manera diferente.API Key de NIFCada obligado tributario para el cual se busca remitir facturas a la AEAT debe ser dado de alta en Verifacti y tendrá una API Key única por entorno. Idealmente, habrá dos API Keys por NIF: una para el entorno de test, y otra para el entorno de producción.Esta API Key es esencial para las llamadas a la API. Esta API Key permite:

• Identificar al contribuyente (sujeto pasivo de IVA) que figura en la factura como vendedor de un producto o servicio.
• Determinar el entorno de la administración al que se debe enviar la información fiscal (test vs. producción).
• Determinar la hacienda (AEAT vs. Haciendas Forales) a la que pertenece el contribuyente.

En Verifacti hay dos entornos: test y producción. Al añadir una empresa (un NIF) dentro de Verifacti hay que especificar el entorno (test o producción). Esa variable de entorno de la empresa en Verifacti definirá a qué entorno de la administración se envían las peticiones relativas a esa empresa.

• En entorno de test, la API Key de la empresa empieza por vf_test_
• En entorno de producción, la API Key de la empresa empieza por vf_prod_

Dependiendo de cada caso de uso, se requerirán más o menos API Keys de este tipo:

• Los distribuidores y comercializadores de software requerirán múltiples NIFs, uno por usuario o contribuyente.
• Las empresas independientes solamente necesitarán crear API Keys en test y prod para su propio NIF (o varios NIFs si son un grupo de empresas).

Las API Keys de NIFs se pueden generar de dos maneras:

1. Manualmente desde la pantalla de inicio. Haz click en "Añadir empresa" y sigue los pasos.
2. A través de la API de gestión de NIFs. Ver documentación.

Las API Keys pueden consultarse de dos maneras:

• Desde la sección de configuración dentro de cada NIF.
• También pueden obtenerse con la API de gestión de NIFs, endpoint API Key de NIF.

Para crear NIFs nuevos es necesario contar con una suscripción de pago.

• Una suscripción de pago por el coste equivalente a 1 NIF en producción da la capacidad de contar con múltiples NIFs en el entorno de prueba sin que el coste aumente.
• Con la suscripción de pago creada, es posible crear NIFs en entorno de producción, y la factura se ajustará al alza

API Key para la API de gestión de NIFsPara la utilización de la API de gestión de NIFs (altas y bajas de NIFs, webhooks, modelos de representación) es necesaria una API Key específica que se obtiene aquí.Para acceder a esta API Key es necesario contar con una suscripción de pago. Cualquier suscripción de pago, independientemente del coste o número de NIFs en producción de la misma, proporciona una API Key para la API de gestión de NIFs y la capacidad de contar con múltiples NIFs en el entorno de prueba.👉 Ver vídeo corto: Funcionamiento de nuestra API (Parte 2) - Cómo crear NIFs y obtener API Keys en Verifacti

Las API Keys no caducan.

Verifacti cuenta con una API específica para gestionar NIFs. Si tienes muchos obligados tributarios usando tu software, esta API es esencial para una integración exitosa.

En Verifacti puedes tanto desactivar un NIF (reversible) como eliminarlo permanentemente (irreversible).Cómo desactivar un NIF

La desactivación es reversible. Para desactivar un NIF hay dos caminos:

1. Manualmente, desde el panel de empresas, haciendo click en el botón "Desactivar"
2. Via endpoint, con el endpoint de desactivación de NIFs.

Consecuencias de desactivar un NIF

Cuando se desactiva un NIF:

• Ya no es posible hacer envíos de facturas a la AEAT con ese NIF.
• Se puede reactivar en cualquier momento el NIF (manualmente o vía endpoint Activar NIFs).
• En caso de tratarse de un NIF en producción y de no ser el único NIF en producción (es decir, si se tienen varios NIFs en producción y se desactiva uno de ellos), ya no se cobrará ese NIF en la siguiente factura.
• En caso de tratarse de el único NIF en producción entonces incluso aunque se desactive ese se seguirá cobrando el importe equivalente al primer NIF en producción mientras la suscripción de pago esté activa.

Cómo eliminar permanentemente un NIF

La eliminación permanente es irreversible: borra el NIF y toda la información asociada (incluidos los registros de facturación) de forma inmediata y definitiva. No incluye el modelo de representación. También hay dos caminos:

1. Manualmente, desde el panel de empresas.
2. Via endpoint, con el endpoint de eliminación permanente de NIFs.

Un NIF eliminado no puede reactivarse ni reutilizarse. Sí puedes volver a crearlo, pero se tratará como un NIF completamente nuevo, con su propia cadena de facturación independiente del NIF eliminado. Si se trataba de un NIF en producción, dejará de cobrarse.

En ese caso, simplemente debes crear un nuevo NIF en nuestra plataforma y desactivar el anterior.

La normativa de facturación exige que las facturas sean emitidas con numeración correlativa dentro de la misma serie.Asignación del número

La práctica correcta es asignar el número de la factura solo después de que haya sido enviada exitosamente a nuestra API y se haya recibido un estado 200 (OK) de respuesta. El estado 200 confirma que el registro de facturación ha sido creado, y al margen de que la AEAT acepte o rechace la factura por cualquier motivo, el número ha quedado asignado correctamente.Dicho esto, si se emiten facturas ligeramente en desorden con una diferencia de unos pocos minutos, esto no suele ser considerado un problema grave.Gestión en caso de rechazo de la factura por la AEAT

Una vez obtenido una respuesta de la API Verifacti estado 200, si la AEAT rechazara posteriormente la factura, el número estaría igualmente siendo utilizado de manera correcta, y no debería "liberarse" para otra factura. En este contexto, el registro de facturación ha sido creado y remitido a la AEAT, y por lo tanto el número está utilizado por la factura con errores. El rechazo de la AEAT debe resolverse mediante una factura rectificativa que hará referencia precisamente esa factura emitida con errores.Incidencias

En situación de incidencia como caída de internet puede suceder que se interrumpa la generación de facturas incluso en un contexto en el cual se siguen produciendo ventas (ver apartado incidencias). Idealmente, en esta situación, al reanudarse la conexión se deben enviar las facturas en orden de operación.No confundir secuencialidad con trazabilidad

Este requisito de secuencialidad de las facturas dentro de una misma serie que establece la normativa de facturación (y que Veri*Factu ignora) no debe confundirse con el requisito de encadenamiento o trazabilidad que sí establece Veri*Factu, y que afecta a los registros de facturación (XMLs) que la API Verifacti se encarga de generar. Es Verifacti por lo tanto quien garantiza este requisito de trazabilidad de los XMLs.Veri*Factu acepta facturas no secuencialesEs importante aclarar que Veri*Factu acepta sin errores la remisión de facturas con numeración no consecutivas. Por lo tanto, no debe asumirse que por haber sido aceptadas las facturas sin errores el requisito de secuencialidad ha quedado debidamente cumplido. Cumplir con Veri*Factu no exime del cumplimiento de la obligación de secuencialidad de la normativa de facturación.

Hay dos campos para fecha en la API Verifacti:

• fecha_expedicion: campo obligatorio, se trata de la fecha de emisión de la factura que debe ser la fecha actual.
• fecha_operacion: campo opcional, en caso de querer emitir una factura por una operación que ocurrió en una fecha pasada se debe usar este campo.

Datos a tener en cuenta:

• El campo fecha_operacion no afecta directamente a la secuencialidad numérica de las facturas.
• La secuencialidad se rige por la fecha de expedición.
• La numeración debe ser correlativa e ininterrumpida basándose en esta fecha de expedición/registro.
• El campo fecha_operacion simplemente indica cuándo se realizó la entrega del bien o la prestación del servicio. Puede ser anterior a la fecha de expedición/registro.
• La fecha de operación es la que marca a qué periodo de liquidación (mes o trimestre) debe imputarse ese IVA, incluso si la factura se expide con posterioridad (siempre dentro de los plazos reglamentarios).

Existe un campo en el registro de facturación (XML) que especifica la hora exacta de la generación del registro de facturación (FechaHoraHusoGenRegistro). Este campo lo completa la API Verifacti, y no requiere ningún dato al respecto en la llamada del usuario de la API.Es la hora que utiliza el sistema para el control temporal: la llamada a la Agencia Tributaria (o al software delegado) debe realizarse como máximo 240 segundos (4 minutos) después de esta hora de generación del registro, según la normativa.

La combinación de la serie y el número de factura no debe exceder los 60 caracteres.

Uno de los requisitos del sistema Veri*Factu al crear una factura nueva es incluir un desglose por tipo de IVA, que en la API de Veri*Factu se denomina líneas.Es importante aclarar que la administración no usa este desglose para obtener información sobre los productos o servicios vendidos. Su finalidad es exclusivamente reflejar diferentes tipos de IVA en aquellos casos en los que una misma factura incluya varios tipos de IVA.Por lo tanto, en situaciones en las que toda la factura tenga un único tipo de IVA, solo será necesaria una única línea.

Las líneas de desglose en el resumen de la factura deben agruparse tanto por tipo impositivo como por clave de régimen.

Si existen diferentes combinaciones de estos dos criterios, se debe generar una línea de desglose independiente para cada una de ellas, incluso si el tipo impositivo es el mismo pero la clave de régimen difiere.

La suma del desglose de una factura puede no coincidir exactamente con el total de la factura. Esta diferencia puede llegar a un máximo de varias decenas de euros. La administración no lo considerará un error.

Veri*Factu sí contempla las facturas emitidas por terceros o destinatario (auto-facturas). En la API se hace usando el campo emitida_por_tercero_o_destinatario. Estas facturas se pueden y se deben enviar al igual que todas las demás.Algunas aclaraciones importantes respecto a este tipo de facturas:

• De cara a calcular costes de la API Verifacti, en este tipo de facturas el obligado tributario (sujeto pasivo de IVA) debe estar dado de alta como NIF, incluso aunque no sea usuario del software de facturación.
• En el JSON no aparecerán los datos del obligado tributario, porque esos datos vendrán comunicados a través de la API Key de NIF
• En el caso de factura emitida por tercero, es necesario indicar quién es el tercero en los campos específicos nombre_tercero y nif_tercero

Las facturas que incluyan retención por IRPF, como en pagos a autónomos, deben excluir el componente de IRPF al ser comunicadas a la Agencia Tributaria a través de Veri*Factu. Esto implica que el importe total de la factura en manos del destinatario final será diferente al importe total de la factura en Veri*Factu. Cuando se consulta una factura en la web de la AEAT (a través del QR) en la propia AEAT explica que los datos que ahí aparecen no incluyen las retenciones.

En Veri*Factu no existe un campo específico de “descuento”: debes reflejarlo ajustando los importes de la factura. Puedes hacerlo restando el descuento directamente en la base imponible de la(s) línea(s) (enviando la base ya neta) o añadiendo una línea adicional con importe negativo (misma clave de IVA que la línea afectada), de modo que el importe total resulte correcto; si el descuento es posterior a la emisión, entonces corresponde una factura rectificativa/abono.

La administración establece que los suplidos no deben incluirse obligatoriamente en las facturas enviadas a través del sistema Veri*Factu. No obstante, pueden incluirse voluntariamente mediante una línea adicional con un IVA del 0%.

Sí, Verifacti API soporta el Régimen Especial de las Agencias de Viajes (REAV). Para registrar facturas bajo el Régimen Especial de Agencias de Viajes (REAV), utilice el parámetro clave_regimen con el valor 05.Puedes encontrar más información en la documentación de la API.

Sí, Verifacti API soporta el Régimen Especial de Bienes Usados (REBU). Para registrar facturas bajo el Régimen Especial de Bienes Usados (REBU) debe utilizar la clave_regimen con el valor 03.Puedes encontrar más información en la documentación de la API.

El Recargo de Equivalencia, si aplica, debe indicarse en las líneas de la factura, especificando tanto el porcentaje como la cuota correspondiente. Esto se alinea con la estructura de desglose de impuestos en las líneas de factura.

Todas las facturas deben comunicarse en EUR.

Puedes usar tantas series como quieras dentro de un mismo NIF.

No, no es necesario comprobar que la factura anterior ha sido admitida por Hacienda.

De hecho, en muchos contextos no es deseable esperar, puesto que la respuesta de la AEAT podría tardar minutos.

Lo único requerido es que el registro de facturación asociado a la factura previa haya sido generado correctamente, lo que en la práctica significa que la llamada a la API de Verifacti anterior haya devuelto un código de estado 200.

Cuando se emite una factura de tipo F1 es necesario identificar al destinatario. Aquí se distinguen dos casos:Cuando el destinatario es una persona física española (autónomo o no), una entidad española con un NIF válido o un extranjero con NIE.

* En este caso hay que informar de los campos "nif" y "nombre" donde el "nombre" corresponde al nombre y apellidos para personas físicas y la razón social para entidades.

• Para personas físicas el nombre debe ser suficientemente parecido al que aparece en el DNI.

Cuando el destinatario no es una persona física española ni una entidad española con un NIF válido ni posee NIE.

* En este caso hay que usar los campos "nombre" e "id_otro" para identificar al destinatario.

• Un caso concreto dentro de este caso general es el de empresas de la UE con un IVA VIES válido.
• Para identificar clientes extranjeros o no residentes, se debe puede usar el pasaporte o, en general, el campo 06 (otro documento probatorio) en la API. En estos casos, la AEAT no realiza la validación de dicho documento.

En caso de emitir una factura con algún error de destinatario, será necesario emitir una rectificativa por sustitución.

Verifacti facilita varios recursos para ayudar en la validación de los datos de los destinatarios de las facturas, para así minimizar errores.1. Validación por defecto del destinatario de las facturas

En la llamada de Crear factura nueva existe un campo validar_destinatario que está por defecto a true.

• Si se incluye el campo nif validamos por defecto que está censado en la AEAT ya que si no lo está, la AEAT rechazará el envío. Esto requiere una llamada adicional por nuestro lado por lo que si estás seguro de que los NIFs de los destinatarios están censados, puedes desactivar esta validación poniendo este campo a false. Esto hará que la llamada vaya más rápido.
• De manera similar, si se incluye el campo id_otro con id_type igual a 02 validamos por defecto que el IVA esté en el censo VIES. Se puede desactivar esta validación poniendo este campo a false.

2. Endpoints específicos de validación

También hay endpoints específicos para usar de manera selectiva fuera del proceso de creación de factura. Estos endpoints requieren una suscripción de pago activada.

• El endpoint Validar NIF en la AEAT permite hacer la validación anterior a través de un endpoint.
• El endpoint Validar IVA en VIES permite validar que un número de IVA intracomunitario se encuentra en el censo VIES. Conviene saber que este endpoint utiliza una API de la EU que falla bastante.

Si los datos del DNI/NIE del cliente son incorrectos o faltan, y las condiciones legales lo permiten, puedes transformar la factura en una factura simplificada.

Para ello, reenvía la factura marcando el tipo_factura como F2 y omitiendo el NIF y el nombre del cliente. Si deseas emitir una factura completa (tipo F1), es obligatorio incluir los datos correctos del destinatario.

Si se detecta que el nombre asociado a un DNI de un cliente es incorrecto, es fundamental obtener y registrar el nombre exacto.

La Agencia Tributaria (AEAT) exige que el nombre del receptor sea correcto. No está permitido marcar a una persona como NO censado si realmente figura en el censo, ya que el problema reside en la inexactitud del dato (el nombre) y no en la falta de registro del DNI.

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:

1. NIF emisor
2. Serie
3. Número
4. Fecha
5. 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.👉 Ver vídeo corto: QR en Veri*Factu, qué es y cómo se genera

Si no has guardado el QR en tu base de datos, puedes realizar una llamada adicional al endpoint de estado de registro para recuperarlo. Para ello, es necesario que hayas guardado el UUID de la petición con la que creaste la factura. Recuerda que con Veri*Factu solo es necesario incluir el QR en la factura; no es necesario incluir ni conservar la huella, a menos que ofrezcas servicios no-Veri*Factu.

Con Veri*Factu no es necesario incluir la huella en la factura, con el QR es suficiente. La huella sí debe ir incluida en el XML que se envía a la administración. La generación de dicho XML (con la huella) y su envío a la administración son responsabilidad de Verifacti.Con Ticketbai sí es necesario incluir la huella y forma parte de la respuesta de la API.

Existen librerías y funciones en todos los stacks tecnológicos para transformar el QR en imagen Base64 que devuelve la API en una imagen para poder pegarla a la factura.

Para el caso concreto SAAS que usan Stripe para suscripciones el flujo puede ser:

1. Llega el evento invoice.payment_succeeded, que trae el objeto invoice.
2. Hacer una llamada a nuestra API y recoger el QR.
3. En el objeto invoice está el PDF de stripe, en invoice.invoice_pdf. Se descarga, se pega el QR y se sube a un S3.
4. Al cliente se le enseña el PDF propio, no el de Stripe.

En cuanto al PDF, se pueden hacer dos cosas:

1. Usar una librería, pero aún así es costoso dejar todos los casos bien
2. Usar el propio PDF de stripe y simplemente modificarlo. Esto es realmente fácil y rápido.

La generación del QR es sencilla. Aunque la API Verifacti proporciona el QR inmediatamente al generar una nueva factura, muchos usuarios prefieren generarlo ellos mismos y añadirlo a la factura, ya que existen librerías de generación de QR en casi todos los lenguajes de programación.

Los QR se devuelven como una imagen codificada en base64, lo que resulta en una cadena de caracteres considerablemente larga (superando los 3000 caracteres), no en una URL corta como podría esperarse.

Sí, es obligatorio incluir un texto descriptivo junto al código QR en el PDF de la factura. Se pueden utilizar frases como VERI*FACTU o Factura verificable en la sede electrónica de la AEAT.

El tamaño del código QR debe seguir la norma ISO/IEC 18004. Dicha norma establece un mínimo de 4 módulos de margen. Los códigos QR generados por Verifacti tienen 6 módulos de margen, cumpliendo así con la especificación.

Sí, es recomendable guardar el QR por las siguientes razones:

1. Facilidad de reimpresión: Tener el QR guardado permite reimprimir el documento de manera rápida y sencilla en caso de pérdida o daño del original.
2. Verificación de autenticidad: El QR puede ser utilizado para verificar la autenticidad del documento en cualquier momento.
3. Cumplimiento normativo: Mantener el QR asegura que se cumplan las normativas de Veri*Factu y Ticketbai, ya que estos sistemas pueden requerir la presentación del QR en auditorías o revisiones.

Además, se sugiere almacenar el QR en un lugar seguro y accesible, como un archivo digital en la nube, para evitar su pérdida.

Sí es posible modificar y cancelar facturas en Veri*Factu y con la API Verifacti.

Para modificar o cancelar una factura ya generada es necesario realizar llamadas adicionales a la AEAT a través de registros de facturación adicionales.Los caminos posibles a seguir incluyen:

• Facturas rectificativas con el endpoint Crear Factura (para la mayoría de los casos)
• Facturas de abono con el endpoint Crear Factura (para devolución total)
• Endpoint anular factura (para casos muy restringidos en que se emitió la factura por error)
• Endpoint de subsanar factura (para casos muy restringidos en que el cambio no incluye campos con impacto fiscal)

Confusión con requisito de inalterabilidad

Es común escuchar que con el sistema Veri*Factu las facturas no pueden modificarse. Esta percepción es errónea. La inalterabilidad exigida por Veri*Factu se refiere a los registros de facturación (XMLs generados por Verifacti), no a las facturas en sí mismas. Los registros de facturación son los XML que genera Verifacti a partir de las llamadas realizadas a la API. Por cada llamada realizada a la Agencia Tributaria hay un XML (registro de facturación) y éstos no pueden modificarse a posteriori una vez creados.

Facturas rectificativas

• Siempre que quieras modificar cualquier aspecto de una factura (aceptada, parcialmente aceptada o rechazada) que suponga un cambio en datos con relevancia fiscal (como destinatario, importe, tipo impositivo, etc.), debes recurrir siempre a una factura rectificativa.
• Las facturas rectificativas son los tipos R1, R2, R3, R4 o R5.
• Las rectificativas son facturas nuevas con serie diferente a la original, y con su propio QR.
• Estas facturas adicionales deben hacerse llegar al destinatario.
• Cuando haces una rectificativa (incluyendo la F3), haces referencia a la factura original. Sin embargo, la AEAT no parece que haga ningún tipo de comprobación de que la factura original haya sido enviada previamente ni nada por el estilo.

Puedes perfectamente hacer una rectificativa haciendo referencia a una factura que nunca se envió a través del sistema Veri*Factu y no te dará problema a nivel de la API de la AEAT.Factura de abono

• La única excepción es cuando emites una factura por un bien que posteriormente es devuelto en su totalidad. En ese caso, basta con emitir una factura “negativa” normal. Se trata de una factura ordinaria con importe total negativo y que puede ir en la misma serie.
• Se trataría de una factura normal F1
• El hecho de que se puede emitir una F1 en negativo queda muy claro en los ejemplos de la AEAT, que se puede encontrar en el siguiente enlace.
• Estas facturas adicionales deben hacerse llegar al destinatario.
• Las facturas de abono no requieren serie propia, pueden ir en la misma serie que la factura original.

Estos endpoints existen en la API de Verifacti porque también existen en la API de la propia AEAT. Si bien la nomenclatura invita a usarlos para todo tipo de operaciones, la AEAT establece un uso muy restringido.Endpoint de Anulación

* Únicamente para facturas que nunca deberían de haberse emitido (emitidas por error).

• Importante: si se anula una factura, no se puede reutilizar ese número, ha de saltarse al siguiente porque de lo contrario Veri*Factu nos dirá que hay error de factura duplicada.

Endpoint de Subsanación

* Cuando el campo corregido no tenga ninguna implicación fiscal, como puede ser el campo descripción.

Verifacti no proporciona asesoramiento fiscal detallado para casos complejos de facturación (como devoluciones de facturas simplificadas, rectificativas con suplidos, o el uso de R1 y R5). Nuestra documentación y ejemplos cubren los escenarios más comunes.Para situaciones específicas o poco claras, recomendamos consultar a un asesor fiscal o directamente a la AEAT a través de verifactu@correo.aeat.es, quienes suelen ofrecer una respuesta rápida.

A continuación, se presenta una visión de alto nivel de los tipos de errores que pueden impedir que su factura sea considerada válida y correcta ante la Agencia Tributaria (AEAT).Algo muy importante a entender de cara a la gestión de errores es que bajo la normativa Veri*Factu, una factura no puede ser creada (ni entregada a su destinatario) si no se ha generado previamente el Registro de Facturación (XML), lo cual exige una llamada exitosa a la API de Verifacti. Esta es una línea roja de la AEAT, que acepta la remisión tardía del XML, pero no acepta la no-creación del XML.1. Respuesta código de estado 500 de la API Verifacti e Incidencias

• Una respuesta de código de estado 500 de la API Verifacti implica que algún tipo de incidencia impide hacer llamadas a la API de manera correcta. Un ejemplo sería que la API de Verifacti está caída.
• La manera de gestionar esta situación sería similar a la gestión de incidencias como caída de internet o de la luz, situaciones en las cuales se vuelve imposible contactar con la API Verifacti.
• En cualquiera de estas situaciones, incluso aunque sigan produciéndose transacciones y ventas, no debe entregarse factura al comprador del bien o servicio, puesto que la AEAT deja claro que no es posible emitir facturas sin que se genere un registro de facturación (XML), es decir, sin que se haya llamado previamente a la API Verifacti correctamente.

2. Respuesta código de estado 429 de la API Verifacti

• Este estado indica que se están haciendo demasiadas peticiones por minuto para una misma API key.
• Se deberá reintentar más tarde a un ritmo más bajo.

3. Respuesta código de estado 400 de la API Verifacti

• El código de estado de respuesta 400 indica errores de validación instantánea de la API de Verifacti que ocurren generalmente por fallos de formato, sintaxis, o autenticación de la petición.
• En caso de recibir un código de estado 400, la factura no puede darse por generada, ya que el registro de facturación no ha sido generado y no se ha devuelto el QR para pegar en la factura.
• En caso de recibir una respuesta con código de estado 400 debe corregirse el envío revisando y corrigiendo la la estructura de la petición y el formato de los datos (ej., asegurarte de que las fechas cumplen el formato DD-MM-YYYY).

4. Estado Rechazado o Aceptado con Errores del registro de facturación por parte de la AEAT

• Cuando se recibe una respuesta con código de estado 200, que viene acompañada del QR para pegar en la factura, el registro de facturación (XML) ya ha sido generado correctamente por la API Verifacti para su remisión a la AEAT y puede darse por generada la factura.
• En este momento se genera el proceso de remisión del registro de facturación a la AEAT, y el estado del registro será "Pendiente".
• Una vez completada la remisión, proceso que puede tardar unos minutos, la AEAT emite un XML de respuesta indicando si han aceptado el registro de facturación.
• El estado del registro debe consultarse a través de dos posible caminos: webhooks (recomendado) o endpoint de estado de registro.
• El estado del registro también puede verse en el interfaz web verifacti.com, dentro del panel de cada NIF, en el menú "Registros".
• Los errores de la AEAT ocurren por fallos en el contenido fiscal del registro (ej., NIF/CIF incorrecto).
• Cuando el registro no tiene el estado "Correcto" entonces la factura ha sido creada, pero no es fiscalmente válida a pesar de haber recibido el OK inicial de Verifacti.
• En este caso, debe rectificarse la factura. Esto implica emitir una Factura Rectificativa para corregir la factura mediante un registro de facturación adicional. En casos excepcionales se puede emitir un registro de subsanación.

5. Errores por incumplimiento normativo ajeno a Veri*Factu

Cumplir con Veri*Factu no garantiza el cumplimiento de todas las normativad de facturación ni de las normas contables o tributarias. Es frecuente encontrarse con situaciones en las que el sistema Veri*Factu acepta facturas con elementos incorrectos desde el punto de vista de la normativa de facturación. Por eso no debe asumirse que una respuesta "correcta" de la AEAT a una llamada a su API a través de Verifacti equivalga a un visto bueno normativo total.Algunos ejemplos de errores en facturas que sin embargo son aceptados por Veri*Factu (y por la API Verifacti) son los siguientes:

• Veri*Factu acepta sin errores facturas que incumplen el requisito de secuencialidad de las facturas dentro de una misma serie que establece la normativa de facturación. Veri*Factu no dará error si enviamos facturas en orden no secuencial, a pesar de ser algo incorrecto y sancionable.
• Veri*Factu acepta sin errores facturas en las cuales la fecha de expedición es anterior a la fecha de la respuesta con código de estado 200 de la API Verifacti, que es el momento exacto de creación del registro de facturación. Esto es incorrecto, ya que la AEAT establece que la fecha de expedición debe coincidir con el momento de la creación del registro de facturación (XML).

En relación a los errores que detecta y previene Verifacti, hay que distinguir entre dos tipos diferentes de errores:Detección de errores en el registro de facturación

* La API Verifacti tiene un sistema de validación que impide algunos de los errores más tipicos en los registros de facturación. Cuando se detectan se impide la creación del registro de facturación, se evita el envío a la AEAT y la necesidad de una rectificativa posterior.

• Si bien la API Verifacti detecta muchos errores, no es posible detectarlos todos y por ello es posible que los registros se encuentren con errores de la AEAT una vez remitidos a hacienda.

Detección de errores según normativas de facturación o fiscales

* Veri*Factu acepta sin errores facturas que tienen errores según distintas normativas vigentes, como por ejemplo, facturas con numeración no secuencial o facturas con fecha de expedición anterior a la fecha de creación del registro de facturación.

• La API Verifacti no hace ningún tipo de validación en estas situaciones. El motivo es que sería arriesgado poner validaciones que no pone la propia administración, siendo posible que la tolerancia a ciertos errores tenga razones que desconocemos y por tanto esa tolerancia debe ser preservada en la API Verifacti también.

A continuación explicamos cómo lidiar con distintos tipos de incidencias.Caída de la AEAT: nos encargamos nosotrosEn caso de que la incidencia sea una caída de la API de la administración (algo que ya ha sucedido en entorno de pruebas en el pasado) Verifacti se encargará de reintentar los envíos hasta que la API de la AEAT vuelva a estar operativa. Los usuarios de Verifacti no deben preocuparse por lo tanto de esta eventualidad, que queda cubierta por nuestra API.Otras incidencias: reintento de llamadas y justificante provisional de venta o retraso de la emisión de la factura (solo B2B)

Cualquiera de las siguientes 3 situaciones suponen la imposibilidad de llamar a la API Verifacti:

• Corte de energía
• Caída de Internet
• Caída de la API Verifacti

La AEAT aborda este tema en una pregunta frecuente de su web, con una respuesta que puede llevar a error. Ahí la AEAT dice que se acepta la remisión tardía del Registro de Facturación (el XML con los datos de la factura) y que se puede “seguir facturando”. Sin embargo, esa FAQ de la AEAT presupone la capacidad de generar el XML on-premise, algo muy poco habitual. Por lo tanto la AEAT da el visto bueno a retrasar el envío del XML, pero no da el visto bueno a retrasar la creación del XML a un momento posterior a la emisión de la factura.En consultas que hemos realizado a la AEAT nos han confirmado que no es posible bajo ningún concepto emitir una factura sin la generación previa del XML. Para aquellos softwares que usan nuestra API, esto quiere decir que crear facturas sin poder llamar a nuestra API no es una posibilidad.La AEAT nos ha comunicado en consultas realizadas que dada esta situación sería aceptable la emisión de un justificante provisional de venta. Es decir, sí se puede seguir vendiendo (y cobrando por ejemplo con la TPV si fuera necesario), simplemente hay que asegurarse de que no se entrega una factura al cliente. En cambio, se le debe entregar una documento alternativo, que incluya los datos que llevaría la factura, pero que aclare que no es la factura, y que indique un canal para obtener la factura más adelante a quién así lo desee.Una vez la incidencia se ha solucionado, y se ha recuperado la capacidad de hacer llamadas a la API Verifacti, deben realizarse todas las llamadas pendientes de generación de factura:

• Debe procurarse que las llamadas de hagan en el mismo orden que tuvieron lugar las transacciones, aunque de no conseguirse no sería un problema grave.
• Debe marcarse el campo de incidencia a TRUE.
• Debe considerarse marcar el campo fecha de operación con la fecha de la transacción si ha transcurrido más de un día.

Conviene también aclarar que en caso de tratarse de una operación B2B, aclarar que es posible retrasar la emisión de la factura. En este caso, la factura puede ser emitida con posterioridad, hasta el día 16 del mes siguiente a la transacción. Esta es otra solución admisible.

A continuación te mostramos algunos errores típicos detectados por la API Verifacti y que generan una respuesta inmediata con código de estado 400. Te mostramos los errores y te damos información para solucionarlos:

• Encabezado de Autorización (Authorization Header): Asegúrate de que el token de autorización esté precedido por la palabra Bearer. Formato correcto: Authorization: Bearer [tu_token].
• Formato de Fecha (fecha_expedicion): Verifica que la fecha esté en el formato DD-MM-YYYY (día y mes con dos dígitos). Por ejemplo, 22-02-2025.
• Campo id_otro: Este campo debe ser un objeto JSON directamente, no una cadena de texto que contenga un JSON.
• Separador Decimal en Importes: Utiliza el punto ( . ) como separador decimal para todos los importes (ej: 320.00) con un máximo de 2 decimales.
• Valores Booleanos (true/false): Asegúrate de que los valores booleanos sean true o false (en minúsculas y sin comillas), no cadenas de texto como "True".
• Manejo de serie y número: Si la información de serie y número se combina en el campo numero, el campo serie debe enviarse explícitamente como una cadena vacía ("").
• Campos de línea mal ubicados: Campos como impuesto, clave_regimen y calificacion_operacion son campos a nivel de línea y deben ser incluidos dentro de los ítems de la factura, no a nivel de cabecera.

Recomendamos encarecidamente revisar nuestra documentación oficial y los ejemplos detallados para asegurar una implementación correcta.

A continuación profundizamos en los errores que puede encontrar la AEAT en los registros de facturación (XML) recibidos de la API Verifacti y cómo gestionarlos:Posibles errores

* Son muchos los posibles errores que la AEAT puede encontrar en un registro de facturación, siendo los más típico los errores de formato o la combinación errónea (contraria a la documentación) de valores de diferentes campos.

• El siguiente documento de la AEAT recoge un listado de posibles errores .

Gestión de los errores

* Si la factura ha sido entregada al cliente, incluso aunque la AEAT haya rechazado el registro de facturación, la factura se da por generada, y por lo tanto su numeración queda "ocupada" y no debe volver a emitirse otra factura con esa numeración.

• El camino recomendado por la AEAT para solucionar estas situaciones es la emisión de facturas rectificativas, que requieren una serie diferente a las originales. Más información sobre las facturas rectificativas en la sección de ejemplos.
• La situación quedaría arreglada por lo tanto mediante registro(s) de facturación adiconal(es), y sin modificar el registro de facturación original, respetando así el requisito de integridad e inalterabilidad de los registros de facturación.
• Únicamente en casos donde la factura no se entregó al cliente final y la factura nunca debió emitirse o se emitió por error podría usarse el endpoint de anulación de factura.

Una integración exitosa debe incluir un mecanismo para escuchar la respuesta de la AEAT a las peticiones realizadas para confirmar que no hay errores.Esto te permitirá:

• Confirmar que la petición fue procesada correctamente.
• Detectar y corregir errores de la Administración a tiempo.

Se puede hacer:

• A través de webhooks (preferible)
• A través del endpoint de estado de registro (exige una llamada extra por cada petición)

La huella (hash) se aplica a los registros de facturación, no a las facturas individuales.

Verifacti es responsable de encadenar estos registros de forma secuencial en el momento de su generación, independientemente de si la factura asociada es posteriormente aceptada o rechazada por el sistema.El estado final de una factura se determina tras su envío, por lo que la secuencia del encadenamiento no se ve afectada por reenvíos de facturas corregidas o previamente rechazadas.

Si el registro de facturación se ha enviado a la AEAT, incluso aunque la AEAT haya rechazado el registro de facturación la factura se da por generada, su numeración queda "ocupada" y no debe volver a emitirse otra factura con esa numeración.

El estado Duplicado y los detalles asociados son respuestas que provienen directamente de la Agencia Tributaria (AEAT), no son generadas por la API de Verifacti. Esto significa que la AEAT ya ha recibido y procesado previamente un registro con los mismos datos.

Ante una factura duplicada no es necesario emitir una rectificativa. La AEAT sencillamente la ignorará.

Sí, es posible usar la misma serie y número de factura en diferentes ejercicios fiscales.Verifactu y la API de la AEAT solo consideran una factura como duplicada si coincide la serie, el número y la fecha de expedición.

Al crear facturas por lotes, las respuestas se devuelven en el mismo orden en que fueron enviadas las facturas. Si alguna factura es rechazada debido a un error de validación, se devolverá un mensaje de error que especificará el índice de la factura dentro del lote que ha fallado. Para probar el envío de lotes de facturas, es necesario tener una suscripción activa.

Actualmente, no es posible ver el estado o el historial de los envíos de webhooks en la interfaz gráfica de Verifacti. El webhook intentará enviar el mensaje a su endpoint configurado inmediatamente después de que la factura se envíe a la AEAT, lo que suele ocurrir aproximadamente un minuto después de su petición.

Según las especificaciones de la AEAT, los registros de facturación deben empaquetarse y enviarse en grupos, no de forma individual.

Verifacti agrupa múltiples registros en un único envío a la AEAT. Cada vez que se realiza un envío de este tipo, se notifica a su webhook con la información de todos los registros incluidos en ese paquete.Por lo tanto, el número de llamadas al webhook corresponde al número de envíos empaquetados realizados a la AEAT, no al número individual de facturas procesadas.

Sí, los webhooks de Verifacti se reintentan automáticamente si su endpoint no responde con un código 2xx dentro del tiempo de espera de 10 segundos. La política actual es:

• Hasta 3 reintentos (4 intentos en total).
• Esperas crecientes de 1 minuto, 6 minutos y 30 minutos.
• Los errores 4xx se consideran permanentes y no se reintentan.

Cada notificación incluye el header X-Webhook-Id, estable a través de reintentos, que puede utilizar como clave de idempotencia para no procesar dos veces la misma notificación.Si un endpoint falla de forma reiterada, desactivamos el webhook automáticamente y le avisamos por correo electrónico. No hay reactivación automática: deberá volver a activarlo manualmente desde su panel una vez corregido el problema; al reactivarlo se reinician los contadores de fallos.Aun así, como buena práctica para garantizar la coherencia de los datos, le recomendamos revisar periódicamente si tiene registros en estado Pendiente con una antigüedad superior a un cierto umbral y utilizar el endpoint de consulta de estado de registro para obtener la información actualizada del documento.

El endpoint de listado de facturas de la API Verifacti consulta directamente la API de la AEAT. Actualmente, la API de la AEAT no permite obtener un listado de facturas de un solo día. Para realizar la consulta, es necesario especificar un rango de fechas.

Sí, para obtener las facturas de un año completo, debe realizar 12 llamadas al endpoint de listado de facturas, configurando el parámetro periodo para cada mes (del 1 al 12). Esta es una restricción de la API de la AEAT.

No existe una manera de consultar a Hacienda la última factura emitida. La última factura emitida debe obtenerse de la propia base de datos del software. Sí es posible listar facturas a través del endpoint listar facturas que traslada la petición directamente a la AEAT, pero no puede hacer una llamada que devuelva solamente la última.

No es necesario incluir las facturas antiguas anteriores del mismo periodo fiscal o de una misma serie.

El entorno de producción de Veri*Factu está habilitado desde abril de 2025. Ya es posible enviar facturas reales a la AEAT.

Para realizar pruebas, debes crear la empresa en modo test. Una misma empresa puede existir en modo test y modo producción simultáneamente, cada una con su propia API Key diferente.

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 documento:

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.

👉 Ver vídeo corto: Declaración responsable parte 1, certificación, dónde incluirla, versiones y otras dudas

La AEAT ha publicado un ejemplo de declaración responsable en PDF.Nosotros hemos adaptado este ejemplo para nuestros usuarios. Lo puedes descargar aquí:

• Proporcionamos un documento de Word editable.
• Incluimos notas informativas para los apartados más complicados.
• Añadimos una sección para explicar el papel de la API Verifacti.

Información clave para rellenar el documento:

1. Los títulos de sección están en negrita y con letra más grande.
2. Sustituye las respuestas de ejemplo con tus propios datos.
3. Borra las notas informativas al completar el documento.

Es obligatorio mencionar a Verifacti como componente externo. Hemos incluido una sección específica para arquitecturas mixtas con componente externo. Debéis indicar nuestro número de versión de software vigente, que puede cambiar. Contáis con un endpoint específico para obtener nuestra declaración y el número de versión vigente.👉 Ver vídeo corto: Declaración responsable parte 2: guía para completar la declaración responsable fácilmente

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.

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 pregungas 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.Verifacti sí ha firmado con la AEAT un convenio específico de colaboración social (convenio 017) que nos permite utilizar nuestro propio certificado para remitir información fiscal a la AEAT en nombre de nuestros clientes. Ver listado de entidades con acuerdo aquí (aparecemos como Bilbabit SL).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.

Ver preguntas específicas de la AEAT al respecto.

Te remitimos a las instrucciones disponibles en la plantilla del documento.

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.

👉 Ver vídeo corto: Certificados y representación (Parte 1) - Certificado de Colaborador Social de Verifacti

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.

Dos formas de firmar el modeloEn ambos casos, el modelo de representació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 del modelo, se firma con el certificado digital del NIF emisor y se sube a Verifacti. Es gratuito.

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

1. Crear NIF en producción (la representación ya estará gestionada sin necesidad de volverlo a hacer).

👉 Ver vídeo corto: Certificados y representación (Parte 2) - Ayuda para la Firma de Modelos de Representación

Sí. Además de la firma con certificado digital, Verifacti ofrece la Firma online: el titular del NIF verifica su identidad por vídeo y firma el modelo de representación desde el navegador, sin necesidad de certificado digital y sin instalar nada. Este método solo está disponible para personas físicas (autónomos); las personas jurídicas deben seguir firmando con certificado digital. Cada proceso de firma online tiene un coste de 2,90 € + IVA. Puedes ver el proceso paso a paso en la guía Firma online del modelo de representación.

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.

El endpoint de Verifacti solo acepta archivos en formato PDF para el Modelo de Representación firmado.

En España, para interactuar con la Agencia Tributaria (Hacienda) y plataformas como Verifacti, se aceptan certificados digitales emitidos por cualquier Entidad Certificadora reconocida, no limitándose exclusivamente a la FNMT.Para la gestión y aplicación de estas firmas digitales, el software AutoFirma (desarrollado por el Gobierno de España) es una excelente opción.Asimismo, programas como Adobe Acrobat también permiten firmar documentos digitalmente utilizando los certificados válidos instalados en su sistema.

Asegúrate de que el NIF que aparece en el certificado digital sea exactamente el mismo que el NIF registrado en nuestros sistemas y en cualquier documento asociado, como los archivos PDF de configuración o alta.Un error común es una discrepancia de un dígito o letra entre el NIF del certificado y el NIF de otros documentos.

Para corregirlo, genere el PDF del documento de representación de nuevo con el NIF correcto, fírmelo y envíelo.Si cree que su modelo es válido, por favor, póngase en contacto con soporte@verifacti.com para que puedan revisarlo y aprobarlo manualmente.

Este error ( Codigo[4112] ), en el entorno de pruebas de la AEAT se debe a pruebas internas realizadas por la propia AEAT y no a un problema con Verifacti. Generalmente, ocurre los sábados por la mañana.El entorno de producción de Verifacti no se ve afectado y funciona correctamente con el mismo certificado.

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 sucediendo antes de la normativa de Veri*Factu.👉 Ver vídeo corto: Veri*Factu vs No Veri*Factu, y la obligación de conservación de los XML Registro de Facturación

Puedes acceder a los datos de un NIF de dos maneras diferentes:

1. Vía endpoint - Verifacti facilita endpoints para descargar los registros de facturación para aquellos usuarios que deseen guardarlos.

Endpoint exportar XMLsEndpoint descargar XML

1. Interfaz web - Puedes consultar los últimos registros a través de la interfaz web, desde la pantalla de registros de cada uno de los NIFs.

Recuerda que Verifacti solo guarda los XMLs generados 30 días naturales después de la desactivación de un NIF. Es responsabilidad de cada usuario de la API Verifacti exportar los XMLs en caso de querer conservarlos.

Toda la información relativa a un NIF (obligado tributario) se conserva mientras esté activo en el entorno de producción. Una vez deja de estar activo, pasado un tiempo corto (ver términos de uso) no garantizamos la custodia de esos datos.Verifacti facilita endpoints para descargar los registros de facturación para aquellos usuarios que deseen guardarlos.Endpoint exportar XMLsEndpoint descargar XML

Sí. Desde Verifacti tenemos la intención de dar respuesta a las necesidades que surjan en torno a la factura electrónica una vez se haya desarrollado el reglamento. Por el momento no es posible al no existir el desarrollo normativo necesario.

Sí. Verifacti tiene intención de dar cobertura al sistema de Navarra NaTicket para cubrir la totalidad del territorio español.

¿Por qué existen dos APIs diferentes para integrar con Veri*Factu y con TicketBAI?

Hemos decidido diseñar dos APIs diferenciadas, una para Veri*Factu 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 Veri*Factu, 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.

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 generar el XML usando los datos proporcionados en la llamada a la API y de firmarlo conforme a la normativa.Cada factura se enlaza criptográficamente con la anterior, y la firma digital garantiza su integridad, evitando manipulaciones. Para ello, es necesario un certificado digital emitido por un proveedor de servicios de confianza cualificado.La legislación vigente admite el uso de varios tipos de certificados digitales para firmar facturas TicketBAI:

• Certificado de dispositivo: creado explícitamente para su uso en TicketBAI.
• Certificado representante de entidad: identifica a la persona física responsable de la persona jurídica.
• Certificado de sello de entidad:: no aparecen datos personales del representante, solo se identifica la empresa.
• Certificado de autónomo: creado explícitamente para su uso en TicketBAI.

En general, la decisión de qué certificado utilizar depende de diversos factores: naturaleza jurídica, software que se va a utilizar, escenario de facturación y características del certificado.¿Por qué elegir el certificado de dispositivo con Verifacti?

En Verifacti optamos por implementar el uso de certificados de dispositivo, ya que presentan numerosas ventajas frente a otras opciones:

• Uso exclusivo para TicketBAI: No permite realizar otros trámites ante la Hacienda Foral.
• Privacidad asegurada: El contribuyente no debe proporcionar su propio certificado personal.
• Simplicidad operativa: El mismo certificado puede utilizarse tanto para firmar como para enviar los ficheros XML.
• La API Verifacti integra un certificado de dispositivo emitido por un QTSP (Izenpe). Este debe estar previamente registrado y asociado al NIF del contribuyente ante la Hacienda Foral. Aunque Verifacti ofrece una opción gestionada para minimizar el esfuerzo técnico, también permite que el integrador utilice su propio certificado de dispositivo si así lo prefiere.

Registro del certificado de dispositivo

Para que el certificado de dispositivo pueda utilizarse en el envío de ficheros TicketBAI, debe estar vinculado al NIF del emisor de las facturas. El proceso varía ligeramente según la provincia:Para Álava y Vizcaya el registro se efectúa antes de enviar el primer registro de facturación. En caso de no hacerlo, Hacienda rechazará el envío e informará en el mensaje de error que la causa es que el certificado no esté registrado.Para Guipúzcoa el registro se efectúa después de enviar el primer registro de facturación.En ambos casos, el proceso de registro es muy sencillo y se realiza de manera telemática. Los pasos para hacerlo son los siguientes:

1. El contribuyente accede al portal web de la Hacienda Foral con su certificado digital personal.
2. Proporciona el número de serie del certificado de dispositivo de Verifacti (1f3647f642e9fae56807d91d6865a22a).

Puedes encontrar los enlaces a los portales de cada una de las Haciendas forales aquí:Registro de certificado de dispositivo en Araba

Registro de certificado de dispositivo en GuipúzcoaRegistro de certificado de dispositivo en VizcayaIMPORTANTE: Si el registro no se realiza, los ficheros TicketBAI serán rechazados por la Hacienda Foral.

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):

• Listado de Software TicketBAI en Álava
• Listado de Software TicketBAI en Guipúzcoa
• Listado de Software Garante en Vizcaya