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

# Variações e estoque

> Controle cores, SKUs, estoque e variação padrão dos produtos.

# Variações e estoque

Cada produto pode ter uma ou mais **variações**. Uma variação representa um SKU específico — geralmente uma cor, tamanho ou modelo. O estoque e o custo são controlados por variação, e uma delas é definida como **padrão** para exibição no catálogo.

## Pré-requisitos

* Permissão `products` com ação `edit`.
* Acesso à tela de detalhes do produto (`/produtos/{id}`).

## Passo a passo: adicionar uma variação

1. Abra o produto e role até a seção **Variações**.
2. Clique em **Adicionar variação**.
3. Preencha:
   * **SKU** (obrigatório): código único da variação.
   * **Cor**: identificação visual (ex.: `Preto`).
   * **Custo**: preço de aquisição desta variação.
   * **Estoque**: quantidade em estoque.
   * **Galeria da variação**: envie imagens. A primeira é a capa.
4. Ative o interruptor **Ativa** para publicar a variação.
5. Marque **Definir como padrão**, se desejar que ela seja a principal.
6. Clique em **Criar variação**.

> **Dica:** Para produtos manuais, a primeira variação é criada automaticamente no momento do cadastro. Você pode adicionar outras cores depois.

## Definir a variação padrão

* Na lista de variações, clique em **Padrão** na linha desejada.
* A variação padrão define a imagem e SKU exibidos como destaque no catálogo.

## Desativar uma variação

1. Na linha da variação, clique em **Desativar**.
2. Confirme a ação se solicitado.

> **Atenção:** O produto precisa ter ao menos uma variação ativa. O botão de desativar só aparece quando existem duas ou mais variações ativas.

## Produtos de fornecedores

* As cores do fornecedor são sincronizadas automaticamente.
* Você pode adicionar variações manuais em produtos de fornecedor (com SKU próprio), e elas não serão alteradas na próxima sincronização.
* Variações do fornecedor permitem ajustar **preço de venda**, **markup %**, **galeria** e **ativa**.

## Erros comuns

* Usar SKU duplicado dentro do mesmo locatário.
* Desativar a única variação ativa de um produto.
* Não definir uma variação padrão (sempre a primeira ativa pode ser usada automaticamente).

## Solução de problemas

| Problema                                              | Causa provável                           | Solução                                                |
| ----------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------ |
| "Já existe uma variação com este SKU"                 | SKU duplicado                            | Insira um SKU único.                                   |
| "O produto precisa ter pelo menos uma variação ativa" | Tentativa de desativar a última variação | Adicione outra variação antes.                         |
| Variação do fornecedor não atualiza                   | Edição limitada a campos específicos     | Ajuste apenas preço de venda, markup, galeria e ativa. |

## Artigos relacionados

* [Criando produtos manualmente](./creating-products)
* [Editando produtos](./editing-products)
* [Importando produtos de fornecedores](./importing-supplier-products)