Sandbox sobre la preproducción de la AEAT · sin tarjeta · Primera factura en 5 minutos
verifactu.co

El QR de la factura: qué lleva dentro y dónde ponerlo

El QR es la parte de VeriFactu que ve el cliente. También es la más fácil de imprimir mal.

Qué lleva dentro

El QR codifica una URL al validador de la AEAT con cuatro parámetros:

  • nif — NIF del emisor
  • numserie — número de la factura
  • fecha — fecha de expedición, en dd-mm-aaaa
  • importe — importe total

Nada más. No lleva la huella, ni el desglose, ni datos del cliente. Es un identificador para que la sede electrónica localice el registro.

Ojo con esto Los parámetros van codificados para URL. Un número de factura con barra (F2026/0184) tiene que viajar como F2026%2F0184. Si no lo escapas, el validador no encuentra la factura.

Entorno de pruebas y entorno real: no los mezcles

La AEAT tiene un validador de preproducción y otro de producción. Son URLs distintas.

El fallo clásico es dejar la URL de preproducción cableada en el código. El resultado: tus clientes reales imprimen facturas cuyo QR lleva a un validador de pruebas donde su factura no existe. Funciona todo, no salta ningún error, y el cliente que escanea ve que su factura «no consta».

El entorno tiene que salir de la configuración del emisor, no de una constante.

Dónde va en la factura

El reglamento pide que sea legible y esté en la propia factura. En la práctica:

  • Tamaño mínimo razonable: 30 × 30 mm. Más pequeño y los lectores de móvil empiezan a fallar en papel térmico.
  • Con zona de silencio alrededor: un margen blanco. Un QR pegado a un borde o a un texto no se lee bien.
  • Contraste real. Nada de QR gris claro sobre fondo crema por estética.

La leyenda

Si operas en modalidad VERI*FACTU, la factura debe llevar la mención correspondiente junto al código. Es lo que indica que ese registro se ha remitido a la AEAT.

Si operas en modalidad no verificable, no lleva esa leyenda — y ese es precisamente uno de los detalles que distingue una modalidad de otra de cara a quien recibe la factura.

Papel térmico: el enemigo

Si imprimes tickets en térmico, prueba de verdad con el rollo que usas. El térmico tiene menos contraste, se degrada y a menudo imprime a 203 ppp. Un QR que se ve perfecto en pantalla puede ser ilegible en la impresora del TPV.

Prueba con el móvil más malo que tengas a mano, no con el mejor.

Y no lo desactives

Nos han preguntado varias veces si se puede quitar el QR «porque afea la factura». En modalidad VERI*FACTU forma parte de lo que la norma exige. Además juega a tu favor: es la prueba visible de que facturas en regla.

¿Te toca integrarlo?

Nosotros ya nos hemos comido los rechazos. Puedes ahorrártelos.

Seguir leyendo

Técnico

Los seis rechazos de la AEAT que te vas a comer (y cómo evitarlos)

Errores 1110, 1177 y 4104, el formato de importes, la cadena bifurcada y el control de flujo. Los que ya hemos pagado nosotros.

Técnico

Qué puede comprobar realmente quien escanea tu factura

Qué información devuelve el validador de la AEAT, qué no devuelve, y para qué sirve eso en una inspección o ante un cliente.