El código QR de VeriFactu en las facturas: para qué sirve y cómo usarlo

Introducción: el QR ya no es decorativo, es cumplimiento

Durante años, el QR en una factura era un detalle opcional:
un enlace al área de cliente, a una copia del PDF o a una página comercial.

Con la llegada del nuevo marco de facturación y el modelo VeriFactu,
eso cambia por completo.

Hoy el código QR es:

• un requisito normativo,
• un mecanismo de verificación pública,
• y una pieza esencial para que la factura sea considerada verificable según el Reglamento de Facturación (RDF 1007/2023).

La premisa es simple:
una factura verificable debe poder validarse desde fuera de tu sistema,
y el QR es la puerta de entrada a esa verificación.

Escaneándolo, cualquier persona —un cliente, un asesor o la propia administración— puede acceder al servicio de verificación (cotejo) en la Sede electrónica de la AEAT, donde se contrastan los datos de la factura con la información registrada oficialmente.

En este artículo aprenderás:

• por qué existe este QR obligatorio,
• qué contiene exactamente,
• cómo funciona el proceso de verificación,
• dónde debe colocarse dentro del PDF,
• qué ocurre si no aparece,
• y cómo OkVerifactu lo genera automáticamente como parte de tu flujo normal de facturación.

El objetivo es que entiendas qué hace este QR, por qué tu factura lo necesita y cómo asegurarte de que tus PDFs lo incluyen correctamente.

El código QR de una factura VeriFactu no es "un QR cualquiera". En el contexto del nuevo modelo de facturación, hablamos de un QR regulatorio: definido en el Reglamento de Facturación, obligatorio para las facturas emitidas bajo el modelo VeriFactu y diseñado específicamente para permitir su verificación en la Sede electrónica de la AEAT.

Dicho de otra forma:

Es el punto de unión entre tu factura, tu sistema de facturación y la Agencia Tributaria.

Qué es el QR de VeriFactu

Cuando en este artículo hablamos del "QR de VeriFactu", nos referimos a un código que:

• Está generado por un sistema de facturación conforme (no por un generador genérico).
• Codifica la información necesaria para identificar de forma única la factura y su emisor.
• Incluye, directa o indirectamente, una URL de verificación en la sede de la AEAT.
• Permite acceder al servicio de cotejo, donde la administración puede contrastar la información de esa factura.
• Forma parte de lo que convierte a esa factura en verificable, no solo "emitida".

En otras palabras, no es solo un gráfico: es un componente clave del sistema de verificación pública que exige VeriFactu.

Qué NO es el QR de VeriFactu

Para evitar confusiones, es importante aclarar lo que NO es este QR:

• No Es un QR que apunta a tu tienda online o a una landing comercial.
• No Es un QR que abre simplemente una copia PDF sin ningún tipo de cotejo oficial.
• No Es un QR generado "a mano" con una web de crear códigos QR.
• No Es un elemento visual opcional que puedas quitar o poner "según diseño".

Por qué es tan importante entender esta diferencia

Muchas tiendas online dan por hecho que "tener un QR en la factura" es suficiente, pero de cara al cumplimiento normativo lo que importa no es que haya un cuadrado con puntitos, sino qué hace ese QR y adónde lleva.

La diferencia es crítica:

• Un QR regulatorio de VeriFactu permite el cotejo oficial en la AEAT y forma parte de una factura verificable.
• Un QR decorativo o apuntando a un PDF no aporta nada en términos de verificabilidad, por muy útil que resulte para tu cliente.

Para qué sirve el QR: la función real del cotejo

Sabiendo ya qué es el QR de VeriFactu, toca responder a la pregunta clave: ¿para qué sirve realmente? No está ahí "para quedar bonito"; es la pieza visible de todo el mecanismo de verificación que hay detrás de una factura verificable.

En el modelo VeriFactu, el QR tiene tres grandes funciones:

• Permitir la verificación pública de la factura sin entrar en tu sistema.
• Conectar el PDF con la información registrada en la AEAT.
• Aportar una prueba adicional de autenticidad e integridad de la factura.

Verificación pública de la factura

El objetivo principal del QR es que cualquier persona pueda verificar la factura sin pedir acceso a tu backoffice ni depender de tus copias internas. Escaneando el QR se puede:

• Comprobar que la factura existe en los sistemas de verificación habilitados.
• Contrastar que los datos esenciales (emisor, fecha, importe, número…) coinciden con lo que aparece en el PDF.
• Validar que la factura no ha sido modificada desde que se emitió.

Conexión con la Sede electrónica de la AEAT

En el contexto VeriFactu, el QR está diseñado para que:

• Codifique, directa o indirectamente, una URL de verificación en la Sede electrónica de la AEAT.
• Permita acceder al servicio de cotejo, donde la Agencia Tributaria puede contrastar la información de la factura.
• Sirva como puente entre el documento que ve el cliente y los datos que la administración tiene registrados.

De esta forma, el QR no solo sirve para ti como comercio, sino también para:

• La AEAT, que puede cotejar fácilmente la factura.
• Tu asesoría o auditor, que puede comprobar que la factura está correctamente registrada.
• Tu cliente, que puede tener la tranquilidad de estar recibiendo una factura verificable.

Prueba de autenticidad e integridad

Además de permitir el cotejo, el QR refuerza dos ideas fundamentales:

Esto es posible porque el QR está ligado al registro técnico, al hash y al encadenamiento que genera el sistema de facturación conforme. Si alguien intentara manipular la factura fuera de ese sistema, el resultado del cotejo no coincidiría.

Qué cambia en la práctica para tu tienda

En tu día a día como tienda online, la existencia de este QR implica que:

• No basta con "mandar un PDF"; la factura tiene que ser verificable.
• Cualquier tercero puede validar la factura sin depender de tus copias internas.
• La administración dispone de un mecanismo estándar para cotejar los datos de tu facturación.

El resultado es un entorno donde:

• Tus clientes confían más en tus facturas.
• Tu asesoría tiene menos fricción a la hora de justificar la facturación.
• Y tú reduces riesgos porque cada factura puede defenderse técnicamente si algún día alguien la revisa.

Qué información contiene el QR de VeriFactu

El QR regulatorio no muestra datos sensibles del cliente, pero sí incluye lo necesario para identificar la factura y permitir su verificación en la Sede electrónica de la AEAT. Esa información no siempre es visible de forma directa, pero está codificada para que el sistema pueda interpretarla.

Datos que incluye el QR

De forma general, el QR de una factura VeriFactu contiene o referencia:

• Identificador único de la factura.
• NIF del emisor.
• Fecha y hora de expedición.
• Importe total.
• Elementos de referencia al hash de la factura.
• URL de verificación en la Sede electrónica de la AEAT.

Qué se ve al escanear el QR

Cuando alguien escanea el QR con un móvil o un lector, es redirigido a la página de verificación de la AEAT, donde puede consultar:

• Datos esenciales de la factura (emisor, fecha, importe, número).
• Coincidencia entre el documento y los registros disponibles.
• Confirmación de que la factura es auténtica.
• Verificación de integridad (si coincide con el registro contra el que se coteja).

Qué NO contiene el QR

Para evitar confusiones, conviene recordar que el QR:

• No contiene información sensible del cliente.
• No expone datos fiscales completos en texto legible.
• No guarda copias del PDF.
• No permite acceder a tu backoffice ni a datos internos de tu tienda.
• No sustituye al registro técnico de la factura.

Por qué está diseñado así

El QR está diseñado para:

• Permitir verificar la factura sin comprometer información privada.
• Ofrecer un método rápido de cotejo para clientes, asesores y administración.
• Garantizar que la factura puede validarse incluso fuera del entorno del comercio.
• Servir como vínculo entre el PDF y los datos registrados oficialmente.

Cómo funciona el proceso de verificación en la AEAT

Cuando alguien escanea el QR de una factura VeriFactu, no está abriendo un PDF ni una copia local del documento. Está accediendo al servicio de verificación (cotejo) de la Sede electrónica de la AEAT, donde se contrasta la información de esa factura con los datos registrados en el sistema oficial. Este proceso es lo que convierte a una factura en verificable.

Qué ocurre al escanear el QR

El flujo es sencillo:

1. 1El usuario abre la cámara o un lector de QR.
2. 2El lector detecta que el QR pertenece al modelo VeriFactu.
3. 3El sistema redirige a una URL de verificación de la AEAT.
4. 4La AEAT muestra la página de cotejo, con información relacionada con esa factura.

Qué comprueba exactamente la AEAT

En la página de verificación, la AEAT muestra o confirma:

• Que la factura existe en sus registros de verificación.
• Que el NIF del emisor coincide con el declarado.
• Que los datos esenciales (fecha, número, importe) coinciden con el documento.
• Que la factura es auténtica.
• Que el documento no ha sido manipulado después de su emisión.

Qué significa que la verificación coincida (o no)

Cuando la verificación coincide:

• La factura se considera válida.
• El contenido del PDF coincide con la información disponible en la AEAT.
• El receptor puede confiar en que no ha habido manipulaciones.

Si la verificación no coincide:

• La factura puede haber sido modificada fuera del sistema.
• Puede existir un error en la cadena técnica.
• O no corresponde con los datos que la AEAT tiene registrados.

Validez aunque se haya reenviado o impreso

Una de las ventajas del QR es que permite verificar la factura incluso si:

• Se reenvía por correo.
• Se imprime en papel.
• Se genera una copia o captura.
• El cliente la reenvía a un tercero.

Por qué este proceso es tan importante

Este sistema garantiza que:

• La factura puede defenderse ante auditorías o revisiones.
• El comercio no depende de sus propias copias internas para justificar integridad.
• La administración dispone de un método objetivo para comprobar la información.
• Los clientes pueden verificar la factura por sí mismos.

Dónde debe aparecer el QR en una factura y cómo debe verse

El QR de VeriFactu debe estar visible y claramente identificable en la representación de la factura. No es un elemento opcional ni decorativo: forma parte del cumplimiento y debe poder escanearse con facilidad por cualquier receptor.

Ejemplo de factura VeriFactu

El QR debe aparecer en una zona visible y limpia de la factura

Ubicación recomendada en el PDF

La normativa no obliga a una posición exacta, pero sí exige que el QR esté visible y accesible. Las ubicaciones más utilizadas y recomendadas son:

• Parte superior derecha del documento.
• Zona inferior de la factura (derecha o centrada).
• Zona limpia, sin elementos visuales que dificulten su lectura.
• Siempre dentro del cuerpo principal de la factura, nunca fuera del área imprimible.

Tamaño mínimo recomendado

Para asegurar que el QR se lea correctamente:

• Tamaño mínimo recomendado: 2,5–3 cm por cada lado.
• Evitar reducirlo por debajo de 2 cm, ya que muchos móviles no lo reconocerán.
• Mantener el mismo tamaño tanto en el PDF como en la impresión en papel.

Contraste y calidad visual

Para una lectura correcta:

• Debe existir alto contraste entre el QR y el fondo (normalmente negro sobre blanco).
• No colocar el QR sobre imágenes, fondos texturizados ni colores intensos.
• Mantener un margen de espacio en blanco alrededor del QR para facilitar la lectura.
• Evitar rotaciones, transparencias o filtros.

En qué casos puede no mostrarse

En modo Producción, el QR debe mostrarse siempre en la factura. Sin embargo, puede no aparecer en situaciones específicas:

• Durante pruebas en modo Test.
• Si la factura todavía no ha pasado por el proceso completo de generación/verificación.
• Si la plantilla PDF del tema de la tienda sobrescribe el módulo que inserta el QR.
• Si el PDF se generó antes de que el QR estuviera disponible.

Por qué la visibilidad del QR es tan importante

Un QR que no se puede leer o no se encuentra fácilmente genera problemas:

• Impide verificar rápidamente la factura.
• Ralentiza auditorías y revisiones.
• Puede interpretarse como un fallo de cumplimiento.
• Resta confianza al cliente si no entiende por qué su factura no incluye un QR legible.

Qué NO sustituye el QR (y por qué no basta él solo)

El QR es esencial en una factura verificable, pero no es el único elemento que exige VeriFactu. Su función principal es permitir el cotejo público en la Sede electrónica de la AEAT, pero no reemplaza los mecanismos internos que garantizan la integridad de la facturación.

El QR no sustituye al hash

El QR no es la huella criptográfica de la factura.
El hash es el identificador técnico que garantiza que el contenido no ha sido modificado.
Sin hash:

• No hay integridad demostrable.
• No se puede detectar manipulación posterior.
• No se puede encadenar la factura con la siguiente.

El QR no sustituye al encadenamiento

El encadenamiento es el mecanismo que une cada factura con la anterior mediante su hash, creando una secuencia inmutable. Su función es evitar:

• Facturas eliminadas sin rastro.
• Saltos en la numeración no explicados.
• Manipulación en la secuencia temporal.

El QR no sustituye al registro técnico

El registro técnico es el fichero detallado y estructurado que recoge todo el contenido fiscal de la factura. Es la base de:

• La verificación oficial.
• La coherencia de datos.
• La trazabilidad ante la administración.

El QR no sustituye a las evidencias

Las evidencias (hash, cadena, estados, logs, respuestas…) son la "historia técnica" de cada factura. Sirven para:

• Justificar qué ha pasado con cada documento.
• Entender rechazos o avisos.
• Demostrar cumplimiento en una auditoría.
• Reconstruir la facturación en caso de incidencia.

Por qué es importante entender esto

Muchas tiendas creen que "si ya tengo el QR, estoy cumpliendo".
Pero esa es solo la parte visible.

Una factura verificable necesita:

• Registro técnico.
• Hash.
• Encadenamiento.
• Evidencias.
• QR regulatorio.

Cómo genera OkVerifactu el QR regulatorio

Hasta aquí hemos visto qué es el QR de VeriFactu, para qué sirve y qué NO sustituye. Ahora toca ver cómo encaja todo esto en tu día a día con OkVerifactu y tu tienda online.

La idea es sencilla:

• Tu tienda genera la factura como siempre.
• OkVerifactu se encarga de construir todo el sistema técnico (registro, hash, cadena, evidencias)
• y, como resultado natural de ese proceso, genera el QR regulatorio que acaba en tu PDF.

Tu tienda emite la factura

El flujo empieza donde siempre:

• Tu cliente realiza un pedido.
• El pedido llega al estado en el que tu tienda genera la factura (por ejemplo, "Pago aceptado").
• La plataforma (PrestaShop u otra) crea la factura con su número, fecha, líneas e importes.

En ese momento entra en juego el módulo o integración de OkVerifactu.

El módulo captura los datos y los manda a OkVerifactu

Cuando se crea la factura:

• El módulo de OkVerifactu recoge los datos necesarios (emisor, cliente, productos, impuestos, totales, fechas…).
• Construye la petición técnica con toda la información relevante.
• Envía esos datos de forma segura a OkVerifactu mediante API.

OkVerifactu genera el registro, el hash y el encadenamiento

Dentro de OkVerifactu se realizan las operaciones clave:

• Se crea el registro técnico completo de la factura.
• Se calcula la huella (hash) del registro.
• Se encadena ese hash con el de la factura anterior, manteniendo la secuencia.
• Se guardan las evidencias asociadas al proceso.

En función de la configuración y del momento normativo, el sistema también puede gestionar la comunicación con la AEAT para obtener el estado correspondiente.

Se genera el QR regulatorio

Una vez que el registro está creado y encadenado, OkVerifactu genera el QR regulatorio que:

• Identifica de forma única la factura y su emisor.
• Incorpora lo necesario para acceder al cotejo en la Sede electrónica de la AEAT (cuando aplica).
• Queda asociado internamente a las evidencias y al registro técnico de esa factura.

OkVerifactu devuelve el QR a tu tienda y se inserta en el PDF

Cuando el QR está listo:

• OkVerifactu avisa a tu tienda mediante un webhook o mecanismo equivalente.
• El módulo actualiza la factura en tu plataforma y guarda el QR asociado.
• En la siguiente generación del PDF, el QR aparece en la posición definida en tu plantilla (por ejemplo, en la parte inferior, como en las facturas de OkVerifactu para PrestaShop).

Desde tu punto de vista:

Qué ves tú como usuario de OkVerifactu

En tu panel de OkVerifactu puedes:

• Ver el listado de facturas y rectificativas.
• Consultar sus estados técnicos.
• Acceder a detalles del registro, hash, cadena y evidencias.
• Entender qué ha pasado si hay avisos o errores.

En tus PDFs ves:

• La factura de siempre.
• Con el QR regulatorio en la posición definida.
• Lista para ser cotejada en la AEAT.

Errores frecuentes cuando el QR no aparece en el PDF (y cómo interpretarlos)

Que el QR no se vea en la factura no siempre significa que no se haya generado. En la mayoría de los casos, está creado correctamente en OkVerifactu, pero el PDF aún no ha sido actualizado o tu tienda no ha recibido la información a tiempo. Estos son los escenarios más habituales y cómo entenderlos.

La factura aún no está lista a nivel técnico

Hay situaciones en las que la factura existe, pero el QR todavía no está disponible para insertarse en el PDF:

• Factura recién creada que aún no ha sido procesada por OkVerifactu.
• Registro técnico generado, pero el proceso de verificación todavía está pendiente.
• Flujo interno sin finalizar (especialmente si el servidor va lento o hay colas de procesos).

El webhook no está funcionando o no ha notificado la actualización

El QR llega a tu tienda mediante un webhook. Si el webhook:

• No está configurado.
• No puede conectarse a tu tienda.
• Da error intermitente.
• Está bloqueado por firewall o hosting.

Entonces la factura tiene QR en OkVerifactu, pero tu tienda no lo ha recibido.

La plantilla PDF de tu tema sobrescribe la plantilla del módulo

Es una causa muy habitual en PrestaShop:

• El tema usa una plantilla PDF personalizada.
• Esa plantilla no incluye el hook donde el módulo inserta el QR.
• El QR sí existe, pero el PDF no lo tiene "dónde ponerlo".

El PDF se generó antes de que el QR estuviera disponible

Si tu tienda:

• Genera el PDF automáticamente al crear la factura.
• O envía el PDF por correo inmediatamente.
• O almacena una copia estática en disco.

Puede ocurrir que ese PDF se genere antes de que OkVerifactu haya devuelto el QR.

Uso de modo Test o entornos de prueba

En modo Test:

• Algunas plantillas pueden ocultar elementos del PDF para evitar confusiones.
• No siempre se insertan los elementos visuales que sí aparecen en Producción.
• El QR puede no mostrarse incluso aunque el sistema haya generado correctamente los datos técnicos.

Qué ocurre en OkVerifactu aunque no lo veas en el PDF

Aunque el PDF no muestre el QR, en OkVerifactu siempre se almacena:

• El registro técnico de la factura.
• El hash y el encadenamiento.
• El QR regulatorio generado.
• Los estados y evidencias técnicas.
• El historial de envíos y respuestas.

Cómo interpretarlo como comercio

Si la factura no muestra el QR:

• 1
  Primero: Comprueba el estado de la factura en OkVerifactu.
• 2
  Luego: Verifica que el webhook ha funcionado.
• 3
  Después: Revisa si tu tema PDF está sobrescribiendo la plantilla.
• 4
  Por último: Regenera manualmente el PDF si es necesario.

Por qué NO puedes generar tú mismo el QR

El QR de VeriFactu no es un gráfico genérico que puedas crear con cualquier generador online. Es parte de un sistema regulado y tiene que cumplir requisitos técnicos y normativos muy concretos. Si intentas "montarlo" por tu cuenta, el resultado puede parecer correcto a nivel visual, pero no tendrá validez como QR regulatorio.

No basta con un generador de códigos QR

Cualquier herramienta de internet te permite crear un QR que apunte a una URL o a un texto, pero el QR de VeriFactu requiere:

• Estar vinculado a una factura emitida por un sistema de facturación conforme.
• Codificar la información necesaria para el cotejo oficial en la AEAT.
• Mantener coherencia con el registro técnico, el hash y el encadenamiento de la factura.
• Estar alineado con el formato y las especificaciones marcadas por la normativa.

Sin registro técnico y hash, el QR no prueba nada

Para que el QR tenga sentido, tiene que apoyarse en:

• Un registro técnico completo de la factura.
• Una huella (hash) calculada sobre ese registro.
• Un encadenamiento que preserve la secuencia.

Si no existe todo esto por detrás:

• El QR no puede demostrar integridad.
• No puede probar que la factura no ha sido manipulada.
• No puede relacionarse con evidencias internas coherentes.

Sin integración con la AEAT, no hay verificación oficial

El QR regulatorio está pensado para que, al escanearlo, se pueda acceder al cotejo en la Sede electrónica de la AEAT (cuando el modelo VeriFactu está aplicado). Eso implica:

• Cumplir el formato que espera la AEAT.
• Generar el contenido según los criterios técnicos definidos.
• Estar vinculado a facturas que el sistema pueda cotejar.

Riesgos de intentar generar el QR por tu cuenta

Crear el QR fuera de un sistema conforme implica:

Quién debe generar el QR regulatorio

El QR regulatorio debe ser generado por:

• Un sistema de facturación que implemente correctamente VeriFactu.
• Una solución capaz de construir el registro técnico, el hash y el encadenamiento.
• Un servicio que pueda enlazar con la verificación oficial de la AEAT cuando corresponda.

Conclusión y próximos pasos: cómo seguir avanzando

El QR regulatorio de VeriFactu no es un elemento decorativo ni un requisito menor. Es la pieza visible de un sistema completo de verificación que garantiza que una factura puede cotejarse, validarse y defenderse ante cualquier auditoría o revisión.

Temas relacionados para profundizar

Si quieres profundizar más en cómo funciona todo esto, puedes explorar temas relacionados: