QR Code ZPL — Guia completo do comando ^BQ

O que é um QR Code em ZPL?

Um QR Code em ZPL é um código de barras bidimensional gerado pelo comando ^BQ — uma das simbologias mais poderosas suportadas pelas impressoras Zebra. Um único QR pode armazenar até 4.296 caracteres alfanuméricos ou 7.089 dígitos numéricos, suporta correção Reed–Solomon (continua legível mesmo parcialmente danificado ou sujo) e é lido por qualquer câmera de smartphone ou scanner industrial. Por isso é a escolha universal para URLs de rastreio, cartões vCard, identificadores GS1, credenciais WiFi, tickets de transporte e qualquer payload que ultrapasse os 20 caracteres ideais para 1D.

Em ZPL, o QR fica dentro de um formato ^XA..^XZ como qualquer outro campo. Você o posiciona com ^FO ou ^FT, declara com ^BQ e em ^FD coloca dois caracteres antes da vírgula e dos dados: o primeiro é o nível de correção de erros (H, Q, M ou L) e o segundo é o modo de entrada (A para seleção de codificação automática, M para segmentos manuais). Para a maior parte da produção você escreve ^FDHA,dados^FS — alta recuperação, codificação automática. Não há passo ^BY separado porque o tamanho do módulo é controlado diretamente pelo parâmetro de magnificação — valores típicos são 4 a 8 numa etiqueta 4×6 polegadas a 203 dpi. O parâmetro de modelo deve ser sempre 2 (modelo 1 é legado e não recomendado para designs novos).

Sintaxe do comando ^BQ

A declaração mínima de QR usa 3 parâmetros após ^BQ — orientação, modelo e magnificação. O nível de correção de erros e o modo de entrada vão dentro de ^FD como um prefixo de 2 caracteres seguido de vírgula (veja Formato do Field Data abaixo). Estrutura canônica:

^XA
^CI28                                ; UTF-8 para dados internacionais
^FO50,50                             ; Posição X=50, Y=50
^BQ orientação,modelo,magnificação    ; orientação N/R/I/B, modelo 2, magnif. 1-10
^FD <ECC><modo>,<payload>^FS         ; ECC = H/Q/M/L, modo = A (auto) ou M (manual)
^XZ

; Linha típica de produção: alta recuperação + codificação automática
; ^FDHA,https://zplpdf.com^FS

Parâmetros do ^BQ

Níveis de correção de erros (H / Q / M / L)

A correção Reed–Solomon permite que o QR continue legível mesmo com parte do símbolo ausente ou danificada. O trade-off é a capacidade: níveis maiores adicionam mais redundância e deixam menos espaço para dados. O nível é selecionado pelo primeiro caractere do prefixo no ^FD — HA para H + auto, MA para M + auto, etc. Não há default implícito — você sempre declara o nível explicitamente. Para envios e exterior, HA é o ponto de partida recomendado; para etiquetas internas limpas MA economiza espaço.

Tamanho e magnificação

O tamanho do QR em ZPL é controlado pelo parâmetro de magnificação (1–10) — não há passo ^BY para QR. Cada unidade multiplica o módulo (o quadradinho menor do QR) por 4 dots a 203 dpi e 6 dots a 300 dpi. O tamanho total do símbolo depende da magnificação e do tamanho do payload (mais dados → mais módulos → código maior).

• Impressora 203 dpi + magnificação 5 ≈ 200×200 dots ≈ 25×25 mm com URL de 50 chars.
• Impressora 203 dpi + magnificação 8 ≈ 320×320 dots ≈ 40×40 mm — recomendado para leitura externa a >50 cm.
• Impressora 300 dpi + magnificação 5 ≈ 300×300 dots ≈ 25×25 mm com URL de 50 chars.
• Smartphones leem magnificação 3 com confiabilidade se a URL for curta (≤25 chars) e a etiqueta estiver a <20 cm da câmera.
• Sempre teste com o scanner mais lento esperado; subir a magnificação em 1 é mais barato do que falhas em campo.
• Módulos menores que 0,4 mm deixam de ser legíveis em scanners de baixa qualidade — mantenha a magnificação ≥4 em impressoras 203 dpi.

Erros comuns com QR e como corrigi-los