Integração com o iFood
Conecte a loja ao iFood para os pedidos chegarem na cozinha, imprimirem a comanda e voltarem ao iFood com a situação certa. Importe o cardápio, vincule os itens e fature com a NFC-e.
9 min de leitura · Intermediário · atualizado em 04/11/2026
A integração com o iFood faz os pedidos feitos no aplicativo chegarem à mesma fila da cozinha do Delivery, com a comanda impressa e a situação do pedido de volta para o iFood a cada passo (confirmado, em preparo, pronto, saiu para entrega, cancelado). Quem busca e responde ao iFood é o servidor: o computador da loja não precisa estar ligado para o pedido chegar.
Este guia cobre o caminho completo, do primeiro acesso ao dia a dia:
- Conectar a loja.
- Escolher como aceitar os pedidos.
- Importar o cardápio do iFood.
- Atender os pedidos (prazo, entrega, comanda).
- Vincular itens que o sistema não reconhece.
- Faturar e emitir a NFC-e com o pagamento real.
Para receber pedidos reais, o iFood exige que o aplicativo da plataforma seja homologado. Até lá, a integração recebe só pedidos de teste (aparecem com "PEDIDO DE TESTE" nas observações). Quem cuida da homologação e das chaves é a BitKernel.
1. Conectar a loja
A conexão com o iFood (as chaves do aplicativo) é da plataforma: você não precisa de nenhuma chave. Você só precisa de duas coisas:
- Autorizar o aplicativo no portal do iFood. No portal do parceiro, a sua loja precisa ter autorizado o aplicativo da plataforma.
- O código da loja no iFood (também chamado Merchant ID), que é um código longo com letras, números e hífen.
2Informar o código da loja
Preencha o nome da loja no iFood (só para você se localizar) e o código da loja (Merchant ID). Clique em Salvar.
3Testar a conexão
Clique em Testar conexão. Se aparecer Conexão com o iFood funcionando, está tudo certo. Se o iFood recusar, a mensagem diz o motivo (por exemplo, a loja ainda não autorizou o aplicativo).
4Ativar
Marque Integração ativa e salve. A partir daí o servidor consulta o iFood duas vezes por minuto. O botão Buscar pedidos agora confere na hora, sem esperar.
Se o servidor ficar mais de 3 minutos sem consultar o iFood, a tela mostra um aviso em amarelo. Com a integração parada a loja pode ficar offline no iFood: avise o suporte.
2. Como aceitar os pedidos
O iFood dá um prazo curto (8 minutos) para confirmar um pedido novo; sem confirmação, ele cancela. Escolha:
- A equipe confirma cada pedido no painel. Alguém precisa acompanhar Delivery › Pedidos e cozinha.
- O sistema confirma o pedido assim que ele chega. O pedido já entra confirmado e vai direto para a cozinha.
Acompanhar o prazo
No painel de pedidos, o pedido do iFood ainda não confirmado mostra um aviso com o tempo que falta (confirmar em N min), que fica em vermelho quando está acabando e vira prazo do iFood esgotado se o tempo passou. O painel se atualiza sozinho a cada 20 segundos, então um pedido novo aparece sem você recarregar a página.
3. Importar o cardápio do iFood
Se a loja já tem cardápio no iFood, não digite tudo de novo. O bloco Importar do iFood lê a sua loja e deixa o sistema pronto: cria os produtos, o cardápio de delivery e os horários de funcionamento.
5Ler o cardápio
Clique em Ler cardápio do iFood. Nada é gravado ainda: aparece a prévia com as categorias, os pratos, os preços e as escolhas (complementos) de cada prato.
6Revisar
Desmarque as categorias que não quer importar. Se o iFood tem horários de funcionamento, marque se quer importá-los também para o Delivery.
7Importar
Clique em Importar selecionados. O sistema grava tudo e mostra um resumo (quantos pratos, produtos novos, categorias e grupos de escolhas).
O que você precisa saber:
- O cardápio de delivery nasce desligado. Revise em Delivery › Cardápio de delivery e ative quando quiser.
- Produto que já existe no cadastro (mesmo código do iFood ou mesmo nome) é reaproveitado e mantém o seu preço. Só os produtos novos recebem o preço do iFood, que costuma ser diferente do balcão: confira os preços.
- Pratos pausados no iFood entram ocultos no cardápio.
- Fotos não são importadas. Cadastre as fotos nos produtos.
- Pode importar de novo quando o cardápio mudar: o que já existe não é duplicado.
- Para os pedidos casarem com o cadastro, o item do iFood precisa ter o código do produto. Nos itens que vieram sem código, aparece o botão Gravar os códigos no iFood, que grava no iFood o código do produto criado.
Antes de importar, o sistema precisa ter uma tabela de preço padrão e unidades de medida cadastradas. Se faltar, a mensagem diz o que cadastrar.
4. Atender os pedidos
Os pedidos do iFood aparecem em Delivery › Pedidos e cozinha, junto com os do cardápio e do telefone, com a origem iFood.
- Confirmar, iniciar preparo, marcar pronto, saiu e entregue: cada botão atualiza o pedido e avisa o iFood.
- Entrega: cada pedido diz quem entrega. Se a entrega é da sua loja, o painel mostra Saiu para entrega e Entregue. Se é do entregador do iFood, basta marcar o pedido como Pronto: o iFood cuida do resto e o sistema acompanha.
- Cancelar: o cancelamento do painel é enviado ao iFood com um motivo válido. O pedido só fica cancelado de vez quando o iFood confirma.
- Comanda: o pedido imprime a comanda da cozinha com o número do iFood, o código de coleta, o localizador, as escolhas de cada prato e a forma de pagamento (pago no app ou cobrar na entrega, com troco).
Pagamento
O iFood informa como o cliente pagou. Pago no aplicativo (cartão, PIX, vale), o pedido não precisa ser cobrado de novo. O que ficou para a entrega aparece em destaque na comanda (COBRAR NA ENTREGA), com o troco.
5. Itens que o sistema não reconhece
Se um item do pedido não tem o código do produto, o pedido mostra item sem cadastro. Vincule o item a um produto uma vez e o sistema lembra nos próximos pedidos. Veja o guia Vincular item do iFood a um produto.
6. Faturar e emitir a NFC-e
Com o caixa aberto, o botão Faturar + NFC-e fecha o pedido no caixa e emite a nota com o pagamento real que o cliente usou no aplicativo (crédito, débito, PIX, vale-refeição ou vale-alimentação). No fechamento do caixa, as vendas pagas no aplicativo aparecem separadas, como recebido pela plataforma (repasse). Veja o guia Faturar o pedido do Delivery e emitir a NFC-e em um clique.
Se algo não funcionar
| Sintoma | O que verificar |
|---|---|
| O iFood ainda não foi habilitado pela plataforma | As chaves do aplicativo ainda não foram cadastradas pela BitKernel. Fale com o suporte. |
| O iFood negou o acesso à loja | A loja precisa autorizar o aplicativo no portal do iFood. |
| O iFood recusou o Client ID ou o Client Secret | Problema nas chaves da plataforma. Avise o suporte. |
| Aviso de que o servidor não busca pedidos | O servidor ficou alguns minutos sem consultar o iFood. Use Buscar pedidos agora e, se persistir, avise o suporte. |
| Pedido não chega | Confira se a Integração ativa está marcada, se o código da loja está certo e se é pedido de teste ou real (reais só depois da homologação). |
| Cancelamento recusado pelo iFood | O motivo aparece no histórico do pedido. Cancelamentos fora do prazo ou de pedidos já entregues podem não ser aceitos. |
O que ainda não é automático
- Quando o cliente altera os itens de um pedido já feito, ou pede mudança de endereço, ou abre uma disputa, o sistema apenas registra o aviso no histórico: acompanhe também pelo Portal do Parceiro do iFood.
- Cupons e taxas do iFood ainda não entram no total do pedido nem na conciliação do repasse.
- O cardápio é mantido no iFood: o sistema lê e importa, mas não envia alterações do seu cardápio para o iFood (exceto o código dos produtos, quando você pede).
Quer avaliar este guia ou usar o sistema? Entre ou cadastre-se.
