Crea un código QR para Wi-Fi, contactos o enlaces y compruébalo antes de imprimirlo

Estático: una decisión, no una limitación

Hay dos tipos de códigos QR y la diferencia no es estética. Un código estático contiene la información en sí: la URL, el registro Wi-Fi o la tarjeta de contacto. Un código dinámico contiene un enlace corto que pertenece a un proveedor y que redirige adonde el proveedor indique en ese momento.

Los códigos dinámicos te dan dos funciones —puedes cambiar el destino después de imprimirlos y contar cada escaneo—, pero tienen un coste que rara vez se explica en la página que los vende. Cada escaneo pasa ahora por un tercero, que lo ve y decide si el código sigue funcionando. Cuando ese proveedor cambia sus precios, retira un producto o cierra, la pegatina de la ventana deja de funcionar y no hay nada que hacer al respecto. Ha ocurrido repetidamente y a gran escala.

Un código generado aquí queda terminado en el momento en que lo descargas. No hay redirección, contador, cuenta ni relación: appvau.lt no interviene en un solo escaneo. Lo que todavía puede fallar es aquello a lo que apunta el código —un enlace puede devolver 404, una contraseña puede cambiar y un número de teléfono puede reasignarse—, y ningún generador de uno u otro tipo puede ayudar con eso.

Por qué se muestra el contenido antes de codificar nada

Un símbolo QR es opaco para quien lo ha creado. No puedes mirar el patrón y ver que a la URL le falta el esquema, que el SSID tiene un espacio al final copiado de una etiqueta o que al número de teléfono le falta el prefijo del país. El fallo siempre se descubre después, cuando alguien sostiene un teléfono delante de algo que ya está impreso.

Por eso esta herramienta muestra primero la cadena canónica exacta: la que entra en el símbolo, en el formato que interpreta un escáner. Un registro Wi-Fi para una red de invitados tiene este aspecto:

WIFI:T:WPA;S:Studio Guest;P:weeknight-parcel-7;;

Ese formato no es una convención inventada por este sitio; es el registro que iOS lee desde la versión 11 y Android desde la 10. Verlo es el único momento en que una persona puede detectar un error, por eso es un paso y no un detalle oculto tras una opción avanzada.

En este mismo paso aparecen los avisos. Un registro Wi-Fi activa uno cada vez, porque la contraseña está dentro del símbolo en texto sin cifrar y una fotografía del código tomada desde el otro lado de una habitación permite recuperarla. Un número de teléfono sin prefijo de país activa otro. Una dirección sin esquema activa otro y se corrige delante de ti en lugar de hacerlo en silencio.

La verificación y lo que demuestra y no demuestra

Después de codificar, la herramienta renderiza el PNG, rasteriza el SVG y vuelve a leer ambos con un decodificador que no sabe nada del codificador que los produjo. Localiza el símbolo como lo haría una cámara —binariza la imagen en blanco y negro, encuentra la tinta, mide el paso entre módulos a partir del patrón buscador—, lee la información de formato, deshace la máscara, desintercala los bloques de datos y vuelve a calcular las palabras de código de corrección de errores Reed-Solomon a partir de los datos recuperados, exigiendo que sean idénticas byte a byte a las del símbolo.

Este último paso es más sólido que «se ha decodificado». Indica que la redundancia también es correcta, además de los datos, de modo que un lector que trabaje con una copia rayada o parcialmente tapada conserva el margen que promete el nivel elegido. Solo cuando los dos archivos superan la prueba se habilita cualquiera de las descargas.

Demuestra que los archivos son correctos. No demuestra que tu cámara, con tu tamaño de impresión, sobre tu superficie y con tu iluminación, vaya a leerlos. Nada de este lado puede establecerlo, y la indicación honesta es la de siempre: imprímelo al tamaño real y escanéalo con el teléfono para el que está pensado antes de pedir quinientas unidades.

La comprobación se justifica por un motivo que conviene explicar. Al crear esta herramienta apareció un error en la tabla de bloques de corrección de errores para el nivel H, que habría producido símbolos estructuralmente válidos pero completamente imposibles de decodificar con el nivel de redundancia más alto. Nada en la imagen habría parecido incorrecto. El decodificador lo encontró en la primera ejecución de prueba.

La corrección de errores no es una licencia para cubrir el centro

Cada símbolo QR lleva palabras de código redundantes para que un lector pueda recuperar los datos aunque estén dañados. Los cuatro niveles recuperan aproximadamente ~7% en L, ~15% en M, ~25% en Q, ~30% en H.

Esos porcentajes son la razón por la que los diseñadores ponen logotipos en el centro de los códigos, y es un mal hábito presentado como una función. La redundancia existe para sobrevivir a los daños que ocurren después de imprimir —rayones, un pliegue, un cerco de café o poca luz—. Gastarla de antemano en decoración significa que el código empieza sin margen, y precisamente los códigos que se manipulan son los que más necesitan ese margen.

Un nivel superior también hace que el símbolo sea más denso para el mismo contenido, porque la redundancia tiene que colocarse en algún sitio. Un símbolo de versión 1 contiene 17 bytes en el nivel L y 7 en el nivel H: la misma cuadrícula de 21 por 21, con menos de la mitad del contenido. Más densidad significa una impresión física más grande para seguir siendo legible, así que «usa H por seguridad» produce con frecuencia un código que se escanea peor.

El nivel M es el valor predeterminado adecuado. Pasa a Q o H cuando el código vaya a imprimirse pequeño, sobre una superficie curva o en un lugar que se vaya a tocar.

Toda la tabla se publica como JSON en qr.json, para cada versión del 1 al 40, junto con las capacidades numéricas y alfanuméricas y los formatos de contenido con ejemplos completos. Se genera en lugar de escribirse manualmente por un motivo que conviene repetir: anotar la estructura de los bloques una segunda vez es exactamente como un número incorrecto consigue sobrevivir.

PNG o SVG, y por qué importa el paso de píxeles

Se generan los dos, ambos son gratuitos y ninguno lleva marca de agua. Elige el SVG para cualquier cosa que vaya a imprimirse o a un archivo de diseño: es vectorial, tiene un view box entero y un único trazado, así que escala desde una tarjeta de visita hasta un cartel sin desenfocarse y se abre correctamente en Illustrator, Figma, Inkscape y el software de maquetación. Elige el PNG para un documento, una diapositiva, un mensaje o una página web, donde una imagen rasterizada fija es más sencilla de colocar.

El tamaño del PNG se redondea hacia abajo para que cada módulo sea un número entero de píxeles. Parece una precisión excesiva, pero no lo es: un símbolo de 29 módulos renderizado exactamente en 500 píxeles da 17,24 píxeles por módulo, y ese cuarto de píxel restante aparece como un borde gris a lo largo de cada límite entre módulos. Las cámaras lo toleran la mayoría de las veces, lo que es peor que no tolerarlo nunca, porque falla en la única impresión que importaba.

La zona despejada de cuatro módulos alrededor del símbolo forma parte del símbolo, no es un margen. Es un requisito de ISO/IEC 18004 y el motivo más habitual por el que un código recortado a mano no se escanea. No la recortes, no coloques el código pegado a un bloque de color y no dejes que una herramienta de maquetación lo recorte hasta los límites de la tinta.

Codificación, juegos de caracteres y la cuestión de ECI

El codificador elige el modo más compacto que permite el contenido: numérico para los dígitos, alfanumérico para el conjunto restringido de mayúsculas y modo byte para todo lo demás. Antes de generar el símbolo se muestra una tabla de capacidad para el símbolo que ha elegido, en cada nivel.

Cuando el contenido incluye caracteres no ASCII —un nombre de red con acento, un nombre en cirílico o en japonés—, el codificador escribe una cabecera ECI que declara UTF-8. Es la declaración correcta y también lo que más probablemente gestionen mal los escáneres antiguos, así que solo se añade cuando los bytes realmente lo necesitan, y el comprobante indica cuándo se ha usado. Un contenido formado únicamente por ASCII no lleva cabecera ECI y se comporta de forma idéntica en todos los lectores jamás creados.

Nada de esta página llega a la red. El codificador, el renderizador y el decodificador que comprueba el resultado son JavaScript que se ejecuta en esta pestaña, y los módulos de /js/tools/ no contienen código que realice solicitudes. Desconecta la red después de que la página se haya cargado y todo seguirá funcionando, algo que merece la pena comprobar, no dar por hecho, en una herramienta a la que estás a punto de entregar tu contraseña de Wi-Fi.