> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bulkroute.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Como Agendar uma Entrega

> Agende entregas com janelas de horário e restrições de condomínio — sem dor de cabeça.

## Quando usar

Seu cliente mora em condomínio que só aceita entrega das 14h às 18h? Precisa agendar uma janela específica? O BulkRoute suporta agendamento com janelas de horário.

## Janelas de horário disponíveis

| Janela          | Horário                                  |
| :-------------- | :--------------------------------------- |
| **Manhã**       | 08h às 12h                               |
| **Tarde**       | 13h às 18h                               |
| **Noite**       | 18h às 22h                               |
| **Customizada** | Horário específico (definido pelo admin) |

## Agendar pelo painel

1. Acesse **Pedidos** > **Envios** (`/admin/shipments`)
2. Abra o envio que quer agendar
3. Na seção **Agendamento**, defina:
   * **Data** da entrega
   * **Janela** (Manhã, Tarde, Noite ou Customizada)
   * **Observações** (ex: "Condomínio só aceita das 14h às 18h, portão 3")
4. Salve — o motorista recebe a janela no app

<Note>
  As janelas de horário são **informativas** — o motorista vê a janela e as observações no app. O BulkRoute não bloqueia a entrega fora da janela, mas o motorista é instruído a respeitar.
</Note>

## Agendar via API

Se você tem e-commerce e quer agendar no checkout:

```bash theme={null}
curl -X PATCH "https://api.bulkroute.com.br/api/orders/{id}/scheduling" \
  -H "X-API-Key: bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledDate": "2026-09-15",
    "deliveryWindow": "AFTERNOON",
    "notes": "Condomínio só aceita das 14h às 18h"
  }'
```

Valores aceitos para `deliveryWindow`: `MORNING`, `AFTERNOON`, `EVENING`, `CUSTOM`.

## Consultar janelas disponíveis

Para mostrar janelas no seu checkout:

```bash theme={null}
curl -X GET "https://api.bulkroute.com.br/api/orders/scheduling/options?zip=01310100" \
  -H "X-API-Key: bk_live_..."
```

Retorna as janelas disponíveis para o CEP informado.

## Reagendamento

Se a entrega falhou e precisa reagendar:

1. Abra o envio com status `FAILED`
2. Na seção **Agendamento**, defina nova data e janela
3. Salve — o motorista recebe a nova janela

O destinatário também pode reagendar pelo link de rastreio público (se habilitado).

<Accordion title="Lembrete automático de agendamento">
  O BulkRoute envia um **lembrete automático** ao destinatário antes da janela de entrega:

  * Enviado na manhã do dia da entrega
  * Por E-mail e SMS (canais ativos)
  * Inclui data, janela e observações
</Accordion>