Catálogo de Mercadorias

O Catálogo de Mercadorias registra tudo o que você vende: preço, custo, foto, código de barras, NCM para NF-e, categorias e estoque.

Como acessar

Painel → ERP → Catálogo de Mercadorias, ou em Painel → Apps.

Cadastrar produto simples

1. Clique em + Adicionar produto.
2. Preencha nome, categoria, SKU, código de barras (opcional), foto, preço, custo e descrição.
3. Marque Controlar estoque se quiser baixa automática nas vendas.
4. Informe NCM e CFOP se emitir NF-e — use o assistente de sugestão de NCM.
5. Salve. Você será levado à página do produto com resumo comercial, fiscal e histórico.

Na ficha do produto, use as abas: Resumo, Preço, Ficha técnica, Editar, Canais, Fiscal, Estoque, Complementos, Sugestões e Histórico. A aba Preço explica qual custo foi usado na margem.

Preço promocional

Todo produto simples tem um campo opcional Preço promocional, ao lado do preço de venda.

• Deixe vazio pra vender pelo preço normal. Preencha com um valor menor que o preço de venda pra ativar a promoção.
• Vale em todo lugar que vende esse produto: loja online (listagem e carrinho), PDV e Vendas ERP — não é só um selo visual, o preço cobrado muda de verdade.
• Na loja, aparece o preço normal riscado + o preço promocional + a porcentagem de desconto.
• Pra remover a promoção, apague o valor do campo e salve.
• Não se aplica a combos — combo já tem seu próprio desconto (veja "Desconto do kit" na ficha do combo), que também aparece riscado + porcentagem na loja.

Produto com variações

Para itens com tamanho, cor etc.:

1. Marque Produto com variações.
2. Defina os eixos (ex.: Tamanho = P, M, G · Cor = Branco, Preto).
3. Marque Gerar variações automaticamente ao salvar, ou gere depois na página do produto.
4. Cada variação tem preço, estoque e código de barras próprios.
5. Somente variações entram na venda — o produto pai é apenas o agrupador.

Página do produto

Clique em Ver produto → na listagem para ver:

• Foto, preço, custo, margem e estoque
• Dados fiscais (NCM/CFOP)
• Resumo de variações (se aplicável)
• Vendas recentes e histórico de preço/custo
• Últimos movimentos de estoque
• Formulário de edição

Custo completo de pizza e produtos manipulados

Quando a massa fica na ficha do produto e o recheio fica na ficha dos sabores, o sistema calcula o custo da pizza (1 sabor):

1. soma o custo da base;
2. soma o custo médio de um sabor inteiro;
3. usa o total para calcular margem e sugerir preço.

O card de custo mostra base, sabor, total e a faixa entre o sabor mais barato e o mais caro. Meio a meio continua sendo calculado na venda; para precificar, o sistema usa um sabor inteiro para não subestimar o custo.

Criar rascunho para Instagram

Na página de um produto vendável, use Rascunho Instagram · Loja ou Rascunho Instagram · Cardápio Zap.

O produto precisa estar ativo, disponível no canal escolhido, com preço maior que zero e imagem cadastrada. A Loja ou o Cardápio Zap também precisa estar publicado. O sistema cria somente um rascunho com foto, preço e link para você revisar na Central de Marketing.

Mudanças de preço, estoque ou disponibilidade não criam posts automaticamente.

Listagem e filtros

Use a busca por nome, SKU ou código de barras. Filtre por categoria, NCM, estoque ou pendências de qualidade. Os cards mostram itens ativos, pendências, produtos Sem custo, margem baixa e desempenho dos últimos 30 dias. Clique no card Sem custo para ver somente os produtos vendáveis cuja ficha técnica ou custo manual ainda não foi informado. A listagem usa o custo da ficha completa quando o campo de custo manual está vazio. Em combos, o custo vem da soma dos produtos do kit — não precisa preencher custo no próprio combo.

Clique no título das colunas (Produto, Categoria, Setor, Custo, Venda, Margem, NCM, Estoque) para ordenar. Clique de novo para inverter a ordem (↑ / ↓). Sem ordenação manual, a lista prioriza produtos destacados.

Atalhos na listagem

• Preço rápido: clique no preço de venda, digite o novo valor e confirme. O histórico do produto registra a alteração.
• Clonar: cria uma cópia inativa com ficha técnica, complementos (incluindo ficha dos sabores), sugestões e setores de impressão. A foto é duplicada (alterar a do clone não afeta o original). Destaques de canal são limpos. Revise e ative quando estiver pronto.
• Destacar: produtos destacados aparecem primeiro na loja online e no PDV.
• Precificação: abra a central para comparar custo, preço atual, margem e preço sugerido para todos os produtos.

Central de Precificação

Na aba Precificação, defina a meta da empresa como margem ou CMV (custo da mercadoria sobre o preço). São o mesmo alvo:

• Margem 30% = CMV 70%
• CMV 28% = margem 72%

No método divisor, um produto que custa R$ 10 com meta de margem 30% (ou CMV 70%) recebe sugestão de R$ 14,29: 10 ÷ (1 − 0,30).

Incluir as despesas da loja

Abra Configurações e marque Incluir despesas operacionais para calcular o preço com:

1. custo da ficha ou custo manual do produto;
2. embalagem, quando habilitada;
3. taxa variável de cartão/marketplace;
4. média das despesas da operação nos últimos meses fechados;
5. lucro líquido desejado.

A página mostra a fórmula, o período analisado, receita e despesas médias, percentuais usados e quais classificações da DRE entraram. Em cada produto, o detalhamento separa custo, taxas, operação e lucro estimado.

Compras/CMV não entram no rateio operacional porque já estão no custo da ficha. Taxas entram como percentual separado, e transferências entre contas não entram.

Se aparecer aviso de dados incompletos, revise Contas gerenciais, Despesas recorrentes, Regras de liquidação e a DRE antes de aplicar preços. Uma folha ou conta que não foi lançada não pode ser considerada pelo cálculo.

Com essa opção desligada, o Hub continua usando somente custo/CMV e margem de contribuição, como antes.

Você também pode escolher o arredondamento. O preço só muda quando você confirma a aplicação; cada alteração entra no histórico.

Para produtos com preço nos tamanhos (Meia/Inteira no grupo Tamanho), o Hub mostra uma linha por tamanho, com o custo da ficha daquela opção e o preço dela — não usa o preço zerado do produto-base. O botão Aplicar neste tamanho grava o valor no complemento.

Para alterar vários produtos:

1. Marque até 50 linhas na lista (produto ou tamanho).
2. Clique em Ver prévia do lote.
3. Confira preço atual, sugerido e diferença de cada item.
4. Confirme o lote.

Produtos sem custo são ignorados e aparecem na prévia. O sistema recalcula as sugestões ao confirmar; não existe opção de aplicar automaticamente em todo o catálogo.

Cada tamanho é um produto

Pizza Pequena, Média e Grande são produtos separados. Sabores e bordas ficam como complementos. No hub, os tamanhos aparecem agrupados pela família (ex.: “Pizza”), mas o botão Aplicar neste tamanho altera só aquela linha.

Sugestões com inteligência artificial

No produto, peça sugestões e compare valor atual e sugerido. Marque apenas os campos que deseja aplicar. A IA não altera preço, custo, estoque, NCM ou CEST e nada é salvo sem confirmação.

Avisos de qualidade e margem

O catálogo mostra cards de pendências, Sem custo, Abaixo da meta e Preço abaixo do custo.

• Abaixo da meta usa a mesma margem-alvo da aba Precificação (ex.: 30%). Vale para produto simples, variação, combo e cada tamanho com preço próprio.
• Preço abaixo do custo é quando o preço de venda não cobre o custo efetivo (margem zero ou negativa).
• Insumos não entram nesses alertas de venda.

Ajuste a meta em Catálogo → Precificação. O digest diário (sino, push, e-mail ou Telegram) lista até 10 itens de cada tipo com nome e margem.

Em ERP → Notificações, configure os canais do resumo. O limiar de margem não fica mais nessa tela — ele segue a Precificação.

Avisos de qualidade (canais)

Destacar e ordenar

No formulário de edição do produto:

1. Marque Destacar na loja / PDV para priorizar o item.
2. Ajuste a Ordem de exibição (número menor = aparece antes, depois dos destaques).

Venda sugestiva (loja online)

Na página do produto, seção Venda sugestiva:

1. Busque e adicione até 5 produtos relacionados.
2. Salve. No carrinho da loja, o cliente vê o bloco Que tal adicionar? com esses itens (somente produtos ativos e visíveis na loja; itens já no carrinho não repetem).

A configuração é manual — não usa histórico automático de vendas e não aparece no PDV.

Categorias

1. No catálogo, abra a aba Categorias (ou + Nova categoria).
2. Informe o nome e se serve para produto, insumo ou ambos.
3. Opcional: escolha um ícone (pizza, bebidas, lanches…) e uma cor de destaque — eles aparecem nos chips do cardápio da loja online.
4. Se você criar sem ícone, o sistema pode sugerir um pelo nome (ex.: “Pizzas” → pizza).
5. Salve. Na edição você também pode ativar/desativar a categoria.

Categorias de produto organizam o cardápio na loja; categorias só de insumo não entram nos chips da loja.

Importar catálogo em massa (JSON)

Para cadastrar dezenas de produtos de uma vez (ex.: todo o cardápio de uma pizzaria com sabores, bordas e adicionais), use a importação por JSON em vez de cadastrar produto por produto.

Como acessar

Catálogo → aba ⬆️ Importar.

Como funciona

1. Cole o JSON do catálogo (categorias, produtos, grupos de complemento com seus itens, e insumos) na caixa de texto.
2. Clique em Ver prévia — o sistema mostra quantas categorias, produtos, grupos e insumos serão criados ou atualizados, sem gravar nada ainda.
3. Se o JSON tiver algum problema (ex.: grupo de complemento sem limite máximo de escolha definido), a prévia mostra o erro e nada é importado até você corrigir e colar de novo.
4. Revise a prévia e clique em Confirmar importação.

Importar de novo (atualizar)

Reimportar o mesmo JSON não duplica nada — categorias, produtos, grupos e insumos são casados pelo nome dentro da sua empresa: se já existir, é atualizado; se não existir, é criado.

O que a importação não faz

Não cria variações automáticas (tamanho/cor), ficha técnica com quantidade de insumo por produto, dados fiscais, imagem nem configuração de canais de venda — esses ajustes continuam sendo feitos manualmente na página de cada produto depois da importação.

Vendas

Na Nova venda, busque produtos pelo nome, SKU ou código de barras. Variações aparecem com o nome completo (ex.: Camiseta — M / Azul). Itens manuais (sem catálogo) exibem aviso se o módulo NF-e estiver ativo.

Guia completo do PDV, orçamentos, OS e comissões: artigo Vendas, Orçamentos e Comissões na Central de Ajuda.

Importação de compras (XML)

Ao importar NF-e de compra, o sistema tenta vincular itens pelo código de barras, depois NCM e nome.

Estoque

Produtos com controle de estoque mostram quantidade na listagem e na página do produto. Use Ver estoque → para lançar entradas, saídas ou ajustes.

Complementos e opcionais (SABORES, BORDAS, ADICIONAIS)

Use grupos de complementos para montar cardápios de delivery com opções que o cliente escolhe na hora — igual ao Alloy e outros sistemas de pizzaria.

O que é um grupo de complementos?

• Grupo: ex. SABORES, BORDAS, ADICIONAIS
• Item do grupo: ex. Calabresa Cebolada (grátis), Frango c/ Catupiry (+R$8,00)
• Grupos são compartilhados: criar SABORES uma vez e vincular a PIZZA GG, PIZZA GRANDE e PIZZA MÉDIA — mudança no grupo reflete em todos os produtos.
• Preços diferentes por produto? Não use “compartilhar”. Use Copiar grupo (cópia independente) ou, se o grupo já estiver compartilhado, clique em Só deste produto na página do produto.

Criar e configurar um grupo

1. Acesse a página do produto (Ver →).
2. Role até a seção Complementos / Opcionais.
3. Clique em + Novo grupo.
4. Preencha:
   • Nome: ex. SABORES
   • Mín. escolhas: 0 = opcional / 1+ = obrigatório (conta a soma das quantidades das opções, não só quantos itens diferentes)
   • Máx. escolhas: limite da soma (ex.: “Até 10” em adicionais permite 3× gelo + 1× limão). Com máximo 1, o cliente escolhe só uma opção (radio)
   • Cálculo do preço:
     • Soma tudo — cada unidade escolhida adiciona seu preço (qty × preço)
     • Média dos escolhidos — média ponderada pela quantidade (comum em pizzas meio a meio)
     • Cobra o mais caro — cobra apenas o item de maior valor entre os escolhidos
     • Sem custo extra — os opcionais não somam nada ao preço
5. Clique em Criar grupo — o grupo já fica vinculado a este produto (preços só dele, até você compartilhar com outro).

No PDV, loja online e Cardápio Zap, grupos com máximo maior que 1 mostram − / N / + por opção; o modal também permite escolher a quantidade do produto. O valor dos adicionais é cobrado uma vez na linha (não multiplica pela quantidade do produto): 2 refrigerantes + 1 gelo = preço dos 2 + 1 gelo.

Canais do grupo (onde aparece)

Ao criar ou editar o grupo, marque em quais canais ele aparece:

• PDV / Mesas — balcão, delivery, mesas e garçom
• Loja online — site / Personalizar
• Cardápio Zap — cardápio WhatsApp

Exemplo: grupo Adicionais Refrigerante (limão, gelo) só no PDV — desmarque Loja e Zap. Vale para todos os produtos que compartilham o grupo.

Adicionar itens ao grupo

Dentro do grupo, clique em + Adicionar item e preencha nome, descrição e preço (em centavos — ex.: R$8,00 = 800). Deixe 0 para opções grátis.

Vincular grupo a outro produto

• Copiar grupo (recomendado se os preços forem diferentes): cria uma cópia independente com os mesmos itens/preços iniciais. Depois você ajusta só neste produto.
• Compartilhar: o mesmo grupo aparece nos dois produtos. Qualquer mudança de preço/item vale para todos. Só use quando isso for desejado (ex.: mesma borda com o mesmo preço em todas as pizzas).

Se o grupo já estiver compartilhado e você quiser preços só neste produto, use o botão Só deste produto no cabeçalho do grupo.

Clonar ou copiar grupo

• Só deste produto: troca o grupo compartilhado por uma cópia exclusiva deste produto (os outros produtos continuam no grupo original).
• Clonar (no cabeçalho do grupo): cria uma cópia extra e também vincula ao produto atual (o grupo original continua). Prefira Só deste produto quando o objetivo for independência de preço.
• Copiar grupo: escolha qualquer grupo da empresa e gere uma cópia com preços/itens próprios (útil para Sabores Grande vs Sabores Média).

Status do complemento (estilo Alloy)

Ao editar um item do grupo, defina o status:

Marque Novidade para destacar o sabor.

Preço “A partir de” na loja

Se o produto tem complementos obrigatórios com acréscimo, a loja mostra A partir de = preço base + os mais baratos necessários para cumprir o mínimo de cada grupo.

Ficha técnica do sabor (estoque)

Ao editar um sabor, use Ficha técnica deste sabor para informar os insumos da pizza inteira daquele sabor (kg).

Na venda com vários sabores no mesmo grupo (ex.: 2 sabores), o sistema baixa 1/N de cada ficha (meio a meio = metade de cada). Massa e molho base ficam melhor na ficha do produto tamanho (Pizza G), não no sabor.

Custo e margem (estilo rede)

Na aba Preço do tamanho (ex.: Pizza Extra GG), o sistema mostra custo receita (1 sabor) = ficha do tamanho + média dos sabores com ficha.

• Use esse valor para olhar margem (como nas grandes redes).
• Campo Custo vazio → a margem usa a receita média automaticamente.
• Botão Usar custo receita no campo grava a média no custo manual.
• Meio a meio (1/N) continua só na baixa de estoque na venda — não na precificação.

Desconectar grupo de um produto

Clique em Remover ao lado do nome do grupo na seção Complementos. O grupo continua existindo e vinculado a outros produtos — apenas é desvinculado deste.

Pausar produto temporariamente

Pausar é diferente de desativar: o produto continua no catálogo (histórico, fichas, vendas passadas), mas não aparece no cardápio público nem no PDV enquanto estiver pausado.

Quando usar: acabou o frango, promoção encerrada, item fora de temporada.

Como pausar

• Da listagem: clique em ⏸ Pausar na linha do produto.
• Do formulário de edição: marque Pausar hoje ao final do formulário e salve.

Como reativar

• Da listagem: clique em ▶ Reativar na linha do produto pausado.
• Do formulário de edição: desmarque Pausar hoje e salve.

Produtos pausados aparecem na listagem com o badge Pausado em laranja.

Desativar produto

Na página do produto, use Desativar produto. Produtos variáveis desativam todas as variações. O histórico é preservado.

Desativação é permanente (remove do sistema). Para ausência temporária, prefira Pausar.