Módulo de Shipping

O módulo de Shipping permite que merchants solicitem o serviço de entrega do iFood para pedidos realizados tanto dentro quanto fora da plataforma. Esta funcionalidade é ideal para merchants que possuem frota própria, mas necessitam de suporte logístico em momentos de alta demanda.

Funcionalidades principais

Solicitar entregadores para pedidos da plataforma iFood ou de canais externos
Verificar disponibilidade de entrega antes de solicitar
Rastrear entregas em tempo real
Receber notificações sobre o status da entrega

Tipos de pedidos

Pedidos na plataforma iFood

Pedidos que já possuem um orderId e contêm todas as informações necessárias (merchant e cliente) para cotação e solicitação de entregador.Casos de uso:

Merchant com frota própria precisa de suporte em horários de pico
Falta temporária de entregadores próprios
Otimização de custos operacionais

Pedidos fora da plataforma iFood

Pedidos realizados por outros canais (telefone, WhatsApp, app próprio) que não possuem orderId. Requerem informações adicionais para cotação e solicitação.

Sob DemandaPara pedidos externos, utilize o serviço Sob Demanda. Saiba mais em: https://news.ifood.com.br/entrega-facil-o-delivery-do-ifood-fora-do-app/

Requisitos

Contratação do serviço

O serviço deve ser contratado através do Portal do Parceiro (menu Serviços). Sem a contratação, não será possível:

Registrar pedidos
Verificar disponibilidade de entrega
Solicitar entregadores

Elegibilidade de pedidos

Nem todos os pedidos são elegíveis para o serviço. Os critérios incluem:

Modelo de negócio: Merchants fullservice já têm logística incluída
Tipo de pedido: Apenas delivery (não disponível para retirada)
Cobertura: Área de entrega deve ser atendida por entregadores parceiros

Verifique sempre a elegibilidade do pedido antes de solicitar um entregador para evitar erros na integração.

Rastreamento de entregas

Obter informações do entregador

As informações do entregador são enviadas através do evento ASSIGN_DRIVER.

Rastrear pedido em tempo real

Use o endpoint GET /tracking para acompanhar a entrega.

Campos retornados

Campo	Tipo	Descrição
latitude	decimal	Latitude atual do entregador (pode ser `null`)
longitude	decimal	Longitude atual do entregador (pode ser `null`)
expectedDelivery	datetime	Previsão de entrega (pode ser `null`)
pickupEtaStart	integer	Tempo estimado (segundos) até coleta. Negativo indica atraso
deliveryEtaEnd	integer	Tempo estimado (segundos) até entrega
trackDate	datetime	Data/hora da consulta (pode ser `null`)

Boas práticas de rastreamento

Quando usar: Somente após receber o evento ASSIGN_DRIVER
Intervalo: Consulte a cada 30 segundos
Erro 404: Aguarde 30 segundos e tente novamente
Rate limit: Respeite os limites para evitar bloqueio

O rastreamento está disponível apenas para pedidos entregues pela logística iFood.

Esta página foi útil?

Avalie sua experiência no novo Developer portal:

Nesta página