Por qué un código QR no escanea, y cómo saber qué fallo tienes

¿Por qué no escanea mi código QR?

Un código QR falla en una de tres etapas: el escáner nunca encuentra el símbolo, el escáner lo encuentra pero no consigue leer los módulos con limpieza, o el escáner lo lee perfectamente y aquello a lo que apunta el código está roto. Los fallos de detección, los de decodificación y los de destino se ven distintos desde fuera y no comparten ninguna solución.

La detección es la etapa en la que un escáner localiza un código QR en la imagen de la cámara y deduce su contorno, su rotación y su rejilla de módulos, antes de leer ningún dato. La decodificación es la etapa en la que un escáner lee los módulos dentro de un código QR ya localizado y reconstruye los datos que codifican. El orden importa más que las definiciones: todo lo que el decodificador puede hacer, solo puede hacerlo sobre un símbolo que la detección ya encontró.

Ese orden es lo que convierte el síntoma en un diagnóstico. Un fallo de detección es absoluto - el móvil no muestra nada en absoluto, cada vez, a cualquier distancia - porque para él no hay ningún código en el encuadre. Un fallo de decodificación es condicional - el código se lee más cerca, o con mejor luz, o en un móvil y no en otro - porque el decodificador trabaja con una imagen justa y a veces gana. Un fallo de destino parece un éxito seguido de una decepción: aparece la notificación, se abre el enlace, y la página que hay detrás está muerta.

La consecuencia práctica es que la mayoría de los consejos para arreglar códigos QR apuntan a la etapa equivocada. Subir el nivel de corrección de errores, añadir un borde, regenerar a más resolución: cada una de esas cosas es la solución correcta para exactamente un fallo y una tirada tirada a la basura para los otros dos.

Empieza por lo que hace el móvil, no por el código

Apunta con un móvil al código y observa qué pasa, a dos distancias y en dos móviles. La respuesta a esa observación reduce el fallo a una sola categoría antes de medir nada, y cuesta unos treinta segundos.

La fila que conviene interiorizar es la primera. El silencio total y repetible no es un escaneo débil: es la ausencia de escaneo, y apunta a los tres o cuatro centímetros cuadrados que rodean el símbolo, no a nada de lo que hay dentro.

No pasa nada en absoluto: el código nunca se detecta

Un código que no produce ninguna reacción, a ninguna distancia y en más de un móvil, ha fallado en la detección y no en la decodificación, y hay cinco causas habituales. Los datos dentro del símbolo casi siempre están perfectos; lo que aún no se ha decidido es que ahí haya un símbolo que leer.

• La zona de silencio ha desaparecido. Un código QR necesita cuatro módulos libres en cada lado, y ese margen es lo que hace localizable el borde del símbolo. Un filete, un pie de texto, una foto que sangra por debajo del código o un borde de corte dentro de ese anillo rompen la detección con todos los módulos intactos. Es, con diferencia, la causa más común de silencio total.
• Un patrón de localización está tapado, recortado o dañado. Los tres cuadrados concéntricos de las esquinas no llevan corrección de errores de ningún tipo. Una pegatina sobre una esquina, un troquel que la recorta, o un logotipo arrastrado fuera del centro hasta encima de ella significan que el código no se encuentra en absoluto.
• El código son módulos claros sobre fondo oscuro. Los códigos invertidos son legales según la norma y poco fiables en la práctica: varias apps de cámara nativas ni lo intentan, así que el mismo archivo escanea en una app dedicada y no hace nada en la app que la gente usa de verdad.
• El símbolo no es un código QR modelo 2. Data Matrix, Aztec, PDF417 y Micro QR parecen códigos QR a ojos de cualquiera que no sea especialista, y la cámara de un móvil no los lee por la vía del QR. Lo normal es que vengan de la biblioteca de artes de un proveedor - código QR vs código de barras explica para qué sirve cada símbolo.
• La superficie no es plana, o no está quieta. Un código envuelto en una botella, doblado sobre un pliegue o detrás de un cristal curvo deforma la rejilla de módulos más allá de lo que pueden corregir los patrones de alineación. Y lo mismo hace un móvil que nunca llega a enfocar, que es lo que pasa cuando un código pequeño se acerca más que la distancia mínima de enfoque de la cámara.

La forma más rápida de separar el arte de la maquetación: pasa el archivo exportado por un decodificador en el ordenador. Si el escáner de códigos QR lee el archivo y ningún móvil lee la pieza impresa, el fallo entró en algún punto entre el archivo y el objeto acabado - una maqueta, un ajuste de exportación o la imprenta. Si el archivo mismo no se decodifica, deja de mirar la impresión.

La zona de silencio recorre ese margen de principio a fin: cuántos milímetros son cuatro módulos en tu tamaño impreso, las costumbres de maquetación que lo eliminan, y cómo medir lo que lleva de verdad un archivo que te han enviado.

Escanea de cerca pero no desde donde se coloca la gente

Un código que se lee a 20 cm y falla a 2 m está dimensionado para la distancia equivocada, y nada más. Cuenta alrededor de 1 cm de ancho de código por cada 10 cm de distancia de lectura, con un mínimo de 2 cm en toda la huella - así que un código que se lee desde 3 m necesita unos 30 cm, y uno que se lee desde 40 cm sigue necesitando sus 2 cm.

La regla de la distancia es un atajo para lo que de verdad importa, que es el ancho de un módulo dentro del encuadre de la cámara. Un móvil tiene que resolver un solo módulo antes de poder leer nada, así que la cuenta que decide el resultado es el ancho impreso dividido entre el número de módulos, y ese número sube con la longitud de la URL. Dos códigos impresos a los mismos 3 cm pueden comportarse de forma completamente distinta si uno lleva un enlace de 30 caracteres y el otro de 200.

Síntomas que confirman un fallo de tamaño y no otra cosa:

• Se lee de forma fiable a corta distancia. No hay nada mal en el arte; el código simplemente no es lo bastante grande para resolverse más lejos.
• La distancia de lectura mejora con luz fuerte. Más luz significa una exposición más corta y menos trepidación, lo que recupera parte del ancho de módulo que falta.
• Un enlace más largo dejó sin funcionar un código que funcionaba. Mismo tamaño impreso, símbolo más denso, módulos más pequeños. Acorta el destino y reimprime.
• Falla en la pieza pequeña y funciona en el cartel. El mismo archivo a dos tamaños es la prueba más limpia que existe.

Comprueba el ancho de módulo antes de agrandar a ojo. Los módulos impresos deberían medir 0,4 mm o más en papel estucado y 0,5 mm o más en no estucado, y la calculadora de tamaño de impresión hace esa cuenta a partir del ancho y de la distancia de lectura. Tamaño mínimo para imprimir tiene las tablas por soporte y explica por qué el mínimo está donde está.

Escanea en pantalla pero no en la pieza impresa

Un código que funciona en un monitor y falla en papel suele haber perdido ancho de módulo, contraste o nitidez de borde en el paso entre los dos, y la pantalla esconde las tres cosas. Un display le da al decodificador iluminación uniforme, una relación de contraste alta y bordes de píxel duros; el papel le da ganancia de tinta, luz ambiente y un borde blando en cada módulo.

Las cosas que hay que mirar, en el orden en que suelen estar mal:

• El ancho de módulo en milímetros. Divide el ancho impreso entre el número de módulos incluyendo la zona de silencio. Por debajo de 0,4 mm en papel estucado o de 0,5 mm en no estucado, el código es demasiado pequeño por muy limpio que esté el archivo.
• El formato del archivo. JPEG y WebP tienen pérdidas: dejan flecos grises en cada borde de módulo, que es justo donde el decodificador necesita un límite duro. Una captura de pantalla de un código es el mismo problema con un remuestreo encima. Manda vector siempre que el destino lo acepte - SVG vs PNG vs PDF vs EPS explica qué archivo va a cada sitio.
• La resolución efectiva. Un código de mapa de bits necesita un número entero de píxeles por módulo al tamaño final, o cada borde de módulo cae a mitad de píxel y el suavizado lo convierte en un gris blando. Resolución y DPI tiene la fórmula en los dos sentidos, y la calculadora de DPI la ejecuta.
• La zona de silencio en la maqueta ya montada. El margen casi nunca se pierde al exportar; se pierde después, cuando el código se encuentra con una página que necesitaba ese espacio.
• La ganancia de tinta en papel absorbente. El papel no estucado, el kraft y el papel prensa dejan que los módulos oscuros crezcan sobre los claros. El símbolo se oscurece en conjunto y los módulos claros se estrechan, y por eso el mínimo de 0,5 mm en no estucado es más alto que el de estucado.

El validador de códigos QR mide las tres cosas que se pueden leer de un archivo - el margen hacia fuera desde cada borde, el contraste entre los dos colores, y el tamaño de módulo a un ancho impreso dado - y reporta el lado peor en vez de una media. Pasa la exportación por ahí antes de que el archivo salga hacia la imprenta, y después saca una prueba sobre el papel real.

Escanea en un móvil y en otro no

Un código que se lee en un móvil y no en otro está justo en el límite en lugar de estar roto, y ese límite casi siempre es el ancho de módulo, el contraste o el esquema de color. Ni Apple ni Google publican un umbral de escaneo para sus apps de cámara, así que la lectura honesta de un resultado dividido es que el código está justo, no que un móvil esté defectuoso.

La solución a un resultado dividido no es probar más móviles. Es sacar al código del límite en el que está: añade un 25% al ancho impreso, separa más la pareja de colores, o dale la vuelta a un código invertido. Un código que se lee en todos los móviles de la oficina es un código con margen, y el margen es lo único que sobrevive a una tirada, a un pasillo mal iluminado y a un protector de pantalla rajado.

Funcionaba en el estudio y falla donde está instalado

Un código que se lee en la mesa y falla en la pared se ha topado con la luz, y de la luz no tiene la culpa el arte. Los dos mecanismos son el reflejo, donde un brillo especular borra parte del símbolo, y la luz ambiente baja, donde la cámara alarga la exposición y la trepidación se come los bordes de los módulos.

Qué mirar en el sitio en vez de en el archivo:

• Un foco o una ventana justo enfrente del código. El laminado brillante lo devuelve directo al objetivo. Ponte donde se pone quien lee y busca la mancha brillante sobre el símbolo: si tú la ves, la cámara ve más.
• Si quien lee puede inclinar el código. Una carta de mesa se puede girar a mano para salir del brillo; un rótulo de pared no. Esa sola pregunta decide el acabado más que el papel - mate vs brillo lo recorre de principio a fin.
• El contraste de color bajo la luz real. La luz cálida y tenue aplana un código cuyos colores se eligieron en un monitor calibrado. Los números de trabajo son 4:1 en pantalla y 7:1 en impresión, y el comprobador de contraste da la relación de una pareja de colores antes de imprimir nada.
• La altura y el alcance. Un código montado por encima del nivel de los ojos lo lee en ángulo todo el que sea más bajo que quien lo instaló, y una lectura en ángulo necesita más tamaño y más contraste que una de frente.
• Detrás de un cristal. Un marco, una ventana o una vitrina añaden dos superficies reflectantes, y el código tiene que funcionar a través de las dos.

El contraste es el eje que peor se juzga, porque el suelo del propio decodificador está muy por debajo de cualquier guía de diseño: el decodificador de código abierto que se puede leer se rinde cerca de 1,24:1, un gris apenas visible sobre blanco. Eso no es permiso para diseñar cerca de ahí. Dónde se rinden iPhone y Android explica de dónde sale ese número y por qué el papel, la luz y el objetivo se gastan el resto del margen.

Escanea al instante y luego no pasa nada útil

Si el móvil detecta el código y muestra una notificación, el código QR ha hecho todo su trabajo y el fallo está detrás. Ningún cambio en el símbolo, el tamaño, los colores o el nivel de corrección de errores va a arreglar un problema de destino, y esta es la categoría que casi todos los consejos de diagnóstico ignoran por completo.

Qué falla de verdad detrás de un código que funciona:

• La URL está muerta o se escribió mal al generar el código. Un código codifica una cadena, no una promesa. Lee la cadena decodificada carácter a carácter contra la dirección que querías, sobre todo cualquier parte escrita a mano.
• Al enlace le falta el esquema. Una cadena como koloqr.com/menu sin https:// delante es texto para unos escáneres y un enlace para otros, así que se abre en un móvil y en el siguiente muestra una cadena que hay que copiar.
• El destino redirige a algo que falla en móvil. Un enlace corto hacia una página solo para escritorio, un PDF que se abre en un visor que nadie tiene, o una cadena de redirecciones que agota el tiempo en una conexión lenta.
• La página pide iniciar sesión, o está restringida por país. El escaneo funciona perfectamente y quien lee se choca con un muro, algo que te contará como "el código QR no funciona".
• Un código de Wi-Fi con el tipo de seguridad mal o una contraseña sin escapar. Una red WPA2 cuyo contenido declara que no tiene contraseña, un SSID oculto sin la marca de oculto, o una contraseña con un punto y coma o una barra invertida que nunca se escapó. Mira códigos QR de Wi-Fi para el formato del contenido.
• Un número de teléfono con formato dentro. Los espacios, los paréntesis y los guiones dentro de un contenido tel: se tratan de forma inconsistente. Lo que viaja son los dígitos y un signo más delante - códigos QR de número de teléfono tiene el formato.
• Un código dinámico cuya redirección ha caducado. Un código vendido por suscripción deja de resolver cuando la suscripción termina, y la pieza impresa no tiene forma de avisar.

La comprobación que separa esta categoría de todas las demás lleva un minuto: decodifica el archivo, copia la cadena y pégala en un navegador del móvil. Si la cadena es correcta y la página está rota, la impresión está bien y la reimpresión no habría cambiado nada.

Funcionó durante meses y luego dejó de funcionar

Un código que ha dejado de funcionar sin que nadie tocara la pieza impresa ha perdido su destino o ha perdido su contraste, y esos son los dos únicos candidatos que merece la pena mirar primero. El símbolo en sí no cambia; lo que cambia es aquello a lo que apunta, o la tinta con la que está impreso.

Un código estático codifica su destino de forma permanente, y por eso la respuesta duradera es una URL que controles y puedas redirigir. Qué compra de verdad una suscripción de código QR dinámico explica ese trato entero, incluido qué le pasa a la tirada impresa cuando dejas de pagar.

Dejó de escanear después de que alguien tocara el arte

La mayoría de los códigos que se rompen durante el diseño se rompen de una de seis formas, y las seis se arreglan regenerando el código en vez de reparando el archivo. La pista es que entró una exportación que funcionaba en una herramienta de diseño y salió una rota.

• El logotipo creció. Un logotipo central que cubre hasta alrededor del 20% del área del símbolo se recupera de forma fiable en nivel H, y el techo teórico del 30% no es capacidad sobrante: la ganancia de tinta, el reflejo y una huella dactilar salen del mismo presupuesto. Niveles de corrección de errores tiene la geometría.
• El logotipo se salió del centro. El daño centrado se reparte de forma pareja entre los bloques de recuperación intercalados; el mismo logotipo descentrado lo concentra, y cerca de una esquina cae sobre un patrón de localización, al que ningún nivel protege.
• Estiraron el código. Cualquier escalado no uniforme hace los módulos rectangulares y la rejilla inconsistente. Bloquea las proporciones antes de redimensionar nada.
• Cambiaron los colores por los de la marca. Dos colores corporativos de tono medio pueden parecer muy contrastados y no llevar casi ninguna diferencia de luminancia. Comprueba la pareja en vez de fiarte de las muestras.
• Dibujaron un marco o un pie ajustado al símbolo. Un marco está bien si su borde interior queda a cuatro módulos como mínimo. Dibujado al símbolo, queda dentro de la zona de silencio.
• Lo exportaron como captura de pantalla o como JPEG. El remuestreo y la compresión con pérdidas ablandan los bordes de los módulos - mira copiar un código QR a Figma para la ruta de colocación y exportación que no lo hace.

Regenerar no cuesta nada, y un código regenerado es exacto donde uno reparado es aproximadamente correcto. KoloQR, un generador de códigos QR gratuito con códigos QR circulares y de formas personalizadas, exporta SVG, PNG, PDF y EPS con la zona de silencio incluida y el nivel de corrección de errores fijado antes de exportar. El estilo nunca mejora el escaneo: las formas decorativas de módulo ponen menos tinta en cada celda que las cuadradas, así que un código con estilo gasta tolerancia en vez de crearla, y ¿escanean las formas de QR personalizadas? tiene las medidas detrás de eso.

Cómo diagnosticar un código QR que no escanea

Trabaja desde el arte hacia fuera y no desde el móvil hacia dentro, porque el archivo es la única parte de la cadena que puedes medir con exactitud. El procedimiento de abajo pone nombre al fallo en unos diez minutos y funciona sobre una pieza impresa que no diseñaste tú, sin archivo original y sin notas.

1. Observa qué hacen dos móviles, a dos distancias. Nada en absoluto en los dos significa detección. Que se lea a veces significa decodificación. Que se lea al instante significa que el código está bien y el destino no.
2. Decodifica el archivo en el ordenador. Suelta la exportación en un decodificador que lea desde una imagen. Si el archivo se decodifica y la impresión no, el fallo entró después de exportar.
3. Lee la cadena decodificada carácter a carácter. Compárala con la dirección que querías codificar y luego ábrela en un navegador móvil. Una cadena errónea o muerta termina la investigación aquí.
4. Mide el margen libre por su lado peor. Compara el espacio libre con el ancho de un módulo al mismo zoom. Mira los cuatro lados y quédate con el menor, en la maqueta montada y no en el archivo.
5. Calcula el ancho de módulo en milímetros. Divide el ancho impreso entre el número de módulos incluyendo el margen. Por debajo de 0,4 mm en estucado o de 0,5 mm en no estucado, el código es demasiado pequeño.
6. Comprueba el contraste de la pareja de colores real. No el de las muestras, el del resultado impreso. Por debajo de más o menos 7:1 en impresión, el código gasta margen que va a necesitar para la luz y el reflejo.
7. Mira el código donde vive. Ponte donde se pone quien lee, a su altura, con las luces de la sala encendidas. El reflejo y el ángulo de lectura son invisibles en todas las comprobaciones sobre archivo de arriba.
8. Cambia una cosa y saca una prueba. Una hoja a tamaño final sobre el papel de producción. Cambiar tres cosas a la vez significa que el siguiente fallo será tan inexplicable como este.

Si todas las comprobaciones pasan y el código sigue sin leerse, regenéralo desde el destino y compara los dos símbolos uno al lado del otro. Un archivo que ha pasado por varias herramientas puede llevar daños que ninguna medición suelta detecta, y una exportación nueva lleva menos tiempo que otra ronda de medir.

Los umbrales con los que evaluamos un código

KoloQR evalúa un código QR con cuatro números, y solo uno de ellos viene de la norma. Los cuatro módulos de zona de silencio son la cifra de ISO/IEC 18004; las bandas de contraste, la línea de aviso bajo el margen y el mínimo de módulo son nuestros, trazados donde un código deja de tener margen de maniobra y no donde deja de funcionar. Los cuatro se pueden comprobar pasando un archivo por las herramientas en vez de creyendo lo que decimos.

Dos de ellos llevan un juicio que conviene decir en voz alta. Avisamos en vez de suspender con dos o tres módulos de zona de silencio, porque eso es lo que deja la mayoría de los marcos decorativos y lo que la mayoría de los decodificadores todavía lee: es un código sin margen de maniobra, no un código roto. Y juzgamos el contraste por el peor entre los módulos oscuros y los patrones de localización en vez de por una media, porque un escáner tiene que encontrar los tres cuadrados de las esquinas antes de leer nada, y un código con módulos oscuros y patrones de localización pálidos falla en la detección mientras su media sigue pareciendo respetable.

El generador aplica la misma regla de contraste en vivo: la insignia junto a la vista previa toma el peor de los dos pares de colores y se pone verde a 4:1. Esa es la línea de pantalla y no la de impresión, y es deliberado: un código que se está diseñando para una pieza impresa debería estar en 7:1 antes de salir de la página, y el comprobador de contraste es donde se zanja eso contra una paleta de marca.

Qué no hacer cuando un código QR no escanea

El error más caro al diagnosticar es reimprimir antes de que el fallo tenga nombre. Una reimpresión cambia varias variables a la vez, así que un código que funciona después no te enseña nada, y un código que sigue fallando ha costado la tirada dos veces.