Cadastro de Produtos — Versão Aprimorada (V2)

O módulo de Cadastro de Produtos é o coração da governança de dados mestres do WMS BeeStock. Ele centraliza as definições físicas, logísticas, de rastreabilidade e fiscais de cada item movimentado no armazém, garantindo que algoritmos avançados de cubagem, separação inteligente (FEFO/FIFO), fracionamento de corte e conferência cega operem com máxima assertividade e segurança.

Este manual consolida a documentação técnica operacional da tela de Cadastro e Edição de Produtos, espelhando os parâmetros em tela e detalhando cada regra de negócio.

—

1. Acesso e Listagem de Produtos

Para acessar o módulo de produtos, navegue pelo menu lateral: * Menu: Cadastros > Produtos > Produtos * Rota do Sistema: /registration/product/product/list

Na tela de listagem, o operador e o gestor têm visão consolidada de todo o catálogo cadastrado no sistema, com suporte a filtros dinâmicos por coluna, paginação rápida e menu contextual de ações por linha.

Coluna	Descrição Funcional	Impacto Operacional
Código	Código identificador exclusivo do produto no armazém.	Chave primária natural de integração com o ERP. Identifica o produto em todas as etiquetas e coletores.
Descrição	Nome comercial ou descrição resumida do material.	Exibida em telas de separação, conferência e nos dashboards de estoque.
Unidade de Medida	Unidade padrão de estoque (ex: CX, UN, KG, M).	Base de cálculo de saldos. Quando configurada em metros, habilita corte fracionado.
Família Material	Agrupamento de características físicas e operacionais.	Define se o produto participa de regras de corte, manuseio especial ou armazenagem segregada.
Grupo de Estoque	Categoria contábil e gerencial do material.	Facilita filtros de inventário, relatórios de divergência e políticas de estocagem.
Situação	Estado cadastral do item (Ativo ou Obsoleto).	Produtos obsoletos são bloqueados para inclusão em novas ordens de recebimento ou venda.
Ações	Menu de operações rápidas: Detalhar, Editar, Copiar e Eliminar.	Permite consultar a ficha completa, atualizar parâmetros ou duplicar cadastros como modelo.

—

2. Formulário de Cadastro e Edição de Produtos

Ao clicar em + Incluir Produto ou em Ações > Editar, o sistema exibe o formulário estruturado em abas temáticas:

Aba 1: Geral — Identificação cadastral e dados básicos;
Aba 2: Estoque — Regras de volumetria, pesagem, validade e shelf life;
Aba 3: Fiscal — Modalidades de controle, rastreabilidade e parâmetros tributários;
Aba 4: Imagens — Galeria de fotos do produto (quando o servidor Image Hub estiver ativo).

—

Aba 1: Dados Gerais do Produto

Esta aba estabelece a identidade principal do material no ecossistema logístico.

Campo em Tela	Tipo de Dado	Comportamento e Regras de Negócio
Código	Texto (Obrigatório)	Código único do material no sistema (até 20 caracteres). Bloqueado para alteração após a criação inicial para assegurar integridade histórica.
Descrição	Texto (Obrigatório)	Descrição resumida do produto (até 100 caracteres). É o texto impresso nas etiquetas de gôndola, romaneios e telas dos coletores de dados.
Descrição Completa	Texto Longo (Obrigatório)	Detalhamento técnico aprofundado do material (até 2000 caracteres), contendo especificações técnicas, composição química, modelo ou aplicação.
Código Complementar	Texto (Opcional)	Código de referência auxiliar (ex: código do fabricante, part number ou referência de catálogo do cliente).
Informação Complementar	Texto (Opcional)	Informação complementar descritiva do item (ex: voltagem, cor, versão de hardware).
Situação	Seleção (Menu Suspenso)	Define a vigência operacional do item: Ativo (liberado para movimentação) ou Obsoleto (descontinuado no WMS).
Observação	Texto Longo (Opcional)	Campo livre para orientações operacionais internas (ex: “Manusear com luvas térmicas”, “Item frágil”).

—

Aba 2: Parâmetros de Estoque, Cubagem e Validade

Esta aba define o comportamento logístico físico do produto, cálculo de capacidade de armazenagem e a gestão crítica de Shelf Life / Vencimento.

Campo / Parâmetro	Tipo	Descrição Detalhada e Regras de Operação
Unidade de Medida	Seleção (Menu Suspenso)	Unidade de medida oficial de estoque (ex: UN, CX, KG, M). Quando a unidade for linear (M, MT, METRO) e a família pertencer a cabos, o WMS ativa as rotinas de corte fracionado de bobinas.
Família Material	Seleção (Menu Suspenso)	Agrupador que classifica as propriedades físicas do material. Define o perfil de corte e restrições de armazenagem.
Grupo de Estoque	Seleção (Menu Suspenso)	Classificação contábil do item utilizada para segregação de saldo e filtros de inventário geral e rotativo.
Volume (cm³)	Numérico (3 decimais)	Cubagem unitária do produto em centímetros cúbicos. Utilizado diretamente pelo motor de cálculo de ocupação de caixas na expedição e capacidade volumétrica de endereços.
Altura (cm)	Numérico (3 decimais)	Altura física unitária da embalagem primária do produto em centímetros.
Largura (cm)	Numérico (3 decimais)	Largura física unitária da embalagem primária do produto em centímetros.
Comprimento (cm)	Numérico (3 decimais)	Profundidade/comprimento unitário da embalagem primária em centímetros.
Peso Bruto (g)	Numérico Inteiro	Peso total do item em gramas, incluindo a embalagem primária. Essencial para conferência por balança e pesagem de pallets.
Peso Líquido (g)	Numérico Inteiro	Peso do material em gramas sem a embalagem.
Controle de Data de Validade	Caixa de Seleção com Dica	Determina se o produto exige controle e rastreabilidade obrigatória de prazo de expiração/validade em todas as movimentações. ✓ Marcado: Exige data de validade no recebimento e aplica a regra FEFO (Primeiro a Vencer, Primeiro a Sair) na separação de pedidos. ✗ Desmarcado: O produto não possui validação de data de validade, seguindo o fluxo padrão de estocagem. ℹ️ Informação: Quando ativo, os campos de Entrada Pré-Vencimento, Saída Pré-Vencimento e Dias de Vida passam a ser validados criticamente pelo sistema.
Margem de Entrada Pré-Vencimento	Numérico Inteiro (Dias)	Quantidade mínima de dias de validade que a mercadoria ainda deve possuir para ser aceita no recebimento físico. ℹ️ Informação: Lotes com validade inferior à margem cadastrada geram alerta de recusa no coletor ou direcionamento para quarentena de qualidade.
Margem de Saída Pré-Vencimento	Numérico Inteiro (Dias)	Quantidade mínima de dias de validade restante exigida para que o lote possa ser alocado e expedido a clientes (Shelf Life comercial). ℹ️ Informação: Impede o envio de mercadorias com prazo de validade residual curto, garantindo contratos comerciais e qualidade.
Tolerância de Dias Vencidos	Numérico Inteiro (Dias)	Dias de carência após a data de expiração em que o sistema ainda permite movimentação interna para descarte ou devolução. ℹ️ Informação: Após este limite, o saldo fica bloqueado para qualquer operação operacional comum.
Prazo Total de Vida Útil	Numérico Inteiro (Dias)	Quantidade total de dias de vida útil do produto, calculada entre a data de fabricação e a data de validade. ℹ️ Informação: Utilizado nos cálculos de percentual de vida útil remanescente exigidos em contratos com grandes redes varejistas.
Sobra Mínima Aceita	Numérico (4 decimais)	Metragem ou quantidade mínima permitida que pode sobrar em um saldo ou bobina após corte ou fracionamento. ℹ️ Informação: Evita a geração de retalhos inúteis no armazém que não atendem pedidos mínimos.
Tolerância de Retalho / Perda de Corte	Numérico (4 decimais)	Percentual ou valor de tolerância aceito como perda técnica na ponta durante o processo de corte fracionado. ℹ️ Informação: Aplica-se a materiais controlados por plano de corte e medidas lineares (cabos, fios, tecidos).
Agrupamento de Produtos	Seleção (Menu Suspenso)	Vincula o item a um agrupamento predefinido para regras combinadas de alocação ou separação em lote.

—

Aba 3: Parâmetros Fiscais e de Classificação

Esta aba define a modalidade contábil, rastreabilidade fiscal e estrutura mercadológica do produto.

Campo / Parâmetro	Tipo	Descrição Detalhada e Regras de Operação
Classificação de Controle do Produto	Botão de Opção (Rádio)	Define a natureza operacional do material no WMS: • Físico: Controle estritamente físico de movimentação de estoque. • Total: Controle simultâneo físico e contábil integrado. • Consignado: Mercadoria de terceiros armazenada sob custódia, com segregação de saldo contábil. • Débito Direto: Itens de consumo imediato que não geram saldo estocado permanente. • Específico: Tratamento customizado conforme regra da filial.
Rastreabilidade de Estoque	Botão de Opção (Rádio)	Determina como o produto é identificado no armazém: • Serial: Rastreabilidade individual com etiqueta serial única. • Número de Série: Controle unitário rastreado por número de série do fabricante. • Lote: Controle agrupado por número de lote de fabricação e prazo de validade. • Referência: Controle genérico sem exigência de lote individual.
Origem da Mercadoria	Botão de Opção (Rádio)	Classificação fiscal e de procedência do produto: • Mercado Interno: Produto de fabricação ou aquisição nacional. • Mercado Externo: Produto importado sujeito a controles alfandegários ou notas fiscais de importação.
Classificação Fiscal	Texto (8 dígitos)	Código NCM (Nomenclatura Comum do Mercosul). Essencial para a validação fiscal das notas de entrada, faturamento de saída e integração ERP.
Unidade de Negócio	Texto (Opcional)	Centro de custo ou unidade corporativa responsável pelo produto na governança da empresa.
Fator de Conversão de Unidade	Numérico (4 decimais)	Multiplicador para conversão automática entre a unidade comercial de compra/venda e a unidade de estoque do armazém. ℹ️ Informação: Exemplo: se a compra é faturada em Caixa com 12 unidades, o fator 12 garante a entrada correta de 12 unidades avulsas no estoque.
Lote Múltiplo de Venda	Numérico (4 decimais)	Quantidade mínima fracionária permitida para comercialização e expedição (ex: múltiplos fechados de 6 ou 12 peças). ℹ️ Informação: O WMS e o ERP impedem alocações com quantidades quebradas que violem a embalagem de venda.
Nível 1 ao Nível 5	Texto (Opcional)	Hierarquia mercadológica de classificação comercial (ex: Nível 1 = Departamento, Nível 2 = Categoria, Nível 3 = Subcategoria, Nível 4 = Segmento, Nível 5 = Família Comercial).

—

3. Guia Passo a Passo: Cadastrando um Novo Produto

1. Acessar a Tela de Produtos:

 Navegue até **Cadastros > Produtos > Produtos** e clique no botão verde **+ Incluir Produto** no topo direito.

2. Preencher os Dados Gerais (Aba 1):

Informe o Código (código oficial do ERP ou SKU interno).
Preencha a Descrição clara e a Descrição Completa.
Defina a Situação como Ativo.

3. Configurar as Propriedades de Estoque (Aba 2):

Selecione a Unidade de Medida (ex: UN, CX, KG, M).
Defina a Família Material e o Grupo de Estoque.
Informe com precisão as dimensões de Altura, Largura, Comprimento e Volume para permitir a cubagem automática do WMS.
Cadastre o Peso Bruto e Peso Líquido em gramas.
Caso o produto seja perecível ou possua prazo de validade:
1. Marque o parâmetro Controlar Vencimento.
2. Defina a Entrada Pré Vencimento (ex: 180 dias de margem para recebimento).
3. Defina a Saída Pré Vencimento (ex: 90 dias de margem para expedição a clientes).
4. Informe os Dias de Vida totais do produto.

4. Configurar as Regras Fiscais (Aba 3):

Selecione a Classificação de Controle do Produto (ex: Físico ou Total).
Marque a Rastreabilidade de Estoque (ex: Lote ou Referência).
Selecione a Origem (Mercado Interno ou Externo).
Digite a Classificação Fiscal (NCM) com 8 dígitos.
Defina o Fator de Conversão e o Lote Múltiplo de Venda caso a comercialização ocorra em embalagens agrupadas.

5. Salvar o Cadastro:

Clique em Criar no rodapé. O sistema registrará o produto imediatamente no banco e habilitará sua utilização em todas as operações de armazém.

—

4. Boas Práticas de Governança Cadastral

* Fidelidade de Medidas e Pesos: As dimensões físicas de altura, largura e comprimento impactam diretamente o cálculo da cubagem de caixas de expedição e a capacidade de ocupação dos endereços de porta-palete. Mantenha os dados aferidos fisicamente com precisão. * Margens de Vencimento Rigorosas: Configure as margens de Entrada e Saída Pré-Vencimento alinhadas aos acordos de nível de serviço (SLA) comerciais dos clientes. Isso previne devoluções por mercadoria próxima do vencimento. * Evite Duplicidade de Códigos: Nunca crie códigos paralelos para itens que já existem no ERP. O código do produto é a chave mestra de conciliação do estoque. * Inativação Segura: Se um material for descontinuado, mude a Situação para Obsoleto em vez de tentar eliminá-lo. Isso preserva todo o histórico de movimentações, auditorias e inventários passados.

—

5. Perguntas Frequentes (FAQ) & Dúvidas Respondidas

Pergunta / Dúvida Operacional	Resposta Objetiva no Manual
Por que o coletor de dados bloqueia o recebimento de um lote com a mensagem de vencimento próximo?	Porque a validade restante do lote físico é menor do que a quantidade de dias configurada no campo Entrada Pré Vencimento da Aba Estoque.
Como fazer com que o sistema obrigue o operador a digitar o lote e a validade durante a conferência?	Na Aba Fiscal, marque a opção de Rastreabilidade de Estoque como Lote, e na Aba Estoque mantenha a opção Controlar Vencimento marcada.
O que acontece se as dimensões de Altura, Largura e Comprimento forem deixadas zeradas?	O volume unitário ficará zerado, impossibilitando que o WMS calcule a cubagem automática para escolha de caixas na expedição e impedindo a verificação de capacidade volumétrica dos endereços.
Como cadastrar produtos vendidos em caixas fechadas de 12 unidades mas estocados em unidades avulsas?	Configure a Unidade de Medida como UN, preencha o Fator de Conversão como 12 e o Lote Múltiplo de Venda como 12. Assim o sistema respeita a embalagem comercial.
É possível alterar o código de um produto após ele ter sido criado?	Não. O campo Código é bloqueado após a criação para garantir a integridade referencial com os históricos de estoque, inventários e integrações fiscais do ERP.