Este guia explica as opções do calendário: comportamento no carrinho, capacidade entre pedidos e quem define a data.
Três eixos (independentes)
| Campo | O que controla |
|---|---|
| Permitir vários itens do mesmo pedido no mesmo período | Composição do carrinho: vários itens = 1 ocupação (ligado) ou 1 opção bloqueia as outras (desligado) |
| Máximo de pedidos diferentes por período | Capacidade entre clientes/pedidos distintos (unidade = pedido) |
| Quem define a data | Cliente escolhe na grade ou sistema aloca a primeira janela |
⚠️ Só vale para produtos/serviços com calendário habilitado e sem controle de estoque. Com estoque, a disponibilidade continua por produto. Kits herdam a regra de cada componente.
Agenda exclusiva (compartilhamento desligado)
- No mesmo pedido, não há overlap no mesmo calendário/período (quantidade > 1 ou kit multi-componente ainda exigem N agendas distintas).
- Máximo de pedidos: padrão 1 ao criar/desligar shared. Vazio = ilimitado — o painel pede confirmação do risco ao salvar.
- Vários clientes no mesmo horário: suba o máximo (ex.: 2) ou deixe vazio (ilimitado) se a operação realmente atender.
- Quem define a data também vale aqui (cliente ou sistema).
- Ao salvar com máximo vazio ou > 1, o painel pede confirmação (vazio grava ilimitado.
Pedido compartilhado (opção ligada)
O que muda
Mesmo pedido, mesma vaga
Ex.: bolo + doces no mesmo horário no mesmo pedido = 1 ocupação, não duas.Pedidos diferentes
Até o máximo de pedidos por período (ou ilimitado, se deixar o campo vazio).
Valores maiores que 1 permitem vários clientes no mesmo período — use com cuidado.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
Prazo mínimo (lead)
A primeira data possível usa o maior entre:
- antecedência do calendário (
minBefore), e - produção do item (dias de funcionamento do calendário; pula feriado se Fechamos em feriados) + dias de frete (seg–sex; pula feriado nacional), quando houver.
Detalhes: Guia de configuração de calendários.
Multi-dia
- Compartilhamento de 1 dia: a opção “dias bloqueados no meio” do calendário não altera a grade.
- Multi-dia com cliente escolhe: extremos livres; meio estrutural ignorável se a flag estiver ativa.
- Kit misto (exclusive + shared): uma única data; o span só aparece se ambos tiverem janela naquele período.
Cancelamento com data agendada
Pedidos pagos com data usam as faixas de retenção da política da loja. Sem data, o cancelamento vai para análise da loja. Detalhes: Solicitações pós-venda.
Capacidade por janela
Com capacidade limitada (ex.: máximo 1 pedido por período), a contagem de vagas é por janela (dia/horário), por pedido distinto, sem “travar” o intervalo inteiro da consulta.
Kits
- Kits não selecionam calendários: herdam dos componentes. Veja Estoque e disponibilidade.
- Se o kit mistura calendário exclusivo e compartilhado nos componentes, o comprador usa uma única escolha de data.
- Se todos os calendários “sistema agenda” dos componentes forem nesse modo, a página segue o modo a partir de….
- O kit só fica disponível se todos os componentes estiverem livres no mesmo período.
- Exclusive no kit: componentes com calendário exclusivo não compartilham a mesma agenda no mesmo período (precisam de agendas distintas), mesmo com máximo > 1.
Copy no anúncio (comprador)
- Venda (sale) com compartilhamento: a UI pode falar em data da encomenda.
- Serviço / locação: linguagem de disponibilidade / período, mesmo com a opção ligada.
Fluxo de reserva e reagendamento
- Sistema agenda — o vendedor informa novo início e fim livremente no painel.
- Pedido criado pelo vendedor em calendário exclusive — pode remanejar sem revalidação de disponibilidade.
- Cliente escolhe a data — reagendamento com checagem de disponibilidade; comprador é avisado no chat.
- Reservas de pedidos feitos pelo comprador em calendário exclusivo cliente escolhe a data não podem ser alteradas pelo painel do vendedor (cancelar/recriar se necessário), apenas quando sistema aloca.
Operação do dia (ops)
Filas do painel Operação do dia:
| Fila | Critério |
|---|---|
| Agenda de Encomendas | Itens sale com agendamento / onDemand |
| Agenda de Serviços | Itens service |
| Separação | Itens rent |
| Despacho | Itens sale (etiqueta se frete transportadora) |
A opção do calendário não escolhe a fila — o transactionType do item escolhe.