La integración de pedidos es uno de los flujos más sensibles de la experiencia de un usuario dentro de la plataforma iFood. Si la tienda no puede recibir y confirmar pedidos, los pedidos se cancelan y esto crea una mala experiencia para los usuarios de la plataforma.Por este motivo, es importante que todas las aplicaciones que utilicen el módulo de pedidos de API cumplan con los requisitos mínimos para garantizar una buena experiencia para nuestros clientes y colaboradores.
Criterios de Homologación
La aplicación debe ser capaz de:- Hacer requests en el endpoint de /polling regularmente cada 30 segundos para no perder ningún pedido. Esto asegura que el merchant permanezca abierto en la plataforma; Utilice el header
x-polling-merchantssiempre 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 inmediatamente después de la solicitud de polling; -Ver el estado de la tienda (Abierta/Cerrada) en la pantalla de la aplicación. Esto requiere usar el endpoint /status de la API del merchant regularmente cada 30 segundos. Si la tienda está cerrada, informe el motivo de la interrupción;
- Recibir, confirmar y enviar una orden de entrega en el instante (orderType = DELIVERY / orderTiming = INMEDIATE);
- Recibir, confirmar y enviar un pedido delivery programada (orderType = DELIVERY / orderTiming = SCHEDULED). Es necesario mostrar la fecha y hora programada;
- Recibir y cancelar un pedido delivery de inmediato (orderType = DELIVERY / orderTiming = INMEDIATE). Es obligatorio proporcionar una lista de todos los códigos/motivos de cancelación previstos en la documentación;
- Recibir, confirmar y notificar que un pedido está listo Para Recoger (orderType = TAKEOUT);
- Recibir pedidos con pago con tarjeta y muestra los detalles del tipo de pago, como la marca;
- Recibir pedidos con pago en efectivo y mostrar el valor de cambio en la pantalla y/o comando impreso;
- Recibir pedidos con todos los cupones de descuento cupones de descuento y visualizar el monto y el responsable del subsidio (iFood/Store);
- Mostrar observaciones de ítems en pantalla y/o comandos impresos (Ej: Quitar cebolla);
- Actualizar el status de un pedido cancelado por el cliente o por iFood;
- Actualizar el status de un pedido que puede haber sido confirmado/cancelado por otra aplicación, como el Gestor de pedidos;
- Recibir el mismo evento más de una vez en el polling y eliminarlo si este evento ya ha sido entregado;
- Informar el NIT/CC en pantalla si es requerido por la tienda o si ya está diligenciado en la factura electrónica (documento fiscal) de manera automática;
- Recibir eventos de Plataforma de Negociação de Pedidos y poder procesarlos a través de los endpoints disponibles;
- Renovar el token solo cuando esté a punto de caducar o inmediatamente después de su caducidad.
- La aplicación debe respetar las políticas de rate limit de cada endpoint.
- Un requisito deseable es que el comando impreso siga el modelo sugerido en la documentación.
- Notificar en pantalla y/o orden impresa la información para indicar al domiciliario donde debe dejar el pedido (que viene en el campo delivery.observations)
Tip
Para validar que tu aplicación puede actualizar el estado de los pedidos con cambios realizados por otra aplicación, puedes confirmar y cancelar pedidos de prueba utilizando el Gestor de Pedidos Web y realizar un seguimiento del estado de esos pedidos en tu aplicación.
Como Agendar
Para programar la homologación de tu solicitud, accede al área de chamados y abre una solicitud de homologación de tu aplicación. Nuestro equipo se pondrá en contacto contigo para agendar el proceso.Nuevo intento
Antes de agendar la homologación de la aplicación, asegúrate de que cumpla con todos los requisitos enumerados anteriormente. Tienes que esperar 15 días para un nuevo intento.