Estoque: saldos, lotes e validades
Módulo a partir do plano Ristorante, para colaboradores da função Gerente para cima. Estende o Custo de Comida: os itens são os mesmos ingredientes das receitas. Seis visões — Saldos, Lotes & Validades, Entrada, Documentos, Configurações, Analytics — mais a exportação de movimentos, saldos, validades, documentos e desperdícios em CSV, Excel ou PDF. Tudo incluído no plano: nenhum consumo de créditos. Um aviso automático sinaliza reservas abaixo do limite e produtos vencendo ou vencidos.
Por que isso ajuda você
As reservas são dinheiro parado em uma prateleira. Quando você não fica de olho nelas, acontecem duas coisas: você percebe que falta algo só depois que o serviço começou, ou encontra produtos vencidos que vão para o lixo. Os dois custam caro.
O Estoque dá a você o quadro em tempo real: quanto você tem de cada item, quais lotes vencem primeiro, quanto está desperdiçando e de quem se reabastecer. Não é um sistema de gestão separado para aprender: ele se apoia nos ingredientes que você já tem no Custo de Comida, então você parte do que já construiu.
Você o encontra em Estoque, no menu da esquerda, e ele está organizado em seis visões em abas.

Disponibilidade e acessos
O módulo começa no plano Ristorante e é uma extensão do Custo de Comida. Ele é ativado sem custos adicionais: nenhuma operação do Estoque consome créditos, exportações incluídas.
No lado da equipe, o Estoque exige a função Gerente de unidade ou Direttore: o Staff e o Editor não o veem. O titular da conta sempre tem acesso. É a mesma permissão manage_inventory descrita no guia Colaboradores e equipe.
Como funciona, em dois minutos
O modelo é por lotes, o mesmo que você usa na prática:
- Quando a mercadoria chega, você faz uma entrada: nasce um ou mais lotes, cada um com a sua quantidade, o fornecedor e a validade.
- O saldo de um item é a soma do que resta nos seus lotes. Você não o digita: ele se calcula sozinho.
- Quando você consome, descarta ou registra um item vencido, você faz um movimento: o saldo restante do lote diminui e o estoque é atualizado na hora.
A partir daí nascem os avisos: reserva abaixo do limite que você definiu, lotes vencendo, produtos já vencidos ainda no estoque.
1. Saldos — quanto você tem, agora
A primeira visão é a lista dos itens que você colocou no estoque. Para cada um, você vê o saldo atual, o limite de reposição, o status e a validade mais próxima.
O status é um semáforo imediato:
- OK (verde) — acima do limite.
- Abaixo do limite (amarelo) — o saldo caiu abaixo do ponto de reposição que você fixou.
- Esgotado (vermelho) — saldo zerado ou abaixo.

Para colocar um item no estoque, você o escolhe na lista dos seus ingredientes do Custo de Comida e clica em Adicionar. Depois, com Gerenciar, você define:
- Limite de reposição — abaixo deste valor dispara o aviso de reserva baixa.
- Unidade de estoque — a unidade com que você conta o saldo (se diferente da de compra).
- Pré-alerta de validade personalizado — os dias de antecedência do aviso para aquele item específico, se você quiser um valor diferente do geral.
O mesmo painel permite retirar um item do estoque: ele deixa de ser rastreado, mas continua no Custo de Comida.
2. Entrada — quando a mercadoria chega
A visão Entrada é onde você registra uma entrega. Em uma única operação:
Escolha o tipo de documento (nota fiscal, fatura ou outro) e, se quiser, anexe o arquivo do romaneio com os dados do fornecedor e o total.
Adicione uma linha para cada lote recebido: item, quantidade, unidade, custo unitário, data de validade e código do lote.
Confirme: a Carteia cria os lotes, registra o documento e anota os movimentos de entrada.
A partir desse momento os lotes aparecem na visão Validades e o saldo dos itens sobe. O documento anexado fica arquivado na visão Documentos.

3. Lotes & Validades — a mercadoria ordenada por urgência
Aqui você vê todos os lotes ativos (os com saldo restante), ordenáveis e filtráveis por item, fornecedor e intervalo de validade. A coluna de validade destaca em amarelo os lotes que vencem em breve e em vermelho os já vencidos, com os dias que faltam.
Em cada lote você registra um movimento com um clique:
- Consumir — quantidade usada na cozinha ou no balcão (movimento out).
- Desperdício — quantidade descartada (quebra, erro, perda).
- Vencido — quantidade descartada por estar fora da data.
Em todos os casos você indica a quantidade e, se quiser, um motivo. O saldo restante do lote diminui na hora; quando chega a zero, o lote sai da lista.

4. Documentos — romaneios e faturas em um só lugar
Cada documento anexado a uma entrada vai parar na visão Documentos: tipo, número, data, fornecedor e total. É o seu arquivo das notas fiscais e das faturas de compra, útil para as fiscalizações e para a rastreabilidade. Os arquivos são privados: só quem tem acesso ao Estoque do estabelecimento os vê.
5. Configurações — como e quando avisamos você
Na visão Configurações você decide o comportamento dos avisos:
- Ativar/desativar o módulo de avisos.
- Dias de pré-alerta de validade — com quantos dias de antecedência sinalizar um lote vencendo (padrão 3).
- Aviso de reserva baixa — ativa a sinalização quando um item cai abaixo do limite.
- Canais — no painel, por e-mail, ou ambos.
- Destinatários adicionais — até dez e-mails além do titular (ex. o responsável de compras).

6. Analytics — onde você perde e onde gasta
A última visão resume a saúde do estoque com quatro números e dois rankings:
- Valor do estoque — quanto vale, em euros, a mercadoria que você tem (soma de saldos restantes × custo do lote).
- Vencendo — quantos lotes estão dentro da janela de pré-alerta.
- Vencidos — lotes fora da data, ainda com saldo restante.
- Valor dos desperdícios — quanto custaram a você desperdício e vencido.
Abaixo, os itens mais consumidos (últimos 90 dias) e os fornecedores por gasto, para entender onde concentrar os pedidos e as negociações.

Avisos automáticos
Uma verificação automática roda todos os dias e gera três tipos de aviso:
- Validade chegando — um lote entra na janela de pré-alerta.
- Produto vencido — um lote ultrapassou a data mas ainda tem saldo restante: convida você a registrar o descarte.
- Abaixo do limite — um item rastreado caiu abaixo do ponto de reposição.
Você recebe cada aviso uma única vez (sem spam: os eventos já notificados não se repetem) nos canais que escolheu. O e-mail chega ao titular e aos eventuais destinatários adicionais.
Exportação — os dados quando você precisa
Na barra de baixo você exporta qualquer visão em CSV, Excel ou PDF, com filtro por data:
| Conjunto de dados | O que contém |
|---|---|
| Movimentos | Todas as entradas, consumos, desperdícios e vencidos |
| Saldos | Itens rastreados, saldo e limite |
| Lotes & validades | Lotes com saldo restante, validade e fornecedor |
| Documentos | Notas fiscais e faturas com número, data e total |
| Desperdícios | Só desperdício e vencido, para o cálculo das perdas |
Bom saber
- O saldo se atualiza só a partir dos movimentos: não existe um campo "quantidade" para corrigir à mão. Para um ajuste, faça um movimento.
- O Estoque valoriza o saldo e os desperdícios só se você inserir o custo dos lotes. Sem custo, você vê as quantidades mas não os euros.
- Os itens e os lotes ficam ligados ao estabelecimento específico: em uma conta multi-local, cada unidade tem o seu estoque separado.
Próximos passos
- Custo de Comida: receitas e margens — o cadastro de ingredientes de onde parte o Estoque
- Colaboradores e equipe — quem pode acessar o Estoque e com qual função
- Planos e créditos — o que inclui o plano Ristorante
Perguntas frequentes
- Preciso recadastrar os ingredientes que já tenho no Custo de Comida?
- Não. O Estoque usa os mesmos ingredientes do Custo de Comida: você escolhe quais rastrear e define o limite de reposição. Sem cadastros duplicados.
- Como o saldo é atualizado?
- Sozinho, a partir dos movimentos. Quando você dá entrada na mercadoria nasce um lote com o seu saldo restante; quando você registra um consumo, um desperdício ou um item vencido, o saldo restante diminui e o estoque é recalculado. Não há um campo para atualizar à mão.
- O Estoque consome créditos?
- Não. Todas as operações — entrada, movimentos, avisos e também as exportações em CSV, Excel e PDF — estão incluídas no plano.
- Quem da minha equipe pode usá-lo?
- É preciso a função Gerente de unidade ou Direttore. Staff e Editor não veem o Estoque. O titular sempre tem acesso.
- Quando chegam os avisos de validade e reserva baixa?
- Uma verificação automática roda todos os dias e avisa você no painel e por e-mail conforme as suas configurações. A janela de pré-alerta de validade é ajustável (padrão 3 dias) e pode ser personalizada por item.
Histórico de versões
v1.0.02026-06-02— Primeira publicação do módulo Estoque: Saldos, Lotes & Validades, Entrada, Documentos, Configurações, Analytics, exportações e avisos automáticos.