Extensão: Controle de Reservas e Esperas

O que é a extensão Controle de Reservas e Esperas

A extensão Controle de Reservas e Esperas (código estoque_reservas) bloqueia estoque quando um produto é incluído em um pedido de venda, uma NF de saída ou uma comanda do restaurante. Esse estoque reservado continua fisicamente no depósito, mas não pode ser prometido a outro cliente até que a operação seja finalizada ou cancelada.

Sem a extensão, é comum vender a mesma peça duas vezes em operações de alto giro — porque o pedido A só baixa o estoque no faturamento, e enquanto isso o pedido B pega a mesma unidade. A reserva resolve isso.

Como instalar e ativar

1. No menu lateral, acesse Extensões.
2. Localize Controle de Reservas e Esperas.
3. Ative para a empresa atual.
4. Confirme.

A partir daí, os fluxos de venda, NF de saída e comanda passam a criar reservas automaticamente. Nenhuma configuração adicional é necessária no cadastro do produto.

Como acessar

A tela de reservas fica em Operações → Suprimentos → Controle de Estoque → subrota /estoque/reservas. Ali você vê todas as reservas em aberto por produto, depósito, origem e data.

Como funciona

Criação automática

Três cenários disparam reserva automática:

• Venda — ao adicionar um item a um pedido de venda, o sistema bloqueia a quantidade correspondente no depósito escolhido.
• NF de saída — quando uma nota fiscal de saída é criada, cada item vira uma reserva até o lançamento efetivo de estoque.
• Comanda do restaurante — ao lançar um prato na comanda, os ingredientes (via ficha técnica) são reservados enquanto a cozinha prepara.

Validação de disponibilidade

Antes de criar uma reserva, o sistema faz a conta:

estoque_disponivel = estoque_fisico − estoque_reservado
suficiente? = estoque_disponivel >= quantidade_solicitada

Se não houver estoque suficiente, o sistema alerta ou bloqueia (dependendo da configuração). Isso elimina o risco de vender duas vezes.

Liberação

A reserva é liberada automaticamente em três situações:

• Venda cancelada — as reservas da venda são removidas, e o estoque volta a ficar disponível.
• NF lançada no estoque — a reserva vira saída efetiva.
• Comanda finalizada — a reserva vira consumo real (baixa de estoque pela ficha técnica).

Criação manual

Também é possível criar reservas manuais — por exemplo, quando um cliente VIP reserva uma unidade por telefone antes de pagar. Use a ação Criar reserva manual na tela de reservas.

Reservas × lista de espera

Quando um produto em falta tem clientes interessados, a extensão pode manter uma lista de espera — um registro das pessoas que querem aquele item assim que ele voltar ao estoque. O aviso é manual, pelo operador, e usa o módulo de mensageria ou o CRM para notificar o cliente.

Integrações com outros módulos

Estoque

A extensão se encaixa sobre o cadastro normal de estoque. O estoque físico continua sendo a fonte da verdade; o disponível é a subtração entre físico e reservado.

Vendas

Pedidos de venda alimentam as reservas a cada novo item. Alterações (trocar produto, mudar quantidade, remover item) ajustam a reserva automaticamente.

NF-e / NFC-e

Notas fiscais de saída geram reservas até o lançamento de estoque; depois viram saída real.

Restaurante

Ingredientes da ficha técnica são reservados quando o prato entra na comanda, evitando que o cozinheiro pegue a matéria-prima para outro pedido em paralelo.

Lotes

Quando o produto tem controle de lotes, a reserva é feita no lote específico escolhido (FEFO ou manual).

Necessidades de Compra

O cálculo de necessidades pode opcionalmente considerar reservas — produtos com muito reservado aparecem com menos disponível, sugerindo compra antecipada.

Permissões

• Visualizar reservas.
• Criar reserva manual.
• Liberar reserva.

Perguntas frequentes

A reserva afeta o estoque contábil?

Não. A reserva é um registro lógico — o estoque físico continua o mesmo até a saída efetiva. Contabilmente, o produto ainda é seu.

O que acontece se eu cancelar uma venda?

As reservas daquele pedido são liberadas automaticamente e o produto volta a ficar disponível para outras vendas.

Posso reservar sem abrir venda?

Sim. A criação manual na tela de reservas serve para esses casos — cliente que reserva por telefone, separação antecipada para um evento, produto separado para amostra.

Como sei quanto de cada produto está reservado?

Na tela de Controle de Estoque, com a extensão ativa, aparece uma coluna adicional de reservado — e a coluna de disponível leva em conta o valor.

Produtos com controle de lote respeitam a reserva por lote?

Sim. A reserva é gravada no lote específico, garantindo que o lote escolhido seja o mesmo quando a venda for faturada.