Integração SAP Business One iFood Mercado: pedidos, benefícios e NF-e

O iFood Mercado impõe um ritmo que nenhum outro canal desta lista impõe: existe uma regra explícita de não atualizar mais de 25% do catálogo dentro de uma janela de 35 minutos. Ultrapassar devolve HTTP 429. Para uma operação de supermercado com milhares de itens, isso não é detalhe — é o que define a arquitetura da carga.

A autenticação é OAuth 2.0 com Bearer token, obtido em merchant-api.ifood.com.br/authentication/v1.0/oauth/token. O catálogo entra pelo módulo Item, via ingestion, e aqui há uma diferença importante em relação a VTEX ou Magalu: preço e estoque viajam no mesmo payload do item, com o saldo no campo inventory.stock. A operação de reset=true, que reprocessa o catálogo inteiro, é limitada a uma chamada por dia por parceiro, com Retry-After até a virada do dia.

No pedido, a pegadinha é fiscal e financeira ao mesmo tempo: o item chega com preço cheio e os descontos vêm separados, em BENEFITS. Quem não reconstrói o preço final a partir dessas duas partes lança no SAP Business One um valor que não corresponde ao que o cliente pagou — e a divergência só aparece na conciliação. Veja as outras integrações do SAP Business One.

O que é a integração SAP Business One iFood Mercado?

É a conexão automática entre o ERP SAP Business One e o iFood Mercado, fazendo os dois sistemas trocarem dados sem intervenção manual.

A divisão de papéis não deveria ser negociável: o SAP Business One é a fonte oficial — controla estoque, preços, faturamento e fiscal. O iFood Mercado é canal — apresenta o produto, capta o cliente e registra o pedido.

Por que integrar o SAP Business One exige atenção?

Porque um conector genérico ignora justamente o que faz o ERP funcionar:

• Pedido lançado com valor que o cliente não pagou. O item chega com preço cheio e os descontos vêm separados, em BENEFITS. Quem não reconstitui o preço final a partir das duas partes lança no SAP Business One um valor divergente — e a diferença só aparece na conciliação.
• Catálogo bloqueado no meio da carga. Existe uma regra explícita de não atualizar mais de 25% do catálogo dentro de uma janela de 35 minutos; ultrapassar devolve HTTP 429. Para um supermercado com milhares de itens, isso define a arquitetura da carga.
• Reprocessamento gasto de uma vez só. A operação de reset=true, que reprocessa o catálogo inteiro, é limitada a uma chamada por dia por parceiro, com Retry-After até a virada do dia. Usar por engano deixa o resto do dia sem essa carta na mão.
• Venda de produto sem estoque. O canal segue anunciando o que já saiu no ERP por outra via, e o cancelamento vem depois.
• Conciliação manual no fechamento. O que o canal registrou não bate com o que o ERP faturou.

O que a API do iFood Mercado permite?

• A Merchant API do iFood autentica por OAuth 2.0 com Bearer token, emitido a partir do clientId e clientSecret da loja.
• O catálogo é enviado pelo módulo Item, em chamadas de ingestion. Os campos obrigatórios são barcode e name — e no PATCH o identificador do item é o próprio barcode.
• Estoque e preço viajam no mesmo payload do item, em inventory.stock e prices.price / promotionPrice. Preço por quantidade usa scalePrices.
• Pedidos chegam pelo módulo Events, por webhook ou por polling. O webhook traz o cabeçalho X-IFood-Signature, e validar o HMAC-SHA256 com o client_secret é exigência de homologação.
• Existe limite documentado: a chamada com reset=true é permitida uma vez por dia, e a regra operacional é não atualizar mais de 25% do catálogo em uma janela de 35 minutos — acima disso a API responde 429.

A pegadinha mais cara está no preço do pedido: o item chega com o valor cheio e os descontos vêm separados, no bloco de benefícios. Quem soma apenas o preço do item lança no ERP um valor que não bate com o que o cliente pagou no app — e o erro só aparece na conciliação.

Quais problemas surgem sem a integração entre SAP Business One e iFood Mercado?

• Venda de produto sem estoque. O canal segue anunciando o que já saiu no ERP por outra via, e o cancelamento vem depois.
• Pedido parado esperando digitação. O cliente já pagou e o pedido ainda não existe no ERP.
• Preço desatualizado. A tabela mudou no ERP e o canal não acompanhou — margem errada ou venda perdida.
• Retrabalho fiscal. Pedido lançado às pressas gera nota com operação errada.
• Conciliação manual no fechamento. O que o canal registrou não bate com o que o ERP faturou.

Quanto custa continuar no manual?

O custo raramente aparece como linha de orçamento, e é por isso que passa despercebido. Ele aparece como uma pessoa dedicada a copiar pedido, como venda perdida por ruptura que não existia no estoque real, e como margem errada em item cujo preço mudou sem o canal acompanhar.

Enquanto o volume é baixo, dá para absorver. O problema é o teto: passado certo número de pedidos por dia, a digitação deixa de ser incômoda e passa a ser o que impede o canal de crescer.

Como funciona a integração ERP SAP Business One iFood Mercado?

A Plugar.me opera como uma camada entre o SAP Business One e a API do iFood Mercado. Ela traduz os dados de um lado para o outro, orquestra a ordem das operações e trata os erros que aparecem no caminho — porque eles aparecem.

O EAN é a chave, não o seu código interno

O iFood Mercado identifica o item pelo código de barras. Isso obriga o ERP a ter o EAN correto e único em cada SKU que vai ao canal — não o código interno, não o código da balança usado só na loja física. Cadastro com EAN repetido entre produtos diferentes, ou EAN em branco, simplesmente não sobe. Vale auditar essa base antes do projeto, porque é o item que mais atrasa go-live.

Como funciona o controle de estoque?

O saldo sai do SAP Business One e atualiza o canal. A pergunta relevante não é apenas “quanto tem”, e sim quanto pode ser vendido ali.

É comum não querer expor todo o saldo: parte está comprometida com pedidos em aberto, parte é de um depósito que não atende o canal. A integração precisa respeitar essa separação.

No iFood Mercado o estoque não tem chamada isolada: ele viaja no mesmo payload do item, no campo inventory.stock, pela rota de ingestion. Isso tem uma consequência prática direta — atualizar saldo consome a mesma cota da regra dos 25% em 35 minutos que atualizar catálogo. Por isso o saldo do depósito que atende a loja precisa ser enviado em blocos priorizados, e não a cada oscilação.

Como funciona o faturamento e a emissão de notas fiscais?

A nota nasce no SAP Business One. É a regra que separa uma integração ERP First de um conector qualquer.

O pedido segue a cadeia de documentos da empresa e a NF-e é emitida com a operação fiscal correta, dentro do ERP. O canal recebe a informação do documento emitido; ele não substitui essa etapa. Seu fiscal continua sendo um só.

Há aqui um passo que não existe nos outros canais: antes de faturar é preciso reconstituir o valor real do pedido. O item chega com preço cheio e os descontos aparecem separados em BENEFITS; o que o cliente efetivamente pagou é o resultado das duas partes. Emitir a NF-e sobre o preço cheio gera nota acima do valor recebido, com impacto fiscal e financeiro; emitir sobre o líquido sem registrar o desconto perde a rastreabilidade. O desenho correto leva as duas informações para dentro do ERP e deixa a operação fiscal decidir como representá-las.

Qual é o fluxo completo, do clique à nota fiscal?

1. O cliente compra no iFood Mercado.
2. A integração captura o pedido e o cria no SAP Business One, na operação correta.
3. O estoque é baixado no ERP e o saldo do canal é atualizado.
4. O pedido segue o fluxo interno de separação e conferência.
5. O faturamento é executado no SAP Business One e a NF-e é emitida.
6. Número da nota e rastreio voltam para o canal.
7. O painel da Plugar.me registra cada etapa em log, para auditoria.

Preciso desenvolver essa integração do zero?

Não existe conector nativo entre o SAP Business One e o iFood Mercado. Os dois lados têm interface; ninguém fez a ponte por você. E a ponte não é só transporte de dados: é mapear a estrutura do ERP, respeitar os limites do canal e tratar o que falha.

O que costuma ser subestimado no desenvolvimento interno não é construir. É manter: o canal muda regra de API, muda exigência de cadastro, muda comportamento. Quem construiu internamente assume essa fila para sempre.

Quais os benefícios para distribuidoras, importadoras e indústrias?

• Volume sem headcount proporcional. Dobrar pedidos não significa dobrar gente digitando.
• Menos cancelamento. O saldo publicado passa a refletir o estoque real.
• Margem sob controle. O preço do canal sai da política definida no ERP.
• Fiscal em um lugar só. A nota nasce no SAP Business One, com a operação correta.
• Fechamento sem conciliação manual. O que aconteceu no canal está registrado no ERP.
• Rastreabilidade. Log de cada etapa, para quando algo precisar ser auditado.

Para quais empresas essa integração é indicada?

• Empresas que rodam SAP Business One e querem canal digital sem trocar de ERP.
• Operações com mais de um depósito, onde estoque e faturamento não são triviais.
• Negócios que precisam de fiscal correto por obrigação, não por preferência.

Se o volume é baixo e não há complexidade fiscal, o manual ainda se sustenta. A conta vira quando o volume cresce ou quando o erro passa a custar reputação.

Por que escolher uma integração ERP First para o SAP Business One?

Porque a alternativa é deixar o canal ditar a operação. Existe um modelo comum em que a plataforma vira o centro: o catálogo passa a viver nela, o pedido é tratado nela e o ERP recebe um resumo depois. Para quem investiu em SAP Business One, isso é inversão de comando.

• Estoque, preço e cadastro têm uma origem: o SAP Business One.
• A nota fiscal nasce no ERP, com a operação da sua empresa.
• O canal é canal — importante, mas não dono do dado.
• Se amanhã você abrir outro canal, a fonte da verdade não muda.

Como a Plugar.me realiza a integração SAP Business One iFood Mercado?

A operação roda 100% em nuvem: não é preciso subir servidor nem manter estrutura adicional na sua infraestrutura.

1. Diagnóstico. Entender como o seu SAP Business One está configurado e o que a operação exige.
2. Mapeamento e setup. Definir de onde sai cada dado, qual operação o pedido do iFood Mercado deve usar e qual saldo o canal enxerga.
3. Go-live assistido. Acompanhamento nos primeiros ciclos, quando os casos de exceção aparecem, com painel de logs para auditar cada etapa.

Conclusão: vale a pena integrar o SAP Business One ao iFood Mercado?

Vale quando o iFood Mercado deixa de ser teste e passa a ser canal. A partir daí, digitação manual não é economia: é o teto do canal e a origem dos erros que custam tempo e margem.

A integração bem feita não muda a forma como a sua empresa opera. Faz o contrário: garante que o canal se encaixe na operação que já existe no SAP Business One, em vez de obrigar a operação a se contorcer para caber no canal.

Quer avaliar como ficaria no seu cenário? Fale com a equipe da Plugar.me e conte como o seu SAP Business One está estruturado hoje: volume, estrutura de estoque e como funciona o seu faturamento.

Luan Carvalho

Luan Carvalho é fundador e CTO da Plugar.me, empresa especializada em integração de ERP com marketplaces e plataformas de e-commerce. Atua no desenvolvimento de soluções para automação de pedidos, estoque, preços, faturamento e documentos fiscais, ajudando empresas a escalarem suas operações com estabilidade, segurança e alto desempenho. Ao longo de sua trajetória, participa da implementação de integrações entre ERPs como SAP Business One, Protheus, WinThor, Consinco e Sankhya, conectando-os aos principais marketplaces e plataformas do mercado.