Modelos de etiquetas UCC: criar e pré-visualizar etiquetas de envio UCC

Guarde os layouts SSCC de palete e caixa de cada retailer como modelos ZPL em uma única biblioteca: nomeie pela convenção, edite com pré-visualização ao vivo, teste com dados de amostra e deixe a impressão casar o modelo por retailer e tipo de etiqueta.

Retailers não aceitam etiquetas de envio «mais ou menos»: cada um quer seus layouts SSCC de palete e caixa do seu jeito. O Docklify guarda esses layouts como modelos em WMS → Configurações → Modelos de impressão (/wms/templates). Um modelo é um trecho de ZPL (a linguagem da impressora de etiquetas) com espaços reservados como [[SSCC]] onde entram os valores reais; na impressão, o Docklify preenche os espaços a partir do pedido e escolhe o modelo automaticamente. A mesma biblioteca guarda modelos de Packing List — use as abas no topo para alternar entre etiquetas UCC e Packing List.

A convenção de nomenclatura e correspondência automática (leia primeiro)#

• Formato: retailer-size-kind-Vn — por exemplo walmart-4x6-pallet-V1; packing list, ex.: default-8.5x11-V1. Nomes em minúsculas, dígitos e hífens, globalmente únicos.
• Correspondência na impressão: o Docklify busca modelos UCC ativos por retailer + tipo de etiqueta (Palete / Caixa); havendo vários, vence a versão mais alta. Pedidos sem retailer (B2C) pulam as etiquetas UCC.
• Espaços reservados como [[SSCC]] são substituídos por valores reais na impressão. Editar o ZPL de um modelo e salvar aumenta a versão em 1 automaticamente.
• A Amazon FBA não exige UCC — usa seu próprio sistema de etiquetas — então não crie modelos UCC para ela. A Amazon Vendor/DC exige. Se você escolher no formulário um retailer sem exigência de UCC, a página avisa na hora.

Etapa 1: Criar um modelo#

1. Abra WMS → Modelos de etiquetas UCC e clique em «Novo modelo».
2. Escolha o tipo de modelo: UCC ou Packing List.
3. Escolha o Retailer do modelo, defina o Tamanho (ex.: 4x6) e — para modelos UCC — o Tipo de etiqueta: Palete ou Caixa (obrigatório no UCC).
4. Deixe o nome se montar sozinho: ao escolher retailer, tamanho e tipo, o formulário monta o nome convencional (retailer-size-kind-V1). Você pode sobrescrever antes de salvar, mantendo o formato.
5. Escreva ou cole o código ZPL no editor, usando espaços reservados (veja a lista abaixo) onde um valor muda por etiqueta. Deixe «Ativo» marcado para a impressão poder casar o modelo e clique em Salvar.

Enquanto você digita, a pré-visualização ao vivo abaixo do editor renderiza a etiqueta com valores de amostra — você vê o layout mudar sem imprimir nenhuma etiqueta de teste. Essa página (editor ZPL com prévia ao vivo) é o jeito mais rápido de ajustar um campo em WMS → Modelos de etiquetas UCC.

Espaços reservados que você pode usar no ZPL#

• [[SSCC]] — o código SSCC-18, com dígito verificador GS1 incluído.
• Pedido e destino: [[ORDER_NO]] nº do pedido de saída, [[PO_NO]] nº do PO do retailer, [[RETAILER]] nome do retailer, [[CARRIER]] transportadora, [[SHIP_DATE]] data de envio.
• Endereço de entrega: [[SHIP_TO_NAME]], [[SHIP_TO_ADDRESS]], [[SHIP_TO_CITY]], [[SHIP_TO_STATE]], [[SHIP_TO_ZIP]].
• Conteúdo e sequência: [[ITEM_SKU]], [[ITEM_NAME]], [[QTY]], além de [[CARTON_SEQ]] para o número da caixa e [[PALLET_SEQ]] para o do palete.

Etapa 2: Pré-visualizar com dados de amostra antes de imprimir#

1. Na lista, abra o modelo (cada um tem sua própria página) e vá até a seção «Pré-visualização com dados de amostra».
2. O painel lista um campo por espaço reservado do ZPL, pré-preenchido com valores de amostra sensatos (incluindo um SSCC de amostra válido). Ajuste o valor que quiser testar.
3. Clique em «Renderizar pré-visualização». Você recebe a imagem da etiqueta no tamanho do modelo, a lista de espaços que ficaram sem substituição e — em «ZPL substituído» — o ZPL exato após a substituição, para conferir o que a impressora receberia.

Se a lista de não substituídos não estiver vazia, um espaço do seu ZPL não tem valor para preenchê-lo — corrija o nome (a correspondência é exata, com colchetes duplos) ou garanta que o fluxo de impressão fornece esse campo, antes de ativar o modelo para pedidos reais.

Etapa 3: Manter a biblioteca — clonar, desativar, reativar#

• Clonar (na página do modelo): abre a página de novo modelo com tudo copiado (o nome ganha o sufixo «-copy» e a versão recomeça em 1). Clone quando um retailer pedir uma variante — não mexa no original em uso.
• Modelos integrados são somente leitura: dá para pré-visualizar e clonar, mas não editar nem desativar. Para personalizar, clone e edite a cópia.
• Desativar (na página do modelo) impede que ele seja usado na impressão sem excluí-lo; Ativar o traz de volta. Marque «Mostrar inativos» e use os filtros de retailer / tipo e a busca por nome para manter uma biblioteca crescente sob controle.
• A lista mostra nome, retailer, tipo, tamanho, versão, status e última atualização de cada modelo; ao organizar, fique de olho na versão: dentro de um grupo retailer + tipo, na impressão só vale a maior versão ativa.
• Histórico de versões: cada salvamento registra um snapshot na página do modelo; abra «Histórico de versões» para ver qualquer versão passada como ela era, ou clone-a como novo modelo para reverter uma alteração.

Veja qual modelo cada varejista realmente usará#

Você não precisa adivinhar na biblioteca qual modelo um varejista acaba usando. Abra WMS → Varejistas: a lista mostra duas colunas de status (Modelos UCC / Modelo de packing list) marcando Dedicado, Padrão (standard), Nenhum ou Não exigido. Na página de edição do varejista, a seção «Modelos vinculados» mostra os três espaços — UCC Palete, UCC Caixa e Packing List — renderizados com os mesmos dados de amostra, para você ver a etiqueta real que seria impressa. O Docklify também exibe os modelos vinculados ali mesmo, enquanto você mantém o cadastro do varejista.

• Um espaço marcado «Padrão (modelo standard)» significa que o varejista não tem modelo dedicado e a impressão usa o modelo padrão compartilhado; no mesmo card você pode criar um dedicado ou clonar o padrão como dedicado.
• Se um espaço disser «Nenhum modelo disponível», o que acontece depende do espaço: a Packing List não pode ser impressa até que um modelo exista, enquanto as etiquetas UCC usam o layout interno do sistema — nos dois casos, o card leva direto à criação. Varejistas sem exigência de UCC (como a Amazon FBA) mostram «Sem exigência de UCC» em vez de pré-visualização.
• As páginas do varejista apenas exibem e linkam — alterar o conteúdo de um modelo ou a qual varejista ele pertence é sempre na página do próprio modelo, um único lugar para mudanças.

Recursos do Docklify usados neste artigo#

• WMS → Modelos de etiquetas UCC (/wms/templates): biblioteca com abas UCC / Packing List, filtros de retailer e tipo, busca por nome e mostrar inativos
• Editor ZPL com pré-visualização ao vivo: edite o código e veja a etiqueta renderizar com valores de amostra ao digitar
• Pré-visualização com dados de amostra: renderizar, listar espaços não substituídos e inspecionar o ZPL substituído antes de imprimir
• Correspondência automática na impressão: modelos UCC ativos por retailer + tipo, vence a maior versão
• Clonar / desativar / reativar: variantes e ciclo de vida sem excluir modelos
• Modelos vinculados do varejista: colunas de status na lista de Varejistas e cards de pré-visualização na página de edição, com links para a página do modelo
• Histórico de versões: um snapshot de cada salvamento, visível e clonável na página do modelo