Guia completo do calendário Unefesta

Este documento explica todas as formas de usar o calendário na Unefesta, com exemplos do dia a dia e o passo a passo de configuração.

1. Em uma frase: para que serve?

O calendário controla quando o comprador pode reservar ou encomendar um produto/serviço (fotógrafo, buffet, locação, bolo, etc.). Ele evita que duas pessoas peguem o mesmo horário quando isso não pode acontecer — ou organiza a capacidade de encomendas quando várias entregas no mesmo dia fazem sentido.

Importante: o comprador final não vê uma tela de “Calendários”. Ele só escolhe datas na vitrine/carrinho/checkout. Quem configura e acompanha a agenda é o vendedor em Calendários no painel.

2. Mapa mental (como as peças se encaixam)

CALENDÁRIO (regras gerais da agenda)
   ├── Estilo: agenda exclusiva ou pedido compartilhado (+ máx. pedidos e quem define a data nos dois)
   ├── Antecedência mínima, fuso, cor
   ├── Flexível ou sequencial
   ├── Horário de funcionamento (+ Fechamos em feriados)
   ├── Reservas com dias bloqueados no meio (duração em dias)
   ├── Feriados extras
   ├── Bloqueios manuais / Google / compartilhamento
   └──
PRODUTO / SERVIÇO (liga o calendário e afina a regra)
   ├── Habilitar calendário + escolher quais calendários consultar
   ├── Com ou sem estoque  ← muda muito o comportamento!
   ├── Duração (fixa ou mín/máx, em horas ou dias)
   ├── Dias da semana bloqueados
   └── Exceto feriados

KIT (não seleciona calendário)
   └── Herda calendário/estoque dos componentes (disponibilidade = TODOS livres no mesmo período)

Regra de ouro: o calendário sozinho não vende nada. O produto/serviço precisa ter “Habilitar calendário” marcado e o(s) calendário(s) selecionado(s). Kits herdam dos componentes — não há seletor de calendário no kit.

3. Onde clicar no painel

O que fazer	Caminho
Ver / criar calendários	Menu → Calendários
Criar	Criar Novo Calendário
Ver agenda, bloqueios, Google	Abrir o calendário → Ver detalhes
Editar regras	No calendário → Editar
Compartilhar com outro vendedor Unefesta	No calendário → Compartilhar
Tratar eventos do Google	No calendário → Ver eventos importados
Ligar calendário a um produto	Produto/serviço → seção Calendário → Habilitar calendário
Ver se kit usa calendário	Kit → Calendário e Disponibilidade (somente leitura; herda dos componentes)
Documentação na loja	“Entenda como funciona o calendário”

4. Passo a passo: criar um calendário do zero

O formulário segue estas seções (mesma ordem da tela). Detalhe campo a campo: Criando calendários.

Vá em Calendários → Criar Novo Calendário (ou “Criar Novo Calendário” no formulário do produto).
Identificação: Nome, Cor, Fuso horário padrão.
Antecedência mínima: Permitir reservar após X + unidade (horas/dias).
Estilo do calendário: Agenda exclusiva ou Pedido compartilhado (seção 5 — decisão mais importante). Com compartilhado: quem define a data + máximo de pedidos por período.
Geração de horários: Início flexível ou Início sequencial.
Horários de funcionamento (faixas Início/Fim + ao menos um dia da semana) e, se quiser, Fechamos em feriados.
- Obrigatório marcar dias: esses dias são a janela bookable e entram na conta do prazo de produção.
- Dia inteiro: início 00:00 e fim 23:59.
- A tela mostra o resumo Aberto: / fechados.
Opcional: Reservas com duração em dias → Permitir reserva com dias bloqueados no meio.
Opcional: Feriados extras (municipais / datas especiais da loja).
Opcional: vincule Produtos / Serviços já existentes (kits não aparecem — herdam dos componentes).
Clique em Criar calendário.
No produto/serviço: marque Habilitar calendário, selecione este calendário e configure duração / dias bloqueados.

5. Os dois estilos do calendário

Na tela: Estilo do calendário — Agenda exclusiva ou Pedido compartilhado.

Estilo	O que acontece no período	Exemplo típico
Agenda exclusiva (padrão)	Só uma reserva ocupa aquele período na agenda. Qualquer outro produto/serviço que consulte o mesmo calendário não pode ir no mesmo horário.	Fotógrafo, espaço, buffet presencial
Pedido compartilhado	Itens do mesmo pedido podem ocupar o mesmo período (contam como 1 vaga). Entre pedidos de clientes diferentes, vale o máximo de pedidos por período.	Bolo + doces no mesmo pedido; várias oficinas no mesmo pedido

⚠️ A opção de compartilhamento só vale para produtos/serviços com calendário habilitado e sem estoque. Com estoque, o comportamento volta a ser exclusive. Em kits, vale a regra de cada componente.

5.1 Agenda exclusiva — quando usar

Use quando uma pessoa, um espaço ou um equipamento não pode atender dois clientes (nem dois produtos da mesma agenda) no mesmo horário.

Regra: naquele calendário, um período = uma ocupação por pedido (máximo padrão 1). Se o pacote Premium reserva sábado 14h–18h, o Básico e o Luxo (ligados à mesma agenda) somem daquele horário no carrinho — e um segundo cliente só entra se o máximo de pedidos for maior que 1.
Exemplos

Negócio	Configuração sugerida
Fotógrafa com 3 pacotes	1 calendário “Agenda Maria”, sem estoque nos 3 pacotes, todos no mesmo calendário
Buffet com cardápios Básico / Premium / Luxo	1 calendário; cardápios sem estoque; reserva de qualquer cardápio bloqueia o horário para os outros
Empresa com 3 recreadores	3 calendários (um por pessoa); o mesmo serviço ligado aos 3; o comprador vê vaga se pelo menos um estiver livre

Passo a passo (fotógrafo)

Criar calendário com estilo Agenda exclusiva, nome “Agenda João”.
Antecedência: ex. 2 dias.
Horário: ex. 08:00–18:00, seg–sáb.
Flexível ou sequencial conforme o estilo de atendimento (ver seção 6).
Nos pacotes: Habilitar calendário → selecionar “Agenda João” → duração (ex. fixa 4 horas) → sem estoque.

O que o comprador vê: seção Disponibilidade / escolha de período; CTAs do tipo Reservar, Agendar, etc.

5.2 Pedido compartilhado — quando usar

Use quando mais de um produto/serviço pode (e deve) caber no mesmo período, sobretudo no mesmo pedido — o “horário” vira data de produção/entrega ou janela compartilhada da operação.

Regra: itens do mesmo pedido no mesmo período = 1 vaga (ex.: bolo + doces). Pedidos de clientes diferentes no mesmo período só até o máximo configurado.

Só funciona bem se: estilo = Pedido compartilhado e produto/serviço = calendário ligado e sem estoque.

Ao ligar o compartilhamento, aparecem mais dois campos:

Quem define a data

Opção na tela	O que acontece
Cliente escolhe a data	Comprador vê a grade (em geral depois do frete, quando há frete)
Sistema agenda; você pode alterar depois	Sistema reserva a primeira janela válida; comprador vê algo como “a partir de…”; vendedor realoca em Pedidos

Máximo de pedidos por horário

Vazio = ilimitado (cuidado com a operação real).
1 = só um pedido de cliente diferente por janela (mais seguro).
> 1 = vários clientes no mesmo período — a tela avisa em vermelho.

Exemplo — confeitaria

Calendário Pedido compartilhado, nome “Encomendas doces”.
Quem define: Cliente escolhe a data.
Máximo: 5 (cinco entregas no mesmo dia, se a cozinha aguentar).
Antecedência: 3 dias (ou deixe a produção do produto fazer o peso maior — ver lead time).
Produtos bolo/doces: sem estoque, calendário habilitado, duração em dias se a unidade de preço for por dia / entrega por data.

Mesmo pedido: bolo + doces no mesmo horário = 1 ocupação, não 2.

6. Flexível vs sequencial (tipo de disponibilidade)

Configurado no calendário: Tipo de disponibilidade no calendário.

Início flexível

Cria janelas de hora em hora com sobreposição.

Exemplo com duração de 2 horas:

08:00 às 10:00
09:00 às 11:00   ← sobrepõe
10:00 às 12:00   ← sobrepõe

Quando usar: o cliente pode começar em horários diferentes (ex. foto das 9h ou das 10h).

Início sequencial

Um bloco depois do outro, sem sobreposição.

08:00 às 10:00
10:00 às 12:00
12:00 às 14:00

Quando usar: precisa de turnos limpos, tempo de montagem/desmontagem, ou menos conflito entre reservas.

7. Antecedência mínima e prazo de encomenda

No calendário: Permitir reservar após X horas/dias.

Em encomendas, a primeira data possível usa o maior entre:

Antecedência mínima do calendário
Dias úteis de produção do produto/serviço (ou do kit, se sob encomenda) + dias úteis de frete/deslocamento (quando o frete já foi escolhido)

Assim o sistema não oferece um dia em que a loja não conseguiria produzir e entregar a tempo.

Ordem na vitrine (com frete): frete primeiro → depois data / disponibilidade já com o prazo do frete.

8. Horário de funcionamento

No calendário, liste faixas Início / Fim e marque os dias (dom…sáb).

Fora dessas faixas não dá para agendar.
É obrigatório ter ao menos uma faixa com pelo menos um dia marcado. Sem isso a grade não abre e o formulário bloqueia o save.
Os dias marcados também entram na conta do prazo de produção (com calendário no produto).
Dia inteiro nos dias marcados: 00:00–23:59.
A tela e a visualização mostram Aberto: / Fechado: com o resumo da configuração.
Evite faixas sobrepostas no mesmo dia (o formulário valida isso).

9. Ligar o calendário no produto / serviço

Pelo produto (mais comum)

Abra o produto/serviço (variant).
Marque Habilitar calendário.
Selecione quais calendários serão consultados (ou Criar Novo Calendário).
Configure Duração (limites e alinhamento com precificação: Configuração de duração):
- Fixa — sempre a mesma (comprador não escolhe duração)
- Mínima e máxima — o comprador escolhe dentro do intervalo (opções na vitrine)
- Intervalo em horas ou dias — com precificação por hora/dia, o intervalo é travado na unidade correspondente
Opcional: Dias da semana bloqueados + Exceto feriados.
Defina se usa estoque ou não (isso muda o impacto das reservas — seção 10).
Salve.

Pelo calendário

Na criação/edição: seção Produtos / Serviços vinculados.
Útil para ver de uma vez quem já está ligado e se controla estoque. Kits não entram nessa lista.

Vários calendários no mesmo item

Disponibilidade aparece se pelo menos um calendário tiver vaga (caso clássico: vários recreadores).

Kits (herança — sem seletor)

Kits não permitem selecionar calendários. calendarEnabled / estoque vêm da composição (OR dos componentes).
Na edição do kit, a seção Calendário e Disponibilidade é só leitura (“Sim/Não”) + explainer da regra E.
Configure calendário, duração e estoque em cada componente (produto/serviço).
Kit misto (um item de agenda exclusiva + outro de pedido compartilhado): o comprador faz uma única escolha de data.
Se todos forem “sistema agenda”, prevalece a UI de “a partir de…”.
Disponibilidade: o kit só vende se todos os componentes estiverem livres no mesmo período — ver Estoque e disponibilidade.

10. Com estoque vs sem estoque (o “truque” que mais confunde)

Mesmo calendário, comportamentos diferentes:

Sem estoque + mesmo calendário

Uma reserva bloqueia o horário para todos os produtos ligados àquele calendário.

Exemplo	Efeito
Cardápio Básico, Premium e Luxo no mesmo calendário	Cliente reserva Premium no sábado → Básico e Luxo também somem naquele horário

Ideal para recurso único (você, a equipe do buffet, o salão).

Com estoque + mesmo calendário

A reserva afeta só aquele produto (e a quantidade).

Exemplo	Efeito
Bandeja azul e bandeja vermelha no mesmo calendário	Alugar a azul não impede alugar a vermelha no mesmo dia

Ideal para locação de itens (bandejas, fantasias, mesas) sem criar um calendário por SKU.

Pedido compartilhado não se aplica a itens com estoque.

11. Casos de uso prontos (copie e adapte)

A) Buffet presencial — vários cardápios, uma equipe

Calendário: Agenda exclusiva
Cardápios: sem estoque, todos no mesmo calendário
Duração: conforme o evento (ex. 4–6 horas)
Resultado: 1 festa por horário — qualquer cardápio ocupado bloqueia os outros naquele período

B) Fotógrafo — vários pacotes

Igual ao A, com pacotes no lugar dos cardápios
Bloqueio manual nas férias = nenhum pacote disponível

C) Empresa de recreação — N profissionais, mesmo serviço

Um calendário por recreador (todos Agenda exclusiva)
No serviço: selecionar todos os calendários
Resultado: vende se qualquer recreador estiver livre

D) Locação de bandejas / fantasias

Um calendário base (pode ser exclusivo)
Cada item: com estoque + calendário ligado
Resultado: reservas independentes por produto (estoque “quebra” o exclusivismo entre SKUs)

E) Confeitaria — cliente escolhe data de entrega

Calendário: Pedido compartilhado + Cliente escolhe a data
Máximo de pedidos por horário realista
Produtos: sem estoque + produção em dias úteis + frete se houver
Resultado: bolo + doces no mesmo pedido = 1 vaga; outros clientes até o máximo

F) Encomenda — loja agenda e depois ajusta

Calendário: Pedido compartilhado + Sistema agenda; você pode alterar depois
Em Pedidos, realocar a data quando combinar com o cliente
Comprador vê prazo a partir de…, não a grade completa

12. Dias da semana bloqueados e feriados

Há dois níveis:

Onde	O quê
Produto	Bloquear domingo, segunda… toda semana; opcional Exceto feriados
Calendário	Feriados extras (município, aniversário da cidade, folga da loja)

Exceto feriados

Desmarcado: segunda bloqueada continua bloqueada mesmo em feriado.
Marcado: se o dia bloqueado cair em feriado nacional ou extra do calendário, aquele dia pode ficar disponível (ainda valem horário comercial, bloqueios manuais, estoque e antecedência).

Exemplo: loja fecha todo domingo, mas quer abrir no Natal → Bloquear domingo + Exceto feriados.

Feriados nacionais (incluindo móveis) entram automaticamente; não precisa cadastrá-los. Só importam se Exceto feriados estiver ativo no produto.

Na listagem de calendários também há painéis de feriados nacionais / extras e opção de sincronizar extras em todos os calendários.

13. Bloqueios manuais (férias, manutenção, “já tenho festa fora”)

Abra o calendário → Ver detalhes.
Só o proprietário pode usar Adicionar bloqueio (compartilhado não).
Informe título, período, se é dia inteiro.
Produtos:
- Sem informar produtos → bloqueia todos os itens do calendário.
- Com estoque → informe produto e quantidade (senão o item pode continuar aparecendo disponível).
Também dá para selecionar no calendário visual e confirmar no modal.

Legenda na tela do calendário

Status	Significado
Importado: Aguardando tratamento	Veio do Google, ainda não decidido
Bloqueado	Bloqueio manual / tratado
Pagamento confirmado	Reserva paga (pedido)
Aguardando pagamento	Pré-reserva no checkout
Cancelado	Cancelado
Feriado nacional / extra	Datas de feriado

Fluxo de reserva (lembrar na operação)

Carrinho → ainda não trava de forma definitiva
Checkout / link de pagamento → pré-reserva (ocupa a vaga)
Pagamento ok → reserva paga
Pagamento negado / erro → pré-reserva liberada

14. Google Agenda

Feature de integração (quando ativa na loja).

Passo a passo

Em Calendários, integrar com Google e autorizar.
Abrir o calendário Unefesta → escolher o calendário Google → Sincronizar Eventos.
Ir em Ver eventos importados (ou link do e-mail).
Para cada evento:
- Salvar / sincronizar → passa a bloquear na Unefesta
- Não importar → some da Unefesta, fica no Google, não bloqueia a loja
Depois da primeira rodada, a sync continua; “Não importar” só volta a aparecer se o evento mudar no Google.

Cuidados

Calendário compartilhado (você não é dono): não sincroniza com Google.
Trocar o Google syncado pode gerar conflitos.
Excluir eventos importados remove só na Unefesta.
Não dá para excluir o calendário Unefesta enquanto a sync Google estiver ativa — cancele antes.
Bloqueio de itens com estoque deve ser feito na Unefesta com produto + quantidade (o Google sozinho não resolve estoque).

15. Compartilhar calendário (entre vendedores Unefesta)

Não é um link público para o comprador. É ACL por e-mail de usuário já cadastrado na Unefesta.

No calendário (como dono) → Compartilhar.
Digite o e-mail → Compartilhar.
O outro usuário vê o calendário na lista (indicado como compartilhado).

Quem recebe o compartilhamento

Na prática da tela atual:

Pode ver a agenda / detalhes
Não pode: editar configurações, adicionar bloqueio, compartilhar de novo, nem sincronizar Google

O dono vê a lista de quem tem acesso e pode Remover.

Compartilhamento antigo “via Google Calendar” não é mais suportado. Use só o compartilhamento da Unefesta.

16. Remarcar data em Pedidos

Situação	Vendedor pode remarcar?
Encomenda sistema agenda	Sim — informa novo início/fim (útil para ajustar o que o sistema escolheu)
Encomenda cliente escolhe	Sim — com checagem de disponibilidade; alinhar com o comprador (ele é avisado no chat)
Pedido criado no checkout do vendedor (agenda de recurso)	Sim
Pedido feito pelo comprador em agenda de recurso	Não pelo painel — cancelar/recriar se necessário

17. Excluir um calendário

Na listagem, Excluir (só o dono).
Confirmar.

Efeitos:

Some da listagem; produtos/serviços são desvinculados
Dados ficam preservados internamente (soft delete)
Se houver Google sync: cancele a sync antes

18. Checklist rápido antes de liberar uma loja

Estilo certo: exclusiva vs pedido compartilhado
Pedido compartilhado só em itens sem estoque
Quem define a data alinhado ao processo da loja
Máximo de pedidos por horário realista
Antecedência + produção + frete conferidos
Flexível vs sequencial faz sentido para o serviço
Horário de funcionamento preenchido (ou de propósito em branco)
Produtos/serviços com Habilitar calendário + calendário(s) certo(s)
Kits: calendário configurado nos componentes (não no kit)
Duração e unidade (horas/dias) coerentes com o preço
Dias bloqueados / Exceto feriados se a loja fecha em dias fixos
Teste na vitrine: frete → data → carrinho → checkout
Se Google: tratamento dos eventos importados feito
Se equipe: compartilhamento só com e-mails Unefesta válidos

19. Erros comuns (e como explicar para o lojista)

Sintoma	Causa provável
“Configurei encomenda mas parece reserva normal”	Item com estoque ligado
“Reserva do cardápio A tirou o B”	Sem estoque + mesmo calendário (comportamento esperado de recurso compartilhado)
“Queria que a bandeja azul não atrapalhasse a vermelha”	Precisa estoque em cada item
“Cliente não vê data”	Calendário não habilitado no produto, ou horário/antecedência/produção/frete fechando tudo
“Domingo abriu no feriado e eu não queria”	Exceto feriados marcado
“Google sincronizou mas item com estoque ainda aparece”	Bloqueio sem quantidade no produto
“Não consigo excluir o calendário”	Sync Google ainda ativa
“Compartilhei e a pessoa não consegue bloquear”	Só o dono bloqueia — esperado

20. Glossário rápido

Termo	Significado
Slot	Evento/período no calendário (bloqueio, pedido, checkout…)
Pré-reserva	Ocupação enquanto o pagamento está pendente
Agenda exclusiva	1 reserva ocupa o período; outros produtos na mesma agenda não entram nesse horário
Pedido compartilhado	Mesmo pedido = 1 vaga no período; entre clientes, até o máximo configurado
Flexível / sequencial	Como as janelas de horário são oferecidas
Lead / antecedência	Quanto tempo mínimo até a primeira data possível
Exceto feriados	Libera dia semanalmente bloqueado se for feriado

21. Para aprofundar (docs irmãs)

Documento orientado a operação e treinamento. Em caso de divergência com a tela, prevalece o comportamento atual do painel do vendedor.