Agendamento

Somente Lojas do tipo Catálogo (Mercado/Farmácia/Pet shop) podem ter agendamento de entrega.

Configuração de Faixas de Agendamento de Entrega por Dia da Semana

Este endpoint é utilizado para definir as faixas de horário (slots) em que os clientes podem agendar pedidos para entrega futura. O payload permite controlar o limite de pedidos por faixa de horário e a janela de dias disponíveis para agendamento.

Importante:
É necessário habilitar que a loja permite entrega conforme descrito em Configuração de Horários e Tempo de Serviço.

POST

/store/{store_id}/scheduled-delivery-time-slots

Payload Configuração de Faixas de Agendamento de Entrega por Dia da Semana

{
  "scheduled_delivery_time_slots": [
    {
      "weekday": 1,
      "time_slots": [
        {
          "active": true,
          "start_time": "12:00",
          "end_time": "14:00",
          "max_number_of_orders": 10
        }
      ]
    },
    {
      "weekday": 2,
      "time_slots": [
        {
          "active": true,
          "start_time": "09:00",
          "end_time": "11:00",
          "max_number_of_orders": 5
        },
        {
          "active": true,
          "start_time": "13:00",
          "end_time": "15:00",
          "max_number_of_orders": 5
        },
        {
          "active": true,
          "start_time": "16:00",
          "end_time": "18:00",
          "max_number_of_orders": 2
        }
      ]
    },
    {
      "weekday": 3,
      "time_slots": [
        {
          "active": true,
          "start_time": "08:00",
          "end_time": "10:00",
          "max_number_of_orders": 1
        },
        {
          "active": false,
          "start_time": "13:00",
          "end_time": "15:00",
          "max_number_of_orders": 1
        }
      ]
    },
    {
      "weekday": 4,
      "time_slots": [
        {
          "active": true,
          "start_time": "09:00",
          "end_time": "11:00",
          "max_number_of_orders": 50
        }
      ]
    }
  ],
  "max_scheduled_delivery_days": 3,
  "store_delivery_type": 2
}

Detalhamento do Payload

1. Campos Principais do Payload

Campo	Obrigatório	Descrição
scheduled_delivery_time_slots	✅	Array principal contendo a lista de configurações de horários de agendamento por dia da semana.
max_scheduled_delivery_days	❌	Máximo de Dias para Agendamento. Define a janela máxima de dias, além do dia atual, que o cliente pode selecionar para agendar. Exemplo: Se o valor for 1, o cliente pode agendar para o dia atual + 1 dia seguinte (total de 2 dias). Se o valor for 2, permite agendamento para o dia atual + 2 dias seguintes. Valor máximo permitido = 3.
store_delivery_type	❌	Tipo de modalidade de entrega para o agendamento. Enviar 2 para entregas de agendamento.

2. Objeto scheduled_delivery_time_slots[] (Configuração por Dia)

Campo	Obrigatório	Descrição
scheduled_delivery_time_slots[].weekday	✅	Dia da semana: 1 (Domingo) a 7 (Sábado).
scheduled_delivery_time_slots[].time_slots	✅	Array contendo as faixas de horário configuradas para o dia.

3. Objeto time_slots[] (Detalhe da Faixa de Horário)

Campo	Obrigatório	Descrição
time_slots[].active	✅	Ativa (true) ou desativa (false) a faixa de horário para agendamento.
time_slots[].start_time	✅	Horário de início da faixa de agendamento (formato HH:MM).
time_slots[].end_time	✅	Horário de fim da faixa de agendamento (formato HH:MM).
time_slots[].max_number_of_orders	❌	Quantidade máxima de pedidos que a loja aceita para agendamento nesta faixa de horário.

Importante:

1. Duração da Faixa: A diferença entre end_time e start_time não pode ser maior que 120 minutos (2 horas).
2. Sobreposição: As faixas de horário configuradas para o mesmo dia não podem se sobrepor. (Ex: 08:00 - 10:00 e 09:30 - 11:00 é inválido).
3. A cada chamada, toda a configuração anterior é sobrescrita. Certifique-se de incluir todos os dias e todas as faixas que você deseja manter ativos.
4. São no máximo 12 blocos de horário permitido.

Configuração de Faixas de Agendamento de Entrega por Data Específica

Este endpoint é utilizado para definir faixas de agendamento de entrega para datas específicas, permitindo que a loja ajuste a capacidade (limite de pedidos) em dias de pico ou feriados, sobrescrevendo as configurações semanais padrão (definidas em /scheduled-delivery-time-slots).

POST

/store/{store_id}/custom-scheduled-delivery-time-slots

Payload Configuração de Faixas de Agendamento de Entrega por Data Específica

{
  "custom_scheduled_delivery_time_slots": [
    {
      "date": "2025-11-19",
      "time_slots": [
        {
          "active": false,
          "start_time": "14:53",
          "end_time": "14:53",
          "max_number_of_orders": 1
        }
      ]
    }
  ]
}

Detalhamento do Payload

1. Agendamento Personalizado

Campo	Obrigatório	Descrição
custom_scheduled_delivery_time_slots	✅	Array principal contendo as configurações de agendamento para cada data específica.
custom_scheduled_delivery_time_slots[].date	✅	A data específica na qual as faixas de horário devem ser aplicadas. Formato: YYYY-MM-DD (Ex: "2025-11-19").
custom_scheduled_delivery_time_slots[].time_slots	✅	Array contendo as faixas de horário e capacidade para a data especificada.

2. Detalhamento dos Slots (time_slots[])`

Os campos dentro do time_slots seguem as mesmas regras e validações do agendamento semanal padrão:

Campo	Obrigatório	Descrição
time_slots[].active	✅	Ativa (true) ou desativa (false) a faixa de horário para agendamento nesta data.
time_slots[].start_time	✅	Horário de início da faixa de agendamento (formato HH:MM).
time_slots[].end_time	✅	Horário de fim da faixa de agendamento (formato HH:MM).
time_slots[].max_number_of_orders	✅	Quantidade máxima de pedidos permitidos nesta faixa de horário.

Importante:

• Duração da Faixa: A diferença entre end_time e start_time não pode ser maior que 120 minutos (2 horas).
• Sobreposição: As faixas de horário configuradas para o mesmo dia não podem se sobrepor.