====== 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'' {{:beestock:registration:product:0550_cadastro_produtos_listagem.png?direct&800|Listagem de Produtos no BeeStock WMS}} 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. {{:beestock:registration:product:0551_cadastro_produtos_aba_geral.png?direct&800|Aba 1: Dados Gerais do Produto}} ^ 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. {{:beestock:registration:product:0552_cadastro_produtos_aba_estoque.png?direct&800|Aba 2: Parâmetros de Estoque e 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. {{:beestock:registration:product:0553_cadastro_produtos_aba_fiscal.png?direct&800|Aba 3: Parâmetros Fiscais}} ^ 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: - Marque o parâmetro **Controlar Vencimento**. - Defina a **Entrada Pré Vencimento** (ex: 180 dias de margem para recebimento). - Defina a **Saída Pré Vencimento** (ex: 90 dias de margem para expedição a clientes). - 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. |