Mi código QR no se escanea
Última actualización: 12 de junio de 2026
Primero, divida el problema en dos
Escanee el código con una cámara de móvil normal:
- No ocurre nada → el código en sí no se puede leer. Causas 1-4.
- Se abre una página, pero es un aviso en lugar de su pasaporte → el código se lee bien; el problema es el estado o el GTIN del pasaporte. Causas 5-7.
Causa 1: Impreso demasiado pequeño
Síntoma: El código se escanea desde su monitor pero no desde la etiqueta impresa, o solo se escanea cuando el teléfono está impracticablemente cerca.
Los códigos pequeños son el fallo de impresión más común, especialmente en textiles donde la superficie se curva y se arruga. Los mínimos:
- Etiquetas de cuidado: 20 mm
- Etiquetas colgantes: 25 mm o más
- Etiquetas tejidas: 14 mm, tejidas desde el SVG
Solución: Vuelva a imprimir al tamaño mínimo de la ubicación o por encima de él. Los ajustes de tamaño y la guía de impresión completa están en Descargar e imprimir códigos QR.
Causa 2: Poco contraste o colores invertidos
Síntoma: El código es lo bastante grande, pero los escáneres tienen dificultades, sobre todo con poca luz.
Los escáneres esperan módulos oscuros sobre fondo claro. Los códigos recoloreados con poco contraste, las inversiones de claro sobre oscuro o los códigos impresos sobre un diseño recargado reducen la tasa de escaneo. El borde blanco alrededor del código (la zona de silencio) forma parte de la norma: si el diseño o los bordes de la etiqueta invaden esa zona, también rompen el escaneo.
Solución: Use el código descargado negro sobre blanco tal cual siempre que sea posible. Si su diseñador lo recolorea, mantenga oscuro sobre claro con un contraste fuerte, conserve la zona de silencio y pruebe una muestra física antes de la tirada de producción.
Causa 3: El archivo se convirtió a JPG
Síntoma: El código impreso se ve ligeramente borroso o tiene halos tenues alrededor de los cuadrados, y el escaneo es poco fiable.
PassportCraft exporta solo SVG y PNG — no hay exportación a JPG, así que un JPG en su flujo de impresión significa que alguien lo convirtió por el camino. La compresión JPG difumina los bordes nítidos de los módulos de los que dependen los escáneres.
Solución: Vuelva a la descarga original. Envíe a las imprentas el SVG; si un flujo exige una imagen rasterizada, use el PNG. Nunca vuelva a guardar ninguno como JPG.
Causa 4: Código dañado o mal colocado
Síntoma: El código se escaneaba bien cuando era nuevo pero falla tras el uso, o falla solo en el producto físico, no en una impresión de prueba plana.
Los códigos de PassportCraft se generan con alta corrección de errores (toleran hasta un 30 % de daño), pero la tela es un territorio hostil: los códigos impresos atravesando una costura o un pliegue, sobre etiquetas muy arrugadas o desgastadas, o bajo acabados brillantes que reflejan la luz, aún pueden fallar.
Solución: Coloque el código en una zona plana lejos de costuras y pliegues, prefiera los acabados mate y, para las etiquetas muy desgastadas, vuelva a imprimir. Si el código del mismo pasaporte sigue fallando sobre el terreno, plantéese pasarlo de la etiqueta de cuidado a una etiqueta colgante de mayor tamaño.
Causa 5: El pasaporte es un borrador
Síntoma: El código se escanea y se abre una página, pero dice «Este pasaporte aún no se ha publicado» con una opción de inicio de sesión.
La URL del código QR nunca cambia, pero solo resuelve al pasaporte activo mientras el pasaporte está publicado. Un borrador — incluido un pasaporte que se publicó una vez y luego se despublicó — muestra este aviso neutro en su lugar. No se expone ningún dato del producto, y su propio equipo puede iniciar sesión desde esa página para previsualizar el borrador.
Solución: Publique el pasaporte. El código impreso recoge el cambio de inmediato, sin nada que reimprimir.
Causa 6: El pasaporte se desactivó por un cambio de plan
Síntoma: La página dice «Este Pasaporte Digital de Producto se ha desactivado temporalmente. Póngase en contacto con la marca para obtener información del producto.»
Este es el aviso para los pasaportes retirados por una bajada de plan — por ejemplo, cuando los pasaportes publicados superaron el límite de un nuevo plan tras el período de gracia. Consulte Cambio de plan y período de gracia para saber cómo ocurre y cómo evitarlo.
Solución: Libere plazas de publicación o mejore el plan, y vuelva a publicar el pasaporte.
Causa 7: El GTIN no coincide
Síntoma: La página dice «Este Pasaporte Digital de Producto no está disponible.»
La URL del código QR se construye a partir de un GTIN, y ningún pasaporte del sistema coincide con él. Razones típicas: el GTIN del pasaporte se cambió después de imprimir el código, la etiqueta lleva un código generado a partir del GTIN equivocado, o una URL serializada apunta a un número de serie que ningún pasaporte tiene.
Solución: Abra el pasaporte y compare su GTIN (y el número de serie, si lo usa) con la URL codificada mostrada en el panel de QR, y después con lo que está impreso. Cómo se construyen estas URL se trata en GS1 Digital Link explicado.
Aplicaciones de cámara frente a aplicaciones de escáner
Cualquier cámara de móvil moderna lee estos códigos: son códigos QR estándar que contienen una URL https corriente, sin necesidad de una aplicación especial. Si una cámara no lo capta: añada luz, sostenga el teléfono a 10-30 cm de distancia y firme, y evite los reflejos en superficies brillantes. Una aplicación dedicada de escáner de QR puede ayudar con los códigos marginales (pequeños, desgastados o con poco contraste), pero si un código solo se escanea en una aplicación dedicada, trátelo como una prueba fallida: sus clientes usarán sus cámaras.
Pruebe como un cliente
Verifique siempre con una cámara de móvil normal, con luz interior normal, sobre el material impreso final. Un código que pasa esa prueba funciona para los compradores reales.
Preguntas frecuentes
¿Cuál es el tamaño mínimo para un código QR impreso?
En etiquetas de cuidado cosidas, 20 mm. Las etiquetas colgantes deben ser de 25 mm o más, y las etiquetas tejidas de al menos 14 mm (tejidas desde el SVG, nunca un archivo rasterizado). Más grande es más seguro: los códigos pequeños que se escanean en pantalla suelen fallar sobre tela curva o con textura.
El código se escanea pero dice que el pasaporte no se ha publicado, ¿por qué?
El código QR está bien; el pasaporte que hay detrás está en borrador. El código QR de un pasaporte solo resuelve a la página activa mientras el pasaporte está publicado. Publíquelo (o vuelva a publicarlo, si se había despublicado) y el código impreso empieza a funcionar de inmediato.
¿Por qué mi código muestra «Este Pasaporte Digital de Producto no está disponible»?
La URL resolvió, pero ningún pasaporte coincide con el GTIN (o GTIN + número de serie) codificado en ella. Compruebe que el GTIN del pasaporte coincide con el producto en el que va la etiqueta, y si usa números de serie, que existe un pasaporte con ese número de serie exacto.