¿El código QR no escanea? Encuentra la causa por el síntoma

Primero separa las tres fallas

Hazte dos preguntas antes de tocar nada. ¿Este código funcionó alguna vez, con quien sea? ¿Y el teléfono reacciona de algún modo —vista previa del enlace, página equivocada— o no pasa nada?

Nunca funcionó, sin reacción: el patrón no se puede leer. Es una falla de impresión o de arte, y de eso trata la siguiente sección.

Antes servía y ahora nada o una página de error: el patrón está bien, el destino desapareció. Sáltate a la tercera sección.

Escanea al instante pero abre algo equivocado: ni el código ni el destino están rotos; el roto es el enlace. Esa es la cuarta sección.

Nunca fue legible

La cámara no logra convertir el patrón en datos. Estas son las causas, más o menos en el orden en que suelen resultar ser la culpable.

• Muy chico para la distancia. Un código leído a tres metros quiere unos treinta centímetros; a treinta centímetros, unos tres. Por debajo de más o menos medio milímetro por módulo, las cámaras de los celulares empiezan a fallar.
• Poco contraste. Oscuro sobre claro, con diferencia de verdad entre los dos. Gris claro sobre blanco, o un color de marca sobre fondo oscuro, es la falla de diseño más común.
• Se perdió la zona de silencio. La especificación pide cuatro módulos libres por lado; texto, un filete o una imagen de fondo que llegue al borde borran la frontera que el lector busca.
• Invertido. Módulos claros sobre fondo oscuro se leen en unos celulares y en otros no: trátalo como roto, no como estilo.
• Estirado o ampliado. Un PNG chico inflado tiene bordes de módulo blandos, y falla por la misma razón que imprimirlo demasiado chico. Imprime desde vectorial.
• El logotipo tapa de más, o no se subió el nivel de corrección de errores para compensarlo.
• El material juega en contra: una botella curva, aluminio, tela, o un plastificado que rebota la luz del techo directo al lente.

A ti te escanea y al cliente no

Este caso merece su propia sección porque el código casi siempre está bien. La diferencia está en el celular, en la luz o en la distancia, y tú estás probando en las mejores condiciones que ese código va a ver en su vida.

Las cámaras más viejas resuelven menos; un lente rayado o grasoso resuelve todavía menos. Un local oscuro te quita distancia, y el ángulo también: un código acostado en la mesa, leído por alguien parado encima, se está leyendo de lado.

También hay diferencia de software. La cámara de fábrica lee códigos QR en ambas plataformas, pero no siempre con la tolerancia de una app dedicada, y un celular viejo puede necesitarla. Si un código sirve en tu celular nuevo y falla en uno de tres años, el código va justo, no el celular viejo: imprímelo más grande.

Servía y dejó de servir

El patrón no cambió, no puede. Cambió algo detrás de él.

• El destino se movió o lo borraron: reorganizaron el sitio, caducó el archivo compartido, la página de campaña se bajó junto con la campaña.
• Apagaron la redirección. Un código dinámico depende de un servicio que lleva el escaneo; una cuenta vencida, una cerrada o el límite de un plan gratuito detienen todas las copias impresas al mismo tiempo.
• Era una prueba. Muchos generadores gratuitos dan una redirección de prueba que se detiene a la semana o dos y muestra una página para contratar.
• No renovaron el dominio, o venció el certificado: el celular va a advertir o negarse en lugar de abrir.
• El destino ahora pide iniciar sesión. A ti te sigue sirviendo porque tu navegador está dentro.

Escanea pero abre otra cosa

El código hace exactamente para lo que se hizo; lo equivocado es para lo que se hizo. Lee la dirección que el celular muestra en la vista previa antes de abrirla: eso solo identifica la mayoría de estos casos.

La causa más frecuente es el código equivocado impreso en el material equivocado: dos campañas, dos sucursales, un archivo confundido en la imprenta. Compara la vista previa con lo que querías codificar.

Después: un caché viejo que muestra una versión anterior de la página, un enlace que abre una app en vez del navegador porque el destino es un enlace profundo, o una dirección http que redirige a otro lado camino al https.

Si un código dinámico abre el destino anterior, el cambio se guardó pero la redirección todavía no llega a ese dispositivo, o el celular la tiene en caché. Prueba en ventana privada con datos móviles.

El diagnóstico de cinco minutos

En este orden, porque cada paso descarta la mayor cantidad de causas con el menor esfuerzo.

• Escanea la pieza impresa y lee la dirección de la vista previa sin abrirla. Si la dirección está mal, la culpa es del arte o del enlace, no del código.
• Abre esa dirección a mano en una ventana privada con datos móviles. Si ahí falla, la culpa es del destino.
• Prueba un segundo celular, de preferencia más viejo, y un tercero si el segundo no coincide con el primero.
• Lleva el impreso a una luz clara y pareja. Si de repente escanea, la culpa es del tamaño o del contraste, no del código.
• Mide el código y el espacio libre alrededor, y compáralo con la distancia de lectura.
• Escanea el archivo digital original en pantalla. Si el archivo escanea y el impreso no, la falla nació en producción.
• Hasta entonces regenera el código; y si es estático, acuérdate de que regenerarlo da un patrón distinto, así que lo ya impreso no cambia.