Integração Ifood com N8n para Central de Pedidos Automatizada

📌 Integração iFood com n8n

Prazo de entrega: 31/10/2025

Contexto do Projeto

Atendendo via PDV local, site próprio e iFood.
Atualmente, os pedidos iFood são gerenciados pelo portal do iFood, sem integração ao restante do sistema. Isso gera retrabalho, atrasos e falhas na cozinha.

Estamos desenvolvendo um novo sistema com base central em MySQL + APIs em PHP + automações via n8n.
Precisamos que os pedidos do iFood sejam integrados automaticamente ao nosso sistema via n8n, centralizando tudo em uma “Central de Pedidos”.

Escopo da Integração (Fase 1 até 30/11/2025)

Autenticação iFood Partner API

Configuração de credenciais (Merchant/Partner).

Validação de tokens (OAuth2).

Ingestão de pedidos (Webhook iFood → n8n)

Receber pedidos novos do iFood (novos eventos).

Normalizar os dados no formato JSON esperado pelo Core api (php).

Idempotência (não duplicar pedidos).

Atualização de status (Core → iFood)

Alterar status de pedidos via API iFood:

Aceito

Em preparo

Saiu para entrega

Entregue

Cancelado (com motivo).

Sincronização de cardápio (opcional nesta fase)

Mapeamento de SKUs entre iFood e sistema próprio.

Envio/atualização do menu (se possível automatizar).

Monitoramento & Logs

Registrar todos os eventos (pedido recebido, status enviado, erros de API).

Retry automático em caso de falha (ex.: Se a API do iFood não responder).

Relatório simples de pedidos processados.

Entrega Esperada

Fluxos n8n configurados e funcionando (importável/exportável em JSON).

Documentação do processo (como atualizar credenciais, como monitorar erros).

Testes em ambiente sandbox e depois em produção iFood.

Demonstração com pedido real entrando do iFood → Central de Pedidos → KDS.

Requisitos do Freelancer

Experiência comprovada em n8n (webhooks, APIs REST, autenticação OAuth2).

Experiência prévia com API do iFood (Partner/Merchant).

Conhecimento em JSON, logs e retry strategy.

Capacidade de documentar os fluxos (não apenas entregar o “.json”).

Diferenciais

Experiência em integração com sistemas de delivery/food service.

Experiência em PHP/MySQL (para pequenos ajustes se necessário).

Disponibilidade para dar suporte até o go-live em novembro.

Prazo

Entrega até 31/10/2025 (para termos 1 mês de testes antes do deadline do MVP em 30/11).

Como será testado o serviço

Criar pedido no iFood → pedido aparece no Core API em menos de 5 segundos.

Alterar status no Core API → status atualizado corretamente no iFood.

Testar cancelamento de pedido com motivo.

Testar falha simulada de conexão (retry funcionando).