Skip to main content

​
Gestão de Produtos (OmniDom)

​
📌 Visão Geral

  • Nome da funcionalidade: Cadastro e Gestão de Produtos
  • Objetivo principal: Permitir o cadastro detalhado do catálogo OmniChannel, suportando produtos do tipo Simples, com Variações (grades) ou Kits (agrupamentos/combos).
  • Perfil de usuário: Gerente de Catálogo, Administrador do Sistema e Analista Fiscal.
  • Pré-requisitos de acesso: Permissão ativa para módulo de Produtos.

​
🔢 Passo a Passo

Passo 1: Acesso e Filtros na Listagem
  • O usuário acessa o menu de “Produtos”.
  • Exibição de listagem contendo os SKUs já operacionais com imagem, nome, saldo atual e preço.
  • O usuário pode aplicar filtros reativos (busca por texto/SKU) para reduzir a visualização.
  • Para gerar um novo item, clica em ”+ Novo Produto”.
Passo 2: Wizard / Abas de Informações Básicas
  • Abre-se o formulário principal estruturado em abas.
  • O usuário seleciona o Tipo do produto (Simples, Variação ou Kit).
  • Preenchimento do nome, marca, categoria e a vinculação da imagem principal.
Passo 3: Aba de Variações e Componentes (Se Aplicável)
  • Produto c/ Variação: O usuário cria a grade (ex: Cor x Tamanho). O sistema multiplica as linhas gerando os SKUs-filhos embaixo.
  • Kit: O usuário pesquisa produtos já existentes e vincula como “Componentes” do kit definindo as quantidades.
Passo 4: Dimensões e Logística
  • Preenchimento compulsório de peso, altura, largura e profundidade para alimentar a API de frete dos Correios/Transportadoras.
Passo 5: Fiscal e Custos
  • O usuário insere Custo Manual, Preço de Venda e tributações (NCM e códigos essenciais para a Reforma Tributária).
  • Clica em Salvar/Criar Produto.
  • Resultado: Toast de sucesso liberado, persistindo todas as ramificações de dados em banco.

​
📋 Regras de Negócio

  • RN01: Unicidade do Identificador SKU
    • Descrição: O sistema rejeita SKUs em duplicidade global.
    • Condição: Na submissão de cadastro simples ou durante a derivação das grades.
    • Comportamento: Retorna alert impedindo o salvamento se já houver match.
  • RN02: Cálculo Ativo de Estoque para Kits
    • Descrição: Um Kit não possui estoque livre próprio isolado.
    • Condição: Na visualização de Kits na prateleira.
    • Comportamento: O estoque base de um Kit é balizado unicamente pela disponibilidade máxima da sua peça/componente com menor saldo em estoque.
  • RN03: Separação de Custo Manual vs Efetivo
    • Descrição: Precificação dinâmica.
    • Condição: Na aba “Custos”.
    • Comportamento: O custo efetivo atualiza automaticamente com os valores puxados da NF-e (módulo de importação), enquanto o Custo Manual permanece arbitrário pelo operador.

​
✅ Critérios de Aceitação

  • CA01: Geração Correta de Variações
    • Dado que: o usuário adicione “Cor: Azul, Vermelho” e “Tam: M, G” a um SKU pai (P-01).
    • Quando: ele aplica a grade.
    • Então: 4 SKUs únicos (ex: P-01-AZ-M, P-01-VM-G…) nascem na tabela matriz interior prontos para preços independentes.

​
⚠️ Pontos de Atenção

  • O NCM (Nomenclatura Comum do Mercosul) é extremamente crítico. Sem a sua correta tipificação na Aba Fiscal, ordens de faturamento travarão no checkout.
  • Não ignorar os alertas de preenchimento vermelho em campos com asterisco (*).

​
💡 Dicas para o Usuário

  • Use o tipo Kit estrategicamente para queimar slow-movers (produtos parados), amarrando a produtos de saída rápida sem perder a contabilidade real da prateleira.