~~NOTOC~~
====== Grade de Produtos (Variações) ======

===== O que é a Grade de Produtos =====

Muitas lojas vendem o "mesmo" produto em várias opções: uma camiseta que existe em vários tamanhos e cores, um calçado que existe em vários números, um produto que existe em voltagens diferentes.

Antes deste recurso, cada uma dessas opções precisava ser cadastrada como um produto separado, do zero, sem nenhuma ligação entre elas. A Grade de Produtos resolve isso: você cadastra a camiseta **uma única vez**, diz quais são as opções dela (por exemplo, "varia por Cor e por Tamanho"), escolhe os valores de cada opção, e o sistema gera automaticamente **todas as combinações** como produtos prontos para vender — cada um com seu próprio código de barras, preço e estoque.

**Exemplo:** uma camiseta com as cores Azul e Vermelho, nos tamanhos P, M e G, gera automaticamente 6 produtos:

^ Cor       ^ Tamanho ^
| Azul      | P |
| Azul      | M |
| Azul      | G |
| Vermelho  | P |
| Vermelho  | M |
| Vermelho  | G |

Cada uma dessas 6 combinações é um produto de verdade — aparece na lista de produtos, pode ser vendida, comprada e tem seu próprio estoque —, mas todas continuam "amarradas" ao produto principal (a Camiseta), o que permite ver e gerenciar todas juntas em um único lugar.

===== Quando usar =====

Use a Grade de Produtos sempre que um produto existir em mais de uma variação e você quiser controlar o estoque separadamente para cada uma. Exemplos comuns:

  * Roupas (cor e tamanho)
  * Calçados (número e cor)
  * Produtos com voltagem (110V / 220V)
  * Qualquer item que "varia" por até duas características

> Cada produto pode variar por, no máximo, **duas características** (por exemplo, Cor e Tamanho). Não é possível combinar três ou mais.

===== Passo a passo: montando a grade de um produto =====

==== 1. Cadastre as características (Atributos) ====

Antes de criar a grade de um produto, é preciso ter cadastradas as características que ele vai usar — no sistema, cada característica é chamada de **Atributo** (por exemplo, "Cor" ou "Tamanho"), e cada opção dela é um **valor** (por exemplo, "Azul", "Vermelho").

  - Abra a tela **Tipos de Atributos**, pelo menu **Estoque → Cadastros → Atributos de Grade**.
  - Clique em **Adicionar** para criar um novo atributo, por exemplo "Cor".
  - Dentro do atributo, cadastre os valores que ele pode ter, um de cada vez (ex: "Azul", "Vermelho", "Verde"). É possível definir a ordem em que eles vão aparecer.
  - Repita para os outros atributos que sua loja usa, como "Tamanho" (P, M, G, GG).

> Você só precisa cadastrar cada atributo uma vez. Depois, ele fica disponível para ser usado na grade de qualquer produto.

> :!: Um valor de atributo que já está sendo usado em alguma grade (por exemplo, "Azul" já usado numa camiseta) não pode ser renomeado nem removido. O sistema avisa e lista os produtos que estão usando aquele valor.

==== 2. (Opcional) Crie um Modelo de Grade ====

Se várias famílias de produtos usam sempre a mesma combinação de atributos (por exemplo, toda a linha de roupas varia por Cor e Tamanho), você pode salvar essa combinação como um **Modelo de Grade**, para não precisar escolher os dois atributos toda vez que cadastrar um produto novo.

  - Abra a tela **Modelos de Grade**, pelo menu **Estoque → Cadastros → Modelos de Grade**.
  - Dê um nome ao modelo, por exemplo "Vestuário".
  - Escolha o **Atributo 1** (ex: Cor) e o **Atributo 2** (ex: Tamanho).
  - Salve.

Esse passo é opcional — também é possível escolher os atributos diretamente no cadastro do produto, sem usar um modelo.

==== 3. Ative a grade no cadastro do produto ====

  - Abra o cadastro do produto (o produto "guarda-chuva", ex: "Camiseta").
  - Vá até a aba **Grade/Variações**.
  - Marque a opção **Produto com Grade/Variações**.
  - Se você criou um Modelo de Grade, selecione-o e clique em **Aplicar Grade** para preencher os atributos automaticamente. Caso contrário, escolha o Atributo 1 e o Atributo 2 diretamente.

> A aba **Grade/Variações** só aparece para produtos comuns — ela é ocultada para serviços e assinaturas, que não fazem sentido ter variações físicas de estoque.

==== 4. Gere as variações e complete as informações ====

Depois de escolher os atributos, o sistema monta uma grade (uma tabela) com uma linha para cada combinação possível. Nessa grade, complete para cada variação:

  * **Cod. Barras** — se deixado em branco, o sistema gera um código automaticamente.
  * **Preco Varejo** — o preço de venda daquela variação específica.

Se depois você adicionar um novo valor (por exemplo, incluir o tamanho "GG"), use o botão **Atualizar Grade** para o sistema recalcular a grade e acrescentar só as novas combinações, sem mexer nas que já existiam.

==== 5. Salve o produto ====

Ao salvar, o sistema cria automaticamente um produto para cada linha da grade (cada combinação de cor/tamanho vira um produto pronto para vender), já vinculado ao produto principal.

> Você pode reabrir o produto a qualquer momento e voltar na aba **Grade/Variações** para ver, alterar preços/códigos de barras, ou incluir novas combinações.

===== O que muda no dia a dia =====

==== Encontrando as variações na lista de produtos ====

Depois de criada, cada variação aparece normalmente na lista de produtos, junto com o produto principal. Se você tentar excluir uma variação diretamente pela lista, o sistema não deixa e explica que a remoção de uma variação deve ser feita pela aba **Grade/Variações** do produto principal — assim o sistema garante que o histórico de vendas e notas fiscais daquela variação não se perca (a variação removida não desaparece: ela só fica inativa e some da lista de opções disponíveis para venda).

==== Vendendo um produto com grade ====

Quando um vendedor adiciona a um pedido ou venda um produto que tem grade (ex: escaneia o código de barras da "Camiseta" genérica, ou busca por ela na tela de venda), o sistema abre automaticamente a tela **Selecionar Variações**, mostrando as opções disponíveis (com preço e estoque de cada uma) para o vendedor escolher exatamente qual cor/tamanho está sendo vendido.

> Se só existir uma variação com estoque disponível, o sistema pode selecioná-la automaticamente, sem precisar perguntar — isso depende de uma configuração do sistema.

==== Distribuindo o estoque manualmente ====

Também é possível mover manualmente uma quantidade do "estoque a distribuir" do produto principal para uma variação específica, pela tela **Distribuição de Estoque por Variação** (acessível pelo botão **Distribuir Estoque** na aba de grade do produto).

==== Recebendo mercadoria por nota fiscal ====

Este é o ponto mais importante para quem trabalha com compras e recebimento de mercadoria: **não é possível dar entrada de estoque direto no produto principal**. Quando uma nota fiscal de compra chega com uma quantidade do produto "guarda-chuva" (por exemplo, 100 unidades de "Camiseta"), o sistema exige que essa quantidade seja **distribuída** entre as variações antes de a nota poder ser concluída.

  - Ao lançar o item da nota fiscal com um produto de grade, abra a tela **Distribuição de Estoque**.
  - Para cada variação (Azul-P, Azul-M, Vermelho-P etc.), informe no campo **Entrada** quantas unidades daquela variação chegaram nesta nota.
  - A tela mostra o total já **Distribuído** e o **Restante** a distribuir, e só permite concluir quando o restante chegar a zero — ou seja, a soma de todas as variações precisa bater exatamente com a quantidade da nota.

> :!: A nota fiscal não pode ser concluída enquanto a distribuição não estiver completa. Se você não souber ainda como separar as quantidades, salve a nota sem concluir e volte depois para finalizar a distribuição.

===== Perguntas frequentes =====

**Posso ter um produto com mais de duas características (ex: Cor + Tamanho + Voltagem)?**\\
Não. O sistema aceita no máximo dois atributos por produto na grade.

**Se eu remover uma cor ou tamanho da grade, perco o histórico de vendas daquela variação?**\\
Não. A variação removida não é apagada, apenas fica inativa — ela some das opções disponíveis para novas vendas, mas todo o histórico de vendas, notas fiscais e movimentações continua intacto.

**Como o estoque do produto principal é calculado?**\\
Ele é sempre a soma do estoque de todas as variações ativas — você não precisa (e não consegue) ajustar o estoque do principal diretamente; ajustes são sempre feitos variação por variação.

**Posso mudar o código de barras ou o preço de uma variação depois de criada?**\\
Sim, voltando na aba **Grade/Variações** do produto principal, editando a linha da variação desejada e salvando novamente.

**Por que não consigo editar a descrição de uma variação abrindo ela diretamente?**\\
Isso é intencional: a descrição e os atributos de uma variação são controlados pela grade do produto principal, para evitar que uma variação fique "desalinhada" do restante da grade. Para alterar, edite pelo produto principal.

\\
===== Veja também =====

  * [[ello_erp:modulos:estoque:produtos|Cadastro de Produtos]]
  * [[ello_erp:modulos:estoque|Módulo de Estoque]]