iFood
A integração com o iFood liga a sua loja no iFood ao idworks: os pedidos entram sozinhos e são confirmados no iFood, os itens do cardápio são publicados e atualizados a partir dos anúncios do Hub (nome, descrição, imagem, preço e disponibilidade) e os itens que já existem no iFood podem ser importados para o idworks. A configuração reúne 21 parâmetros em 4 grupos: Credenciais de Acesso (1), Integração de Vendas (3), Integração de Produtos (5) e Importação de Anúncios (12).
Antes de começar: o iFood recebe só disponível ou indisponível, não a quantidade em estoque. E um pedido abaixo do Valor mínimo do pedido (R$ 20,00 quando o campo fica vazio) não é confirmado no iFood nem vira pedido no idworks. Veja Como o estoque é enviado ao iFood? e Por que um pedido do iFood não virou pedido no idworks?.
Categoria no catálogo do idworks: Canal de Venda.
Índice
Conceito
Cadastro e acesso
Parâmetros por grupo
Pedidos
- Como os pedidos do iFood entram no idworks?
- Por que um pedido do iFood não virou pedido no idworks?
- O que acontece quando o pedido muda de status no iFood?
Itens do cardápio
- Como publicar um item no cardápio do iFood?
- Como o preço é enviado ao iFood?
- Como o estoque é enviado ao iFood?
Limites
Referência rápida
O que é a integração iFood?
É a conexão entre a sua loja no iFood e o idworks. Ela cobre três frentes: pedidos (entram sozinhos, são confirmados no iFood e viram pedido no idworks), itens do cardápio (você publica e atualiza os itens a partir dos anúncios do Hub) e importação dos itens que já estão no iFood para dentro do idworks.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → Ifood (é assim que o nome aparece no catálogo).
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Ifood e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir mais de uma loja do iFood.
- Clique em Salvar. A integração aparece em Minhas Integrações já com status Ativo: o iFood não tem a etapa Autenticar Integração (cadeado).
- Na linha da integração, abra a Configuração (ícone de engrenagem), preencha o Merchant Id no grupo Credenciais de Acesso e ligue as opções que quiser em Integração de Vendas e Integração de Produtos.
- Clique em Salvar e confirme.
Pré-requisitos: privilégio Criar parametrizações empresa para ativar e Editar parametrizações empresa para configurar.
Como o idworks acessa a sua loja no iFood?
Não há usuário, senha ou chave da loja para digitar. O idworks se conecta ao iFood com a credencial do próprio aplicativo da idworks, obtém o token de acesso sozinho e usa o Merchant Id para saber de qual loja são os pedidos e para qual loja enviar os itens. Por isso:
- O Merchant Id precisa ser o ID exato da sua loja no iFood. Os avisos de pedido que o iFood manda são ligados à integração por esse ID. Com ele vazio, nenhum pedido é importado, e a publicação de itens, o preço e a disponibilidade param com a mensagem
Credenciais não encontradas para iFood. - A tela do iFood não tem o botão Validar credenciais. A dica do campo fala em preenchimento automático ao validar, mas, como essa ação não aparece na tela, informe o ID à mão.
- A integração passa para Erro na listagem quando a renovação do token falha ou quando o iFood recusa o acesso à loja (erro 403) ao receber a disponibilidade de um item.
Credenciais de Acesso
1 parâmetro.
| Parâmetro | Tipo | O que preencher |
|---|---|---|
| Merchant Id | Texto | ID da sua loja no iFood. É por ele que o idworks reconhece os pedidos da loja e envia itens, preço e disponibilidade. |
Integração de Vendas
3 parâmetros.
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Importar pedidos | Sim/Não | Ligado, o idworks importa os pedidos da loja. Desligado, os avisos de pedido do iFood são ignorados e nenhum pedido entra. |
| Valor mínimo do pedido | Decimal | Pedido com valor total abaixo deste valor não é confirmado no iFood nem criado no idworks. Campo vazio vale R$ 20,00. Preencha 0 para confirmar todos os pedidos. |
| Cancelamento automático | Sim/Não | Ligado, quando o iFood informa o cancelamento, o idworks cancela o pedido. Desligado, o pedido recebe uma ocorrência de tratativa para você cancelar à mão. |
Os pedidos só são importados com a integração Ativa (ou em Erro). Integração Inativa não importa pedidos nem atualiza status, mesmo com Importar pedidos ligado.
Integração de Produtos
5 parâmetros.
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Atualizar categoria | Sim/Não | Libera o envio da categoria do idworks ao cardápio do iFood. Hoje, para o iFood, a ação Reprocessar de Integrações (HUB) → Hub Categorias responde "Integração não tem recurso" (ver O que a integração iFood não faz?). |
| Atualizar produto | Sim/Não | Libera a ação Sincronizar Produto, que cria ou atualiza o item no cardápio do iFood. Desligado, a sincronização responde configuração cadastro de produto não está ativa. |
| Atualizar preço | Sim/Não | Libera a ação Sincronizar Preço. Desligado, ela responde Configuração para atualizar o preço não está habilitado. |
| Atualizar saldo estoque | Sim/Não | Liga o envio da disponibilidade (disponível ou indisponível) ao iFood, automático quando o estoque muda e pela ação Sincronizar Saldo Estoque. Desligado, nada é enviado e o anúncio registra configuração de saldo estoque não está ativa. |
| Estoque de segurança | Decimal | Quantidade usada quando o SKU não tem estoque de segurança próprio. Veja a regra completa em Como o estoque é enviado ao iFood?. |
Ao salvar uma mudança em Atualizar saldo estoque ou Estoque de segurança, o idworks reenvia a disponibilidade de todos os anúncios ativos da integração.
Importação de Anúncios
12 parâmetros. Ficam na aba Importação de Anúncios da configuração da integração, e não em Configurações Gerais. A importação lê todos os catálogos e categorias da loja no iFood e traz cada item como anúncio do idworks.
Como importar:
- Na linha da integração, abra a Configuração (ícone de engrenagem) e vá à aba Importação de Anúncios.
- Ligue as opções que quiser (tabela abaixo).
- Clique em Importar Anúncios e confirme "Confirma a importação dos anúncios para esta integração?". O idworks salva as opções marcadas e roda a importação em segundo plano.
- Acompanhe na própria aba: Data início, Data finalização, Quantidade, Usuário e Progresso importação (use Atualizar Dados para recarregar). Ao terminar, quem iniciou recebe o resultado por e-mail.
Enquanto uma importação está em andamento, o botão fica desabilitado: só roda uma por integração de cada vez.
Como o item é ligado ao Produto/SKU: o idworks procura o SKU cujo código é igual ao código externo do item no iFood (se o item não tiver, ao código externo do produto no iFood; se também não tiver, ao ID do item). Não achando pelo código, procura pelo EAN. Itens disponíveis no iFood entram como anúncio ativo; os indisponíveis, como inativos.
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Importar anúncios sem Produto/SKU correspondente | Sim/Não | Ligado, também importa os itens que não acharam Produto/SKU; eles entram sem vínculo, para você associar depois. Desligado, esses itens ficam de fora e o log registra Não foi encontrado sku/produto referente ao anúncio. |
| Não Realizar o vínculo do Anúncio ao Produto/SKU | Sim/Não | Importa todos os itens sem vincular a nenhum Produto/SKU, mesmo os que têm correspondência. |
| Incluir Título na ficha do Anúncio | Sim/Não | Grava o nome do item no iFood como título do anúncio. Desligado, vale o nome do cadastro do produto. |
| Incluir Descrição na Ficha do Anúncio. | Sim/Não | Grava a descrição do item no iFood na ficha do anúncio. A descrição que o idworks envia ao iFood ao sincronizar continua sendo a do cadastro (ver Como publicar um item no cardápio do iFood?). |
| Incluir Preços na ficha do Anúncio | Sim/Não | Grava no anúncio o preço de venda e o preço "de" do iFood (o preço original, quando é maior que o de venda). Desligado, vale o preço da política comercial do produto. |
| Incluir Imagem dentro do Anúncio | Sim/Não | Traz a imagem do item no iFood para o anúncio. |
| Incluir Imagem dentro do Produto | Sim/Não | Traz a imagem do item para o cadastro do SKU. Só tem efeito com Criar Produto/SKU, com base no Anúncio Importado. ligado. |
| Atualizar anúncios já importados | Sim/Não | Atualiza os anúncios que já existem no idworks. Desligado, eles são pulados. Com Criar Produto/SKU, com base no Anúncio Importado. ligado, também reescreve nome, descrição, categoria e peso do SKU existente com os dados do iFood e marca o SKU como produto normal (sem variação). |
| Importar somente anúncios ativos | Sim/Não | Importa só os itens com status disponível no iFood. Os pausados ou indisponíveis são ignorados. |
| Criar Produto/SKU, com base no Anúncio Importado. | Sim/Não | Quando o item não acha Produto/SKU, cria o cadastro como produto normal (sem variação), com nome, descrição, categoria, peso bruto e líquido, EAN e preço do iFood. O preço vai para a política comercial padrão da empresa (sem ela, a importação para com empresa não tem politica comercial padrão). A categoria do iFood é procurada pelo nome no idworks e criada se não existir, e o De-Para dela fica gravado em Hub Categorias. Na criação, o EAN só é gravado se nenhum outro SKU já usa o mesmo código. |
| Criar Produto ou SKU Único (Todos Anúncios terá um produto único associado) | Sim/Não | Usa o ID do item no iFood como código do Produto/SKU, em vez do código externo, tanto para procurar quanto para criar o cadastro. Assim cada item importado fica com um Produto/SKU só dele. |
| Baixar imagens em segundo plano | Sim/Não | Na importação iniciada por esta aba, as imagens já são sempre baixadas em segundo plano, com a opção ligada ou desligada. |
Pré-requisito: privilégio Importar Produto / Anúncio. Sem ele, a aba fica desabilitada.
Como os pedidos do iFood entram no idworks?
Com Importar pedidos ligado, o idworks recebe os avisos de pedido do iFood e também consulta a fila de eventos da loja. Para cada pedido novo:
- Busca o pedido completo no iFood e grava em Integrações (HUB) → Pedidos Integrados: cliente (nome, CPF/CNPJ, e-mail e telefone, quando o iFood envia), endereço de entrega, itens, pagamentos e totais.
- Compara o valor total do pedido com o Valor mínimo do pedido (R$ 20,00 quando o campo está vazio).
- Se o valor alcança o mínimo, confirma o pedido no iFood e cria o pedido no idworks.
Como os dados do iFood chegam ao pedido:
| No iFood | No idworks |
|---|---|
| Data de criação | Data do pedido, convertida para o horário de Brasília. |
| Taxa de entrega | Frete do pedido. |
| Taxas adicionais | Despesas acessórias do pedido. |
| Itens | Preço unitário e quantidade do iFood. As observações do item ficam no comentário do item. |
| Benefícios (descontos e cupons) | Ficam no pedido integrado como desconto, mas não são lançados como desconto nos itens do pedido idworks. |
| Formas de pagamento | Um pagamento para cada forma, em 1 parcela, com adquirente ifood. |
| Quem entrega | Código de transportadora do canal: IFOOD (entregador do iFood), MERCHANT (entrega da própria loja) ou TAKEOUT (retirada). |
Vínculo dos itens. O item do pedido é ligado ao SKU nesta ordem: (1) SKU com código igual ao ID do item no iFood (o código usado por Criar Produto ou SKU Único); (2) SKU com código igual ao código externo do item (SKU do tipo Produto com variação não entra); (3) ao criar o pedido, o SKU que já está ligado a esse item do iFood pelo anúncio do Hub, seja porque o idworks publicou o item, seja porque a importação casou o SKU por código ou EAN, seja porque você associou o SKU ao anúncio em Integrações (HUB) → Anúncios. Os itens publicados pelo idworks já vão ao iFood com o código do SKU como código externo. Só se nenhuma das três achar o SKU, o pedido para com Anúncio/variação não vinculado (ver Pedidos Integrados); para resolver sem mexer em código, associe o SKU ao anúncio em Integrações (HUB) → Anúncios ou vincule-o ao item (ver Como vinculo um SKU local a um anúncio do canal?).
Armazém, tipo de pagamento e transportadora seguem os De-Paras da integração (ação De-Paras na linha da integração, disponível com status Ativo). Veja Como o sistema decide o armazém, tipo de pedido e tipo de pagamento?.
Por que um pedido do iFood não virou pedido no idworks?
- Valor abaixo do mínimo. O processamento para com
Pedido abaixo do valor mínimo de R$ 20,00. Confirmação bloqueada para tratamento manual.(com o valor configurado). O pedido fica em Pedidos Integrados, sem confirmação no iFood e sem pedido no idworks: confirme ou recuse direto no iFood. Para que pedidos menores entrem, reduza o Valor mínimo do pedido (com0, todos entram). - O iFood recusou a confirmação. O processamento para com
Falha ao confirmar pedido no iFoode o pedido não é criado. - Merchant Id errado ou vazio. Os avisos do iFood não acham a integração e o pedido nem chega a Pedidos Integrados.
- Item sem vínculo. O pedido para com
Anúncio/variação não vinculado(ver Como os pedidos do iFood entram no idworks?). - Falta De-Para. Com Validar se pedido integrado possui de/para antes de criar ligado (Configurações → Parametrizações → Integração de Vendas), o pedido para com
Pedido não tem de/para de transportadora. No canal: 'IFOOD'(ouMERCHANT/TAKEOUT),Pedido não tem de/para de tipo de pagamentoouPedido não tem de/para de armazém. O iFood não informa código de armazém nos itens, então o De-Para de armazém é procurado com origem vazia e a mensagem mostraNo canal: ''. O pedido já está confirmado no iFood e fica em Pedidos Integrados: cadastre o De-Para em Hub Transportadora, Hub Pagamento ou Hub Estoque (ou pelo botão Criar DE-PARA em Pedidos Integrados) e clique em Criar Pedido de novo. Com a validação desligada, o armazém sem De-Para cai no armazém padrão da empresa (ver Como o sistema decide o armazém, tipo de pedido e tipo de pagamento?).
O que acontece quando o pedido muda de status no iFood?
| Evento no iFood | O que o idworks faz |
|---|---|
| Pedido confirmado | Marca o pedido integrado como CONFIRMED e registra "Pedido confirmado no iFood" no pedido. |
| Cancelamento solicitado | Registra no pedido a tratativa "Cancelamento solicitado no iFood, aguardando confirmação". |
| Pedido cancelado | Busca o motivo no iFood. Com Cancelamento automático ligado, cancela o pedido com o comentário "Pedido cancelado no iFood. Motivo: ..."; se o status do pedido não permite cancelar, registra uma tratativa para verificar à mão. Com a opção desligada, registra a tratativa "cancelamento automático desabilitado, verificar manualmente". Se o pedido ainda não tinha sido criado no idworks, o pedido integrado ganha o problema Cancelar pedido. |
| Código de coleta ou de entrega solicitado | Registra o evento no pedido. |
| Pedido concluído | Marca o pedido como entregue. |
| Outros eventos | Atualizam o status do pedido integrado com o código do iFood. |
Evento de um pedido que ainda não foi importado é ignorado.
Como publicar um item no cardápio do iFood?
Antes de sincronizar, confira:
- Atualizar produto ligado e Merchant Id preenchido.
- O produto tem categoria no cadastro. Sem ela, a sincronização responde
Categoria não cadastrada no produto no ERP. - Essa categoria tem De-Para em Integrações (HUB) → Hub Categorias para uma categoria que já existe no cardápio do iFood. Sem ele, a sincronização responde
Categoria não cadastrada no iFood. Em Categoria canal, informe o código da categoria no iFood; se ela não estiver na lista, use Digite... e Adicionar (ver Hub Categorias). A importação com Criar Produto/SKU, com base no Anúncio Importado. já grava esse De-Para.
Como publicar: crie o anúncio do produto para a integração iFood em Integrações (HUB) → Anúncios (ver Como criar um anúncio?) e use Sincronizar → Sincronizar Produto (ver Como sincronizo anúncios com o canal?). Na primeira vez, o idworks cria o item no iFood e grava o vínculo; depois, a mesma ação atualiza o item. Se o iFood avisar que o item já existe com outro ID, o idworks corrige o vínculo para o item existente.
O que vai para o iFood:
| No iFood | Vem de |
|---|---|
| Nome | Título do anúncio. Vazio, o nome do SKU. |
| Descrição | Descrição completa do cadastro. Vazia, o nome. |
| Código externo | Código do SKU. |
| EAN | Código de barras do cadastro, quando houver. |
| Peso | Peso bruto do cadastro, em kg. |
| Imagem | A primeira imagem do anúncio ou do produto. |
| Categoria | A categoria do iFood definida no De-Para. |
| Preço | Preço de venda do anúncio; o preço "de" vai como preço original quando é maior. |
| Situação | Disponível se o anúncio está ativo; indisponível se está inativo. |
Para pausar um item no iFood, inative o anúncio no idworks e use Sincronizar Produto.
Como o preço é enviado ao iFood?
Com Atualizar preço ligado, use Sincronizar → Sincronizar Preço no anúncio. O idworks envia o preço de venda do anúncio e, como preço original, o preço "de" quando ele é maior que o de venda (senão, os dois iguais). Veja Como defino o preço do anúncio?.
O preço não vai sozinho ao iFood quando muda no idworks: é preciso sincronizar. Sincronizar Produto também envia o preço, mesmo com Atualizar preço desligado.
Como o estoque é enviado ao iFood?
O iFood recebe só a situação do item: disponível ou indisponível. Com Atualizar saldo estoque ligado, o idworks envia essa situação sempre que o saldo do SKU muda, quando você usa Sincronizar → Sincronizar Saldo Estoque e quando salva uma mudança em Atualizar saldo estoque ou Estoque de segurança.
A conta tem duas etapas:
- Saldo considerado = saldo disponível do SKU no armazém da integração (o De-Para de armazém ou, na falta dele, o armazém padrão da empresa), menos o estoque de segurança (o do SKU; se o campo do SKU estiver vazio, o Estoque de segurança da integração). Nunca fica abaixo de zero. Sem De-Para de armazém na integração, vale o armazém padrão da empresa; só se a empresa também não tiver armazém padrão ativo o saldo é zero. Com De-Para, vale um só armazém (o primeiro que não seja
fulfillmentnemonsite; se só houver esses, o saldo é zero) e os saldos de vários armazéns não são somados. SKU com Estoque Infinito ligado: o saldo considerado vale no mínimo 400, então, com estoque de segurança abaixo de 400, o item fica sempre disponível. - O item fica disponível quando o saldo considerado é maior que o estoque de segurança: o do SKU, quando é maior que zero; senão, o da integração.
Exemplo, para um SKU sem Estoque Infinito, com estoque de segurança 5: saldo 8 → 8 − 5 = 3, que não passa de 5 → indisponível. Saldo 11 → 11 − 5 = 6 → disponível. Quando o mesmo estoque de segurança vale nas duas etapas, o item só fica disponível com saldo acima do dobro dele. Um SKU com estoque de segurança 0 usa o Estoque de segurança da integração na etapa 2 (ver Estoque de Segurança e Alerta de Estoque).
O que a integração iFood não faz?
- Não envia quantidade em estoque, só disponível ou indisponível.
- Não envia ao iFood nota fiscal, etiqueta nem o andamento do pedido (preparo, pronto para retirada, despacho, entrega). Isso é feito no próprio iFood. Ao tentar enviar a NF de um pedido iFood, o idworks responde "Integração não tem envio de NF".
- Não traz a comissão nem as taxas do iFood para o resultado do pedido e não faz conciliação financeira: a integração não tem o grupo Conciliação.
- Não lança os benefícios do iFood (descontos e cupons) como desconto nos itens do pedido.
- Não atualiza o item nem o preço sozinho quando o cadastro ou o preço mudam no idworks: use Sincronizar Produto ou Sincronizar Preço.
- Não envia complementos (grupos de opções) nem restrições alimentares: o item vai simples, marcado para servir 1 pessoa, com uma imagem.
- Não cria a categoria no iFood pela tela. Para o iFood, Reprocessar em Hub Categorias responde "Integração não tem recurso". Crie a categoria no iFood e faça só o De-Para.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Abrir a Configuração (engrenagem), editar nome e status, abrir os De-Paras. |
| Deletar parametrizações empresa | Excluir a integração. |
| Importar Produto / Anúncio | Aba Importação de Anúncios. |
As ações de Sincronizar ficam em Integrações (HUB) → Anúncios e dependem do privilégio Sincronizar Anúncio.