Modelos de etiqueta ET01¶
Cadastrar e manter os modelos (templates) de etiqueta usados pela empresa. Cada modelo define tamanho, densidade, conteúdo e em que situações pode ser usado.
Pré-requisitos¶
- Estar logado com permissão Etiquetas: gerenciar modelos.
- Saber a largura × altura em mm da etiqueta física que você usa na impressora.
- Saber a densidade da impressora (203 ou 300 DPI) — está no manual ou na etiqueta da própria impressora.
Antes de cadastrar
Tenha em mãos uma etiqueta de exemplo já impressa do modelo que quer reproduzir. Largura, altura e DPI errados fazem o conteúdo sair cortado ou minúsculo.
Visão geral da tela¶
A tela inicial é uma galeria de cards. Cada card mostra:
- Nome do modelo e seu código interno.
- Badge de tipo (ex.: COMPRA, GONDOLA, PRECO).
- Badges de setor (Almoxarifado, Gôndola, Expedição…).
- Tamanho em mm e DPI.
- Número de placeholders (campos dinâmicos) usados.
Filtros disponíveis no topo:
| Filtro | Função |
|---|---|
| Tipo | Filtra por categoria de uso (compra, gôndola, preço, livre etc.). |
| Setor | Filtra por setor de aplicação. |
| Status | Ativos, inativos ou todos. |
Passo a passo — criar um modelo¶
1. Abrir o formulário¶
Clique em + Novo Modelo no canto superior direito da tela.
2. Preencher a Identificação¶
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome | Sim | Nome legível, ex.: Etiqueta Produto Compra 60×40. |
| Código | Sim | Slug único do modelo. Use minúsculas, dígitos e _. Entre 3 e 50 caracteres. O sistema valida disponibilidade em tempo real. |
| Tipo | Sim | Escolha uma categoria sugerida ou digite uma nova em Tipo customizado. |
| Setores | Não | Lista livre de setores onde a etiqueta é usada (Almoxarifado, Gôndola, Expedição…). Digite e pressione Enter para adicionar. |
| Largura (mm) | Sim | Largura física da etiqueta. |
| Altura (mm) | Sim | Altura física da etiqueta. |
| Densidade (DPI) | Sim | 203 ou 300. Precisa bater com a impressora. |
| Colunas por fileira | Não | 1 para bobina padrão, 2 ou 3 para bobinas com várias etiquetas lado a lado. |
| Gap entre colunas (mm) | Não | Espaço vazio entre etiquetas na mesma fileira. Só aparece se houver mais de 1 coluna. |
| Observação | Não | Notas internas sobre o modelo. |
| Ativo | — | Chave liga/desliga. Modelos inativos não aparecem na pré-fila nem nas etiquetas avulsas. |
3. Preencher o Template¶
O painel à direita tem dois campos:
Variáveis esperadas (placeholders declarados)
Lista os campos dinâmicos que o modelo aceita, no formato chave.sub. Exemplos:
produto.skuproduto.eanproduto.descricaoproduto.precopedido.numero
Digite o nome e pressione Enter ou vírgula para adicionar.
Template ZPL
Cole o template no editor. Onde precisar do valor dinâmico, use o placeholder entre chaves duplas (ex.: {{produto.sku}}).
Análise automática
Logo abaixo do editor o sistema mostra:
- Usados no template — placeholders detectados.
- Não declarados — aparecem no template mas não estão na lista de "Variáveis esperadas". Adicione-os para evitar surpresas.
- Declarados mas não usados — estão na lista mas não aparecem no template. Pode ser sobra de versão anterior.
Conteúdo do template
Você não precisa entender ZPL para mexer no Sistemax — o template é fornecido pelo fabricante da impressora ou pelo suporte. Se precisar criar um novo modelo do zero, peça ajuda ao suporte e copie um modelo existente como ponto de partida.
4. Gerar preview (opcional)¶
Depois de salvar o modelo pela primeira vez, o botão ▶ Gerar preview fica disponível. Ele renderiza o template com valores de exemplo (cada placeholder vira EXEMPLO_NOME) para conferência visual.
Preview só após salvar
O preview precisa do ID do modelo, então salve antes. Para um modelo novo, salve, gere o preview e ajuste se necessário.
5. Salvar¶
Clique em Criar modelo (modelo novo) ou Salvar alterações (modelo existente). O botão só fica ativo quando nome, código, tipo, largura, altura e template estão preenchidos.
Pronto!
O modelo está disponível imediatamente para uso em Etiquetas avulsas e na Pré-fila.
Editar ou desativar um modelo¶
Na lista:
- Editar — abre o formulário com os dados atuais.
- Desativar — remove o modelo da seleção em outras telas. Pode ser reativado depois alterando o campo Ativo dentro do formulário.
Não dá pra excluir definitivamente
Modelos não são apagados — apenas inativados. Isso preserva o histórico de etiquetas já impressas.
Erros comuns¶
Código já existe
Cada modelo tem um slug único. Se o código aparecer em vermelho com a mensagem "Código indisponível", troque por outro.
Conteúdo cortado na impressão
Provavelmente largura ou altura em mm estão erradas. Meça a etiqueta física com régua e ajuste.
Texto sai minúsculo ou esticado
DPI incorreto. Confirme se a impressora é 203 ou 300 DPI e ajuste o campo Densidade.
Aviso de placeholder não declarado
O template usa uma variável que não está em "Variáveis esperadas". Adicione na lista ou remova do template — etiquetas que não receberem o valor sairão com o placeholder literal.