KMódulos
Authentication
Merchant
Catalog
Order
Events
Logistics
Shipping
Review
Financial
Soluções
Shipping
Use a API de Shipping para solicitar entregadores iFood quando sua frota própria estiver sobrecarregada, indisponível ou para expandir sua operação. A API oferece dois modos de operação: pedidos feitos na plataforma iFood e pedidos feitos fora da plataforma.Dois modos de integração
Escolha o modo que melhor se adapta ao seu caso de uso:Pedidos feitos na plataforma iFood
Para pedidos que já existem no sistema iFood comorderId pré-atribuído.| Aspecto | Detalhe |
|---|---|
| Quando usar | Quando você tem pedidos iFood confirmados e precisa de logística |
| Requisitos | Apenas o orderId do pedido |
| Fluxo | Verificar disponibilidade → Solicitar entregador → Rastrear |
| Entregador | Alocado de forma assíncrona |
| Melhor para | Picos de demanda, frota própria sobrecarregada, backup de logística |
POST /shipping/v1.0/orders/{orderId}/requestDriverPedidos feitos fora da plataforma iFood
Para pedidos criados em sistemas externos (WhatsApp, telefone, app próprio, integradores) semorderId iFood.| Aspecto | Detalhe |
|---|---|
| Quando usar | Quando precisa criar pedido + contratar entrega iFood simultaneamente |
| Requisitos | Dados completos de cliente, endereço, itens e pagamento |
| Fluxo | Verificar disponibilidade → Registrar pedido → Gerenciar endereço → Rastrear |
| Entregador | Alocado após criação do pedido |
| Melhor para | Serviço Sob Demanda, integradoras, marketplace, vendas por WhatsApp |
| Segurança | Código de confirmação + nível de confiança de entrega |
POST /shipping/v1.0/merchants/{merchantId}/ordersQual modo escolher?
Quando usar cada modo
Pedidos feitos na plataforma
| Cenário | Exemplo | Ação |
|---|---|---|
| Pico de demanda | Black Friday, horário de rush | Solicite entregadores iFood como backup |
| Frota indisponível | Motoristas faltaram, veículo quebrou | Use logística iFood temporariamente |
| Entrega urgente | Cliente quer em 30 minutos | Aloque entregador iFood rapidamente |
Pedidos feitos fora da plataforma
| Cenário | Exemplo | Ação |
|---|---|---|
| Vendas por WhatsApp | Cliente pede via chat | Crie pedido + contrate entrega iFood |
| Integradora | Sistema de gerenciamento próprio | Sincronize pedidos com logística iFood |
| Marketplace | App de delivery customizado | Ofereça iFood como opção de entrega |
| Serviço Sob Demanda | Cliente precisa de entrega ASAP | Crie sob demanda com entregador iFood |
Próximos passos
- Pedidos iFood? Consulte Pedidos feitos na plataforma
- Pedidos externos? Consulte Pedidos feitos fora da plataforma
- Entender arquitetura? Consulte Como funciona
Tipos de pedido (resumo)
| Tipo | Descrição | Requisitos |
|---|---|---|
| Pedido iFood | Pedido com orderId existente na plataforma | Apenas o orderId |
| Pedido externo | Pedido de outros canais (telefone, WhatsApp, app) | Dados completos de entrega |
Pedidos feitos fora da plataforma: Sob DemandaPara solicitar entregadores para pedidos feitos fora do iFood, use o serviço Sob Demanda.
Pré-requisitos
Antes de usar a API de Shipping:| Requisito | Como resolver |
|---|---|
| Contratar o serviço | Acesse Portal do Parceiro → Serviços |
| Verificar elegibilidade | Confirme que o pedido é DELIVERY (não disponível para retirada) |
| Validar cobertura | Use o endpoint de disponibilidade antes de solicitar |
Merchants fullserviceSe sua loja opera no modelo fullservice, a logística iFood já está incluída. A API de Shipping é destinada a merchants com frota própria que precisam de suporte adicional.
Rastreamento de entregas
Acompanhe a entrega em tempo real após atribuição do entregador. O rastreamento fica disponível após o eventoASSIGN_DRIVER. Antes disso, o endpoint retorna 404 Not Found.Campos de rastreamento
UseGET /tracking para obter a localização atual. Os campos retornados incluem:| Campo | Tipo | Descrição |
|---|---|---|
latitude | decimal | Latitude atual do entregador |
longitude | decimal | Longitude atual do entregador |
expectedDelivery | datetime | Previsão de entrega |
pickupEtaStart | integer | Segundos até coleta (negativo = atraso) |
deliveryEtaEnd | integer | Segundos até entrega |
trackDate | datetime | Timestamp da consulta |
Todos os campos podem retornar
null enquanto o entregador está sendo atribuído ou em trânsito para a loja.| Prática | Recomendação |
|---|---|
| Intervalo de polling | A cada 30 segundos |
404 Not Found | Aguarde 30s e tente novamente |
| Rate limit | Respeite os limites para evitar bloqueio |
| Iniciar rastreamento | Somente após receber ASSIGN_DRIVER |
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
Conteúdo lido0%