Como criar um código QR em ZPL
Aprenda a gerar um código QR confiável com Zebra Programming Language (ZPL), escolher o tamanho e a correção de erro e testar a etiqueta impressa antes da produção.
O que um QR code em ZPL contém
Um QR code armazena texto em uma matriz bidimensional. Em etiquetas, costuma ser uma URL, um identificador de produto ou um código de rastreamento. O ZPL envia as instruções e a impressora cria os módulos.
O comando ^BQ cria símbolos QR. Ele define orientação, modelo e ampliação, enquanto ^FD fornece os dados. Comece com um conteúdo curto e deixe uma zona branca ao redor.
Sintaxe básica de ^BQ
No exemplo, ^FO posiciona o símbolo, ^BQN seleciona o QR, 2 escolhe o modelo comum e 6 é a ampliação. O prefixo LA ativa a correção automática para os dados seguintes.
^FS fecha o campo e ^XZ encerra o formato. Mantenha os comandos separados ao depurar para distinguir posição de dados inválidos.
^XA
^FO60,60^BQN,2,6^FDLA,https://editorzpl.com^FS
^XZEscolha tamanho, DPI e correção
Os módulos são pontos de impressão, portanto a mesma ampliação produz tamanhos físicos diferentes em 203, 300 e 600 DPI. Combine o DPI do visualizador com o da impressora.
Deixe uma zona branca clara em todos os lados. Mais correção tolera danos, mas deixa o símbolo mais denso. Aumente o tamanho antes de reduzir a zona branca.
Prepare os dados antes de codificar
URLs, textos e identificadores funcionam bem. Use a URL HTTPS final e mantenha-a curta. Para Wi-Fi, vCard ou outro formato, gere exatamente o conteúdo exigido pelo formato.
Não cole caracteres de controle nem quebras de linha acidentais em ^FD. Teste acentos e valores longos com o mesmo firmware e página de código da produção.
Abrir o gerador de QRVisualize e imprima uma amostra
Cole o exemplo no visualizador ZPL, selecione o tamanho físico e o DPI. A prévia verifica posição e densidade, mas não prova a leitura da tinta impressa.
Imprima uma amostra e leia com dois dispositivos. Verifique contraste, zona branca, orientação e valores curtos e longos. Se falhar, aumente a ampliação e revise os dados.
Problemas comuns de QR em ZPL
Um QR que não lê costuma estar pequeno, denso, com pouco contraste ou cortado pela borda. Zona branca insuficiente, rotação errada ou DPI diferente também causam falhas.
Se a impressora rejeitar o comando, confirme o suporte a ^BQ no firmware e que o formato começa com ^XA e termina com ^XZ. Use uma URL curta como controle.
Perguntas frequentes
Qual comando ZPL cria um código QR?
Use ^BQ. Ele define o símbolo QR e usa ^FD para os dados.
O que significa ^BQN,2,6?
N indica orientação normal, 2 seleciona o modelo QR 2 e 6 é a ampliação em pontos.
Um QR pode conter URL ou texto?
Sim. Coloque o conteúdo depois do prefixo LA em ^FD, mantenha-o curto e teste o valor de produção.
Por que meu QR ZPL não lê?
Verifique tamanho, zona branca, contraste, DPI, rotação e comprimento e teste uma amostra real.
Guias relacionados
Referências oficiais
Referências verificadas em 4 de outubro de 2026. Ilustração gerada por IA de uma impressora térmica genérica.
Sobre o autor
Eduard Diaz
Eduard Diaz é técnico de TI (desenvolvimento) na S-IE, parceira oficial da Zebra com mais de 20 anos oferecendo serviços de identificação e etiquetagem. Ele desenvolve e mantém o EditorZPL para facilitar o trabalho com ZPL e impressoras de etiquetas Zebra.
s-ie.cat