Diagnóstico

Errores que hacen que un código QR no funcione

Un código que no funciona tiene dos averías posibles y son muy distintas: o el lector no consigue leerlo, o lo lee perfectamente y lo que hay al otro lado no sirve. Empieza por saber cuál de las dos tienes.

Torelya Publicado el 2 de septiembre de 2026

El diagnóstico en tres minutos

Antes de tocar nada, haz esta secuencia. Ahorra la mayor parte del trabajo:

  1. Abre el archivo original del código en la pantalla del computadora y escanéalo con el celular. Si escanea, el código está bien: el problema está en la impresión o en el sitio.
  2. Si no escanea ni en pantalla, el problema está en el archivo: margen, contraste, deformación o logotipo.
  3. Si escanea y te lleva a algún sitio, mira a dónde te lleva exactamente desde el celular, no desde el computadora. Muchos códigos «rotos» leen perfectamente y llevan a una página caída o a una versión de escritorio ilegible.

Errores que impiden leer el código

Correcto margen libre por los cuatro lados Mal el marco toca el código
El margen no es decoración: es lo que permite al lector saber dónde empieza y dónde acaba el código. En cuanto un marco o una línea de texto lo tocan, muchos lectores dejan de encontrarlo.

Recortar el margen blanco

Es de los fallos más frecuentes. El código necesita un borde libre a su alrededor —la zona silenciosa—, sin marco, sin texto y sin dibujo, para que el lector pueda delimitarlo. El estándar pide al menos cuatro módulos del propio código por cada lado.

Ocurre casi siempre por la misma razón: alguien quiere que el código se vea más grande dentro del cartel y se come el margen. El resultado es un código mayor que escanea peor.

Invertir el contraste

El estándar está planteado para módulos oscuros sobre fondo claro. Algunos lectores aceptan códigos invertidos, pero la compatibilidad es menor y hay que probarla en varios dispositivos antes de imprimir. Si el diseño es oscuro, la salida sin riesgo es poner el código dentro de un recuadro claro en lugar de invertirlo.

Contraste insuficiente

Gris sobre beige, azul marino sobre azul, dorado sobre crema. Todo eso se ve bien impreso y no lo lee la cámara, sobre todo con poca luz. Si tienes dudas, haz una foto en blanco y negro del cartel: si a ti te cuesta distinguir los cuadraditos, a la cámara también.

Un logotipo demasiado grande

Los códigos toleran cierto daño gracias a la redundancia que llevan dentro, y de ahí viene la posibilidad de poner un logotipo en el centro. Pero esa tolerancia se gasta, y se gasta a la vez con el desgaste, la suciedad y los reflejos. Un logotipo grande deja el código sin margen para nada más.

Deformar el código

Estirarlo para que encaje en un hueco rectangular rompe la rejilla. Un código QR es cuadrado y tiene que redimensionarse manteniendo la proporción exacta. Si el hueco es rectangular, cambia el hueco.

Partir de una captura de pantalla

Una captura tiene la resolución de la pantalla y muchas veces pasa además por una compresión que emborrona las transiciones de blanco a negro. Es suficiente para verlo, no para imprimirlo. Descarga siempre el archivo del generador, y para imprimir, el SVG o el PDF. Está desarrollado en cómo imprimir un código QR sin perder calidad.

Imprimirlo demasiado pequeño para la distancia

Un código de dos centímetros en la pared de una sala de espera está bien hecho y es inservible. El tamaño depende de la distancia de lectura, y el cálculo está en qué tamaño debe tener un código QR.

Reflejos y superficies curvas

Un plastificado brillante bajo un foco deja una mancha de luz sobre el código. Una botella, una taza o un cartel arrugado deforman la rejilla. Ambos son problemas del mundo físico, no del archivo: el mismo código funciona en un papel mate y plano.

Errores que impiden que sirva de algo

Estos son peores, porque el código escanea y todo parece correcto. Solo se detectan si alguien comprueba de verdad a dónde va.

El destino está mal escrito

Una letra de más, un espacio al final, un http donde tenía que ir https. El código se genera igual de bien con una dirección rota que con una buena: no valida nada, solo codifica lo que le des.

La página de destino no se ve en el celular

Todo el que escanea un código lo hace desde un teléfono. Si la página de destino es una versión de escritorio, un PDF pesado o algo que pide iniciar sesión, el código funciona y la experiencia no.

El acortador o el servicio dinámico ha caducado

Si el código apunta a un redirector de terceros, tu cartel depende de que ese servicio siga funcionando y siga siendo gratis. El día que cierre o cambie de plan, todos los carteles impresos dejan de funcionar a la vez. Para códigos permanentes, usa estáticos.

El enlace de reseñas lleva a la ficha, no al formulario

Un caso muy concreto y muy común: el código lleva a la ficha del negocio en Maps en vez de al formulario de estrellas, y el cliente tiene que buscar el botón. El enlace correcto está en la guía del cartel de reseñas.

El código sigue puesto y la información no

Un cartel de wifi con la contraseña vieja, un menú de temporada pasada, una promoción terminada. El código funciona perfectamente y hace daño. Es el error más silencioso de todos, porque nada avisa.

Errores de gestión que se pagan más tarde

  • No guardar el archivo original. Cuando haya que reimprimir, sin el SVG o el PDF hay que rehacerlo todo, y quien lo hizo puede que ya no esté.
  • No apuntar qué código lleva a dónde. Con cinco carteles en el local, al mes nadie recuerda cuál es cuál. Una lista de dos columnas lo resuelve.
  • Cinco códigos juntos en el mismo sitio. Ante varios cuadrados iguales, la gente no elige ninguno.
  • No probar después de imprimir. La prueba en pantalla no cuenta como prueba: la pantalla emite luz y el papel la refleja.

Lista de comprobación para arreglar un código que no funciona

  • He probado a escanear el archivo original en pantalla, para separar problema de archivo de problema de impresión.
  • El margen blanco está completo y nada lo toca.
  • El código es oscuro sobre fondo claro, no al revés.
  • El contraste aguanta una foto en blanco y negro.
  • El código es cuadrado, no está estirado.
  • El logotipo, si lo hay, es pequeño y central.
  • El archivo viene del generador, no de una captura de pantalla.
  • El tamaño corresponde a la distancia real de lectura.
  • No hay reflejo ni superficie curva sobre el código.
  • He abierto el destino en un celular y funciona y se ve bien.
  • La información a la que lleva sigue siendo correcta hoy.
  • Tengo guardado el archivo original y apuntado a dónde lleva cada código.

Preguntas frecuentes

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

Empieza por escanear el archivo original en la pantalla del computadora. Si ahí funciona, el fallo está en la impresión, el tamaño o el sitio. Si tampoco funciona, está en el archivo: margen recortado, contraste invertido, deformación o un logotipo demasiado grande.

¿Puede caducar un código QR?

Un código estático no caduca: el destino va escrito dentro del propio dibujo. Los que caducan son los dinámicos, porque dependen de un servicio intermedio que puede cerrar o dejar de ser gratuito, y ese día fallan todos tus carteles a la vez.

¿Cuánto margen blanco necesita un código QR?

El estándar pide al menos cuatro módulos de ancho por cada lado, medidos en cuadraditos del propio código y no en milímetros fijos, porque la medida depende de lo denso que sea el código. Sin ese margen muchos lectores no consiguen delimitar dónde empieza y dónde acaba, aunque el dibujo esté perfecto.

¿Puedo poner mi logotipo encima del código?

Sí, pequeño y en el centro, y probándolo después con varios teléfonos. El logotipo consume la misma tolerancia que necesitas para el desgaste y los reflejos, así que cuanto más grande, menos margen te queda para todo lo demás.

¿Por qué escanea en mi celular y no en el de mi cliente?

Suele ser por condiciones distintas, no por el teléfono: tú lo escaneas de cerca, con buena luz y sabiendo dónde está. También influye que algunas aplicaciones lectoras son más permisivas que la cámara del sistema. Prueba siempre con la cámara normal y desde la posición del cliente.

¿El código QR se estropea si se raya?

Aguanta bastante, porque lleva redundancia interna. Pero esa tolerancia es un presupuesto que se gasta entre el desgaste, la suciedad, el logotipo y los reflejos. Un código rayado que además tiene un logotipo grande deja de leerse mucho antes que uno limpio.

Genera uno nuevo y limpio

Si el código viene de una captura o de un archivo perdido, sale más rápido rehacerlo. El generador es gratis y te da el SVG y el PDF listos para imprimir.