iFood Developer

Buscar en la documentación

Módulos

Authentication

Merchant

Catalog

Order

Events

Logistics

Shipping

Review

Financial

Soluciones

Logistics

Criterios de homologación

Para realizar la homologación de la aplicación es necesario que la misma ya esté lista. Las pruebas se realizan en la APP como un todo y no solo en las llamadas de nuestras APIs.

Solicitudes de homologación con registros de cuenta Personal/Estudiante (CPF) no serán aceptadas. Solo solicitudes con registro de cuenta Profesional (CNPJ).

Estos criterios son aplicables para integradoras que desean integrar exclusivamente con el módulo Logistics y realizar la operación de delivery para los Merchants.

La aplicación debe ser capaz de

Recibir eventos de pedidos vía polling o vía webhook.
- En el caso del polling:
  - Hacer requests en el endpoint de /polling regularmente para no perder ningún pedido, pasando el parámetro excludeHeartbeat para evitar que la tienda quede abierta indebidamente; Utilice el header x-polling-merchants siempre que necesite filtrar eventos de uno o más merchants. También es posible filtrar los eventos que desea recibir por tipo y por grupo;
  - Enviar /acknowledgment para todos los eventos recibidos (con status code 200) inmediatamente después del request de polling;
- En el caso del webhook: responder con éxito a los requests del webhook, verificado por nuestra auditoría interna;
- Actualizar el estado del Driver, avisando que el mismo fue asignado al Pedido a través del endpoint POST /assignDriver
- Notificar el desplazamiento del Driver, informando que el mismo está yendo a la dirección de origen para recoger el Pedido a través del endpoint POST /goingToOrigin.
- Confirmar que el Driver llegó a la dirección de origen para recoger el pedido a través del endpoint POST /arrivedAtOrigin.
- Notificar que el Driver recogió el pedido y está en camino a la dirección de entrega a través del endpoint POST /dispatch.
- Notificar que el Driver llegó al destino para realizar la entrega del pedido a través del endpoint POST /arrivedAtDestination.
- Etapa obligatoria para todas las Integradoras. Enviar el código de confirmación de entrega a través del endpoint POST /verifyDeliveryCode. En esta etapa, la aplicación debe ser capaz de analizar si el pedido es elegible para realizar la validación del código por el evento "DELIVERY_DROP_CODE_REQUESTED". Este evento será generado y enviado para cada pedido elegible.

Requisitos no funcionales

Renovar el token solamente cuando esté próximo a expirar o inmediatamente después de la expiración.
La aplicación debe respetar las políticas de rate limit de cada endpoint.

Cómo agendar

Para agendar la homologación de su aplicación acceda al área de tickets y abra una solicitud para homologación de su aplicación. Nuestro equipo entrará en contacto con usted para agendar el proceso.

Nuevo intento Antes de agendar la homologación de su aplicación asegúrese de que cumple todos los requisitos listados arriba. Es necesario esperar 15 días para un nuevo intento.

Preparación

Antes de iniciar, tenga a mano los datos de su tienda de prueba, como id y nombre de la tienda. Asegúrese de tener acceso a un servicio de internet estable

Duración

En el horario agendado, un analista de nuestro equipo hará el acceso remoto para acompañar cada etapa de las pruebas. El proceso dura en promedio 45 minutos.

Reagendamiento

Caso su aplicación no sea homologada, nuestro equipo registrará en el ticket los requisitos que no fueron atendidos y usted deberá ajustar su software. Podrá agendar una nueva homologación 15 días después del intento anterior.

¿Esta página fue útil?

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

En esta página