Impressão pela API para bancadas Windows

Seu sistemamanda.A etiqueta sai.

O Tagu liga o seu ERP, loja ou sistema de assistência às impressoras da bancada. Uma chamada HTTP vira etiqueta ZPL na Zebra ou PDF na laser, sem janela de impressão e sem perder nada quando a internet cai.

01 · Seu sistema
02 · Tagu
  1. Recebido pela APIPOST /v1/jobs · 202
  2. Na fila da bancadabancada-expedicao-01
  3. ImprimindoZebra ZD220
  4. Impressotrabalho concluído
03 · Zebra ZD220
Pedido 48213ZPL
Volume 1 de 2 · Rota SP-07 Transportadora Norte
48213-0107

A bancada tem dia ruim. O trabalho não se perde.

Expedição e balcão não param porque acabou o papel. Veja o que o Tagu faz em cada caso, sem ninguém abrir o sistema de novo.

Acabou o papel

O trabalho volta para a fila e o motivo aparece na bandeja e no painel. Trocou o rolo, ele sai sozinho.

A internet caiu

O que já chegou fica guardado no disco da bancada e imprime normalmente. O que for enviado depois espera na nuvem e chega quando a conexão voltar.

Impressora desligada

Novas tentativas com intervalo crescente. Se não der, o trabalho fica marcado como falho, com o erro, e reimprime em um clique.

O PC reiniciou

O Tagu roda como serviço do Windows. Volta antes do login e imprime até com a tela bloqueada.

Pedido duplicado

Mande uma idempotency_key por pedido. O segundo envio devolve o trabalho que já existe, e a etiqueta não sai repetida.

Do instalador à primeira etiqueta, sem chamar o TI.

Windows 10 ou 11. Em muitas bancadas de uma vez, o instalador roda em modo silencioso com um token.

1

Rode o instalador

Ele instala o serviço, o ícone perto do relógio e já abre o assistente.

Baixar tagu-setup.exe
2

Aprove o código no painel

A bancada mostra um código. Quem administra a conta confirma no navegador e ela entra na empresa.

K7Q-M2X
3

Escolha as impressoras

O Tagu lista as do Windows e acha as de rede pelo IP. Marque quais a bancada usa e pronto.

OnlineTudo certo2 impressoras prontas

Uma chamada por etiqueta.

Mande o ZPL ou o PDF em base64, ou uma URL para o Tagu buscar. A resposta traz o id do trabalho, e o status fica no painel e na API.

  • Formatos zplpdfraw
  • De 1 a 100 cópias por trabalho
  • Seu número de pedido em external_ref
Ler a documentação
POST /v1/jobs
curl -X POST https://api.tagu.com.br/v1/jobs \
  -H "Authorization: Bearer tg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "printer_id": "8f2c...",
    "format": "zpl",
    "content": "XlhBXkZPNTAsNTBeQUROLDM2LDIwXkZEVGFndV5GU15YWg==",
    "external_ref": "PED-48213",
    "idempotency_key": "PED-48213"
  }'
202{ "id": "c41e...", "status": "queued", "external_ref": "PED-48213" }

Dúvidas de quem já tentou de outro jeito.

Funciona com a minha impressora?

Qualquer impressora instalada no Windows imprime PDF. Para ZPL, Zebra e compatíveis (Elgin, Argox, TSC) funcionam pela USB, pelo driver ou direto na rede, na porta 9100.

Preciso deixar alguém logado no computador?

Não. O Tagu é um serviço do Windows. O ícone na bandeja só mostra o estado e deixa testar e reimprimir.

Como instalo em muitas bancadas?

Gere um token de instalação no painel e rode tagu-setup.exe /S /TOKEN=... por GPO, Intune ou script. Cada bancada entra sozinha, sem aprovar código.

Ele guarda o conteúdo das etiquetas?

Na bancada, só enquanto o trabalho está na fila. Na nuvem, pelo prazo descrito na política de privacidade, para permitir a reimpressão.

Ligue a primeira bancada hoje.