Esta tela conecta o Lisya às suas impressoras térmicas. As impressoras são persistidas no backend (por unidade); o job vai ao agente local (que fala ZPL/EPL/TSPL com o térmico via USB/serial/rede) ou, sem agente, cai no PDF do navegador.
Baixar e ligar o agente
O agente de impressão é um executável único (não precisa instalar Node). O cartão de download detecta seu sistema e oferece o binário: Windows (.exe), macOS e Linux. Ele escuta só em localhost:9110.
- 1Baixe e execute o agente no computador ligado à impressora (no Windows, se o SmartScreen avisar, *Mais informações → Executar assim mesmo*; no Mac/Linux,
chmod +xe rode). - 2Libere no firewall/antivírus se pedir.
- 3Clique Verificar agente — o cartão de status deve ficar conectado (verde). No Chrome/Edge funciona direto (aceite a permissão de rede local na 1ª vez).
- 4Cadastre a impressora e clique Teste.
Sem agente = PDF
Sem o agente rodando, as etiquetas saem em PDF pelo navegador. Safari/Firefox em página https exigem o agente em https com certificado — veja o README do agente. Se os binários não aparecerem no download, o deploy precisa de BUILD_PRINT_AGENT=1.
Cadastrar uma impressora
Use + Adicionar. Campos do formulário:
| Campo | Opções / uso |
|---|---|
| Nome | Ex.: *Zebra ZD230 — Coleta Centro*. |
| Unidade | A que a impressora pertence (ex.: Centro). |
| Linguagem | ZPL (Zebra) · EPL (Zebra antiga) · TSPL (TSC/Elgin) · Argox · PDF (navegador). |
| Conexão | Agente local (USB/serial) · Rede (IP:9100) · Navegador (PDF). |
| Alvo | O destino: USB, COM3 ou 192.168.1.50:9100. |
| Tamanho | 50×30 · 40×25 · 33×22 (mm). |
| Tipo de código | Code128 ou Data Matrix. |
| Deslocamento horizontal (mm) | Corrige térmicas center-justified (ex.: Zebra ZD200t) que cortam à esquerda — aumente até centralizar. 0 = sem deslocamento. |
| Modelo de etiqueta | Vincula um template do editor de modelos; em branco usa o layout padrão. |
| Impressora padrão da unidade | Chave que define a térmica usada na impressão automática da coleta. |
Ações de cada impressora
| Ação | O que faz |
|---|---|
| Definir (estrela) | Torna a impressora a padrão da unidade. |
| Teste | Envia uma etiqueta de exemplo (via agente, ou PDF se não houver térmica). |
| Ver código (< >) | Mostra o payload ZPL/PPLB que o agente manda ao térmico. |
| Editar / Excluir | Altera ou remove o cadastro. |
Preview do modelo padrão
A pré-visualização deixa você escolher Tamanho (50×30/40×25/33×22) e Tipo de código (Code128/Data Matrix) e ligar/desligar os campos da etiqueta: Nome do paciente, Nº da O.S., Recipiente/cor, Mnemônicos dos exames e Data/hora. O botão Imprimir teste gera uma etiqueta de exemplo.
Precisa de um layout próprio?
Para desenhar a etiqueta livremente (barras, QR, logo, campos posicionados), use o Editor de modelos de etiqueta e vincule o modelo à impressora.
Os atalhos Etiquetas de teste (códigos escaneáveis das amostras reais, com *simular bipagem*) e Editor de modelos ficam no canto superior da tela.