Por qué tu QR no escanea: 7 causas reales y cómo arreglarlas

Un código QR no es un dibujo: es un sistema de lectura óptica con reglas bastante estrictas. La cámara del celular tiene que encontrar tres cuadrados de referencia en las esquinas, calcular la perspectiva, y después distinguir cada módulo (cada cuadradito) como claro u oscuro. Cuando algo de esa cadena falla, el resultado es siempre el mismo desde afuera: el celular apunta y no pasa nada.

Lo frustrante es que casi nunca hay un mensaje de error que te diga por qué. Estas son las siete causas que explican la enorme mayoría de los casos, en el orden en que conviene revisarlas.

1 · Contraste insuficiente entre el código y el fondo

Es la causa número uno, y la más engañosa, porque el ojo humano y la cámara no ven lo mismo. Dos tonos que a vos te parecen claramente distintos —un azul marino sobre un violeta oscuro, un gris medio sobre gris claro— pueden quedar prácticamente idénticos cuando la cámara los convierte a escala de grises, que es lo que hace para leer el código.

La regla práctica: un color tiene que ser claramente oscuro y el otro claramente claro. Si entrecerrás los ojos hasta que la imagen se vuelva borrosa y todavía distinguís el patrón, vas bien. Si se convierte en una mancha uniforme, la cámara tampoco lo va a leer.

2 · El código está invertido (claro sobre oscuro)

Un QR con el patrón en color claro sobre un fondo oscuro es visualmente atractivo y muchos generadores lo permiten. El problema es que el estándar asume lo contrario: módulos oscuros sobre fondo claro. Los lectores modernos de iOS y Android suelen manejar la inversión sin problema, pero muchos lectores integrados dentro de otras apps —cámaras de apps bancarias, escáneres de punto de venta, apps de delivery— siguen fallando con códigos invertidos.

Si el QR va a un contexto controlado, la inversión es un riesgo aceptable. Si va a un cartel público donde no sabés con qué lo van a escanear, no la uses.

3 · Le comieron la zona de silencio

Alrededor de todo código QR tiene que haber un margen libre, sin nada, que el estándar llama quiet zone. Su ancho mínimo es de cuatro módulos —es decir, cuatro veces el tamaño de un cuadradito— en los cuatro lados.

Ese margen no es decorativo: es lo que le permite al lector saber dónde termina el código y empieza el mundo. Cuando alguien pega el QR contra el borde de un folleto, le superpone un texto encima, o lo recorta "para que entre justo", la lectura se vuelve errática — funciona a veces sí y a veces no, según el ángulo, que es la peor clase de falla porque parece aleatoria.

4 · El logo del centro es demasiado grande

Poner un logo o un emoji en el medio del código funciona gracias a que el QR incluye corrección de errores: información redundante que permite reconstruir el contenido aunque una parte esté tapada o dañada. Hay cuatro niveles, y el más alto (H) tolera hasta un 30% del código destruido.

Pero ese 30% es el presupuesto total de daño, y no es solo para tu logo: también lo consumen los reflejos, las manchas, el desgaste del papel y las imperfecciones de impresión. Si el logo ya se come el 25%, no queda margen para nada más y el código pasa a ser frágil. Mantené el logo por debajo del 20% de la superficie y centrado, que es donde menos información crítica hay.

5 · El enlace es larguísimo

Cuanta más información metés en un QR, más módulos necesita para guardarla, y más chico queda cada módulo dentro del mismo espacio físico. Un enlace corto genera un código de pocos módulos, grandes y robustos. Una URL de campaña con parámetros de seguimiento —esas que arrastran utm_source, utm_medium, utm_campaign y un identificador de sesión— puede triplicar la cantidad de módulos y convertir el código en una maraña que necesita el doble de tamaño físico para leerse igual de bien.

Si tu enlace es largo, tenés dos caminos: acortarlo con un servicio de redirección, o agrandar el código impreso. Lo que no funciona es dejar la URL kilométrica y el tamaño chico.

6 · La superficie es curva, brillante o está mal iluminada

Un QR sobre una botella, una taza o un tubo se deforma, y la deformación rompe el cálculo de perspectiva que hace el lector a partir de los cuadrados de las esquinas. Cuanto más pronunciada la curva y más grande el código en relación al diámetro, peor. Para superficies curvas conviene un código más chico ubicado en la zona más plana disponible.

El brillo es el otro enemigo: laminados brillantes, vidrio y plásticos pulidos generan un reflejo especular que borra una franja entera del código justo cuando el usuario se acerca a escanearlo. Acabado mate, siempre, si el QR va a algo que se lee de cerca.

7 · Problemas propios de la impresión

Si el código sale de una impresora —de papel o 3D— aparece una familia de causas extra:

• Tinta corrida o papel poroso: en papel absorbente los módulos se expanden y se tocan entre sí, cerrando los espacios claros que separan la información.
• Escala mal calculada al imprimir: mandar a imprimir con "ajustar a la página" puede reducir el código por debajo del tamaño mínimo sin que te enteres.
• En impresión 3D, módulos por debajo de 1,5 mm: la boquilla redondea los bordes y el relieve pierde definición. Lo tratamos en detalle en la guía de ajustes de impresión 3D.
• Primera capa despareja: en 3D, una cama mal nivelada deja módulos incompletos que la cámara interpreta como espacios vacíos.

Cómo probarlo antes de tirar 500 folletos

El error más caro es descubrir el problema después de imprimir la tanda. Tres pruebas que toman dos minutos y evitan casi todo:

1. Probá con el brillo bajo. Escaneá el código en pantalla con el brillo del monitor al mínimo, simulando la luz pobre de un local o una calle de noche. Si ahí falla, en papel también.
2. Probá desde lejos. Alejate al doble de la distancia a la que esperás que la gente lo escanee. Si a esa distancia lee, tenés margen de sobra.
3. Probá con más de un teléfono. Idealmente uno Android y uno iPhone, y si podés, alguno viejo. Los lectores no son todos igual de tolerantes.

Si vas a imprimir una tanda grande, imprimí una sola pieza de prueba primero y escaneala en el lugar real donde va a estar colgada, con la luz de ese lugar. Es el único test que cuenta de verdad.

Preguntas frecuentes