# Criando Calendários

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/calendarios/criando-calendarios

Como criar e configurar calendários na Unefesta.

## Passo a passo

1. Acesse **Calendários** no menu principal
2. Clique em "Criar Novo Calendário"
3. Preencha as informações:
   - Nome do calendário
   - Fuso horário
   - Cor (opcional)
   - Horário de funcionamento
   - Feriados extras (opcional)
4. Opcionalmente marque **Permitir vários itens do mesmo pedido no mesmo período** (ver abaixo)
5. Configure flexível ou sequencial
6. Salve o calendário
7. Vincule produtos/kits (na criação/edição do calendário ou no produto)

## Compartilhamento no mesmo pedido

Por padrão, **cada reserva ocupa o período**. Se marcar a opção:

> **Permitir vários itens do mesmo pedido no mesmo período**

itens do mesmo pedido compartilham **1 vaga**; você define capacidade entre clientes e quem escolhe a data.

⚠️ Só vale para produtos/kits com **calendário habilitado e sem estoque**. Com estoque, a disponibilidade continua independente por produto.

### Com a opção ligada

- **Quem define a data**
  - **Cliente escolhe a data** — grade após o frete (quando houver)
  - **Sistema agenda; você pode alterar depois** — primeira janela válida; realoque em Pedidos
- **Máximo de pedidos por período** — vazio = ilimitado; valores > 1 permitem vários clientes no mesmo período

Detalhes: [Encomendas e disponibilidade](./encomendas-e-disponibilidade.md).

**Ops do vendedor:** as filas (Agenda de Encomendas, Agenda de Serviços, Separação, Despacho) seguem o **tipo do item** (`sale` / `service` / `rent`), não esta opção do calendário.

## Calendários: outras configurações

### Tipo de disponibilidade (flexível vs sequencial)

- **Flexível**: sobreposição de janelas (hora a hora) para o comprador escolher
- **Sequencial**: um evento após o outro, sem sobreposição

Veja [Flexível vs Sequencial](./flexivel-sequencial.md).

### Duração (no produto/serviço)

- Defina a duração mínima e máxima dos eventos, ou duração fixa
- Intervalo em **horas** ou **dias**

### Horário de funcionamento

- Configure os dias e faixas em que aceita reservas
- Fora disso não é possível agendar
- Com calendário no produto, esses dias também entram na conta do **prazo de produção**
- Opcional: **Fechamos em feriados** — feriados nacionais e extras ficam indisponíveis (como fora do expediente) e não contam na produção

### Antecedência mínima

- Tempo mínimo entre "agora" e a primeira data/hora reservável
- Em encomendas, combina com produção + frete — vale o **maior** prazo (produção usa dias de expediente; frete usa seg–sex)

### Feriados

- Feriados **nacionais** são reconhecidos automaticamente
- Use **Feriados extras** para datas locais
- **Fechamos em feriados** (calendário): fecha a agenda nessas datas
- **Exceto feriados** (produto): libera weekday bloqueado em feriado — só se o calendário **não** fechar em feriados
- Detalhes: [Bloqueio semanal e feriados](./bloqueio-semanal-e-feriados.md) e [Guia de configuração](./guia-de-configuracao-de-calendarios.md)

## Associar a produtos / serviços

### Pelo calendário

Na edição do calendário, use **Produtos vinculados**:

- Lista produtos/serviços da loja; use o filtro **Apenas com calendário habilitado** se quiser
- Vincular **adiciona** este calendário aos já ligados no item — **não substitui**
- Itens sem calendário habilitado passam a ter calendário habilitado ao vincular
- Mostra se **controla estoque** e quais **calendários já estão ligados**
- Kits **não** se vinculam aqui: herdam os calendários dos componentes

### Pelo produto/serviço

1. Acesse o produto/serviço
2. Habilite o uso de calendário
3. Selecione o(s) calendário(s)
4. Configure duração e, se quiser, **dias da semana bloqueados** / **Exceto feriados**
5. Salve

## Excluindo um calendário

Você pode excluir (soft delete) um calendário da listagem:

1. Na tela de calendários, clique em **Excluir** no card do calendário desejado
2. Confirme a ação no modal

### O que acontece ao excluir

- O calendário sai da listagem e não pode mais ser editado
- **Todos os produtos e kits vinculados são desvinculados** automaticamente
- Os dados do calendário (eventos, histórico) são preservados internamente
- A ação **não apaga** o calendário do banco de dados

### Restrições

- ⚠️ **Calendários sincronizados com o Google Agenda não podem ser excluídos.** Você precisa [cancelar a sincronização](./google-agenda.md#cancelar-sincronização) antes de excluir.
- Apenas o **proprietário** do calendário pode excluí-lo (calendários compartilhados não exibem o botão).

## Depois de criar

- Revise se a opção de compartilhamento no pedido combina com o negócio (e com o tipo sale/service/rent)
- Teste na vitrine: frete → data / "a partir de…"
- Em encomenda "sistema agenda", confira a realocação em Pedidos