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.

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

Listagem e filtros

Use a busca por nome, SKU ou código de barras. Filtre por categoria, NCM pendente ou estoque baixo. A listagem mostra miniatura, margem e status fiscal.

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) e sugestões. Revise e ative quando estiver pronto.
• Destacar: produtos destacados aparecem primeiro na loja online e no PDV.

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

Expanda + Nova categoria no topo da listagem para criar categorias rápidas e organizar o catálogo.

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.

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
   • Máx. escolhas: limite de itens que o cliente pode selecionar
   • Cálculo do preço:
     • Soma tudo — cada item escolhido adiciona seu preço
     • Média dos escolhidos — divide o total pelo número de itens (comum em pizzas meio a meio)
     • Cobra o mais caro — cobra apenas o item de maior valor
     • Sem custo extra — os opcionais não somam nada ao preço
5. Clique em Criar 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

Para reutilizar SABORES em PIZZA GRANDE, abra a página de PIZZA GRANDE → seção Complementos → selecione o grupo no dropdown → Adicionar. O mesmo grupo (e qualquer mudança futura nele) aparecerá nos dois produtos.

Clonar ou copiar grupo

• Clonar (no cabeçalho do grupo): cria uma cópia independente e já vincula ao produto atual. Editar a cópia não altera o original.
• 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.

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.