KMódulos
Authentication
Merchant
Catalog
Order
Events
Logistics
Shipping
Review
Financial
Soluções
Critérios de homologação
Requisitos prévios
- O aplicativo deve estar completamente desenvolvido antes da homologação
- Os testes avaliam o aplicativo integralmente, não apenas as chamadas de API
- Apenas contas Profissionais (CNPJ) são aceitas para homologação
- Contas Pessoais/Estudante (CPF) não serão aceitas
Aplicabilidade
Estes critérios aplicam-se a integradoras que desejam integrar exclusivamente com o módulo Shipping para contratar serviços de entrega de pedidos fora da plataforma iFood.Para integradoras que também usam o módulo Orders:- Consulte os critérios de homologação de Orders
- Embora não obrigatória, recomendamos realizar a homologação do módulo Shipping
- Garante que as requisições estejam corretas
- Permite detectar problemas antecipadamente
Requisitos funcionais
1. Gestão de eventos
O aplicativo deve:- Polling: Consultar o endpoint /polling a cada 30 segundos
- Acknowledgment: Enviar /acknowledgment imediatamente após receber eventos
- Idempotência: Identificar e descartar eventos duplicados recebidos no polling
2. Gestão de pedidos Sob Demanda
O aplicativo deve ser capaz de:Confirmação de pedidos
- Receber e confirmar pedidos Sob Demanda imediatos
- Parâmetros:
orderType=DELIVERY,orderTiming=IMMEDIATE,salesChannel=POS
Cancelamento de pedidos
- Receber e cancelar pedidos delivery imediatos
- Obrigatório: Consultar códigos de cancelamento via /cancellationReasons antes de solicitar o cancelamento
- Obrigatório: Disponibilizar lista de motivos no sistema de PDV para seleção pelo usuário
Sincronização de status
- Atualizar status de pedidos cancelados pelo cliente ou iFood
- Atualizar status de pedidos confirmados/cancelados por outros aplicativos (ex: Gestor de Pedidos)
3. Gestão de endereços
O aplicativo deve:- Aceitar ou rejeitar solicitações de alteração de endereço
- Processar alterações dentro do prazo estabelecido
4. Código de coleta
O aplicativo deve:- Verificar o código de coleta do pedido
- Validar se o código foi confirmado pelo entregador
Requisitos não funcionais
Performance e segurança
- Renovação de token: Renovar apenas quando próximo da expiração ou imediatamente após expirar
- Rate limiting: Respeitar os limites de requisições de cada endpoint
- Tratamento de erros: Implementar retry com backoff exponencial
Monitoramento
- Registrar logs de todas as operações críticas
- Implementar alertas para falhas de integração
Requisitos desejáveis
Embora não obrigatórios, os seguintes itens são fortemente recomendados:Impressão de comanda
- Seguir o modelo sugerido na documentação de layout
- Incluir todas as informações essenciais do pedido
Observações de entrega
- Exibir na tela do sistema o campo
delivery.observations - Imprimir observações na comanda
- Garantir visibilidade de instruções especiais de entrega
Processo de homologação
1. Preparação
- Concluir desenvolvimento do aplicativo
- Validar conta Profissional (CNPJ)
- Configurar ambiente de testes
2. Testes
- Executar todos os cenários obrigatórios
- Validar tratamento de erros
- Testar sincronização de eventos
3. Aprovação
- Revisar checklist completo
- Corrigir não conformidades
- Solicitar validação final
Suporte
Para dúvidas sobre o processo de homologação:- Consulte a documentação completa
- Entre em contato com o suporte técnico iFood
- Acesse o portal do desenvolvedor
Próximos passos
Após aprovação na homologação:- Migrar para ambiente de produção
- Configurar monitoramento contínuo
- Estabelecer processo de suporte operacional
Esta página foi útil?
Avalie sua experiência no novo Developer portal:
Nesta página
Conteúdo lido0%