Códigos QR em ZPL

A impressora renderiza QR de forma nativa com o comando ^BQ: nenhuma biblioteca externa necessária, a impressora calcula a matriz sozinha.

QR básico

^XA
^FO100,100^BQN,2,8^FDMA,https://zplcloud.com^FS
^XZ

Parâmetros do ^BQ: ^BQa,b,c,d,e

Parâmetro	Significado	usual
a	orientação: apenas N (normal)	N
b	modelo: 1 = original, 2 = aprimorado (recomendado)	2
c	ampliação (1–10, tamanho do módulo em pontos)	2–4
d	correção de erros: H (≈30 %), Q (≈25 %), M (≈15 %), L (≈7 %)	M
e	valor de máscara (0–7)	7

Modos de dados

O conteúdo do ^FD começa com um prefixo formado pelo nível de correção de erros e pelo modo de entrada, seguido de uma vírgula:

Prefixo	Significado	para
MA,	correção M, entrada automática	URLs, conteúdos mistos
HA,	correção H, entrada automática	etiquetas pequenas ou muito sujeitas a desgaste
MM, + modo	entrada manual: N = numérico, A = alfanumérico, B = byte, K = kanji	codificação explícita

^FDMA,https://zplcloud.com^FS ; automático
^FDQM,N4006381333931^FS       ; correção Q, manual numérico

Recomendação de tamanho

O tamanho físico depende da ampliação e do conteúdo:

Ampliação	Tamanho do módulo @203 dpi	~24 caracteres (URL)
2	0,25 mm	≈ 12 mm
3	0,38 mm	≈ 18 mm
4	0,50 mm	≈ 24 mm

Regra prática: pelo menos 4 módulos de zona de silêncio em todos os lados; a impressora deve conseguir imprimir um quadrado limpo e fechado (cabeça limpa, escuridão suficiente).

Dicas

• O QR precisa de bom contraste: módulos pretos sobre material branco, com ^MD alto o suficiente.
• Sempre teste com o celular: um QR que «parece bom» só é lido se a correção de erros corresponder à qualidade de impressão.
• Em etiquetas muito pequenas escolha a correção de erros mais alta (H) para resistir a poeira e defeitos.