Personalização produtos na Colmeia

• A Personalização de Produtos na Colmeia está disponível apenas para o fluxo de colmeia. Pedidos personalizados só podem ser atendidos por ondas configuradas com esse fluxo — os demais fluxos de expedição não tratam a personalização.

Com o Gestão de Armazenagem | WMS Senior.

Acesse Cadastro > Depositante > guia Integração

• Habilitar Cadastro de Personalização de Produtos na Importação: quando habilitado, a integração cria automaticamente uma nova configuração de personalização ao receber uma chave que ainda não existe para o produto/depositante, usando o valor da chave recebida como descrição.

Acesse Cadastro > Depositante > guia Regras de Expedição

• Habilitar Personalização de Produtos na Colmeia: quando habilitado, o botão Informação de Personalização passa a ficar disponível na tela de Produto vinculado ao depositante, e a formação de onda passa a considerar os pedidos personalizados desse depositante no direcionamento para colmeia.

Acesse Cadastro > Armazém > Armazém > botão Colmeia > botão Cadastrar > guia Outras > agrupamento Personalização de Produtos

• Permitir Fluxo de Personalização de Produtos: quando habilitado, a colmeia passa a receber pedidos de personalização durante a formação de onda, e o campo de modelo de etiqueta de personalização passa a ser exigido.
• Modelo de Etiqueta para Personalização de Produtos: define qual etiqueta será impressa durante a execução do fluxo nesta colmeia.

Acesse Cadastro > Produto > Produto > botão Depositante > botão Informação de Personalização

O botão Informação de Personalização fica disponível quando o depositante do produto está habilitado para o fluxo (ver Depositante — Regras de Expedição).

• O sistema permite cadastrar, alterar e excluir personalizações.
• Cada personalização deve possuir uma descrição de até 20 caracteres. A descrição deve ser única para cada produto e depositante. Caso seja informada uma descrição já cadastrada para o mesmo produto e depositante, o sistema não permitirá o cadastro ou alteração.
• Para excluir uma personalização, é necessário confirmar a operação.
• Todas as operações de inclusão, alteração e exclusão são registradas na tela de Log de Segurança, contendo as informações de usuário, depositante, produto e descrição. Nas alterações, também são registradas a descrição anterior e a nova descrição.

Acesse Gestão de Etiqueta > Gerenciador de Etiquetas

• A etiqueta usada no fluxo é do tipo Etiqueta de Personalização de Produto, com dimensão padrão de 70mm x 100mm, imprimindo Onda, Nota Fiscal, Escaninho, Colmeia, Produto, Nome e Número da Personalização. O modelo pode ser customizado.
  

O processo de personalização inicia pela integração de pedido. Na integração dos itens do pedido é necessário informar quais itens serão personalizados e, a partir dessa informação, o sistema passa a esperar a integração da personalização desses itens.

Ou seja, são duas etapas encadeadas dentro do mesmo processo de integração:

1. Integração do pedido — traz os itens e marca quais deles são personalizados.
2. Integração da personalização — envia as informações de cada item marcado (nomes, números para gravação, bordado, estampa).

Enquanto a personalização dos itens marcados não é recebida, o pedido fica pendente e a liberação da nota fica bloqueada. Item que não é marcado como personalizado segue a expedição padrão, sem existir o fluxo de retirada para personalização na colmeia.

Layout Itens do Pedido / Nota Fiscal

O layout do cabeçalho da Integração de Pedido permanece inalterado. As alterações foram realizadas exclusivamente na estrutura dos itens, com a inclusão do campo ItemPersonalizado, conforme apresentado a seguir:

• Integração do Pedido / Nota Fiscal

Regra do campo ItemPersonalizado

Campo ItemPersonalizado: indica se o item possui personalização.

Valores permitidos:

• S: item personalizado.
• N: item não personalizado.

Regras:

• Quando o campo não for informado, o sistema assume automaticamente o valor N.
• Caso seja informado um valor diferente de S ou N, a importação do item será rejeitada.

Ao receber as informações de personalização, o sistema realiza algumas verificações para garantir que os dados estejam corretos:

• Confirma se existem informações de personalização para a unidade informada.
• Verifica se a chave de personalização já está cadastrada ou se pode ser criada automaticamente, conforme a configuração do depositante.
• Valida se a quantidade informada não ultrapassa a quantidade total de itens personalizados da nota fiscal.

Importante

• A quantidade informada pode ser enviada em etapas.
• O sistema considera tanto as quantidades já processadas anteriormente quanto a quantidade enviada na importação atual.
• É possível realizar vários envios parciais até atingir a quantidade total de itens personalizados da nota fiscal.
• Não é necessário enviar todas as personalizações em uma única integração.

Layout Personalização

{
    "chavelayout": "int_pedidodet_personalizacao",
    "list": [
        {
            "codigointerno": "",
            "numpedido": "",
            "cnpj_depositante": "",
            "serie": "",
            "idseq": 0,
            "barra": "",
            "qtde": 0,
            "cnpj_emitente": "",
            "dadospersonalizacao": [
                {
                    "chavelayout": "int_infopersonalizacaodet",
                    "chave": "",
                    "valor": ""
                },
                {
                    "chavelayout": "int_infopersonalizacaodet",
                    "chave": "",
                    "valor": ""
                }
            ]
        }
    ]
}
								

Cabeçalho Personalização

Campo	Tipo	Tamanho	Obrigatório	Descrição
chavelayout	Texto	—	Sim	Identificador do layout de integração. Valor fixo: int_pedidodet_personalizacao.
codigointerno	Texto	60	Sim	Número da nota fiscal.
numpedido	Texto	60	Sim	Número do pedido ao qual o item pertence.
cnpj_depositante	Texto	20	Sim	CNPJ do depositante dono do pedido.
serie	Texto	20	Sim	Série da nota fiscal.
idseq	Numérico	12	Sim	Sequência do item (ordem de impressão dos itens).
barra	Texto	32	Sim	Código de barras do produto a personalizar.
qtde	Numérico	12	Sim	Quantidade de unidades a serem personalizadas neste item. A validação é cumulativa: a soma dos envios não pode exceder o total de itens personalizados da nota.
cnpj_emitente	Texto	20	Sim	CNPJ do emitente da nota fiscal, usado para localizar a NF quando o emitente é diferente do depositante.
dadospersonalizacao	Lista	—	Sim	Lista de pares chave/valor com as informações de personalização da unidade.

Itens Personalização

Campo	Tipo	Tamanho	Obrigatório	Descrição
chavelayout	Texto	—	Sim	Identificador do layout de detalhe. Valor fixo: int_infopersonalizacaodet.
chave	Texto	20	Sim	Chave da informação de personalização (deve corresponder a uma descrição cadastrada em Produto × Depositante, ou ser criada automaticamente quando o parâmetro de cadastro na importação estiver habilitado).
valor	Texto	400	Sim	Conteúdo a ser gravado na unidade para aquela chave (ex.: nome, número, texto do bordado/estampa).

Acesse Movimentação > Saída > Liberar Nota Fiscal para Expedição

Uma nota com item personalizado só é liberada para expedição depois que a personalização de todas as unidades marcadas for recebida. Enquanto houver pendência, a nota não avança.

Na liberação, o sistema compara, para cada nota/pedido, a quantidade de itens marcados como personalizados (itens com "Item Personalizado" = S) com a quantidade de unidades já recebidas pela integração de personalização:

• Personalização completa: todas as unidades marcadas foram recebidas — a nota segue normalmente para expedição.
• Personalização pendente: ainda faltam unidades a receber — a nota é bloqueada e apresenta a mensagem "A NF {número} possui item personalizado aguardando o recebimento dos dados de personalização".

Ou seja, o operador pode liberar pedidos/notas em massa a qualquer momento — as notas com personalização pendente ficam retidas até completar o recebimento, sem travar o restante da operação.

Acesse Movimentação > Saída > Gerenciador de Expedição > botão Formar

Ao formar a onda, o sistema avalia o conjunto de notas fiscais que compõem a onda. A presença de pelo menos uma nota fiscal com item personalizado faz com que a onda seja tratada como uma onda de personalização, demandando exclusivamente a utilização de colmeias habilitadas para esse fluxo.

• Se a configuração de onda usada não for de fluxo de colmeia, a formação é interrompida antes de concluir.
• Se for de fluxo de colmeia mas não houver colmeia compatível disponível, a formação também é interrompida, com uma mensagem que orienta o operador a verificar a configuração de personalização.
• Pedido sem item personalizado, de depositante habilitado, segue o fluxo padrão, sem exigir colmeia de personalização.

Priorização de colmeias: para pedidos que não exigem personalização, o sistema prioriza colmeias comuns e, em seguida, as que possuem mais escaninhos livres — preservando os escaninhos das colmeias de personalização para os pedidos que realmente precisam delas.

Acesse Movimentação > Saída > Conferência Colmeia

A personalização ocorre na tela Conferência de Colmeia. Cada unidade a personalizar tem um status próprio, e o escaninho reflete o estado das unidades que contém.

Cada impressão da etiqueta ocorre a partir dos botões Retirar ou Reimprimir Etiqueta da tela Personalização de Produtos (acessível no botão Conteúdo do escaninho).

Status do escaninho:

Status da unidade: Aguardando → Iniciado → Finalizado no fluxo normal, ou Iniciado → Divergência quando há problema.

Ações disponíveis, conforme o status da unidade:

Propagação de divergência: ao registrar divergência, apenas o escaninho onde a ação foi executada é afetado — não há propagação para outros escaninhos do mesmo pedido.

Visualização na Montagem da Colmeia: durante a montagem da colmeia, os escaninhos também exibem a identificação visual do status da personalização, permitindo que o operador localize rapidamente itens que dependem desse processo. Dessa forma, o acompanhamento do fluxo pode ser realizado tanto na tela de conferência quanto na montagem de volumes na colmeia.

1. O fluxo completo — direcionamento, execução e etiqueta — só ocorre quando depositante, colmeia e produto estão configurados simultaneamente para personalização. Na ausência de qualquer uma dessas condições, o pedido segue o fluxo padrão de expedição.
2. Pedidos com item personalizado só podem ser atendidos por onda de fluxo de colmeia. Não é permitido formar onda em outro fluxo para esses pedidos.
3. No direcionamento de colmeia, pedidos sem personalização são priorizados para colmeias comuns, preservando os escaninhos das colmeias de personalização.
4. A liberação de nota fiscal é bloqueada enquanto houver item personalizado sem todas as unidades recebidas/processadas — a NF é retirada do lote de liberação, sem impedir a liberação das demais notas.
5. Divergência registrada em um escaninho não se propaga para outros escaninhos do mesmo pedido — cada escaninho é avaliado isoladamente.
6. A criação automática de personalização via integração não é parcial: com o cadastro automático desabilitado, uma única chave desconhecida rejeita a integração inteira.
7. A validação de quantidade da integração é cumulativa, permitindo múltiplos envios parciais até completar a quantidade total esperada para a nota.
8. Cada colmeia tem configuração independente das demais — um mesmo armazém pode ter colmeias com e sem o fluxo habilitado ao mesmo tempo.