Integração

Integração iFood + ERP:
o que considerar antes de começar

A integração parece simples, mas há detalhes operacionais que fazem a diferença entre uma solução que funciona e uma que cria mais problemas.

O que a API do iFood permite (e o que não permite)

O iFood disponibiliza uma API para parceiros que permite: receber pedidos em tempo real, atualizar status do pedido (confirmado, em preparo, saiu para entrega), gerenciar cardápio (itens, preços, disponibilidade) e consultar o histórico de pedidos e repasses financeiros.

O que ela não faz automaticamente: registrar o pedido no seu ERP, baixar o estoque dos ingredientes, emitir nota fiscal, lançar o valor no financeiro. Essas etapas precisam ser construídas na integração.

Tipos de integração — qual escolher

Integração via middleware próprio. Um sistema intermediário recebe o pedido do iFood, transforma os dados no formato do seu ERP e faz o lançamento automático. É a abordagem mais flexível e robusta — permite mapear itens do cardápio iFood para os produtos do ERP, tratar cancelamentos, e integrar outros canais (ZigPay, PagBank) no mesmo fluxo.

Integração nativa do ERP. Alguns ERPs já oferecem conector com iFood. É mais rápido de implementar, mas menos flexível — as regras de mapeamento são limitadas e customizações costumam depender do fornecedor do ERP.

Importação de planilha. Solução manual que não resolve o problema. Só é válida como medida temporária enquanto a integração real é desenvolvida.

O que realmente importa no dia a dia

Mapeamento de cardápio. O nome de um item no iFood raramente é idêntico ao código do produto no ERP. O mapeamento precisa ser feito item a item — e atualizado quando o cardápio muda.

Tratamento de cancelamentos. Pedidos cancelados pelo iFood depois de confirmados precisam estornar o lançamento no financeiro e devolver o estoque. Sem isso, os números ficam errados.

Conciliação do repasse. O iFood repassa semanalmente, com deduções de comissão e taxa de entrega. A integração precisa separar o valor bruto da venda do valor líquido recebido — senão o financeiro não fecha.

Histórico para auditoria. Guarde o JSON original de cada pedido recebido. Se houver divergência com o repasse do iFood, você terá evidência para contestar.

Dica: antes de contratar qualquer integração, mapeie todos os canais que seu restaurante usa. Integrar só o iFood e deixar ZigPay e PagBank manuais resolve metade do problema — e às vezes cria confusão no fechamento.

Ver solução para restaurantes Falar com a Flait