Padrões de QR Code: versões, correção de erros e boas práticas

QR codes parecem um problema resolvido até que você imprima 5.000 cartões de visita e um terço deles não leia. A norma dá muito espaço para criar códigos válidos que mesmo assim não funcionam no mundo real. Este guia cobre as partes da ISO/IEC 18004 que importam para design e integração, e as regras práticas que a especificação não declara, mas que todo QR code em produção obedece.

A norma: ISO/IEC 18004

QR codes foram inventados pela Denso Wave em 1994 para rastreamento de peças automotivas. O formato foi aberto em 1999 e padronizado como ISO/IEC 18004, atualmente na revisão de 2015. Qualquer um pode gerar ou decodificar QR codes sem taxas de licença; a marca registrada do termo “QR Code” permanece com a Denso Wave, mas é licenciada gratuitamente para uso.

Você pode gerar qualquer um dos códigos descritos abaixo com nosso gerador de QR code, que produz saída SVG adequada tanto para telas quanto para impressão — vetorial significa que os padrões de localização ficam nítidos em qualquer tamanho, de um adesivo de 2 cm a um outdoor.

Versões 1 a 40

A versão de um QR code determina seu tamanho físico — medido em módulos, não pixels. A Versão 1 é 21×21 módulos; cada versão subsequente adiciona 4 módulos por lado, então a Versão 40 é 177×177. A versão necessária depende do comprimento do payload, modo de codificação e nível de correção de erros. Um gerador normalmente escolhe a menor versão que cabe.

Capacidade aproximada no nível de correção de erros M (recuperação de 15%), a escolha mais comum:

• Versão 1 (21×21): 14 alfanuméricos ou 20 caracteres numéricos.
• Versão 5 (37×37): 122 alfanuméricos ou 202 numéricos — suficiente para uma URL típica.
• Versão 10 (57×57): 395 alfanuméricos ou 652 numéricos.
• Versão 25 (117×117): 1.853 alfanuméricos ou 3.057 numéricos.
• Versão 40 (177×177): 4.296 alfanuméricos ou 7.089 numéricos — o máximo absoluto.

A capacidade cai significativamente em níveis mais altos de correção de erros. No nível H (30%), o mesmo código Versão 40 contém apenas cerca de 1.852 caracteres alfanuméricos. Escolha a versão mais baixa possível — cada passo multiplica o número de módulos e força o leitor a focar em uma grade mais densa.

Os quatro níveis de correção de erros

QR codes usam correção de erros Reed–Solomon, o mesmo algoritmo usado em CDs, DVDs e comunicação de espaço profundo. As palavras de código são intercaladas para que danos locais (uma mancha de café, uma impressão digital, um adesivo) destruam uma pequena fração de cada bloco em vez de apagar uma sequência contígua de dados.

• L (Baixo) — recupera ~7%. Densidade máxima de dados. Use apenas para códigos limpos, grandes e na tela.
• M (Médio) — recupera ~15%. O padrão para quase tudo. Impressão, telas, embalagens.
• Q (Quartil) — recupera ~25%. Impressão pequena, ambientes levemente contaminados, cartões laminados.
• H (Alto) — recupera ~30%. Necessário ao sobrepor um logotipo; recomendado para sinalização externa, embalagens de alimentos, etiquetas de equipamentos em ambientes sujos.

A porcentagem de recuperação refere-se às palavras de código, não módulos — mas na prática as duas são suficientemente próximas para que projetar pela porcentagem seja uma aproximação razoável.

Modos de codificação

QR codes têm quatro modos de codificação de dados, e o gerador alterna entre eles com base no conteúdo:

1. Numérico (0–9). 3,33 bits por dígito. O modo mais compacto; útil para números de série, números de telefone e IDs de rastreamento.
2. Alfanumérico. 5,5 bits por caractere. Cobre0–9, A–Z (somente maiúsculas), espaço e a pontuação $ % * + - . / :. URLs cabem se você as colocar em maiúsculas; alguns leitores normalizam de volta antes de abrir o link.
3. Byte (8 bits). 8 bits por byte. O fallback para qualquer coisa fora do conjunto alfanumérico; quase sempre texto UTF-8 em códigos modernos.
4. Kanji. 13 bits por caractere para Kanji Shift-JIS. Mais denso que o modo Byte para texto japonês, mas somente suportado se o codificador e o leitor concordam em Shift-JIS. A maioria dos códigos japoneses modernos usa UTF-8 no modo Byte por segurança.

Um único QR code pode alternar modos no meio do payload, então um número de série mais uma URL pode ser mais compacto do que qualquer um isoladamente. Bons geradores fazem isso automaticamente.

Anexo estruturado

Para payloads mais longos do que a Versão 40 suporta, a especificação permite que uma única mensagem seja dividida em até 16 códigos usandoanexo estruturado. Cada parte carrega um cabeçalho identificando sua posição na sequência e um byte de paridade para verificar a mensagem inteira. O suporte de leitores é limitado a leitores industriais; câmeras de telefone de consumo quase universalmente tratam cada código como independente. Não confie no anexo estruturado para qualquer coisa que chegue ao público.

Micro QR

Micro QR codes (versões M1–M4) reduzem o formato para etiquetagem com espaço restrito. M1 é 11×11 módulos e contém apenas 5 caracteres numéricos; M4 é 17×17 e contém até 35 numéricos, 21 alfanuméricos ou 15 bytes. São úteis para etiquetas de placas de circuito impresso pequenas e marcações de circuito integrado; câmeras de telefone de consumo os suportam, mas bibliotecas de webcam desktop nem sempre.

Regras de design que decidem se lê

Três coisas importam mais que qualquer outra na especificação:

1. Contraste. Módulos escuros sobre fundo claro. A proporção de contraste entre primeiro plano e fundo deve ser pelo menos 4:1; verifique as amostras em nosso seletor de cor antes de imprimir. Códigos invertidos (claro sobre escuro) são permitidos pela especificação, mas rejeitados por muitos leitores, especialmente apps de câmera Android mais antigos.
2. Zona silenciosa. Uma margem de 4 módulos de cor de fundo em cada lado. Omiti-la — geralmente porque um designer queria encaixar o código em um layout apertado — é a causa mais comum de falha de leitura em material produzido profissionalmente.
3. Tamanho do módulo.Na distância típica de câmera de telefone (15–30 cm), os módulos devem ter pelo menos 0,4 mm de largura para ler de forma confiável. Para pôsteres destinados a serem lidos de um lado a outro da sala, use a regra “distância ÷ 10 = largura mínima do código.” Um código destinado a ser lido de 2 m de distância precisa ter pelo menos 20 cm quadrado.

A personalização de cor é permitida dentro dessas restrições. Um azul escuro ou verde escuro sobre creme está bom. Um pastel sobre branco não está — o contraste fica abaixo do limiar de detecção.

Formatos de payload que leitores de consumo entendem

• URL. Basta colar a URL. Inclua o esquemahttps://; alguns leitores rejeitam códigos sem ele. Mantenha URLs curtas para caber em uma versão menor — use nossa ferramenta de URL para verificar a codificação.
• Wi-Fi. Formato: WIFI:T:WPA;S:NomeDaRede;P:Senha;H:false;;. Reconhecido pelos apps de câmera iOS e Android. Defina H:true para redes ocultas.
• Contato vCard. Payload vCard 3.0 ou 4.0 padrão entre BEGIN:VCARD e END:VCARD. Os telefones oferecem adicionar o contato diretamente.
• SMS / tel / mailto. Esquemas URI padrão (sms:+55119999?body=Ola, tel:+5511999999999, mailto:[email protected]?subject=Oi). Universalmente suportados.
• Geo. geo:37.7749,-122.4194 abre o app de mapas padrão. iOS pode exigir o fallback específico da Apple http://maps.apple.com/?ll=… em versões mais antigas.

Rastreamento e URLs encurtadas

Muitos códigos de marketing usam uma URL encurtada não para economizar caracteres, mas para rastrear leituras e dar ao impressor uma saída de emergência se a URL de destino mudar. O compromisso: o usuário aterrissa no redirecionamento antes de chegar ao seu site, o que adiciona latência e revela o domínio do encurtador na prévia. Se você controla o destino, prefira seu próprio domínio curto em vez de um encurtador público — o redirecionamento é mais rápido e a prévia aparece como sua marca.

A conclusão honesta

Escolha o nível de correção de erros M a menos que tenha uma razão específica para ir mais alto. Mantenha a URL curta para que a versão permaneça baixa. Respeite a zona silenciosa. Teste em pelo menos dois telefones — idealmente um Android mais antigo — sob luz realista antes de o código ir para impressão. A maioria das falhas de QR não são bugs do gerador; são violações de zona silenciosa, contraste ou tamanho de módulo que pareciam boas na prova de design e falharam no mundo real.