Buscar na documentação

Módulos

Authentication

Merchant

Catalog

Order

Events

Logistics

Shipping

Review

Financial

Soluções

Introdução

O agendamento de pedidos permite que o cliente escolha o melhor horário para receber o seu pedido. Além de oferecer essa facilidade para o cliente, a loja pode também otimizar a sua operação gerenciando melhor a demanda em horários de picos por exemplo e também planejando melhor sua linha de produção.Conheça todos os detalhes sobre esse recurso na página oficial: https://agendamento.ifood.com.br/Como habilitar o agendamento de pedidos? Para habilitar esse recurso para a sua loja, acesse o Portal do Parceiro e abra um chamado solicitando a configuração do agendamento. Você pode definir as janelas de horário que deseja disponibilizar.

Integração

Pedidos agendados exigem um comportamento específico do seu aplicativo e dos usuários dele. Seguem as orientações necessárias para homologar essa funcionalidade no seu aplicativo.

Como identificar um pedido agendado

Para esses pedidos, o campo orderTiming do detalhe do pedido virá preenchido com o valor "SCHEDULED".

Não trate um pedido "SCHEDULED" como um pedido "IMMEDIATE" É importante que você diferencie esse tipo de pedido, pois diferente de um pedido "IMMEDIATE", você só deve enviar/entregar o pedido no horário escolhido pelo cliente.

Tipos de pedidos que permitem agendamento Todos os tipos de pedidos (DELIVERY, TAKEOUT e INDOOR) permitem agendamento.

O que muda nos detalhes do pedido?

Além do campo orderTiming mencionado acima, nesses pedidos temos o grupo "scheduled" contendo as informações específicas sobre o horário agendado pelo cliente:

deliveryDateTimeStart - início da janela de horário do agendamento.
deliveryDateTimeEnd - fim da janela de horário do agendamento.

Além das informações do horário, nos detalhes do pedido você encontrará campos específicos de acordo com a entrega/retirada do pedido:

orderType	campo	descrição
DELIVERY	delivery	informações sobre hora e local de entrega incluindo endereço do cliente
TAKEOUT	takeout	informações sobre a retirada do pedido

Ex:

"schedule": {
  "deliveryDateTimeStart": "2020-01-01T00:20:00.000Z",
  "deliveryDateTimeEnd": "2020-01-01T01:20:00.000Z"
}

O que muda no ciclo de vida do pedido?

Confirmação do pedido agendado

Antes de preparar o pedido, você deve confirmar o recebimento através do endpoint POST /orders/{id}/confirm.Requisição exemplo:

curl -X POST "https://merchant-api.ifood.com.br/order/v1.0/orders/{id}/confirm" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

Este endpoint retorna HTTP 202 (Accepted) indicando que o pedido foi confirmado com sucesso.

Horário de preparo ou separação do pedido

É essencial que você verifique o horário agendado e prepare o pedido somente próximo desse horário.

Envio do pedido antes do horário agendado Se o pedido for enviado imediatamente ou em qualquer horário antes do agendado ele será recusado pelo cliente, o que além de prejudicar a taxa de cancelamento pode causar prejuízo financeiro para a loja.

preparationStartDateTime O campo preparationStartDateTime já calcula o horário recomendado para início do preparo do pedido. Ele é calculado com base na configuração do tempo médio de entrega no cadastro da loja.

Despachar ou avisar que o pedido está pronto

Depois que o pedido estiver pronto, respeitando o preparationStartDateTime você deve utilizar um dos endpoints abaixo de acordo com o tipo de pedido:Para pedidos de DELIVERY - Despachar o pedido:

curl -X POST "https://merchant-api.ifood.com.br/order/v1.0/orders/{id}/dispatch" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

Para pedidos de TAKEOUT e INDOOR - Avisar que o pedido está pronto:

curl -X POST "https://merchant-api.ifood.com.br/order/v1.0/orders/{id}/readyToPickup" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

Ambos os endpoints retornam HTTP 202 (Accepted). Você pode consultar a documentação de cada endpoint em /dispatch ou /readyToPickup.

Dúvidas Comuns

Prazo para confirmação de pedido agendado

O pedido agendado pode ser confirmado a partir do momento em que o seu aplicativo o recebe, mas deve-se respeitar o horário recomendado para preparar e entregar o pedido.A confirmação pode ser enviada até 8 minutos após o preparationStartDateTime. Passados 8 minutos, entendemos que o pedido não está sendo preparado a tempo de ser entregue no horário agendado e o pedido é cancelado automaticamente.

preparationStartDateTime = deliveryDateTimeStart - DeliveryTime (configuração da loja)

Exemplo:
Um pedido entrou às 17:00 e foi agendado para ás 20:00. O tempo de entrega médio da loja é de 40 minutos.O preparationStartDateTime será: 19:20:00 (já que o restaurante precisa de 40 minutos para entregar esse pedido).Nesse caso, esse pedido deve ser confirmado até as 19:28:00. Caso contrário, o pedido será cancelado.

Outros conteúdos que podem ser do seu interesse:

Pedidos DeliveryDocumentação de pedidos "Delivery"

Pra retirarParticularidades de pedidos "Pra retirar"

Esta página foi útil?

Avalie sua experiência no novo Developer portal:

Nesta página