Por qué no se escanea un código QR impreso en 3D: lista de comprobación

Publicado por Vysa Trading LLC · Actualizado el 8 de noviembre de 2026 · 12 min de lectura

Un código QR impreso que no se escanea casi siempre falla por un motivo que se puede identificar. Esta página te da un árbol de decisión, una tabla de síntomas ligada a los mensajes exactos del Comprobador de escaneo de la herramienta, una prueba con el móvil en seis pasos y los números que hay detrás de cada solución: contraste, tamaño del módulo, margen de la zona de silencio y longitud del enlace.

Empieza por averiguar qué mitad del problema tienes

Un código falla por una de dos razones. O los datos están mal (una errata, un enlace roto, un campo wifi que nunca se decodifica), o los datos están bien y el objeto es difícil de leer (poco contraste, módulos diminutos, brillo, alabeo). Un módulo es un cuadradito del código; la herramienta los hace de 1,7 mm (Pequeño), 2,3 mm (Mediano) o 3,0 mm (Grande) de ancho.

Si ya has imprimido, abre la herramienta con los mismos ajustes y lee el Comprobador de escaneo (pregunta 2): en segundos te dice si el problema estaba en el diseño.

Tabla de síntomas: de lo que ves a lo que cambias

La columna «Qué comprobar» cita el mensaje correspondiente del Comprobador de escaneo siempre que la herramienta tiene uno.

Cómo leer el Comprobador de escaneo

El Comprobador de escaneo está bajo la vista previa 3D y se actualiza cuando cambias los colores, el tamaño o el relieve. El rojo significa que lo corrijas antes de imprimir, el azul que leas la nota y el verde que esa línea pasa. Aquí tienes un diseño con problemas:

Y este es el objetivo, con todas las líneas en verde:

Una prueba con el móvil en seis pasos

Usa la app de cámara del propio móvil, que es la que usará la mayoría de tus clientes. Cambia una sola variable cada vez y apunta todos los resultados.

1. Primero, la pantalla. Escanea la vista previa en pantalla. Si falla, el problema es el contenido. Si pasa, compara el enlace que muestra el móvil con lo que escribiste.
2. Objeto impreso, condiciones ideales. Luz intensa y uniforme, sin reflejos, el móvil paralelo al código y a 20-30 cm. Si falla aquí, es un problema de diseño o de impresión, no de colocación.
3. Distancia. Prueba de cerca, a distancia normal y lejos. Un código se lee desde unas 10 veces su ancho, así que un código de 57,5 mm (25 módulos en Mediano) debería leerse desde unos 57 cm. Apunta la distancia máxima a la que sigue enfocando en un par de segundos.
4. Ángulo. Inclina 0°, 30° y 45° respecto a la perpendicular. El código se ve comprimido según el coseno del ángulo: 0,87 a 30° y 0,71 a 45°, así que un código al límite falla primero cuando se inclina.
5. Luz. Prueba en el lugar real, una condición cada vez: ventana a tu espalda, lámpara a un lado, sala con poca luz.
6. Segundo móvil. Repite los pasos 2 y 3 en un móvil de otra marca o de otra antigüedad. Si solo falla ese móvil, el diseño está al límite: acerca las líneas del Comprobador de escaneo al verde.

Si dos pruebas repetidas dan el mismo fallo, cambia el diseño y reimprime en lugar de intentar salvar el objeto. Una segunda impresión corregida suele costar menos que una tarde de pintura y lijado.

La zona de silencio: por qué un borde, un colgante o un marco rompen un código

Todo código QR necesita un margen vacío y liso a su alrededor, la zona de silencio. El estándar QR pide 4 módulos por cada lado. El escáner la usa para encontrar los tres grandes patrones cuadrados de posición, que tienen que destacar sobre algo liso.

La herramienta mantiene sus márgenes pequeños para que el objeto quede compacto. Los escáneres de los móviles suelen tolerar menos de 4 módulos cuando el entorno es liso y claro, pero eso es una tolerancia, no una promesa. Trata el margen incorporado como el mínimo:

• Marcos y biseles. Un borde elevado o un soporte oscuro que toque el canto pone algo oscuro junto a los patrones de posición. Deja una franja lisa o usa un marco claro.
• Superficies de montaje oscuras. Una placa clara sobre madera negra queda rodeada de oscuro. Móntala sobre un fondo claro.
• Agujeros, tornillos y anillas. El llavero tiene un agujero de 4,2 mm para la anilla y la placa dos agujeros de 3,6 mm cerca de sus esquinas superiores. Una anilla, un cordón o la cabeza de un tornillo sobre el código eliminan módulos, así que mantén las piezas oscuras o metálicas lejos de él.
• Pegatinas y texto en relieve. Todo lo denso junto al código cuenta como ruido. Si el texto se redujo, bórralo y vuelve a probar.

Comprueba qué hay codificado realmente

Muchos avisos de «no se escanea» son en realidad «se escanea a otro sitio». Antes de culpar a la impresión:

1. Lee antes de abrir. La app de cámara normalmente muestra primero el enlace decodificado. Compáralo carácter a carácter: http frente a https, un www que falta, un espacio al final.
2. Ábrelo con datos móviles. Apaga la wifi. Un enlace que solo funciona en tu red o mientras tienes la sesión iniciada falla para todos tus clientes.
3. Cuenta la longitud. La Calculadora de tamaño muestra el número de módulos en «Tu QR ahora».

Enlace más largo, código más denso

Más caracteres necesitan más módulos, así que con un ancho fijo los módulos se encogen. La tabla usa las capacidades en modo byte del estándar QR para el nivel de corrección de errores M (sin logo) y H (el nivel que usa la herramienta con un logo o un emoji). La herramienta elige el tamaño más pequeño que cabe, así que el tuyo puede variar un poco.

Ejemplo: el enlace de la carta de una cafetería con parámetros de seguimiento llega a 119 caracteres. En Mediano da un código de 45 módulos y 103,5 mm de ancho. Si se fuerza a 57,5 mm, cada módulo mide 1,3 mm y el Comprobador de escaneo se pone en rojo. Detrás de una dirección de 22 caracteres, la misma carta se queda en 25 módulos y 57,5 mm. Los espacios, las letras con tilde y los emojis de un enlace ocupan varios bytes cada uno y añaden módulos.

Acórtalo sin un servicio de terceros

Pon una ruta corta en un dominio que sea tuyo y redirígela a la página larga. El código contiene solo la dirección corta y puedes cambiar el destino más adelante sin reimprimir. Usa una redirección temporal (302) para que los navegadores no guarden en caché el destino antiguo.

Apache (.htaccess):

Redirect 302 /m https://www.yourcafe.com/menu/lunch-and-dinner?utm_source=qr

Nginx (bloque server):

location = /m { return 302 https://www.yourcafe.com/menu/lunch-and-dinner?utm_source=qr; }

Cualquier hosting estático (una página en /m/index.html):

<meta http-equiv="refresh" content="0; url=https://www.yourcafe.com/menu/lunch-and-dinner">

Después codifica https://yourcafe.com/m (22 caracteres, 25 módulos sin logo) y prueba la redirección con datos móviles antes de imprimir.

Códigos wifi

El modo wifi construye WIFI:T:WPA;S:name;P:password;; y añade H:true; para las redes ocultas. Los caracteres \ ; , : " del nombre o de la contraseña se escapan con una barra invertida, así que Cafe;Guest se convierte en Cafe\;Guest. Las contraseñas distinguen mayúsculas de minúsculas y el tipo de seguridad tiene que coincidir con el del router.

Qué cambiar en la herramienta y por qué funciona

La Calculadora de tamaño convierte la distancia en un tamaño: indica desde qué distancia se escaneará y te dice cuál es el tamaño predefinido más pequeño que cumple la regla práctica, nunca por debajo del número de módulos multiplicado por 1,5 mm.

Para reimprimir desde un diseño ya configurado, abre la plantilla de soporte de mesa, de placa wifi o de llavero. Para ver en detalle los tamaños, el contraste y las capas, lee la guía de escaneo.

Preguntas frecuentes