Agente de impressão ZPL

Uma loja em nuvem ou ERP não consegue acessar uma impressora na sua rede. O agente OpenZPL roda ao lado da impressora, coleta os trabalhos de impressão e os entrega, sem necessidade de abrir uma porta de firewall.

Baixar

O agente ainda não está assinado, então o Windows e o Mac avisam na primeira vez. No Windows, escolha Mais informações, depois Executar assim mesmo. No Mac, clique com o botão direito e escolha Abrir.

Execute-o

Crie um API key, então inicie o agente com o endereço de cada impressora. Sem qualquer --printer, ele utiliza todas as impressoras instaladas no computador.

openzpl-agent --key oz_live_… --printer "Dock=192.168.1.50"

Para uma impressora conectada ao computador, use seu nome como instalado, com queue: na frente. Liste-as com openzpl-agent list.

openzpl-agent --key oz_live_… --printer "Desk=queue:ZDesigner ZD421"

Envie uma etiqueta para isso

De qualquer sistema, envie ZPL ou preencha um design salvo, nomeando a impressora.

curl https://api.openzpl.com/v1/print-jobs -H "X-API-Key: oz_live_…" -H "Content-Type: application/json" \
  -d '{"printer": "Dock", "zpl": "^XA^FO50,50^A0N,50,50^FDHello^FS^XZ"}'

curl https://api.openzpl.com/v1/templates/d123/print -H "X-API-Key: oz_live_…" -H "Content-Type: application/json" \
  -d '{"printer": "Dock", "data": {"sku": "A-100"}}'

A resposta tem um ID de trabalho: pergunte GET /v1/print-jobs/{id} se imprimiu.

Mantenha-o em execução

Coloque sua chave e impressoras em openzpl-agent.conf ao lado do programa, uma por linha, e inicie-o com o computador.

key=oz_live_…
printer=Dock=192.168.1.50

Windows

schtasks /Create /TN OpenZPLAgent /SC ONSTART /RU SYSTEM /TR "C:\OpenZPL\openzpl-agent.exe"

Linux (systemd)

[Service]
ExecStart=/opt/openzpl/openzpl-agent
Restart=always

Perguntas

Quais impressoras funcionam?

Qualquer um que aceite ZPL, na rede (porta 9100) ou instalado no computador.

Minha rede está exposta?

Não. O agente apenas faz chamadas HTTPS de saída, e nada se conecta.

Vocês mantêm as etiquetas?

Apenas até o agente relatar o resultado, e no máximo um dia se nunca os coletar. Veja a privacy page.

Isso conta contra meu plano?

O agente faz parte do Pro, até 3 impressoras, e do Business, sem limite. Uma conta gratuita pode experimentá-lo por 14 dias. Cada etiqueta enviada conta como uma renderizada.