# Estoque e Disponibilidade

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/anuncios/estoque-e-disponibilidade

Saiba como é calculada a disponibilidade para seus itens.

## Disponibilidade em Produtos/Serviços

- Disponibilidade em Produtos/Serviços: Com Calendário Habilitado

### Com Estoque Habilitado:
- Serão consultados **todos os calendários** do produto/serviço
- O produto/serviço estará disponível se houver estoque **maior ou igual** ao informado pelo comprador em **PELO MENOS UM** calendário
- Calendários com **compartilhamento no mesmo pedido** **não** aplicam essas regras neste cenário (com estoque, a ocupação continua exclusive por produto)

### Sem Estoque Habilitado:
- Serão consultados **todos os calendários** do produto/serviço, de acordo com a quantidade informada pelo comprador
- O produto/serviço estará disponível quando **PELO MENOS UM** dos calendários estiver disponível
- Se o calendário permitir **vários itens do mesmo pedido no período**, a ocupação conta **por pedido** no horário (itens do mesmo pedido = 1 vaga) e respeita o **máximo de pedidos por período**. Veja [Encomendas e disponibilidade](../calendarios/encomendas-e-disponibilidade.md)

- Disponibilidade em Produtos/Serviços: Sem Calendário Habilitado

### Com Estoque Habilitado:
- Será consultada se a quantidade disponível é **maior ou igual** à quantidade informada pelo comprador

### Sem Estoque Habilitado:
- Sempre disponível

## Frete e prazo na consulta com calendário

Quando o item tem calendário e o comprador já escolheu frete/deslocamento com prazo em dias:

- Esses dias (úteis) entram no **piso** da primeira data possível, junto com **produção** e a **antecedência mínima** do calendário (vale o maior)
- Na página do produto, o frete vem **antes** da escolha de data / “a partir de…”
- Trocar o frete **não apaga** a data se ela continuar válida com o novo prazo

## Configurações de Variante no Calendário

- Intervalo de Duração
- **Horas** ou **Dias**

- Quantidade
- Em horas ou dias

- Tipo de Duração
- **Mínima e Máxima**: Define um intervalo (ex: 3 a 4 horas)
- **Fixa**: Define um valor único (ex: 4 horas)

## Bloqueio por dia da semana e feriados

Com calendário habilitado, na seção **Dias da semana bloqueados**:

- Marque os dias que o item **não** atende toda semana (ex.: bloquear domingo e segunda)
- Opcional: **Exceto feriados** — quando ativo, um dia bloqueado fica disponível se a data for feriado nacional ou feriado extra cadastrado no calendário vinculado

Regras importantes:

- A exceção de feriado **não** substitui horário de funcionamento, bloqueios manuais no calendário nem estoque
- Feriados nacionais brasileiros são automáticos; feriados locais cadastre em **Calendário → Feriados extras**
- Detalhes e exemplos: [Bloqueio semanal e feriados](../calendarios/bloqueio-semanal-e-feriados.md)

## Disponibilidade em Kits

Para cada componente, de acordo com a quantidade informada na composição, será realizada a consulta do produto/serviço conforme tabela acima.

- Quantidade Final Consultada

**Quantidade final consultada** = quantidade informada no componente × quantidade solicitada pelo comprador (quando for o caso, senão 1)

### Regras de Disponibilidade

Após analisar cada componente, o **KIT estará disponível se TODOS os componentes estiverem disponíveis**.

- Para itens com estoque, é necessário ter a quantidade especificada de cada item
- Para itens com calendário, é necessário que todos estejam disponíveis no mesmo período
- Kit **misto** (agenda de recurso + encomenda): o comprador escolhe **uma única data** para ambos
- Kit só com encomenda “sistema agenda”: o comprador vê prazo **a partir de…**, sem grade
## Regras de Disponibilidade: Tipos de Transação

- Venda
Venda definitiva do item (ex: lembrancinhas, velas, salgados, doces, etc)

⚠️ **Se controla estoque**: Após a venda (confirmação de pagamento) o estoque será subtraído.

- Locação
Aluguel temporário com devolução (ex: mesas, cadeiras, equipamentos)

ℹ️ **Mesmo se controla estoque**: O estoque nunca será alterado.

- Serviço
Prestação de serviço (ex: animação, buffet, fotografia)

ℹ️ **Mesmo se controla estoque**: O estoque nunca será alterado.

## Trilha de Status e impacto na disponibilidade

Quando uma etapa da trilha de status estiver com a propriedade **Aguardando retorno** marcada, o sistema considera **indisponíveis** apenas as unidades desse pedido que **ainda não foram devolvidas** na vistoria, enquanto o pedido permanecer nessa etapa.

- Isso vale para itens com controle de estoque, inclusive em fluxos de locação.
- Nessa mesma etapa a locação conta como **entregue/retirada** e a Unefesta cria o rascunho de caução (veja [Trilha de status](../pedidos/trilha-de-status.md)).
- **Devolução parcial:** ao registrar a vistoria (quantidade devolvida ou unidade com série liberada), essas unidades voltam a ficar disponíveis para novas reservas **sem sair** da etapa **Aguardando retorno**.
- O bloqueio das unidades ainda pendentes some por completo quando o vendedor avança o pedido para uma etapa sem **Aguardando retorno**, ou quando todas as unidades do item já foram conferidas na vistoria.
- A consulta de disponibilidade evita dupla contagem com a reserva já existente no período, para não bloquear além do necessário.

## Locação atrasada e a próxima reserva

Exemplo: a unidade (ou o estoque) ficou com o cliente no dia **12/08** e há outra reserva do mesmo item no **13/08**. Enquanto o primeiro pedido estiver em **Aguardando retorno** e aquela unidade **não** tiver sido liberada na vistoria, ela continua ocupada. Se parte do pedido já foi devolvida, só o que ainda falta bloqueia o estoque.

No pedido da reserva seguinte (aba **Itens** → **Reatribuir estoque**):

1. A Unefesta avisa se a unidade alocada ainda está com outro cliente **ou** se o estoque compartilhado (sem série) não cobre a quantidade deste pedido/dia.
2. Se o produto gera **código único** (`isUnique`), escolha **outra unidade livre** do mesmo produto.
3. Se o produto só controla **quantidade** (estoque ligado, sem `isUnique`) e não há unidades suficientes naquele dia — por devolução atrasada ou outras reservas no mesmo período — **substitua por outro produto ou kit** de locação disponível.
4. A **mensagem de sistema no chat só é criada quando você confirma** a troca ou a substituição neste pedido. Abrir o pedido ou ver o aviso de estoque insuficiente **não** gera mensagem. O valor que o cliente já pagou **não muda**.

Isso vale para cumprir a reserva do segundo cliente sem esperar a devolução do primeiro.

## Veja também

- [Encomendas e disponibilidade](../calendarios/encomendas-e-disponibilidade.md)
- [Guia de configuração de calendários](../calendarios/guia-de-configuracao-de-calendarios.md)
- [Introdução aos calendários](../calendarios/introducao.md)
