> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domsoftware.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Produtos (Funcional)

> Gestão de Produtos

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