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)
   ├── Opção: permitir vários itens do mesmo pedido no período (sim/não)
   ├── Antecedência mínima, fuso, cor
   ├── Flexível ou sequencial
   ├── Horário de funcionamento
   ├── Feriados extras
   ├── Bloqueios manuais / Google / compartilhamento
   └──
PRODUTO OU KIT (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

Regra de ouro: o calendário sozinho não vende nada. O item precisa ter “Habilitar calendário” marcado e o(s) calendário(s) selecionado(s).

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
Documentação na loja	“Entenda como funciona o calendário”

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

Vá em Calendários → Criar Novo Calendário (ou “Criar Novo Calendário” no formulário do produto).
Preencha:
- Nome (ex.: “Agenda Ana — Buffet”, “Encomendas confeitaria”)
- Permitir reservar após X horas/dias (antecedência mínima)
- Fuso horário
- Cor (ajuda a identificar na lista)
Escolha o Tipo de uso do calendário (seção abaixo — é a decisão mais importante).
Escolha Início flexível ou Início sequencial. Opcional: Permitir reserva com dias bloqueados no meio (só duração em dias).
Informe Horários de funcionamento (faixas Início/Fim + ao menos um dia da semana).
- 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: / Fechado: com o que você configurou.
Opcional: Feriados extras (municipais / datas especiais da loja).
Opcional: vincule Produtos e kits já existentes.
Clique em Criar calendário.
No produto/kit: marque Habilitar calendário, selecione este calendário e configure duração / dias bloqueados.

5. Os dois tipos de uso do calendário

Ao criar ou editar, a tela mostra:

Botão na tela	Ideia	Exemplo típico
Opção desligada	“1 reserva bloqueia o horário.”	Fotógrafo, espaço, buffet presencial
Opção ligada (mesmo pedido no período)	“Mesmo pedido compartilha horário; capacidade entre clientes.”	Bolo/doces sob encomenda, recreação montar com várias oficinas, buffet de carrinhos opcionais

⚠️ Aviso da tela: a opção só vale para produtos/kits com calendário habilitado e sem controle de estoque. Se o item tiver estoque, o comportamento volta a ser exclusive.

5.1 Agenda de recurso — quando usar

Use quando uma pessoa, um espaço ou um equipamento não pode atender dois clientes no mesmo horário.

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 Agenda de recurso, 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 Encomendas / entregas — quando usar

Use quando o “horário” é na prática data de produção/entrega, e vários itens do mesmo pedido (bolo + doces) devem ocupar uma vaga só.

Só funciona bem se: calendário = Encomendas e produto/kit = calendário ligado e sem estoque.

Ao escolher este tipo, 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 Encomendas / entregas, 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/kit + 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 / kit

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:
- Fixa — sempre a mesma
- Mínima e máxima — o comprador escolhe dentro do intervalo
- Intervalo em horas ou dias (alinhar com a precificação: por hora → horas; por dia → dias)
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 e kits vinculados.
Útil para ver de uma vez quem já está ligado e se controla estoque.

Vários calendários no mesmo item

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

Kits

Kit pode herdar calendário dos componentes.
Kit misto (um item de agenda de recurso + outro de encomenda): o comprador faz uma única escolha de data.
Se todos forem “sistema agenda”, prevalece a UI de “a partir de…”.

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.

Encomendas / entregas não se aplicam a itens com estoque.

11. Casos de uso prontos (copie e adapte)

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

Calendário: Agenda de recurso
Cardápios: sem estoque, todos no mesmo calendário
Duração: conforme o evento (ex. 4–6 horas)
Resultado: 1 festa por horário

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 de recurso)
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 recurso)
Cada item: com estoque + calendário ligado
Resultado: reservas independentes por produto

E) Confeitaria — cliente escolhe data de entrega

Calendário: Encomendas / entregas + Cliente escolhe a data
Máximo de pedidos por horário realista
Produtos: sem estoque + produção em dias úteis + frete se houver

F) Encomenda — loja agenda e depois ajusta

Calendário: Encomendas / entregas + 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/kits 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

Tipo certo: recurso vs encomenda
Encomenda 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 com Habilitar calendário + calendário(s) certo(s)
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 de recurso	1 reserva ocupa o horário
Encomenda	Capacidade por pedido/janela; mesmo pedido = 1 vaga
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.