Preguntas frecuentes de la API Verifactu

Respuestas a las dudas más habituales al integrar Verifactu con la API Verifactu de Verifacti: cómo crear facturas y rectificativas, el QR, los errores de la AEAT, los webhooks, el paso a producción y la declaración responsable. Lo que dice la norma sobre a quién aplica y desde cuándo está en la página de Verifactu. La referencia completa de la API está en la documentación.

Preguntas comunes de Verifactu

8 preguntas

¿Cuáles son los plazos para la adecuación a Verifactu?

El RDL 15/2025, de 2 de diciembre (BOE del 3 de diciembre de 2025), amplió estos plazos. Planteamos debajo los plazos publicados en el BOE, que la AEAT explica aquí.
1. Plazos para software de uso propio
Si 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)
Son fechas publicadas en el BOE. Además, Hacienda ha anunciado un aplazamiento a octubre de 2028 (nota informativa del 5 de octubre de 2026), todavía sin norma publicada.
2. Plazos para productores o comercializadores de software
Si eres productor o comercializador de software, tu software debe estar adaptado a Verifactu 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.
Excepción: software ya vendidos con contrato plurianual de mantenimiento, el plazo se alarga a los plazos de 2027 (ver arriba).
Todas las fechas, con su estado, en Cuándo entra en vigor Verifactu.

¿Cuándo debo enviar las facturas a la AEAT?

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.

¿Por qué es recomendable una adopción temprana de Verifactu?

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 Verifactu. Vender software no adaptado expone al SIF a sanciones muy importantes. Esta obligación legal no ha cambiado con el aplazamiento del 2 de diciembre de 2025 (RDL 15/2025), que solo afecta a obligados tributarios individuales con su propio software, ni con el aplazamiento a octubre de 2028 que ha anunciado Hacienda sin norma publicada. Todas las fechas, con su estado, en Cuándo entra en vigor Verifactu.
  • 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 Verifactu. Cualquier oferta de software que se produzca de ahora en adelante que no incorpore Verifactu estará en desventaja competitiva respecto a aquellos que puedan asegurar el cumplimiento normativo.
Para las empresas que facturan
Adaptarse antes de la fecha obligatoria permite probar la integración y resolver incidencias sin la presión del plazo.

¿Cual es la diferencia entre un registro de facturación y una factura?

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.

¿Deben comunicarse a la AEAT los tickets, recibos y facturas simplificadas?

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 Verifactu. En otras palabras, todos los tickets deben ser comunicados por el sistema Verifactu como facturas simplificadas
Mira el ejemplo de factura simplificada.

¿Es posible enviar facturas de un mismo NIF con SIFs diferentes?

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

¿Qué es modo NO VERI*FACTU y por qué no está cubierto por la API?

La administración ofrece dos caminos para cumplir con el sistema Verifactu: 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. Modalidad preferente: la AEAT presenta VERI*FACTU como la modalidad preferente.
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: Verifactu vs NO VERI*FACTU, y la obligación de conservación de los XML Registro de Facturación
Más en Modalidades VERI*FACTU y NO VERI*FACTU.

¿Es obligatorio el sistema Verifactu para empresas ya acogidas al Suministro Inmediato de Información (SII)?

No, las empresas acogidas al Suministro Inmediato de Información (SII) no tienen la obligación de adecuarse al sistema Verifactu.
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.

Funcionamiento de la API

15 preguntas

¿Cómo funciona la API Verifacti?

La API de Verifacti para Verifactu 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 rapidez
La 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 gestionar la espera entre envíos que impone la AEAT: Verifacti encola los registros y respeta su control de flujo.
  • 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.
Validación previa y errores de la AEAT
Los endpoints y la estructura de las llamadas siguen los de la API de la AEAT. Cada factura se valida antes de enviarla y el error vuelve con un código (catálogo de códigos). Cuando la AEAT rechaza un registro, su respuesta llega tal cual, con el código y el mensaje de la AEAT.

¿Qué pasos debo seguir para integrarme con la API Verifacti y asegurar el cumplimiento normativo?

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.

¿Quién se encarga de generar la huella o hash, el encadenamiento y el XML?

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.

¿Qué es el requisito de trazabilidad y cómo cumple con ello la API Verifacti?

El requisito de trazabilidad exigido por Verifactu 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 Verifactu no tiene en cuenta (no da error cuando no se cumple la secuencialidad) y que no tiene nada que ver con la trazabilidad.

¿Por qué motivo tarda unos minutos en llegar mi factura a la AEAT?

En el caso de Verifactu la administración ha impuesto unos límites a la cantidad y tiempos de las peticiones que se puede realizar a la AEAT y por eso la API devuelve el QR de manera inmediata y el registro de facturación llega a la administración después, normalmente en uno o dos minutos. Esto es correcto y es la manera que ha elegido la AEAT para gestionar las peticiones a su API.
En TicketBAI la respuesta trae al instante el código TicketBAI (tbai) y el QR para imprimirlos en la factura; el envío a la hacienda foral también se hace después.

¿Qué capacidades y funcionalidades ofrece la API?

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
  • Cada factura se valida antes de enviarla y el error vuelve con un código
  • 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

¿Puedo integrar Verifacti con mi lenguajes y stacks tecnológico?

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.

¿Cómo garantiza Verifacti la trazabilidad si una misma empresa (mismo CIF) utiliza el sistema para facturar desde múltiples establecimientos o TPVs con series de facturación diferentes?

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.

¿Es posible enviar facturas a la AEAT a través de la API de Verifacti utilizando Excel o Google Sheets?

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.

¿Tenéis colecciones de Postman?

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

¿Cómo funciona la cabecera Idempotency-Key y cuándo debo usarla?

La cabecera opcional Idempotency-Key permite reintentar un envío sin riesgo de duplicarlo, por ejemplo tras un timeout o un corte de conexión. La admiten /verifactu/create, /verifactu/create_bulk, /verifactu/modify y /verifactu/cancel, en TicketBAI /ticketbai/create, /ticketbai/modify y /ticketbai/cancel, y en el SII /sii/create, /sii/create_bulk, /sii/modify y /sii/cancel.
Genera una clave única por operación (una cadena ASCII imprimible de 1 a 255 caracteres; un UUID sirve) y guárdala junto a la factura antes de enviarla. Así funciona:
  • Mismo cuerpo, misma clave: la API devuelve el código y el cuerpo de la primera respuesta, con la cabecera Idempotent-Replayed: true, y no crea un registro nuevo.
  • Respuestas que se guardan: las 2xx y las 4xx. Un 400 también se repite, así que si corriges los datos usa una clave nueva. Las 5xx no se guardan: el reintento se procesa de nuevo y se vuelven a validar todos los datos, incluida la fecha de expedición.
  • Duración: 24 horas desde la primera respuesta. Los reintentos no alargan el plazo; después, la petición se procesa como nueva.
  • Ámbito: la clave va ligada al NIF emisor, no a la API key, así que sigue valiendo tras rotar la clave. Una petición rechazada por autenticación (401) no la consume.
  • Errores: la misma clave con un cuerpo distinto o en otro endpoint devuelve 422; si la primera petición sigue en curso, el reintento devuelve 409 y basta con repetir en unos segundos.
Si has perdido la respuesta y han pasado más de 24 horas, comprueba primero si la factura se registró: cómo saber si una factura se registró sin el uuid. Detalle completo en la documentación de la API.

¿Qué datos de las respuestas de la API de Verifacti se recomienda guardar en mi base de datos?

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: xml_req (XML de la solicitud) y xml_res (XML de la respuesta) para fines de auditoría y referencia.

¿Son diferentes las URLs de los endpoints en los entornos de test y producción?

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_

¿Tengo que incluir el identificador del SIF en mis llamadas a Verifacti?

Por defecto no hace falta. Verifacti genera el XML que se envía a la AEAT y rellena el bloque SistemaInformatico con su propia identidad.
Si quieres que los registros de Verifactu lleven la identidad de tu software, configúrala por NIF (campo sistema_informatico de POST /nifs o PUT /nifs/{entorno}/{nif}/sistema_informatico) y envía sistema_informatico.version e sistema_informatico.indicador_multiples_ot en cada petición. Ver ¿Qué datos de SistemaInformatico figuran en los registros que Verifacti envía a la AEAT?

¿Qué versiones de SSL/TLS soporta la API de Verifactu?

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

Nueva factura

16 preguntas

¿Cómo debo gestionar la numeración de las facturas con Verifactu para asegurar la secuencialidad y el orden correcto de las facturas dentro de la misma serie?

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 Verifactu ignora) no debe confundirse con el requisito de encadenamiento o trazabilidad que sí establece Verifactu, 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.
Verifactu acepta facturas no secuenciales
Es importante aclarar que Verifactu 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 Verifactu no exime del cumplimiento de la obligación de secuencialidad de la normativa de facturación.

¿Cómo debo rellenar los campos de fecha de expedicion y operacion al crear facturas y cual es el impacto en numeración y fiscalidad?

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

¿Como puedo incluir la hora de creación de factura en la llamada?

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.

¿Cuál es la longitud máxima del campo serie?

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

¿Por qué sólo hay 12 líneas en las facturas?

Uno de los requisitos del sistema Verifactu al crear una factura nueva es incluir un desglose por tipo de IVA, que en la API de Verifactu 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.

¿Cómo agrupar las líneas de desglose de la factura por tipo impositivo y clave de régimen?

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.

Ejemplo: Varios tipos de IVA.

¿Cómo gestionar autofacturas o facturas emitidas por terceros a Verifactu?

Verifactu 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

Ejemplo: Emitida por terceros.

¿Cómo incluyo las retenciones por IRPF?

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 Verifactu. Esto implica que el importe total de la factura en manos del destinatario final será diferente al importe total de la factura en Verifactu. 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.

Ejemplo: Suplidos y retención.

¿Cómo puedo reflejar un descuento en una factura?

En Verifactu 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.

¿Cómo incluyo los suplidos?

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

Ejemplo: Suplidos y retención.

¿Verifacti API soporta el Régimen Especial de las Agencias de Viajes (REAV)?

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.

¿Verifacti API soporta el Régimen Especial de Bienes Usados (REBU)?

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.

Ejemplo: REBU (bienes usados).

¿Cómo se gestiona el Recargo de Equivalencia al enviar facturas a la API de Verifacti?

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.

Ejemplo: Recargo de equivalencia.

¿Cómo se comunican las facturas emitidas en moneda extranjera?

Todas las facturas deben comunicarse en EUR.

¿Hay límite de series en un mismo NIF?

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

¿Es necesario verificar la aceptación de la factura anterior por Hacienda antes de realizar una nueva llamada a la API de Verifacti?

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.

Destinatario y validación del NIF

4 preguntas

¿Cómo introducir los datos fiscales (NIF, DNI) de los destinatarios de las facturas nacionales o extranjeros?

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

¿Cómo validar los datos fiscales de clientes y destinatarios nacionales y extranjeros de las facturas para evitar errores?

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.

¿Cómo proceder si faltan o son incorrectos los datos de DNI/NIE del cliente en una factura?

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.

¿Puedo marcar al cliente como 'NO censado' si no tengo los datos correctos de su DNI?

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.

QR

10 preguntas

¿Qué es el QR y cómo lo obtengo?

El QR en el sistema Verifactu 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 Verifactu. La administración espera que todas las facturas emitidas por contribuyentes sujetos al sistema Verifactu 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 Verifactu, qué es y cómo se genera
Más en QR de Verifactu.

¿Puedo recuperar el QR de una factura si no lo he guardado en mi base de datos?

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 Verifactu solo es necesario incluir el QR en la factura; no es necesario incluir ni conservar la huella, a menos que ofrezcas servicios no-Verifactu.

¿Debo incluir la huella en la factura para cumplir con Verifactu?

Con Verifactu 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.
En TicketBAI la factura lleva el código TicketBAI y el QR, que devuelve la API; la huella no se imprime.

¿Cómo transformo el QR para pegarlo en mi factura?

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.

¿Cómo transformo el QR para pegarlo en mi factura si uso Stripe?

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.

¿Puedo generar yo mismo el QR?

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.

¿Cuál es la longitud esperada de los códigos QR en la respuesta de la API de Verifacti?

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.

¿Es obligatorio añadir texto junto al código QR en las facturas Verifactu?

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.
Más en QR de Verifactu.

¿Qué especificaciones de márgenes tienen los códigos QR generados por la API de Verifacti y cumplen con la normativa 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.

¿Es recomendable guardar el QR por si tengo que reimprimirlo?

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

Anulación y modificación

5 preguntas

¿Cómo puedo anular, cancelar, modificar o subsanar una factura con la API Verifacti?

Sí es posible modificar y cancelar facturas en Verifactu 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 Verifactu las facturas no pueden modificarse. Esta percepción es errónea. La inalterabilidad exigida por Verifactu 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.

¿Cuándo y cómo usar las facturas rectificativas y de abono?

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

¿Cuándo y cómo usar los endpoints de subsanación y de anulación?

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

¿Cómo gestiono el cambio o transformación de una factura simplificada en una normal?

  • En las facturas simplificadas (tipo F2) no se pueden añadir los datos del destinatario.
  • Las facturas normales (tipo F1) sí llevan datos de destinatario.
  • Se podría generar primero una simplificada y "convertirla" en una normal añadiendo los datos del destinatario. Muchos de nuestros usuarios se refieren a esto como "Factura de canje". En esta situación hay que emitir una factura nueva sustitutiva tipo F3.

¿Verifacti ofrece asesoramiento fiscal para facturas en casos complejos (ej. rectificativas, suplidos)?

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.

Errores e incidencias

13 preguntas

¿Qué tipo de errores pueden surgir al enviar facturas y cómo los gestiono?

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 Verifactu, 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
  • Has superado el límite de peticiones por minuto de tu API key.
  • Reintenta más tarde y a menor ritmo.
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 o sintaxis de la petición. Una API key ausente o incorrecta devuelve 401.
  • 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 Incorrecto 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 Verifactu
Cumplir con Verifactu 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 Verifactu 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 Verifactu (y por la API Verifacti) son los siguientes:
  • Verifactu 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. Verifactu no dará error si enviamos facturas en orden no secuencial, a pesar de ser algo incorrecto y sancionable.
  • Verifactu 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).
Más en la guía de errores de Verifactu.

¿Por qué la API Verifacti permite el envío de facturas que son erróneas y no lo impide a través de sistemas de validación?

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
* Verifactu 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.

¿Cómo debo gestionar incidencias como caída de Internet, caída de las APIs de Verifacti con código 500, caída de la AEAT o cortes de luz?

A continuación explicamos cómo lidiar con distintos tipos de incidencias.
Caída de la AEAT: nos encargamos nosotros
En caso de que la incidencia sea una caída de la API de la administración (algo que ya ha ocurrido, también en producción) 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 enviarse el campo incidencia con el valor S.
  • 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, antes del día 16 del mes siguiente a la transacción. Esta es otra solución admisible.

¿Que tipo de errores de código de estado 400 puede dar la API Verifacti y cómo puedo solucionarlos?

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): el formato correcto es Authorization: Bearer [tu_API_key]. Ojo: si falta la API key o no es válida, la respuesta no es 400 sino 401.
  • 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.

¿Que posibles errores puede encontrar la AEAT en mis facturas y cómo los debo gestionar?

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.
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.
Más en la guía de errores de Verifactu.

¿Cómo puedo saber si la AEAT acepta mi factura sin errores o si la AEAT encuentra errores?

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:

¿Cómo afecta el reenvío de facturas corregidas tras detectarse un error de la AEAT a la huella (hash)?

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.

¿Cómo afecta el reenvío de facturas corregidas o rechazadas tras detectarse un error de la AEAT a la numeración?

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.

¿Por qué la API de Verifacti devuelve el estado 'Duplicado' para una factura?

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.

¿Cómo gestiono el error "factura duplicada"?

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

¿Es posible usar la misma serie y número de factura en diferentes ejercicios fiscales sin que Verifactu lo considere un duplicado?

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.

¿Cómo se asocian las respuestas a las facturas enviadas por lotes y cómo se gestionan los errores de validació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.

He perdido la respuesta de un envío y no tengo el uuid. ¿Cómo sé si la factura se registró?

Consulta la factura con POST /verifactu/status enviando serie, numero y fecha_expedicion (y fecha_operacion si la informaste). La API consulta la AEAT y te devuelve el registro con su uuid, su estado y su huella.
  • Si aparece, la factura ya está registrada: no la vuelvas a enviar.
  • Si responde «Factura no encontrada», puede que todavía no haya llegado a la AEAT: los registros se remiten de forma asíncrona, normalmente en pocos minutos. Espera unos minutos y vuelve a consultar antes de reenviarla.
  • Si la consulta devuelve 502, la AEAT no ha respondido: repítela más tarde.
Si no han pasado 24 horas desde el envío y guardaste la Idempotency-Key, también puedes repetir la misma petición con la misma clave y el mismo cuerpo: recibirás la respuesta original, con el uuid, sin crear un registro nuevo.
En TicketBAI, POST /ticketbai/status admite los mismos campos.

Webhooks

3 preguntas

¿Es posible hacer un seguimiento del estado o historial de los envíos de webhooks desde la interfaz gráfica de Verifacti?

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 normalmente ocurre uno o dos minutos después de su petición.

¿Por qué el número de llamadas a mi webhook es menor que el número de facturas que he enviado?

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.

¿Se reintentan los webhooks de Verifacti si mi endpoint no está disponible o falla?

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.

Listado de facturas

3 preguntas

¿Cómo puedo obtener un listado de facturas para un día específico utilizando la API?

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.

¿Debo realizar 12 llamadas al endpoint de listado de facturas para obtener los datos de un año completo?

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.

¿Puedo consultar el número de la última emitida para hacer la siguiente?

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.

Paso a producción

3 preguntas

Cuando empecemos a dar de alta a nuestros usuarios, ¿qué debemos hacer con las facturas antiguas anteriores?

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

¿Cuándo se puede comenzar a enviar las facturas al entorno de producción de la AEAT?

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

¿Cómo puedo realizar pruebas si mi empresa ya está configurada en modo producción?

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.

Certificación y declaración responsable

7 preguntas

¿Qué es la declaración responsable?

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 Verifactu) 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 Verifactu 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:
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 Verifactu. 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
Más sobre la declaración responsable.

¿Cómo hago mi declaración responsable?

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. Tienes que indicar nuestra versión de software vigente, que puede cambiar: la devuelve GET /verifactu/declaracion junto con nuestra declaración.
👉 Ver vídeo corto: Declaración responsable parte 2: guía para completar la declaración responsable fácilmente
Más sobre la declaración responsable.

¿Es necesario homologar o certificar mi software?

No existe un listado de softwares homologados para Verifactu 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 un registro de “software garante”: el fabricante declara que su software cumple y lo inscribe en cada hacienda foral. Nosotros también cubrimos TicketBAI y estamos inscritos como “software garante” en los tres territorios: Álava, Bizkaia y Gipuzkoa. Incluimos aquí el listado de softwares garantes de Bizkaia a modo de ejemplo.
Más sobre la declaración responsable.

¿Es Verifacti un software homologado por la AEAT?

No existe un listado de softwares homologados para Verifactu 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.
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 un registro de “software garante”: el fabricante declara que su software cumple y lo inscribe en cada hacienda foral. Nosotros también cubrimos TicketBAI y estamos inscritos como “software garante” en los tres territorios: Álava, Bizkaia y Gipuzkoa. Incluimos aquí el listado de softwares garantes de Bizkaia a modo de ejemplo.
Más sobre la declaración responsable.

¿Qué datos de SistemaInformatico figuran en los registros que Verifacti envía a la AEAT?

Por defecto, los registros llevan la identificación de Verifacti como sistema informático de facturación, la misma que figura en nuestra declaración responsable: NombreRazon BILBABIT SL, NIF B75777847, NombreSistemaInformatico bilbabit, IdSistemaInformatico A1 y la versión declarada.
Si tu software es el que expide las facturas e invoca nuestra API, puedes hacer que los registros lleven su identidad. La nota del bloque SistemaInformatico del anexo de la Orden HAC/1177/2024 indica que, cuando el sistema consta de componentes de varios productores, se consignan los datos del productor del componente principal, y en una integración por API ese componente suele ser tu software. Se configura por cada NIF de Verifactu:
  • Al crear el NIF, con el campo sistema_informatico de POST /nifs, o después con PUT /nifs/{entorno}/{nif}/sistema_informatico: razón social y NIF del productor, nombre del sistema, IdSistemaInformatico (exactamente 2 caracteres, letras mayúsculas o dígitos), TipoUsoPosibleSoloVerifactu y TipoUsoPosibleMultiOT.
  • En cada petición de crear, modificar o anular factura, tu software envía sistema_informatico.version y sistema_informatico.indicador_multiples_ot, que calcula para cada uno de tus usuarios (FAQ 4 de la AEAT para desarrolladores). Mientras el NIF use la identidad de Verifacti se ignoran, así que conviene desplegar primero su envío y cambiar después los NIFs.
  • Cambiar de identidad es, para la AEAT, un sistema informático nuevo: el NIF recibe un número de instalación nuevo y el siguiente registro empieza una cadena nueva. Los registros ya enviados no cambian, y los que estuvieran pendientes de envío se envían con la identidad con la que se generaron.
  • Tu declaración responsable debe mencionar que utilizas nuestro componente y su versión.
Sobre el resto del bloque:
  • NumeroInstalacion lo asigna Verifacti: distingue cada NIF dado de alta en Verifacti y cada cambio de identidad, y no se repite nunca.
  • Con la identidad de Verifacti, TipoUsoPosibleSoloVerifactu, TipoUsoPosibleMultiOT e IndicadorMultiplesOT van siempre a S. Con tu identidad, los dos primeros son los que configuras y el tercero, el que envías en cada petición.
En el entorno de pruebas, los NIFs con la identidad de Verifacti usan la identificación de prueba (NombreSistemaInformatico NombreSistemaInformatico, IdSistemaInformatico 77, versión 1.0.03), por eso su XML de test no coincide con el de producción.

¿Qué es el número de instalación que figura en la declaración responsable y cómo lo gestiono?

¿Qué es la identificación del Sistema Informático que figura en la declaración responsable y cómo lo gestiono?

Almacenamiento y exportación de datos

1 pregunta

¿Cuáles son las obligaciones de conservación de datos con Verifactu?

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 XMLs
Endpoint descargar XML
Asimismo, Verifacti guarda esta información mientras el NIF está activo en producción y 30 días naturales después de su desactivación.
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 Verifactu sigue vigente. Sí existen, por tanto, obligaciones de conservación en lo relativo a las facturas, tal y como ya venía sucediendo antes de la normativa de Verifactu.
👉 Ver vídeo corto: Verifactu vs NO VERI*FACTU, y la obligación de conservación de los XML Registro de Facturación

Empieza a integrar hoy

Pruébalo gratis con el entorno de test.

Entorno de test y NIF de prueba incluidosVer precios