Introdução

Além de poder receber seu pedido em casa, o usuário pode escolher fazer o pedido pelo iFood e retirá-lo no restaurante. A retirada pode ser feita no balcão, drive-thru ou até mesmo em uma vaga especial.Conheça todos os detalhes sobre esse recurso no Portal do Parceiro.Como habilitar o Para retirar Para habilitar esse recurso para a sua loja, acesse o Portal do Parceiro e em seguida clique no menu "Serviços". Lá você encontrará todas as instruções necessárias.

Integração

Pedidos "Pra Retirar" 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 "Para retirar"

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

Não trate um pedido "Para Retirar" como um pedido "Delivery" É importante que você diferencie esse tipo de pedido, pois diferente de um pedido "DELIVERY", seu aplicativo não deve despachar um pedido "Para retirar".

O que muda nos detalhes do pedido

Além do campo orderType mencionado acima, nesses pedidos temos o grupo "takeout" contendo as seguintes informações:

mode
takeoutDateTime

mode Específica onde o cliente fará a retirada do pedido.

DEFAULT - Quando o cliente retira o pedido no balcão.
PICKUP_AREA - cliente aguardará o recebimento do pedido em uma vaga especial no estabelecimento (estacionamento / drive-thru)

takeoutDateTime Horário previsto para a retirada do pedido.Ex:

"takeout": {
  "mode": "DEFAULT / PICKUP_AREA:",
  "takeoutDateTime": "2020-01-01T00:00:00.000Z"
}

O que muda no ciclo de vida do pedido

Pedido pronto para retirar

É essencial que você disponibilize um botão para que o usuário do seu aplicativo possa informar que o "Pedido está pronto para retirar".Diferentemente de um pedido delivery que seu aplicativo deve enviar a request de /dispatch, nos pedidos "Pra retirar" você deve enviar a request /readyToPickup para notificar o cliente que o pedido está pronto para ser retirado.Quando essa request é enviada, o cliente recebe uma notificação no aplicativo informando que o pedido está pronto.

Vaga especial para retirar o pedido

Quando o cliente escolhe retirar o pedido em uma vaga especial, ao receber a notificação de que o pedido está pronto ele deve ir até a loja. Assim que ele estacionar na vaga especial, ele poderá informar o número da vaga.

Configuração de vaga especial O uso de vaga especial para entrega do pedido é opcional e os nomes ou números das vagas devem ser informados nas configurações da loja.

Assim que o usuário informa a vaga, você receberá no próximo polling o evento PICKUP_AREA_ASSIGNED e no campo PICKUP_AREA_CODE você terá o número da vaga.Esse deve ser o número informado na tela do seu aplicativo para que o atendente possa localizar o cliente e levar o pedido até ele.Exemplo:

{
  "id": "d585214c-b95a-4c4d-9d05-16f7d8f99999",
  "code": "PAA",
  "fullCode": "PICKUP_AREA_ASSIGNED",
  "orderId": "169e6c99-93e9-43b2-981a-498817088888",
  "createdAt": "2020-01-01T00:00:00.000Z",
  "metaData": {
    "PICKUP_AREA_CODE": "1",
    "PICKUP_AREA_TYPE": "NUMBER"
  }
}

Identificação de pedidos via Totem (Self-service)

Os pedidos gerados em Totem devem ser identificados pelo campo category presente nos detalhes do pedido com o valor: FOOD_SELF_SERVICE. Esse marcador indica que o pedido segue o fluxo de autosserviço para a categoria FOOD (veja ciclo de vida aqui).Para pedidos com category = FOOD_SELF_SERVICE, utilize o campo orderType nos detalhes do pedido para direcionar o atendimento:

TAKEOUT — Pedido “para viagem”: o atendente deve embalar para o cliente levar.
DINE_IN — Pedido “para comer aqui”: o atendente deve preparar para consumo no local.

Campos específicos quando orderType = DINE_IN