KMódulos
Authentication
Merchant
Catalog
Order
Events
Logistics
Shipping
Review
Financial
Soluciones
Criterios de homologación
Requisitos previos
- La aplicación debe estar completamente desarrollada antes de la homologación
- Las pruebas evalúan la aplicación integralmente, no solo las llamadas de API
- Solo cuentas Profesionales (CNPJ) son aceptadas para homologación
- Cuentas Personales/Estudiante (CPF) no serán aceptadas
Aplicabilidad
Estos criterios se aplican a integradoras que desean integrar exclusivamente con el módulo Shipping para contratar servicios de entrega de pedidos fuera de la plataforma iFood.Para integradoras que también usan el módulo Orders:- Consulte los criterios de homologación de Orders
- Aunque no es obligatorio, recomendamos realizar la homologación del módulo Shipping
- Garantiza que las solicitudes sean correctas
- Permite detectar problemas anticipadamente
Requisitos funcionales
1. Gestión de eventos
La aplicación debe:- Polling: Consultar el endpoint /polling cada 30 segundos
- Acknowledgment: Enviar /acknowledgment inmediatamente después de recibir eventos
- Idempotencia: Identificar y descartar eventos duplicados recibidos en el polling
2. Gestión de pedidos Bajo Demanda
La aplicación debe ser capaz de:Confirmación de pedidos
- Recibir y confirmar pedidos Bajo Demanda inmediatos
- Parámetros:
orderType=DELIVERY,orderTiming=IMMEDIATE,salesChannel=POS
Cancelación de pedidos
- Recibir y cancelar pedidos delivery inmediatos
- Obligatorio: Consultar códigos de cancelación vía /cancellationReasons antes de solicitar la cancelación
- Obligatorio: Poner a disposición lista de motivos en el sistema de PDV para selección del usuario
Sincronización de estados
- Actualizar estado de pedidos cancelados por el cliente o iFood
- Actualizar estado de pedidos confirmados/cancelados por otras aplicaciones (ej: Gestor de Pedidos)
3. Gestión de direcciones
La aplicación debe:- Aceptar o rechazar solicitudes de cambio de dirección
- Procesar cambios dentro del plazo establecido
4. Código de recolección
La aplicación debe:- Verificar el código de recolección del pedido
- Validar si el código fue confirmado por el repartidor
Requisitos no funcionales
Performance y seguridad
- Renovación de token: Renovar solo cuando esté próximo a expirar o inmediatamente después de expirar
- Rate limiting: Respetar los límites de solicitudes de cada endpoint
- Tratamiento de errores: Implementar retry con backoff exponencial
Monitoreo
- Registrar logs de todas las operaciones críticas
- Implementar alertas para fallos de integración
Requisitos deseables
Aunque no obligatorios, los siguientes ítems son fuertemente recomendados:Impresión de comanda
- Seguir el modelo sugerido en la documentación de layout
- Incluir toda la información esencial del pedido
Observaciones de entrega
- Mostrar en la pantalla del sistema el campo
delivery.observations - Imprimir observaciones en la comanda
- Garantizar visibilidad de instrucciones especiales de entrega
Proceso de homologación
1. Preparación
- Concluir desarrollo de la aplicación
- Validar cuenta Profesional (CNPJ)
- Configurar ambiente de pruebas
2. Pruebas
- Ejecutar todos los escenarios obligatorios
- Validar tratamiento de errores
- Probar sincronización de eventos
3. Aprobación
- Revisar checklist completo
- Corregir no conformidades
- Solicitar validación final
Soporte
Para dudas sobre el proceso de homologación:- Consulte la documentación completa
- Entre en contacto con el soporte técnico iFood
- Acceda al portal del desarrollador
Próximos pasos
Después de la aprobación en homologación:- Migrar a ambiente de producción
- Configurar monitoreo continuo
- Establecer proceso de soporte operacional
¿Esta página fue útil?
Evalúa tu experiencia en el nuevo portal de desarrolladores:
En esta página
Contenido leído0%