Produtos e categorias
🛂 Permissões:
product.view,product.create,product.edit,product.delete🔒 Plano: contagem máxima de produtos limitada pormax_productsno plano contratado. 📍 Caminho: Catálogo → Produtos / Categorias
O catálogo é a base de todo o restante (pedidos, loja online, promoções, comissões). Esta página descreve cadastro e gestão de produtos e categorias.
Categorias
O que é
Categorias agrupam produtos. Aparecem como filtros na loja online e podem ser usadas como escopo de promoções (Promoções).
Como criar / editar
- Em Catálogo → Categorias, clique em Nova Categoria.
- Preencha Nome e (opcional) Descrição.
- Salve.
A exclusão de categoria não apaga os produtos: apenas remove a associação (FK fica
NULL).
Produtos
Como cadastrar
Em Catálogo → Produtos, clique em Novo Produto. Os campos são:
Identificação
| Campo | Obrigatório | Descrição |
|---|---|---|
| SKU | sim | Código interno único do produto. |
| EAN | não | Código de barras (EAN-13/EAN-14). Útil para integração com leitores e ERP. |
| Nome | sim | Nome exibido em todos os lugares. |
| Descrição | não | Texto livre — aparece na página de produto da loja online. |
| Categoria | não | Categoria à qual o produto pertence. |
Preços e custos
| Campo | Descrição |
|---|---|
| Preço base | Preço público padrão. Tabelas de preço, promoções e cupons partem deste valor. |
| Custo | Custo do produto (insumo). Usado para calcular margem nos relatórios. |
Estoque
| Campo | Descrição |
|---|---|
| Quantidade em estoque | Saldo atual. Decremenetado automaticamente em pedidos. |
| Unidade | UN, KG, L etc. Afeta a exibição. |
Encomenda (pré-venda)
Habilite Permite encomenda para vender produtos com estoque zerado (sob demanda). Quando ativo, define:
| Campo | Descrição |
|---|---|
| Prazo mínimo (dias) | Número mínimo de dias para produção/aquisição. |
| Quantidade mínima por pedido | Ex.: 100 brigadeiros — não faz sentido produzir 1. |
| Quantidade máxima por pedido | Teto para a capacidade produtiva. |
Destaque e visibilidade
| Campo | Descrição |
|---|---|
| Destaque | Produtos em destaque aparecem na home da loja online. |
| Ordem de exibição | Posição entre os destaques (menor = primeiro). |
| Ativo | Se desligado, o produto some da loja e não pode ser usado em pedidos. |
Imagens
- Imagem principal — capa do produto.
- Galeria — múltiplas imagens. Defina ordem e qual é a primária.
O backend marca uma imagem como primária; ela substitui a
image_urldo produto. Imagens são armazenadas em S3.
Promoção ativa
Os campos Preço promocional e Promoção ativa são preenchidos automaticamente quando uma promoção (Promoções) está vigente. Não precisam ser editados manualmente.
Listagem de produtos
A listagem em Catálogo → Produtos permite:
- Pesquisa por nome / SKU / EAN.
- Filtro por categoria, status (ativo/inativo) e destaque.
- Análise rápida por produto — abre um diálogo com vendas, ticket médio, clientes que mais compram (botão de gráfico).
Limites do plano
A criação de novos produtos é bloqueada quando o tenant atinge max_products do plano. Para aumentar o limite:
- Confira o limite atual em Configurações → Planos.
- Faça upgrade contatando o suporte.
Boas práticas
- SKU único e estável — evite renumerar SKUs depois que o produto começou a vender; isso quebra histórico em ERPs.
- EAN — preencha quando vender produtos industrializados; viabiliza leitor de código de barras nos pedidos.
- Descrição — capriche; é o que a loja online e o agente de IA usam para responder perguntas.
- Imagens — 1.200 px no lado maior, formato JPG ou WebP, fundo claro/branco.
- Categorias — não exagere na profundidade. Categorias planas dão melhor experiência na loja.
- Encomenda — útil para confeitaria, marcenaria, gráfica. Avise o cliente com clareza no campo de descrição.