Criação e manutenção de templates de etiqueta ZPL para impressão no cockpit e no WMS.
Rota
/dashboard/wms/etiquetas
Objetivo
Gerenciar os templates de etiqueta usados para identificar produtos, lotes, caixas e posições. Cada template define o corpo ZPL com placeholders substituídos no momento da impressão.
Pré-requisitos
- Padrão de etiquetas definido (modelo ZPL e dimensões físicas)
- Placeholders mapeados para os dados de cada fluxo (ordem, operação, lote, produto)
Como usar
- Acesse
/dashboard/wms/etiquetas.
- Clique em + para criar um novo template.
- Preencha:
- Código: identificador único do template
- Corpo ZPL: código ZPL com placeholders entre
{{ }}
- Largura (cm) e Altura (cm): dimensões físicas da etiqueta
- Use o botão Preview para visualizar o resultado antes de salvar.
- Salve.
Placeholders disponíveis (exemplos)
{{codigo_ordem}}, {{codigo_operacao}}, {{codigo_lote}}
{{codigo_produto}}, {{descricao_produto}}, {{unidade_produto}}
{{codigo_endereco_origem}}, {{codigo_endereco_destino}}
{{quantidade_boa_reporte}}, {{quantidade_refugo_reporte}}
Dados e integrações
GET/POST/PATCH/DELETE /wms/label-templates/
- Endpoint de preview/render para validação do ZPL
Erros comuns
- ZPL inválido: erros de sintaxe no ZPL causam preview em branco ou malformado; valide com uma ferramenta ZPL externa se necessário.
- Tamanho incompatível: dimensões informadas diferentes do papel configurado na impressora distorcem a etiqueta.
- Placeholder não substituído: verifique a grafia exata — os placeholders são case-sensitive.
Print
Ainda não há screenshot versionado. Salve em public/images/cloudmes/telas/etiquetas.png e substitua este bloco pela imagem.