Pular para o conteúdo principal

Etiquetas

A tela de Etiquetas centraliza o cadastro dos modelos de etiqueta ZPL usados pela empresa em todo o sistema — etiquetas de embarque de transportadora (Correios, J&T, Loggi, etc.), etiquetas de itens em recebimento, etiquetas de endereçamento do armazém, etiquetas de cesto de picking, etiquetas de inconformidade no packing e qualquer outro layout impresso em impressora térmica. Cada modelo cadastrado aqui fica disponível em todas as telas que precisam imprimir etiqueta: pedidos, recebimento, packing, ressuprimento e o próprio cadastro de transportadora (campo Etiqueta padrão).

A tela tem um modo de visualização único, em lista. O cadastro pode ser feito em dois modos: Canvas (interface visual em que você arrasta elementos — texto, código de barras, logo, variáveis — sobre a área da etiqueta) ou ZPL (você cola um código ZPL pronto, desenvolvido externamente). Em ambos os modos, o sistema gera o ZPL final que é enviado para a impressora. A janela de cadastro tem ainda o botão Visualizar Etiqueta, que renderiza o PDF em tamanho real via integração com o serviço público labelary.com, e ações em lote em Mais Ações → Duplicar Etiqueta — útil para clonar um modelo para outra conta ou criar variações.

Esta tela não tem parametrizações próprias — todo o comportamento é definido pelos campos do cadastro de cada modelo (categoria de uso, dimensões, número de colunas).

Conceitos gerais (multi-conta, privilégios, parametrizações e padrões de tela) estão em Conceitos → Funcionamento do sistema.

Índice​

Conceito

Cadastro e edição

Ações em lote (Mais Ações)

Onde as etiquetas são usadas

Busca e visualização

Regras de negócio

Referência rápida

O que é a tela de Etiquetas?​

É a tela onde você desenha e mantém os modelos de etiqueta ZPL da empresa — layouts pré-configurados, com dimensões e elementos definidos, que o idworks usa em toda situação que envolve impressão de etiqueta em impressora térmica: etiqueta de embarque colada no volume, etiqueta de identificação do item no estoque, etiqueta de endereço da posição no armazém, etiqueta do cesto de picking e outras. Cada modelo é cadastrado com um nome, uma categoria de uso (que define onde ele pode ser aplicado), dimensões em centímetros e o conteúdo — desenhado pelo editor visual (Canvas) ou colado como código ZPL.

📍 Onde: menu lateral → Configurações → Etiquetas.

Quais são as categorias de etiqueta?​

A categoria define onde a etiqueta pode ser usada dentro do idworks. A lista é fixa do sistema:

CategoriaOnde é usada
Embarque (adicional transportadora)Etiquetas extras impressas ao lado da etiqueta principal da transportadora (declaração de conteúdo, etiqueta interna, etc.).
Itens (recebimento)Etiqueta colada no item durante o recebimento, para identificação física no estoque.
EndereçosEtiqueta da posição de armazenagem (rua/coluna/nível) afixada na prateleira.
Itens (cadastro)Etiqueta de produto gerada a partir do cadastro do SKU (sem vínculo com lote ou venda específica).
Transportadora (embarque)Etiqueta principal do volume, com endereço de entrega e código de rastreio — quando a transportadora não tem etiqueta própria ou quando a empresa optou por usar a etiqueta do idworks.
Cesto PickingEtiqueta colada no cesto/caixa que separa os itens de um pedido durante o picking.
Transportadora (cadastro)Etiqueta padrão associada ao cadastro de uma transportadora (selecionada no campo Etiqueta padrão em Cadastro → Fornecedores, aba Config. Transportadora).
Ressuprimento pendenteEtiqueta usada na operação de ressuprimento de armazém.
Inconformidade picking/packingEtiqueta de identificação de uma inconformidade detectada durante picking ou packing.

Qual a diferença entre o modo Canvas e o modo ZPL?​

São dois modos de desenhar o conteúdo da etiqueta:

CanvasZPL
Como funcionaInterface visual: você arrasta blocos sobre a área da etiqueta — texto fixo, variável ({Order}, {Address}, etc.), código de barras, logo, linhas, retângulos.Editor de código: você cola um ZPL pronto (gerado em ferramenta externa ou copiado de outra etiqueta) e o sistema usa exatamente esse código.
Quando usarQuando a etiqueta tem layout simples ou padrão e você quer ajustar com facilidade (mover elementos, trocar variáveis).Quando você já tem o ZPL pronto, ou quando precisa de algo mais sofisticado (códigos de barras especiais, fontes customizadas, gráficos complexos).
VariáveisLista de variáveis disponível direto no editor — basta arrastar.Você escreve direto no ZPL ({{Order}}, {{Address}} — substituição feita no momento da impressão).
Onde escolherSeletor Modo de visualização na janela de cadastro: Canvas ou ZPL.Mesmo seletor.

O ZPL final que vai para a impressora térmica é o mesmo em ambos os casos — no Canvas, o sistema gera o ZPL automaticamente a partir do layout.

O que são as variáveis disponíveis no editor Canvas?​

São marcadores que o idworks substitui no momento da impressão pelos dados reais do pedido, item, endereço ou transportadora. As variáveis disponíveis dependem da categoria escolhida na etiqueta — o painel lateral do editor Canvas mostra apenas as que pertencem à categoria selecionada, e basta arrastar a variável para a área da etiqueta. O ZPL gerado fica com os marcadores no formato {{NomeDaVariável}}, que o sistema troca pelos valores reais quando a impressão é disparada.

Lista completa por categoria:

Embarque (adicional transportadora)​

  • {{Order}} — Pedido
  • {{OrderFrom}} — Pedido origem
  • {{ConsumerNameCorporateName}} — Cliente
  • {{IDSkuCompany}} — Cód. ref. SKU
  • {{SkuName}} — Nome SKU
  • {{SkuComments}} — Comentários SKU
  • {{Quantity}} — Quantidade
  • {{ItemCount}} — Index item
  • {{ItemTotal}} — Qtde SKUs
  • {{CarrierName}} — Transportadora
  • {{Logos}} — Logo transportadora
  • {{OrderDate}} — Data pedido
  • {{EstimatedDate}} — Data estimada entrega

Itens (recebimento)​

  • {{nNF}} — Número NFe
  • {{chNFe}} — Chave NFe
  • {{dhEmi}} — Data NFe
  • {{InvoiceFinishTimestamp}} — Data finalização
  • {{SupplierNameCorporateName}} — Fornecedor
  • {{SupplierCpfCnpj}} — Fornecedor CNPJ
  • {{SupplierCode}} — Cód. fornecedor
  • {{SkuName}} — Nome SKU
  • {{IDSkuCompany}} — Cód. ref. SKU
  • {{BarCode}} — Cód. barras
  • {{IDBatch}} — Cód. lote
  • {{Quantity}} — Quantidade
  • {{WarehouseName}} — Armazém
  • {{Address}} — Endereço
  • {{BestBeforeDate}} — Data de validade
  • {{ValueCostUnitPurchase}} — R$ custo unitário
  • {{ValueCostTotal}} — R$ custo total

Endereços​

  • {{Address}} — Endereço

Itens (cadastro)​

  • {{SkuName}} — Nome SKU
  • {{IDSkuCompany}} — Cód. ref. SKU
  • {{BarCode}} — Cód. barras
  • {{Category}} — Categoria
  • {{Cor}} — Cor
  • {{Tamanho}} — Tamanho
  • {{PriceList}} — Preço de
  • {{PriceSell}} — Preço por
  • {{ItemCount}} — Quantidade
  • {{ItemTotal}} — Quantidade total
  • {{Logo}} — Logo da empresa

Transportadora (embarque)​

  • {{IDOrder}} — Código do pedido
  • {{ConsumerNameCorporateName}} — Cliente
  • {{SupplierNameCorporateName}} — Transportadora
  • {{CarrierLogoUrl}} — Logo transportadora
  • {{SkuName}} — Nome SKU
  • {{Cor}} — Cor
  • {{PackageWeight}} — Peso pacote (kg)
  • {{ShippingStreet}} — Rua
  • {{ShippingNumber}} — Número
  • {{ShippingComplement}} — Complemento
  • {{ShippingNeighborhood}} — Bairro
  • {{ShippingCity}} — Cidade
  • {{ShippingState}} — Estado
  • {{ShippingPostalCode}} — CEP
  • {{NfeNumber}} — Número NFe
  • {{NfeChaveAcesso}} — Chave de acesso NFe
  • {{NfedhEmi}} — Data NFe
  • {{RecordTimeStamp}} — Data pedido
  • {{ShippingId}} — Código de rastreio
  • {{CompanyCpfCnpj}} — CNPJ faturador
  • {{CompanyStateInscription}} — Inscrição estadual
  • {{ItemCount}} — Index item
  • {{ItemTotal}} — Qtde SKUs

Cesto picking​

  • {{ExternalId}} — Cód. externo

Transportadora (cadastro)​

  • {{CarrierName}} — Razão social transportadora
  • {{CarrierTradeName}} — Nome fantasia transportadora
  • {{IDSupplier}} — Cód. transportadora
  • {{BarCode}} — Cód. barras

Ressuprimento pendente​

  • {{IDOrder}} — Código do pedido
  • {{Order}} — Pedido
  • {{OrderFrom}} — Pedido origem
  • {{ConsumerNameCorporateName}} — Cliente
  • {{CarrierName}} — Transportadora
  • {{BarCode}} — Cód. barras
  • {{Items}} — Itens inconforme
  • {{OrderDate}} — Data pedido
  • {{EstimatedDate}} — Data estimada entrega
  • {{CurrentTimestamp}} — Data/hora atual

Inconformidade picking/packing​

  • {{IDOrder}} — Código do pedido
  • {{Order}} — Pedido
  • {{OrderFrom}} — Pedido origem
  • {{ConsumerNameCorporateName}} — Cliente
  • {{CarrierName}} — Transportadora
  • {{BarCode}} — Cód. barras
  • {{Items}} — Itens inconforme
  • {{OrderDate}} — Data pedido
  • {{EstimatedDate}} — Data estimada entrega
  • {{CurrentTimestamp}} — Data/hora atual

Como cadastrar um modelo de etiqueta?​

Acesse Configurações → Etiquetas e clique em Criar Etiqueta. Na janela:

  1. (Quando a empresa tem mais de uma conta) Conta — escolha a conta da empresa.
  2. Categoria — onde a etiqueta vai ser usada (Embarque, Itens, Endereços, etc.).
  3. Nome etiqueta — nome livre (ex.: "Etiqueta Embarque Correios 10x10").
  4. Altura (cm) — altura, em centímetros (limite 20 cm).
  5. Largura (cm) — largura, em centímetros (limite 20 cm).
  6. Colunas — quantas colunas a etiqueta tem por linha (opcional, default 1).
  7. Espaçamento entre colunas (cm) — espaço horizontal entre as colunas (opcional).
  8. Modo de visualização — Canvas (desenhar no editor visual) ou ZPL (colar o código bruto).
  9. Desenhar etiqueta — área principal. No Canvas, arraste elementos e variáveis. No ZPL, cole o código.

Clique em Salvar. O modelo aparece na lista e fica disponível em todas as telas de impressão.

Pré-requisito: privilégio Criar etiqueta.

Quais campos são obrigatórios ao cadastrar?​

São obrigatórios:

  • Conta — quando a empresa tem mais de uma.
  • Categoria — define onde a etiqueta pode ser usada.
  • Nome etiqueta.
  • Altura (cm) e Largura (cm) — ambas limitadas a 20 cm.

Colunas, Espaçamento entre colunas e o conteúdo da etiqueta (Canvas ou ZPL) ficam preenchidos no editor e podem ser deixados em branco no início (o modelo é salvo vazio e completado depois).

Por que a altura e a largura são limitadas a 20 cm?​

Porque o limite reflete o tamanho máximo de impressora térmica padrão usada em logística e varejo. Etiquetas térmicas de embarque, item ou endereço raramente passam de 10×15 cm — o limite de 20 cm dá folga para casos especiais (etiqueta de cesto, etiqueta com declaração de conteúdo) sem permitir layouts inviáveis para o equipamento. Se você tentar digitar um valor maior, o sistema mostra a mensagem "A altura/largura máxima para a etiqueta é 20cm" e ajusta automaticamente para 20.

Como funcionam Colunas e Espaçamento entre colunas?​

São dois campos opcionais que controlam layout multi-coluna, útil quando você imprime várias etiquetas pequenas no mesmo papel térmico maior (ex.: papel A4 com 2 ou 3 colunas de etiquetas lado a lado):

  • Colunas — quantidade de etiquetas por linha (ex.: 2 significa duas etiquetas lado a lado, repetindo o mesmo conteúdo ou conteúdos sequenciais).
  • Espaçamento entre colunas (cm) — distância horizontal entre cada etiqueta da linha. Também limitado a 20 cm: se você digitar um valor maior, o sistema mostra um aviso e ajusta automaticamente para 20.

Para etiquetas de embarque ou logo único por volume, deixe Colunas = 1 (ou em branco) — o sistema imprime uma etiqueta por área de impressão.

Como visualizar a etiqueta antes de imprimir?​

Na lista, clique no ícone de Visualizar Etiqueta (olho) na linha. O idworks envia o ZPL salvo para o serviço público labelary.com e renderiza o PDF da etiqueta em tamanho real numa janela interna — você vê exatamente como a etiqueta vai sair na impressora térmica antes de gastar papel térmico ou imprimir errado.

O botão fica desabilitado quando o modelo ainda não tem ZPL salvo (modelo criado mas sem desenho).

Como editar um modelo de etiqueta já existente?​

Na lista, clique no ícone de editar (lápis) na linha do modelo — ou dê duplo clique na linha. A janela abre com todos os campos preenchidos e o editor (Canvas ou ZPL) com o desenho atual. Faça os ajustes e clique em Salvar.

Não é possível trocar o modelo de conta pela edição — quando há mais de uma conta, o campo Conta fica bloqueado. Para mover uma etiqueta para outra conta, use a ação de Duplicar com a conta destino.

Pré-requisito: privilégio Editar etiqueta.

Como duplicar uma etiqueta?​

Selecione um ou mais modelos na lista (caixas à esquerda das linhas). Clique em Mais Ações → Duplicar Etiqueta. Na janela, (quando a empresa tem mais de uma conta) escolha a Conta destino e clique em Salvar.

Para cada modelo selecionado, o sistema cria uma cópia com o nome <Nome original>-Cópia, preservando categoria, dimensões, layout (Canvas ou ZPL), logo, colunas e espaçamento. Renomeie a cópia depois (editar → Nome etiqueta) para algo identificável.

Útil para:

  • Criar variações de um mesmo modelo (ex.: "Embarque Correios 10x10" + "Embarque Correios 10x15").
  • Testar mudanças sem alterar o original.
  • Copiar um modelo conhecido como ponto de partida para outra categoria.

Pré-requisito: privilégio Criar etiqueta.

Como duplicar uma etiqueta para outra conta da empresa?​

Quando a empresa tem mais de uma conta cadastrada (multi-empresa), o modal de Duplicar Etiqueta pede a Conta destino. Selecione a outra conta no campo e clique em Salvar — o sistema cria a cópia na conta escolhida, com o nome <Nome original>-Cópia.

Esse fluxo é a forma oficial de mover/copiar etiquetas entre contas da mesma empresa, já que a edição direta não permite trocar a conta de um modelo já cadastrado.

Como definir a etiqueta padrão de uma transportadora?​

Modelos da categoria Transportadora (cadastro) ficam disponíveis no cadastro do fornecedor que opera como transportadora. Acesse Cadastro → Fornecedores, abra a transportadora desejada e vá na aba Geral (ou em Config. Transportadora, dependendo do tipo). Selecione a etiqueta no campo Etiqueta padrão e salve.

A partir desse momento, toda impressão de etiqueta de embarque para essa transportadora usa o modelo selecionado por padrão. A regra também aceita modelos cadastrados na empresa-padrão de etiquetas do idworks — o que permite usar modelos de etiqueta compartilhados sem reconfigurar em cada conta.

Cadastros que você precisa ter antes

  • Modelo de etiqueta com categoria Transportadora (cadastro) — esta tela.

Como imprimir uma etiqueta cadastrada?​

Modelos cadastrados aqui são acionados em várias telas de impressão do idworks:

  • Pedido: tela de detalhe do pedido → botão de impressão → escolhe o modelo.
  • Packing/Fulfillment: durante o packing, o sistema imprime as etiquetas de embarque do volume automaticamente quando a transportadora tem etiqueta padrão configurada.
  • Recebimento: ao receber itens, gera-se etiqueta de item para identificação no estoque.
  • Endereçamento de armazém: ao cadastrar uma posição, é possível imprimir a etiqueta da posição.
  • Cesto de picking: no início da onda, o sistema imprime a etiqueta do cesto que vai separar o pedido.
  • Cadastro de SKU / fornecedor: botões de impressão direto no detalhe.

Em todos os casos, o ZPL final é gerado pelo sistema substituindo as variáveis do modelo pelos dados reais (pedido, item, endereço) e enviado para a impressora térmica configurada no navegador ou no PDV.

Como filtrar a lista de etiquetas?​

Abra o painel de filtros à direita da tela. O filtro disponível é por Categoria — selecione a categoria desejada (Embarque, Itens, Endereços, etc.) e clique em Aplicar.

Para procurar por nome ou outras colunas, use a busca interna da tabela: clique no ícone de lupa no cabeçalho da coluna (Nome etiqueta, Categoria, Altura, Largura, etc.) e digite o termo.

Como excluir um modelo de etiqueta?​

Na lista, clique no ícone de lixeira na linha do modelo e confirme a janela. Atenção: essa exclusão é física — diferente de outros cadastros do idworks, o modelo é apagado definitivamente do banco e não pode ser recuperado pela tela. Antes de excluir, confirme que nenhuma transportadora ou produto está apontando para esse modelo como etiqueta padrão.

Pré-requisito: privilégio Deletar etiqueta.

O que acontece com uma transportadora vinculada a uma etiqueta excluída?​

O vínculo fica quebrado. A transportadora continua cadastrada normalmente, mas o campo Etiqueta padrão dela passa a apontar para um id que não existe mais — o que pode causar erro na impressão da etiqueta de embarque, dependendo de como a tela de origem trata a ausência.

Antes de excluir um modelo:

  1. Filtre a lista de Cadastro → Fornecedores por transportadoras e confira se alguma delas usa o modelo a ser removido.
  2. Se sim, edite cada transportadora e troque o Etiqueta padrão para outro modelo antes de excluir.

Como a exclusão é física, não há "desfazer" — só recriar o modelo do zero.

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar etiquetaAcesso à tela, à lista de modelos e ao botão Visualizar Etiqueta (preview em PDF).
Criar etiquetaCadastrar novos modelos (botão Criar Etiqueta) e duplicar modelos selecionados.
Editar etiquetaAlterar modelos já cadastrados (campos do cabeçalho e conteúdo no editor Canvas/ZPL).
Deletar etiquetaExcluir modelos (exclusão física).
Última atualização em