CloudMES Docs
CloudMES Docs

Etiquetas

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

  1. Acesse /dashboard/wms/etiquetas.
  2. Clique em + para criar um novo template.
  3. 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
  4. Use o botão Preview para visualizar o resultado antes de salvar.
  5. 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.