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

# Editando produtos

> Atualize informações, imagens e visibilidade de produtos manuais e de fornecedores.

# Editando produtos

A tela de detalhes de um produto (`/produtos/{id}`) reúne as informações gerais, galeria, markup e variações. O que pode ser editado depende da origem do produto: **Manual** ou **Fornecedor**.

## Pré-requisitos

* Permissão `products` com ação `edit`.
* O produto deve existir no catálogo do locatário.

## Passo a passo

1. Na lista de produtos, clique em **Ver detalhes** no item desejado.
2. Na aba **Informações gerais**, ajuste:
   * **Nome** (apenas manuais).
   * **Categoria** (dropdown com as categorias do locatário).
   * **Descrição** (apenas manuais).
   * **Ativo** e **Destaque**.
3. Na seção **Galeria do produto**, adicione ou remova imagens. A primeira imagem vira a capa.
4. Na seção **Markup por quantidade**, escolha:
   * Usar o markup global da loja/fornecedor.
   * Ativar **Usar markup personalizado** e configurar faixas de markup.
5. Clique em **Salvar produto**.

## Diferenças por origem

### Produtos manuais

Podem alterar praticamente todos os campos: nome, categoria, descrição, imagens e markup.

### Produtos de fornecedores

Sincronizados automaticamente. Você pode:

* Ativar/desativar visibilidade.
* Marcar como destaque.
* Substituir a galeria de imagens.
* Ajustar markup nas variações (preço de venda e markup %).

> **Importante:** Não é possível alterar o nome, SKU, custo ou estoque de variações vindas do fornecedor. Esses dados são atualizados pela sincronização.

## Opções

* **Ativo**: o produto aparece no catálogo.
* **Destaque**: destaca o produto em vitrines.
* **Usar markup personalizado**: aplica faixas de markup próprias do produto em vez do global.

## Erros comuns

* Tentar salvar um produto de fornecedor alterando campos bloqueados (a interface manterá o campo somente leitura).
* Não preencher o **Nome** ao editar produtos manuais.
* Esquecer de salvar após alterar a categoria.

## Solução de problemas

| Problema                               | Causa provável                                 | Solução                                                |
| -------------------------------------- | ---------------------------------------------- | ------------------------------------------------------ |
| Produto não encontrado                 | ID inexistente ou não pertencente ao locatário | Verifique a URL e acesse pelo catálogo.                |
| Campos de fornecedor bloqueados        | O item tem `source = supplier`                 | Use os controles de visibilidade e galeria permitidos. |
| "Não foi possível atualizar o produto" | Erro de validação ou banco                     | Confira os campos obrigatórios e tente novamente.      |

## Artigos relacionados

* [Criando produtos manualmente](./creating-products)
* [Variações e estoque](./variants-and-stock)
* [Importando produtos de fornecedores](./importing-supplier-products)
* [Organizando produtos em categorias](../categories/organizing-products)