Módulo de Shipping

El módulo de Shipping permite que los merchants soliciten el servicio de entrega de iFood para pedidos realizados tanto dentro como fuera de la plataforma. Esta funcionalidad es ideal para merchants que poseen flota propia pero necesitan soporte logístico en momentos de alta demanda.

Funcionalidades principales

Solicitar repartidores para pedidos de la plataforma iFood o de canales externos
Verificar disponibilidad de entrega antes de solicitar
Rastrear entregas en tiempo real
Recibir notificaciones sobre el estado de la entrega

Tipos de pedidos

Pedidos en la plataforma iFood

Pedidos que ya poseen un orderId y contienen toda la información necesaria (merchant y cliente) para cotización y solicitud de repartidor.Casos de uso:

Merchant con flota propia necesita soporte en horarios pico
Falta temporal de repartidores propios
Optimización de costos operacionales

Pedidos fuera de la plataforma iFood

Pedidos realizados por otros canales (teléfono, WhatsApp, app propia) que no poseen orderId. Requieren información adicional para cotización y solicitud.

Bajo DemandaPara pedidos externos, utilice el servicio Bajo Demanda. Más información en: https://news.ifood.com.br/entrega-facil-o-delivery-do-ifood-fora-do-app/

Requisitos

Contratación del servicio

El servicio debe contratarse a través del Portal del Socio (menú Servicios). Sin la contratación, no será posible:

Registrar pedidos
Verificar disponibilidad de entrega
Solicitar repartidores

Elegibilidad de pedidos

No todos los pedidos son elegibles para el servicio. Los criterios incluyen:

Modelo de negocio: Merchants fullservice ya tienen logística incluida
Tipo de pedido: Solo delivery (no disponible para retiro)
Cobertura: Área de entrega debe ser atendida por repartidores socios

Verifique siempre la elegibilidad del pedido antes de solicitar un repartidor para evitar errores en la integración.

Rastreo de entregas

Obtener información del repartidor

La información del repartidor se envía a través del evento ASSIGN_DRIVER.

Rastrear pedido en tiempo real

Use el endpoint GET /tracking para seguir la entrega.

Campos retornados

Campo	Tipo	Descripción
latitude	decimal	Latitud actual del repartidor (puede ser `null`)
longitude	decimal	Longitud actual del repartidor (puede ser `null`)
expectedDelivery	datetime	Previsión de entrega (puede ser `null`)
pickupEtaStart	integer	Tiempo estimado (segundos) hasta recolección. Negativo indica retraso
deliveryEtaEnd	integer	Tiempo estimado (segundos) hasta entrega
trackDate	datetime	Fecha/hora de la consulta (puede ser `null`)

Buenas prácticas de rastreo

Cuándo usar: Solo después de recibir el evento ASSIGN_DRIVER
Intervalo: Consulte cada 30 segundos
Error 404: Espere 30 segundos e intente nuevamente
Rate limit: Respete los límites para evitar bloqueo

El rastreo está disponible solo para pedidos entregados por la logística iFood.

¿Esta página fue útil?

Evalúa tu experiencia en el nuevo portal de desarrolladores:

En esta página