## Visão geral

O **catálogo nativo** é a sua base de produtos dentro da ConversaLabs. É onde você cadastra cada item
com nome, descrição, imagens, preço e disponibilidade, organiza tudo em **categorias** e mantém os
dados que serão usados para sincronizar com o WhatsApp e para enviar produtos durante o atendimento.

Tê-lo bem organizado é o primeiro passo: a partir dele você sincroniza com a Meta, envia produtos na
conversa e cobra pedidos. Mesmo que você também use plataformas externas, o catálogo nativo é a fonte
da verdade dentro da plataforma.

## Pré-requisitos

- Módulo de **Catálogo & Comércio** habilitado para sua conta e perfil de acesso.
- Permissão para gerenciar o catálogo (cadastrar/editar produtos e categorias).
- Imagens dos produtos em um formato comum (por exemplo, JPG ou PNG) e acessíveis.

## Passo a passo

1. Abra a área de **Catálogo** da plataforma.
2. Crie suas **categorias** para agrupar produtos (por exemplo, "Bebidas", "Serviços", "Cursos").
3. **Cadastre um produto**: informe nome, descrição, categoria e a primeira variação.
4. Em cada variação, defina nome, SKU, preço e **opções** como `Cor: Azul` e `Tamanho: M`.
5. Use as setas para ordenar as variações e escolha exatamente uma como **padrão**.
6. Adicione uma ou mais **imagens** ao produto. Depois, você pode vincular uma imagem do produto a
   cada variação; variações sem imagem usam a imagem principal.
7. Defina disponibilidade e estoque quando necessário, salve e repita para os demais produtos.

## Configurações & opções

- **Produto**: nome, descrição, preço, categoria, disponibilidade, imagens e identificadores (como SKU
  e link externo).
- **Categorias**: agrupamento dos produtos para facilitar a busca e a montagem de listas.
- **Imagens**: uma ou mais por produto; a primeira costuma ser usada como destaque.
- **Variações**: cada combinação vendável tem nome, opções, posição, preço, estoque e imagem
  opcional. A variação padrão é a escolha inicial nas listas e nos envios.
- **Arquivar uma variação**: o formulário de edição só descarta variações que ainda não foram salvas.
  Arquive uma variação salva no detalhe do produto, após a confirmação, e escolha antes outra
  variação padrão. O registro arquivado e seu histórico de pedidos e pagamentos são preservados.
- **Imagem da variação**: só pode ser escolhida na galeria do mesmo produto. Ao excluí-la, a
  variação volta com segurança para a imagem principal do produto.
- **Preço**: sempre em **unidades maiores** da moeda (veja a seção de dicas).
- **Baixa automática de estoque**: quando uma venda ao vivo fica **paga**, a quantidade de cada
  variação com controle de estoque é baixada uma única vez. A cobrança e o pedido da mesma venda
  compartilham a mesma identidade, portanto webhooks repetidos ou os dois eventos não baixam em dobro.
  O saldo para em zero; variações sem controle de estoque não são alteradas. Importações e adoções
  históricas também não alteram o saldo atual. O estoque rastreado usa unidades inteiras: uma linha
  fracionária falha de modo seguro, sem arredondar nem baixar parcialmente a venda, e fica visível no
  Histórico. Quantidades fracionárias de variações sem controle de estoque não alteram o saldo.
- **Relatórios**: a visão de relatórios distingue o orçamento dos itens de negócios do valor **realizado** nos
  itens de pedidos pagos. As duas métricas não são somadas e podem divergir quando há descontos, frete ou
  pedidos ainda não liquidados.

## Casos de uso

- Cardápio de um restaurante ou lanchonete com categorias e fotos.
- Catálogo de serviços (consultas, planos, pacotes) com preço por item.
- Lista de produtos físicos de uma loja que vende por WhatsApp.
- Catálogo de infoprodutos ou cursos para enviar diretamente ao cliente.

## Dicas, limites e boas práticas

- **Preço em unidades maiores**: digite `4,97` para indicar **R$4,97**. A plataforma **não** divide por
  100 — o valor que você cadastra é o valor exibido e cobrado.
- O **total de um pedido** é a soma de `preço × quantidade` de cada item — também sem divisão por 100.
- Use imagens nítidas e acessíveis publicamente: a sincronização com o WhatsApp precisa conseguir
  baixá-las. Imagens hospedadas em endereços que ficam fora do ar não serão importadas.
- Mantenha nomes e descrições claros — eles aparecem para o cliente quando você envia o produto.
- No relatório, trate **Orçado** como a proposta registrada no negócio e **Realizado** como itens de pedidos
  pagos. Um item sem pedido pago não entra no realizado.

## Solução de problemas

- **Preço aparecendo errado (ex.: R$0,05 em vez de R$4,97)**: confirme que digitou o valor em unidades
  maiores; não multiplique nem divida por 100.
- **Imagem não aparece**: verifique se o arquivo é válido e se o endereço da imagem está acessível.
- **Uma variação não pode ser arquivada ou excluída**: escolha primeiro outra variação ativa como
  padrão.
- **A imagem errada aparece na variação**: edite o produto e escolha uma imagem da galeria para essa
  variação, ou selecione o uso da imagem principal.
- **Produto não some das listas**: marque-o como indisponível em vez de manter visível quando não
  estiver à venda.
- **Uma venda paga não baixou o estoque**: confirme que a linha da venda aponta para uma variação com
  controle de estoque ativo. Registros apenas importados ou adotados como histórico são mantidos para
  consulta e, de propósito, não reescrevem o saldo atual.
- **A baixa aparece como falha depois dos retries automáticos**: um administrador deve abrir
  **Catálogo → Importar & Sincronizar → Histórico**, localizar a execução **Baixa automática de
  estoque**, abrir o detalhe e clicar em **Tentar baixa novamente**. A execução identifica a cobrança
  ou o pedido e mostra apenas uma referência técnica sanitizada, sem credenciais ou payload do
  gateway. O retry é seguro: o recibo único da venda impede uma segunda baixa se a tentativa anterior
  tiver concluído de forma ambígua. Se a execução estiver Pendente ou Processando, aguarde o worker em
  vez de clicar novamente. Se o motivo indicar quantidade fracionária, corrija a linha de origem para
  unidades inteiras — ou desative o controle somente quando a variação for legitimamente fracionável —
  antes de tentar novamente; a plataforma nunca arredonda essa quantidade.

## Veja também

- [Visão geral de Catálogo & Comércio](/hc/ajuda/articles/catalog-commerce-overview-pt-br)
- [Sincronização e WhatsApp Business Catalog](/hc/ajuda/articles/catalog-commerce-sync-whatsapp-business-catalog-pt-br)
- [Enviar produto e receber pedidos na conversa](/hc/ajuda/articles/catalog-commerce-enviar-produto-pedido-na-conversa-pt-br)