Agenda

🛂 Permissão: order.view 📍 Caminho: Operações → Agenda

A agenda é uma visão de calendário dos pedidos com data agendada de entrega. Ajuda a planejar a operação por dia/semana e a evitar gargalos.

O que aparece

• Pedidos com data agendada (scheduled_delivery_date definida no checkout ou no painel).
• Janelas de horário configuradas em Frete (time_slots).
• Capacidade utilizada vs. disponível por slot.

Visualizações

• Mês — visão macro, contagem por dia.
• Semana — slots de cada dia, com pedidos.
• Dia — detalhe completo: cada pedido, cliente, status, motorista atribuído.

Como usar no dia a dia

1. Pela manhã, abra o Dia.
2. Cheque a quantidade de pedidos por slot — se um slot está sobrecarregado, redistribua mudando a janela do pedido (editando o pedido).
3. Atribua motoristas e crie rotas a partir da agenda.
4. No fim do dia, confirme que todos os pedidos foram concluídos.

Como o cliente agenda

• Na loja online, se a configuração de frete tiver delivery_schedule.enabled = true, o cliente vê o calendário no checkout e escolhe dia + horário.
• Se você criar o pedido manualmente, defina a data agendada no formulário.

Cutoff (antecedência mínima)

O parâmetro cutoff_hours em delivery_schedule impede o cliente de agendar slots com menos de N horas de antecedência. Ajuste para a sua janela operacional (ex.: pedidos para o dia precisam entrar até 2h antes).

Boas práticas

• Use slots mesmo que sua operação seja flexível — dá previsibilidade ao cliente e à equipe.
• Reserve slots especiais (ex.: 09:00 e 14:00) para pedidos grandes e agende somente nesses horários.
• Em datas críticas (Black Friday, Natal), abra mais slots com antecedência ou desligue novos agendamentos para datas saturadas.