Estoque

O que é: o cadastro e o controle de quantidade dos itens da loja. Um item pode ser um insumo (ingrediente usado nas receitas — farinha, leite, copo descartável) ou um produto de revenda (vendido direto no caixa, sem ficha técnica — refrigerante, água). Antes esta tela usava o termo "insumo"; hoje o nome padrão é item, que cobre os dois casos.

Item de revenda: ao cadastrar/editar um item há a opção "Também vendo este item (revenda)". Ligando, o item passa a aparecer no PDV para venda direta e você informa o preço de venda — útil para produtos que você compra prontos e revende, sem montar uma ficha técnica.

Código do item: cada item cadastrado ganha um código sequencial amigável (INS-0001, INS-0002, ...), específico da loja — mais fácil de referenciar do que um código técnico interno.

Status de estoque (badge colorido em cada item):

• 🔴 Crítico: quantidade já abaixo do mínimo configurado.
• 🟡 Atenção: quantidade a menos de 20% acima do mínimo (está perto de faltar).
• 🟢 OK: quantidade confortável.

Ajustando o estoque: três tipos de movimento, cada um pedindo um motivo:

• Entrada (compra de fornecedor, transferência de outra loja, devolução de cliente).
• Saída (perda/vencido, uso interno, transferência para outra loja) — diferente de

Desperdício, que é o caminho certo para registrar perdas com impacto de custo rastreado.

• Corrigir (contagem física diferiu do sistema, erro de lançamento anterior) — informa o valor

real, não uma quantidade a somar/subtrair.

Baixa automática: o estoque é baixado sozinho sempre que uma venda é finalizada no Caixa — nos produtos com ficha técnica baixam os insumos da receita; nos itens de revenda baixa o próprio item; e num produto que tem os dois (modelo aditivo — ex.: água + sacola), baixa os dois. Não é preciso dar baixa manual depois de vender.

Bloquear venda sem estoque (opcional): em Configurações → PDV, um administrador pode ligar a trava que impede finalizar uma venda que deixaria o estoque negativo. Desligada (padrão), o estoque pode ficar negativo — útil para quem repõe depois. Com a trava ligada, o PDV mostra "Sem estoque" nos itens esgotados, empurra-os para o fim da lista (e permite ocultá-los), e recusa a venda com uma mensagem de estoque insuficiente. O alerta de estoque baixo continua funcionando dos dois jeitos.

Cadastrar insumos por IA (foto ou planilha): o botão Importar por IA aceita uma foto/print de uma lista ou uma planilha qualquer (.csv/.xlsx) — sem modelo fixo. A IA lê e monta a lista de insumos (nome, unidade, custo, estoque, fornecedor), ignorando linhas de título e colunas de ruído (datas, totais). Quando a planilha tem várias abas, você escolhe qual aba usar. Antes de salvar há revisão obrigatória (confira custos e unidades) e os itens já cadastrados são ignorados (não duplica). Há também um modelo pronto para baixar.

Atualizar em massa (exportar e reimportar): dá para baixar o cadastro atual (com código por linha), editar no Excel e reenviar para atualizar os existentes — preço, custo, quantidade, mínimo, unidade e outros campos de uma vez. Esse import estruturado (casando por código) é diferente do cadastro novo por IA.

Quem acessa: papéis com permissão de "ver" no módulo Estoque; ajustar quantidade ou cadastrar exige permissão de "editar".