^XZ
Fim do FormatoPreview: parcialFecha o formato e manda a impressora imprimir e avançar a etiqueta. Sem ele, nada é impresso.
Sintaxe
^XZEste comando não tem parâmetros.
Como funciona
^XZ encerra o formato aberto pelo ^XA. É o comando que de fato faz a etiqueta ser impressa e avançada — até a impressora recebê-lo, tudo que você enviou está apenas no buffer dela.
^XZ não tem parâmetros. Qualquer campo deixado aberto por um ^FS faltando é fechado no fim do formato, mas o campo em si pode sair errado, então isso não substitui fechar os campos direito.
Um bug clássico de integração é a transmissão terminar sem o ^XZ final, normalmente porque um template foi concatenado errado ou uma quebra de linha foi cortada. O sintoma é sempre o mesmo: a impressora aceita os dados, a luz de status continua normal, e nenhuma etiqueta aparece.
Exemplo
^XA
^FO40,60^A0N,45,45^FDPrinted on ^FS
^FO40,130^A0N,45,45^FDone label^FS
^XZRenderizando…
O que o preview deste site faz com ele
O preview desenha a etiqueta assim que termina de ler, então um ^XZ faltando ainda mostra algo aqui, mesmo que uma impressora de verdade não imprimisse nada. O validador aponta isso como format/missing-xz.
Erros comuns
- Esquecer o ^XZ. A impressora fica esperando indefinidamente pelo resto do formato e não imprime.
- Enviar ^XZ sem um ^XA correspondente. Não há formato aberto para fechar e o comando é descartado.
- Colocar um ^XZ no meio da etiqueta para 'forçar' a impressão. Isso encerra a etiqueta ali, e tudo depois vira um novo formato.