Produtos

PRODUTO

AMBOS

O módulo de Produtos é o coração do catálogo de vendas. Cadastre seus produtos com fotos, preços, variações e adicionais para vender via WhatsApp ou atendimento presencial.

📍 Como Acessar

Menu lateral → Catálogo → aba Produtos (/dashboard/catalogo/produtos)

Disponível em: Empresas com modelo "Produto" ou "Ambos".

Tela Principal (Lista)

Buscar: Filtre por nome, SKU ou código de barras
Filtrar por categoria: Veja produtos de uma categoria específica
Filtrar por status: Ativos, inativos ou com estoque baixo
Novo produto: Cadastre um novo produto
Editar: Altere dados do produto
Gerenciar variações: Adicione tamanhos, cores, etc.
Gerenciar adicionais: Configure extras opcionais

Link direto para um produto. A lista aceita ?edit=<id>na URL e abre o cadastro daquele produto já em edição — mesmo que ele não esteja na página que a lista mostra. É como o checklist da primeira emissão fiscal leva você ao produto sem NCM: um clique por pendência, em vez de uma busca por pendência. Depois de abrir, o parâmetro sai da URL, para um F5 não reabrir o mesmo cadastro para sempre.

Variações do Produto

Variações permitem oferecer o mesmo produto em diferentes versões:

Exemplos de variações:

Tamanho: Pequeno (R$ 15), Médio (R$ 20), Grande (R$ 25)
Cor: Preto, Branco, Azul (mesmo preço)
Sabor: Chocolate, Morango, Baunilha
Volume: 300ml (R$ 10), 500ml (R$ 15), 1L (R$ 25)

Cada variação pode ter seu próprio preço e controle de estoque independente. Veja mais detalhes em Variações de Produto.

Unidade de compra e de venda

Se você compra em caixa e vende em unidade, diga isso uma vez aqui. São dois campos:

Unidade de venda — o que sai na nota ao vender. Ex.: UN, KG, L.
Unidade da embalagem — como você compra do fornecedor. Ex.: CX, FD, PCT.
Unidades por embalagem — quantas unidades de venda vêm em 1 embalagem. Ex.: 12.

1 CX = 12 UN. Com isso preenchido, a entrada de 2 caixas vira 24 unidades no estoque e o custo da caixa é repartido entre elas. O saldo continua sendo contado sempre na unidade de venda.

A unidade da embalagem tem de ser diferente da unidade de venda, e os dois campos andam juntos: ou preenche os dois, ou deixa os dois em branco. Se você compra e vende na mesma unidade, deixe em branco — não há o que converter.

Ao importar uma NF-e de entrada, o sistema preenche esses campos sozinho quando a nota traz as duas quantidades (comercial e tributável). Se você já preencheu algo diferente, o seu cadastro é mantido e a prévia da importação avisa da divergência.

Lotes e validade

Produto que vence pode ter lotes. Cada lote tem o código impresso na embalagem e a data de validade; o saldo de cada lote vem das entradas e saídas registradas com ele.

Na baixa de estoque sai primeiro o lote que vence antes. Lote vencido não é vendido pelo sistema — ele pede a baixa por perda. Veja os detalhes em Estoque.

Adicionais do Produto

Adicionais são extras que o cliente pode incluir no produto:

Exemplos de adicionais:

Hambúrguer: +Bacon (R$ 5), +Ovo (R$ 3), +Queijo Extra (R$ 4)
Pizza: +Borda recheada (R$ 8), +Catupiry extra (R$ 6)
Açaí: +Leite em pó (R$ 2), +Granola (R$ 2), +Frutas (R$ 4)

Adicionais podem ser obrigatórios (cliente deve escolher pelo menos um) ou opcionais. Veja mais em Adicionais de Produto.

Imagens do Produto

Até 5 imagens por produto
Formatos: JPG, PNG, WebP
Tamanho máximo: 5MB por imagem
A primeira imagem é a capa/principal
Imagens são comprimidas automaticamente para performance

Dica: Fotos de qualidade aumentam significativamente as vendas. Use fundo claro e boa iluminação.

Código de Barras

O campo Código de barras (EAN/GTIN) é o que permite achar o produto bipando a etiqueta, na venda rápida e no balcão. Ele é opcional: sem ele, a nota sai com "SEM GTIN", que o fisco aceita.

Há três formas de preencher, e todas as três funcionam:

Leitor USB ou Bluetooth — não precisa configurar nada. O leitor se comporta como teclado: clique no campo e bipe a etiqueta.
Câmera do celular — toque no ícone de código de barras dentro do campo. A câmera abre, e ao passar sobre a etiqueta o código entra sozinho, sem precisar tocar em nada nem confirmar.
Digitando — dá para colar da planilha do fornecedor com pontuação; o sistema tira os pontos e mantém os dígitos.

Câmera: funciona no Google Chrome do Android, sem precisar ativar nada. No iPhone e no iPad nenhum navegador oferece leitura por câmera — nesses aparelhos use um leitor USB/Bluetooth ou digite. A câmera também exige que o sistema esteja aberto por um endereço https. Quando não dá, a tela diz o motivo e o que fazer.

Os dois avisos do campo

Ao sair do campo, o sistema confere o código e pode mostrar um aviso. Nenhum aviso impede o salvamento — eles existem para você conferir a etiqueta, porque existe código interno de loja e etiqueta de balança que não seguem o padrão EAN.

"O dígito verificador não fecha" — o código tem o comprimento de um EAN/GTIN (8, 12, 13 ou 14 dígitos), mas o último dígito não confere com os anteriores. Quase sempre é um número trocado ou faltando na digitação. O aviso diz qual deveria ser o último dígito. Se ficar assim, o leitor do balcão não vai reconhecer a etiqueta e a nota pode ser recusada por GTIN inválido.
"Este código já é de [outro produto]" — dois produtos com o mesmo código fazem a leitura puxar o errado, e qual dos dois vem depende da ordem da consulta. Confira a etiqueta antes de salvar.

Por que o dígito importa: o código de barras vai para o campo cEAN da NF-e/NFC-e. Um código com dígito errado é aceito no cadastro, mas falha depois em dois lugares que ninguém liga ao cadastro — o leitor do balcão não bipa na etiqueta e a SEFAZ recusa a nota. É por isso que o sistema confere na hora.

Controle de Estoque

Quando "Controla Estoque" está ativado, dois campos extras aparecem no cadastro:

Estoque atual (só na criação)

Quantidade que você tem hoje. Ao salvar, o sistema registra uma movimentação de entrada com motivo "Saldo inicial". Para ajustar depois, use a tela de Estoque.

Avisar quando estoque baixo

Checkbox que habilita o campo Quantidade mínima. Quando o estoque atinge ou fica abaixo desse valor e o checkbox está ativo, o produto aparece no widget Produtos com estoque baixo no dashboard.

Baixa imediata na comanda

Ao incluir um produto que controla estoque numa comanda/atendimento, o estoque é baixado imediatamente (não no pagamento). Se o item for removido ou a comanda cancelada, a quantidade é devolvida automaticamente.

Demais comportamentos

Produto sem estoque suficiente bloqueia a inclusão na comanda
Cancelar item ou comanda devolve a quantidade ao estoque
Saldo atual é o resultado de SUM(entradas - saidas) em estoque_movimentacoes

Se você não quer controlar estoque (ex: alimentos preparados na hora), deixe "Controla Estoque" desativado.

Dicas e Avisos

Não é possível excluir um produto que já tem vendas ou movimentação de estoque. Ao tentar, o sistema explica o motivo e oferece desativar o produto na hora: ele sai do catálogo e o histórico fica preservado.

O SKU e Código de Barras são opcionais mas ajudam muito no controle interno e conferência de estoque.

Dica: Uma boa descrição ajuda o agente de IA a responder perguntas dos clientes sobre ingredientes e características.

Para produtos com muitas variações e adicionais, considere criar combos pré-montados como produtos separados para simplificar o pedido.