A integração WinThor iFood Mercado conecta o ERP TOTVS WinThor ao canal de mercado do iFood para que produtos, preços, estoque e pedidos de cada filial circulem sem digitação, com o WinThor como fonte da verdade. A loja vende no app com o saldo que está na gôndola, e cada pedido entra no ERP na filial certa, pronto para faturar.
Numa rede de supermercados ou num atacarejo, o desafio não é ligar uma loja ao iFood, e sim ligar várias. Cada filial tem o seu estoque, a sua tabela de preço e a sua emissão de nota, e o iFood Mercado tem regras próprias de catálogo e de pedido, com prazo de 8 minutos para confirmar e limite de atualização a cada meia hora.
A seguir, você vê o que é a integração, o que o WinThor já traz pronto para o iFood, quem faz o quê, como o catálogo e o pedido circulam, quem emite a nota, como fica a operação com várias filiais e como a Plugar.me faz essa integração.
O que é a integração WinThor iFood Mercado?
A integração WinThor iFood Mercado é a conexão automática entre o ERP da TOTVS e o iFood Mercado, o canal do iFood para mercados, farmácias, pet shops e outras lojas. Em vez de manter um catálogo à parte no app, cada filial publica produtos, preços e estoque a partir do WinThor e recebe os pedidos de volta no ERP.
O WinThor é usado por supermercados, atacarejos e distribuidores que trabalham com várias filiais, política comercial por região e um fluxo de rotinas encadeadas, do pedido à expedição.
É exatamente isso que a integração precisa respeitar: o app não pode virar um segundo sistema de estoque, nem um lugar onde o preço é digitado de novo. O guia de como integrar o iFood com o ERP mostra como essa lógica muda em cada canal do iFood.
Suas lojas ainda mantêm no iFood um catálogo separado do WinThor? Cada preço digitado duas vezes é uma chance de vender com margem errada. A Plugar.me conecta o WinThor ao iFood Mercado com o ERP no comando. Fale com a nossa equipe e veja como funcionaria na sua rede.
WinThor e iFood: o ERP já tem integração com o app?
Tem uma parte. Na lista pública de parceiros do iFood Mercado, o Winthor aparece com integração de “Produtos”, e não de “Pedidos”, enquanto outros sistemas, como o TOTVS Protheus, aparecem com os dois.
Na prática, o conector listado cuida do catálogo, e o caminho do pedido até o ERP precisa ser resolvido de outro jeito.
Do lado do ERP, a rotina 2699 é o web service oficial do WinThor para o comércio eletrônico, mas trabalha com um padrão genérico de dados, sem as regras de pedido, filial e cobrança de cada empresa, segundo a central de atendimento da TOTVS.
O mesmo ponto aparece na integração WinThor Amazon: a interface existe, mas alguém precisa traduzir o pedido do canal para a estrutura da sua operação.
Por isso, a pergunta certa para o seu fornecedor não é “tem integração?”, e sim “a integração cobre produto, estoque, pedido, cancelamento e nota, filial por filial?”. Sem as cinco respostas, a loja continua com uma parte do trabalho manual.
Já sabe qual parte da sua operação com o iFood ainda depende de digitação? Em geral, é o pedido. Converse com a Plugar.me e veja o fluxo completo desenhado para o seu WinThor.
Quem faz o quê entre o ERP WinThor e o iFood Mercado?
O ERP WinThor manda no cadastro, no preço de cada filial, no estoque e no fiscal, e o iFood Mercado apresenta os produtos, recebe o pedido e acompanha a entrega ao cliente. A integração faz cada dado andar na direção certa:
| Dado | Direção | O que acontece |
|---|---|---|
| Produto | WinThor → iFood Mercado | O item sai do cadastro do ERP, identificado pelo código de barras |
| Preço | WinThor → iFood Mercado | O valor sai da política comercial da filial que atende aquela loja no app |
| Estoque | WinThor → iFood Mercado | O saldo da filial vai ao app a cada mudança, inclusive nas vendas do caixa |
| Pedido | iFood Mercado → WinThor | O pedido entra no ERP depois da separação, na filial certa |
| Status do pedido | WinThor → iFood Mercado | Confirmação e andamento seguem a rotina da loja |
| NFC-e | Emitida no WinThor | A filial emite a nota ao consumidor, e o iFood aparece como intermediador |
Cada loja do iFood corresponde a uma filial do WinThor. Esse de-para é a base do projeto: é ele que garante que o saldo publicado seja o da loja que vai separar o pedido, e que a nota saia com o CNPJ certo.
A mesma separação por local aparece na integração fulfillment WinThor, em que o centro de distribuição de cada marketplace vira um local próprio no ERP.
Sua rede tem filiais com preços diferentes? Então o app precisa mostrar o preço de cada uma, e não uma média. Fale com a Plugar.me e veja essa divisão de papéis aplicada às suas lojas.
Como o catálogo de cada filial chega ao iFood Mercado?
O catálogo chega ao iFood Mercado a partir do WinThor, item por item, com o código de barras como chave. Segundo a documentação do iFood Developer, o catálogo do mercado tem regras que a integração precisa cumprir:
| Regra do catálogo | O que diz a documentação do iFood | Como a integração trata |
|---|---|---|
| Identificação do item | EAN-13, EAN-8 ou código interno de balança | Usa o código que já está no cadastro do WinThor |
| Volume de atualização | No máximo 25% do catálogo a cada 30 minutos | Envia só o que mudou, por eventos |
| Carga completa | Uma vez por dia por loja, e no máximo 20 lojas por hora | Fica fora da rotina e, numa rede, é escalonada por filial |
| Preço promocional | Precisa ser menor que o preço normal | Confere a promoção antes de enviar |
| Item sem atualização | Item inativo ou sem preço sai do app em 15 dias | Mantém preço e status em dia |
Produto de balança, como frios, carnes, padaria e hortifrúti, pode ir ao iFood com o código interno, desde que cada código seja único no cadastro. É aqui que muitos projetos travam: código repetido entre filiais, EAN em branco ou o mesmo EAN em dois produtos fazem a API recusar o item.
O limite de 25% pesa mais em rede grande. Num catálogo de 12.000 itens, a janela de meia hora comporta até 3.000 mudanças por loja. Uma troca de tabela de preço que mexa em todo o catálogo precisa ser dividida em etapas, senão parte dos itens fica com o preço antigo no app até a próxima janela.
Também cabe a cada filial decidir quanto do saldo vai para o app. Reservar uma margem nos itens que giram rápido reduz o cancelamento por falta, e separar o estoque comprometido com o atacado evita vender o que já tem destino.
Seu iFood já mostrou produto que acabou na gôndola? Saldo errado vira pedido cancelado e cliente insatisfeito. Fale com a Plugar.me e veja como o estoque de cada filial fica certo no app.
Como o pedido do iFood Mercado entra no WinThor?
O pedido entra no WinThor pelos eventos do iFood, lidos pela integração e transformados em pedido na filial que vai atender. O fluxo tem prazos e etapas que não podem falhar:
- Os eventos de pedido chegam por consulta a cada 30 segundos ou por webhook, este disponível só para aplicativos centralizados, com assinatura HMAC-SHA256.
- O pedido precisa ser confirmado em até 8 minutos, senão é cancelado de forma automática.
- No mercado, a separação é feita pelo App Separador, ferramenta do próprio iFood, ou pelo módulo Picking, em que a loja pode remover, trocar ou incluir itens.
- O pedido só deve ser importado para o ERP depois do evento que indica que ele está pronto para faturar, já com os itens que de fato foram separados.
- Cada evento recebido precisa ser confirmado, e o iFood guarda os eventos por até 8 horas depois da entrega.
O cuidado mais caro está no valor do pedido. Os descontos e cupons chegam separados, no bloco de benefícios, com a parte paga pelo iFood e a parte paga pela loja. Se a integração lançar no WinThor só o preço cheio de cada item, o valor do pedido não bate com o que o cliente pagou no app, e a diferença só aparece na conciliação.
Do lado do WinThor, o pedido precisa entrar com a filial, o cliente, a cobrança e o tipo de venda certos, para seguir a mesma rotina de faturamento das outras vendas.
É essa tradução, filial por filial, que um padrão genérico de dados não faz sozinho. O mesmo desafio de pedido aparece na integração do 99Food com o WinThor, outro app de entrega.
Já perdeu pedido no iFood porque ninguém confirmou a tempo? Oito minutos passam rápido numa loja cheia. Converse com a Plugar.me e veja como a confirmação deixa de depender de alguém olhando a tela.
Quem emite a nota fiscal da venda no iFood Mercado?
Quem emite a nota é a filial, no WinThor, porque o iFood atua como intermediador da venda. Na entrega ao consumidor final, o documento é a NFC-e, e passa a ser NF-e quando o cliente pede a nota com CNPJ, conforme a regra do estado.
Dois cuidados fazem diferença na fiscalização:
- A nota da venda traz o CNPJ do intermediador, que é o do iFood, 14.380.200/0001-21. A exigência vale para a NF-e e para a NFC-e, pelos ajustes do Confaz.
- A comissão do iFood não entra na nota da venda: ela sai numa nota de intermediação emitida pelo próprio iFood.
Com a integração, a nota nasce no WinThor, com a operação fiscal que a filial já usa no caixa, e não num sistema paralelo. A página de integração do iFood Mercado com o seu ERP resume o que a Plugar.me cobre nesse canal.
Seu fiscal tem certeza de que as notas do delivery saem com o intermediador certo em todas as filiais? Esse detalhe aparece numa auditoria. A Plugar.me deixa a emissão no WinThor, do jeito que as suas lojas já fazem.
Como fica a integração iFood Mercado numa rede com várias filiais?
A integração iFood Mercado numa rede com várias filiais começa pelo desenho, e não pela tecnologia. Cada loja do app precisa de uma filial de origem para o estoque, para o preço e para a nota, e cada loja aprova o acesso do aplicativo de integração no iFood.
O iFood oferece o aplicativo centralizado, com uma credencial para várias lojas, que a própria documentação indica para ERPs e plataformas. Com ele, a rede administra todas as filiais pelo mesmo canal de integração, inclusive com webhook para os eventos de pedido.
Na prática, a entrada costuma funcionar melhor em ondas:
- Uma ou duas filiais piloto, com as categorias que mais vendem no delivery.
- Ajuste do cadastro: códigos de barras, itens de balança e preços por filial.
- Acompanhamento dos primeiros pedidos, com atenção às trocas na separação e aos cancelamentos.
- Entrada das demais filiais, escalonando a carga inicial de catálogo, que tem o limite de 20 lojas por hora.
Quem já vende o mesmo estoque em outros canais pode reunir tudo no WinThor com um hub de integração de marketplaces.
A integração WinThor Mercado Livre e a integração AnyMarket com o WinThor mostram o mesmo cuidado com o saldo de cada filial.
Quantas filiais da sua rede poderiam estar no iFood hoje? Começar por um piloto mostra o caminho para as outras. Fale com a Plugar.me e desenhe a entrada da sua rede no app.
Que problemas a integração resolve?
A integração resolve o cadastro feito duas vezes, o estoque desatualizado por filial e o pedido que depende de digitação. Veja a diferença:
| Sem integração | Com o WinThor integrado ao iFood Mercado |
|---|---|
| Catálogo mantido à mão no app, loja por loja | Produto e preço saem do WinThor, por filial |
| Estoque do app ajustado quando dá tempo | Saldo enviado a cada mudança, inclusive das vendas do caixa |
| Pedido redigitado no ERP | Pedido criado no WinThor depois da separação, na filial certa |
| Desconto lançado errado | Valor do pedido com os benefícios do iFood |
| Nota emitida fora do fluxo | NFC-e emitida no WinThor, com o intermediador certo |
| Conciliação manual no fechamento | Log de cada etapa no painel da integração |
O ganho é operacional: menos digitação, menos cancelamento por falta de produto e o fiscal num lugar só. Redes que usam outro ERP de supermercado passam pelo mesmo raciocínio, como mostra a integração do iFood Mercado com o Consinco.
Quantas horas por semana as suas lojas gastam mantendo o iFood em dia? Esse tempo pode voltar para o atendimento. Fale com a Plugar.me e veja o antes e o depois na sua operação.
Preciso desenvolver essa integração do zero?
Não. As APIs do iFood são gratuitas para quem atende aos requisitos, mas exigem CNPJ com atividade de tecnologia, um aplicativo completo e a homologação do iFood, que no mercado inclui uma sessão de cerca de 45 minutos com tela compartilhada, além da autorização de cada loja. O caminho mais curto costuma ser um hub que já conversa com os dois lados.
| Caminho | Investimento inicial | Tempo até operar | Manutenção |
|---|---|---|---|
| Desenvolver internamente | Alto | Longo | Sua equipe, sempre que o iFood ou o WinThor mudar |
| Consultoria sob medida | Alto | Médio | Cada ajuste vira um novo escopo |
| Hub ERP-first | Baixo | Curto | Do fornecedor, com o WinThor como fonte da verdade |
O que costuma ser subestimado não é construir, é manter: o iFood muda regras de catálogo, de eventos e de homologação, e a rede que construiu sozinha assume essa fila de ajustes em todas as filiais. A integração Protheus iFood Mercado passa pela mesma conta, com outro ERP da TOTVS.
Sua equipe de TI tem tempo para acompanhar cada mudança da API do iFood? Se não tem, a integração caseira vira mais um sistema para manter. Converse com a Plugar.me e compare os caminhos para a sua rede.
Como a Plugar.me pode ajudar nessa integração?
A Plugar.me conecta o WinThor ao iFood Mercado pelas interfaces oficiais dos dois lados, com o ERP como fonte da verdade. A operação roda em nuvem, faz parte do modelo de hub ERP-first da Plugar.me e segue práticas de segurança e proteção de dados em cada integração.
- Diagnóstico: filiais que vão para o app, categorias, política de preço por filial e como o estoque é controlado hoje.
- Mapeamento: de-para de lojas e filiais, códigos de barras e itens de balança, regra dos descontos, cobrança e operação fiscal da NFC-e.
- Go-live assistido: filial piloto, primeiros pedidos acompanhados e entrada das demais filiais em ondas.
- Monitoramento: painel de logs, fila e reprocessamento de falhas, com alerta quando um item ou pedido não passa.
Quer saber o que precisa estar pronto no seu cadastro antes de ligar o iFood Mercado? Um diagnóstico evita surpresa no primeiro pedido. Fale com a Plugar.me e comece pelo diagnóstico do seu WinThor.
Conclusão
A integração WinThor iFood Mercado leva o estoque e o preço de cada filial para o app e traz o pedido de volta para o ERP, sem tirar o WinThor do comando. A loja vende com o saldo real, confirma no prazo, separa com as regras do iFood e emite a NFC-e na mesma rotina do caixa.
Para uma rede, a diferença está no desenho por filial e na manutenção das regras do canal. O conector de catálogo resolve uma parte; o pedido, a nota e a conciliação pedem a integração completa.
As regras de cada documento fiscal estão no Portal Nacional da Nota Fiscal Eletrônica, e a integração faz a venda do app seguir a rotina de cada loja.
Fale agora com a Plugar.me e descubra como conectar o seu WinThor ao iFood Mercado com o ERP no comando. Conte quantas filiais você quer levar ao app e a gente desenha a integração certa para a sua rede.
Na lista pública de parceiros do iFood Mercado, o Winthor aparece com integração de produtos, e não de pedidos. Para que o pedido também entre no ERP, o caminho é uma integração própria ou um hub que conecte o WinThor ao canal, como a Plugar.me.
As APIs do iFood são gratuitas para quem atende aos requisitos, como CNPJ com atividade de tecnologia e a homologação do aplicativo. O custo de uma integração está em construir e manter as regras do canal.
Pode. O iFood aceita o código interno de balança, além do EAN-13 e do EAN-8, desde que cada item tenha um código único no cadastro.
Até 8 minutos. Sem confirmação nesse prazo, o iFood cancela o pedido de forma automática.
O iFood aceita mudanças em até 25% do catálogo a cada 30 minutos, por loja. Por isso, a integração envia só o que mudou, a cada alteração no WinThor.
A filial, no WinThor. Na entrega ao consumidor final, o documento é a NFC-e, com o iFood informado como intermediador.
Dá. Cada loja do app corresponde a uma filial do ERP, com o seu estoque, o seu preço e a sua nota, e o aplicativo centralizado do iFood permite administrar todas com uma só credencial.
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.
