Pular para o conteúdo principal

Perguntas Frequentes

Nesta página, forneceremos respostas para perguntas comuns que frequentemente recebemos no suporte.

Sinta-se à vontade para entrar em contato conosco se tiver alguma pergunta que não esteja respondida aqui.

Como imprimir programaticamente código ZPL em uma impressora Zebra conectada à rede?​

Para uma impressora Zebra conectada à rede, a maneira mais fácil é enviar o código ZPL diretamente por um soquete TCP. As impressoras Zebra escutam na porta TCP 9100 por padrão.

No MacOS ou Linux, você pode usar a ferramenta de linha de comando netcat / nc para imprimir um arquivo contendo código ZPL:

nc -N 192.168.1.234 9100 < my_label.zpl

Abaixo está um exemplo em Java para enviar uma string ZPL (conforme retornado pela API) para uma impressora:

String zplCode = ... // This should be the full ZPL code
try (Socket socket = new Socket("192.168.1.234", 9100)) {
	OutputStream os = socket.getOutputStream();
	os.write(zplCode.getBytes(StandardCharsets.US_ASCII));
	os.flush();
} catch (IOException e) {
	// Notify users of network errors here...
	throw new RuntimeException(e);
}

Como gerar um código de barras em HTML?​

Você pode incluir uma biblioteca JavaScript que renderiza um código de barras.

Abaixo está um exemplo que adiciona um simples código de barras Code128 usando a biblioteca JsBarcode:

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/JsBarcode.all.min.js"></script>
<svg id="barcode"></svg>
<script>
  JsBarcode("#barcode", "htmltozpl.com", {
    format: "code128"
  });
</script>

Isso gerará a seguinte etiqueta ZPL:

Exemplo de etiqueta mostrando um código de barras

Qual é a melhor maneira de posicionar elementos com precisão em uma etiqueta?​

Recomendamos posicionar os elementos usando unidades absolutas do CSS, como in (polegadas) ou mm (milímetros). Por exemplo:

<style>
	.box {
		position: absolute;
		box-sizing: border-box;
		top: 1.5in;
		left: 1in;
		width: 2in;
		height: 3in;
		border: 5pt solid black;
		padding: 5mm;
	}
</style>
<div class="box">
	This box is positioned using absolute units
	and appears centered in a 4 x 6 label
</div>

Isso renderizará uma etiqueta que se parece com isso:

Exemplo de etiqueta mostrando uma caixa posicionada com unidades absolutas

É possível rotacionar uma etiqueta?​

Sim! Você pode usar a função de rotação CSS para rotacionar qualquer elemento HTML. Se você envolver todo o corpo em um div com rotação, a etiqueta será renderizada rotacionada.

Por exemplo:

<div style="transform: rotate(90deg);">
	This will appear rotated 90°
</div>

Como você pode especificar valores de sangria ou margem?​

Você pode envolver o HTML da sua etiqueta em um contêiner <div> e adicionar um preenchimento (padding). Considere adicionar o atributo de estilo box-sizing para evitar que o preenchimento seja adicionado às dimensões da caixa.

Por exemplo, para adicionar uma margem de 0,5 polegadas em torno de uma etiqueta de 4"x6":

<div style="width: 4in; height: 6in; padding: 0.5in; box-sizing: border-box;">
   ... rest of label here ...
</div>

Como imprimir uma imagem na etiqueta ZPL?​

Você pode simplesmente usar a tag <img> do HTML diretamente para renderizar uma imagem:

<img src="https://www.example.org/test.png" style="width: 2in; height: 1in;" />

Observe que isso acionará uma solicitação de rede em cada invocação e você precisará hospedar a imagem publicamente, para que nossos servidores possam acessá-la. Se você quiser evitar isso, pode codificar a imagem em base64 e incluí-la diretamente na URL. Existem vários serviços online que podem converter arquivos de imagem para o formato base64, como por exemplo o base64-image.de, ou no Linux/MacOS você pode usar a ferramenta base64 para codificar um arquivo na linha de comando.

<img src="data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
     style="width: 2in; height: 1in;" />

Posso usar uma fonte personalizada na etiqueta ZPL?​

Sim! Você pode incluir fontes web via CSS.

Alternativamente, você pode nos enviar um e-mail curto anexando os arquivos de fonte (por exemplo, arquivos TTF ou WOFF). Nós os disponibilizaremos para uso dentro da API.

Tenho outra pergunta ou encontrei um bug! Como posso obter ajuda?​

Envie-nos um e-mail rápido. Faremos o nosso melhor para ajudar.