Generador de Códigos QR Universal

Cómo funciona un código QR: módulos, máscaras y corrección de errores

Un código QR (Quick Response, "respuesta rápida") es un código de barras bidimensional: en lugar de una hilera de barras verticales, almacena información en una matriz cuadrada de módulos (cuadraditos negros sobre fondo blanco). Cada versión del estándar va de la 1 a la 40, y cada versión añade 4 módulos por lado. La versión 1 mide 21×21 módulos; la 40 llega a 177×177. Esto le da una capacidad enorme: con corrección Media (M) caben hasta 2.953 caracteres alfanuméricos o 4.296 dígitos en la versión 40. Para la mayoría de usos reales (URLs, vCards, Wi-Fi)我们会使用的版本1 a 10 entre los que producen una matriz limpia, fácil de escanear incluso desde pantallas pequeñas.

Lo que distingue a un QR de un simple patrón de cuadraditos es su estructura geométrica. En las tres esquinas (arriba-izquierda, arriba-derecha y abajo-izquierda) hay tres patrones de detección de 7×7 módulos con una proporción 1:1:3:1:1 (negro:blanco:negro:blanco:negro). Esos tres cuadrados permiten al escáner detectar el código, calcular la orientación y corregir el giro de la imagen. A su alrededor va una zona quieta (quiet zone) de al menos cuatro módulos blancos. Si la recortas, el lector falla aunque el QR esté perfecto.

Modos de codificación y capacidad

El estándar QR admite cuatro modos para comprimir los datos según el tipo de contenido:

• Numérico (0–9): la más eficiente. Codifica tres dígitos en 10 bits.
• Alfanumérico (0–9, A–Z, espacio y pocos símbolos): dos caracteres en 11 bits.
• Byte (binario arbitrario, UTF-8): un carácter por 8 bits. Es el modo que usamos aquí para URL, vCard, email, etc.
• Kanji: optimizado para caracteres japoneses, poco habitual fuera de Japón.

La librería elige automáticamente el modo más compacto según el texto. De ahí que un QR numérico puro admita mucho más contenido que uno con texto internacional: cada modo reserva bits distintos en la cabecera del símbolo.

Corrección de errores: Reed-Solomon en cuatro niveles

La magia del QR es que sigue funcionando aunque le tape un logo, le caiga agua o alguien lo raye. Esto se logra con códigos de Reed-Solomon, una técnica de corrección de errores que añade redundancia calculada a los datos. El estándar define cuatro niveles:

• L (Low, ~7 %): recuperación mínima. Máxima capacidad de datos. Solo pantalla.
• M (Medium, ~15 %): equilibrio estándar. Sirve para tarjetas de visita y menús.
• Q (Quartile, ~25 %): aguanta un logo central que tape hasta una cuarta parte.
• H (High, ~30 %): máxima robustez. Cartelería exterior, etiquetas industriales.

Cada nivel cuesta módulos extra. Por eso, si subes de M a H con un texto largo, el QR puede saltar de versión y la matriz crece. La herramienta lo gestiona automáticamente.

Máscaras y formato de información

Antes de pintar la matriz, los datos se someten a una operación XOR con una de ocho máscaras posibles (numeradas 0 a 7). La máscara evita que aparezcan patrones grandes del mismo color —que confunden a los escáneres—. El estándar define cuatro penalizaciones (bloques grandes, módulos del mismo color en filas y columnas,Finder-like falsos, balance global de luz-oscuridad) y el algoritmo elige la máscara con menor penalización. El número de máscara elegido se codifica en los 15 bits del bloque de información de formato, que va alrededor de los patrones de detección.

Patrones de alineación, temporización y versión

Desde la versión 2 aparecen patrones de alineación (cuadraditos de 5×5 módulos) en posiciones fijas dentro de la matriz. Sirven para corregir la distorsión cuando el QR se imprime sobre una superficie curva o se fotografía en ángulo. Los patrones de temporización son líneas de puntos que conectan los patrones de detección y permiten al escáner conocer el tamaño exacto de cada módulo. Por último, los símbolos de versión 7 a 40 llevan un bloque extra de información de versión (18 bits) en la parte inferior-izquierda y superior-derecha.

Cómo usar la herramienta paso a paso

1. Elige el tipo. En la parte superior tienes un selector con siete opciones: URL, Wi-Fi, vCard, texto, email, SMS y ubicación. Solo cambia el formulario que aparece debajo; la previsualización se actualiza al instante.
2. Rellena los datos. Para URL basta con pegar la dirección (incluye https://). Para Wi-Fi, introduce SSID, contraseña y tipo de seguridad. Para vCard, completa al menos nombre y teléfono.
3. Personaliza el color. El color por defecto (negro sobre blanco) es el que mejor lee cualquier escáner. Si quieres un color de marca, mantén un contraste alto: el indicador te dice si es "PERFECTO", "MEJORABLE" o "ILEGIBLE".
4. Añade logo (opcional). Sube una imagen cuadrada; la herramienta calcula un hueco central automáticamente para que el código siga siendo legible. Si tu logo tapa demasiado, sube la corrección a Q o H.
5. Abre el Modo Experto si necesitas calibración de impresión, lotes numerados, modo espejo o trazo continuo para plotter.
6. Descarga. PNG para impresión rápida, SVG para imprenta o web (es vectorial y escala sin pixelarse), ZIP para lotes grandes.

Casos prácticos detallados

Caso 1 — Cartel exterior con logo en el centro.
Un bar quiere poner un QR grande (40×40 cm) en la fachada, con su isotipo en el centro. El QR codifica la URL de la carta. Solución: corrección Q (permite hasta un 25 % de oclusión por el logo), color de marca (#00529B sobre blanco), tamaño físico que a 2 metros de distancia cubre al peatón. Activar también Modo Experto → Trazo continuo si la imprenta corta el cartel con plotter.

Caso 2 — Wi-Fi para invitados de un Airbnb.
El anfitrión quiere que los huéspedes se conecten sin pedir la clave. Codifica: WIFI:T:WPA;S:CasaPlaya_5G;P:vacaciones2026;;. Resultado: cualquier móvil con cámara detecta el QR y, tras confirmar, se conecta automáticamente. Imprime el QR en una tarjeta laminada junto al router.

Caso 3 — 300 entradas numeradas para un evento.
El organizador necesita 300 QRs distintos que diferencien cada entrada sin revelar el orden. Activa Modo Experto → Serie numérica, patrón EVT2026-[N], cantidad 300. Pulsa "Descargar ZIP". Listo: el ZIP contiene qr-EVT2026-001.png a qr-EVT2026-300.png, listos para enviar a imprenta.

Consejos y trucos

• No recortes la zona quieta. Deja siempre al menos cuatro módulos blancos alrededor del QR. La mayoría de fallos de lectura vienen de esto.
• Mide a la distancia real. La regla "tamaño mínimo = distancia × 10 cm" es conservadora; en exteriores con buena luz puedes reducir hasta un 30 %.
• Si imprimes en plotter, activa trazo continuo. La cuchilla no levanta entre módulos y el corte es más limpio.
• Si pegas por dentro de un cristal, activa modo espejo. El QR se lee correctamente visto desde fuera del cristal.
• El logo no debe pasar del 25 % del QR. Si necesitas un logo más grande, sube la corrección a Q o H.
• SVG en imprenta profesional. A diferencia del PNG, el SVG es vectorial y se imprime a cualquier tamaño sin pixelarse. Úsalo siempre que puedas.
• Comprueba el QR escaneándolo con dos móviles distintos. iOS y Android leen diferente; si ambos lo pillan a la primera, vas bien.

Limitaciones y consideraciones

Esta herramienta es un generador, no un escáner: no lee QRs existentes. Tampoco convierte PDFs, no aplica marcas de agua y no aloja los QRs en ningún sitio (los archivos se descargan en tu dispositivo). Para QRs dinámicos que cambien de destino sin reimprimir, esta herramienta no es la adecuada: necesitarías un servicio backend con una URL corta que redirige. Aquí todos los QRs son estáticos: lo que codificas es lo que se queda.

La corrección de errores y el ajuste de versión los decide la librería automáticamente; si tu texto es extremadamente largo, puede que la matriz crezca hasta hacerse poco práctica. En ese caso, considera partir la información en varios QRs o usar una URL corta. La versión máxima que usa la herramienta es la 40 (177×177 módulos), suficiente para la mayoría de casos reales.

Glosario

Módulo

Cada uno de los cuadraditos negros o blancos que componen la matriz del QR.

Versión

Tamaño del símbolo. Va de 1 (21×21) a 40 (177×177) en pasos de 4 módulos.

Patrón de detección (finder pattern)

Cuadrado de 7×7 módulos en las tres esquinas que permite al escáner localizar y orientar el código.

Patrón de alineación

Cuadrado de 5×5 módulos presente desde la versión 2; corrige distorsión por perspectiva.

Patrón de temporización

Línea de módulos alternos que recorre el código y permite calcular el tamaño exacto del módulo.

Zona quieta (quiet zone)

Borde blanco obligatorio de 4 módulos alrededor del QR.

ECC (Error Correction Code)

Bits de redundancia que permiten recuperar datos dañados. Niveles L (7 %), M (15 %), Q (25 %), H (30 %).

Reed-Solomon

Algoritmo matemático que añade la redundancia del ECC. Misma familia usada en CDs y códigos espaciales.

Máscara

Operación XOR sobre los datos para evitar patrones grandes del mismo color. Hay 8 posibles.

Modo numérico / alfanumérico / byte / kanji

Formas de codificar el contenido. Byte es el más común (UTF-8).

ECC H con logo

El logo central "tapa" parte del código; la corrección alta compensa la oclusión.