Integração por canal
Integração do iFood Mercado com o seu ERP
O iFood Mercado levou o modelo de entrega rápida para o varejo alimentar, e integrá-lo ao ERP tem uma exigência que nenhum outro canal impõe: ritmo. A plataforma limita quanto do catálogo pode ser atualizado por janela de tempo, e o valor que chega no pedido não é o valor que o cliente pagou. No modelo ERP-first, o seu sistema continua sendo a fonte da verdade — produtos, saldo, preços, pedidos e notas fiscais nascem e são controlados nele. Abaixo estão os ERPs com integração documentada.
Como funciona a integração ERP-first · Todos os ERPs integrados · Integração com a Tray · Integração com a VTEX · Integração com a Shopify
O que muda, na prática, ao integrar com o iFood Mercado
- Existe um teto de 25% do catálogo por janela de 35 minutos. Ultrapassar devolve HTTP 429. Para um supermercado com milhares de itens, isso não é detalhe de implementação: é o que define a arquitetura da carga e a ordem de prioridade do que sincronizar primeiro.
- Preço e estoque viajam no mesmo payload do item. Diferente de VTEX ou Magalu, não há chamada isolada de estoque: o saldo vai no campo
inventory.stock, pela rota de ingestion. Atualizar saldo consome a mesma cota que atualizar catálogo. - O pedido chega com preço cheio e desconto separado. Os benefícios vêm em
BENEFITS, à parte. O que o cliente efetivamente pagou é o resultado das duas partes — e faturar sobre o preço cheio gera nota acima do valor recebido. - O reprocessamento total é limitado a uma vez por dia. A operação de
reset=truereprocessa o catálogo inteiro, mas é uma chamada por dia por parceiro, comRetry-Afteraté a virada. Usar por engano deixa o resto do dia sem essa carta. - A autenticação é OAuth 2.0 com Bearer token. Obtido em
merchant-api.ifood.com.br/authentication/v1.0/oauth/token, com as credenciais na aba do próprio portal do parceiro. - Os pedidos chegam por polling ou webhook. O módulo de Events oferece os dois caminhos para acompanhar o ciclo do pedido; a escolha depende de quanto atraso a operação tolera entre a venda e a entrada no ERP.
TOTVS WinThor + iFood Mercado
Estoque por filial e faturamento na rotina do WinThor.
SAP Business One + iFood Mercado
Cadeia de documentos preservada, com o preço real reconstituído antes de faturar.
TOTVS Protheus + iFood Mercado
TES correta na entrada e saldo saindo da filial que atende o canal.
Linx Microvix + iFood Mercado
Estoque por loja da rede refletido no ritmo que o canal exige.
Consinco + iFood Mercado
Varejo alimentar com giro alto e fiscal controlado no Consinco.
Hiper + iFood Mercado
Loja de bairro publicando o estoque do balcão com segurança.
Usa outro ERP e vende no iFood Mercado?
A lista acima cobre os sistemas com integração já documentada, mas a arquitetura da Plugar.me é agnóstica de ERP: onde existe API, view ou base acessível, existe caminho. O próximo passo é mapear os fluxos que a sua operação precisa — produtos, estoque, preços, pedidos, NF-e e financeiro — e definir de qual depósito sai o saldo publicado.