beestock:registration:product:product_v2 [SZ Soluções Wiki]

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
====== 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 =====

<div style="font-size: 0.9em; opacity: 0.95;">

^ 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. |

</div>