Integração iFood
A integração com o iFood permite que pedidos feitos na plataforma iFood cheguem automaticamente ao painel do MeuCardapio.ai. Gerencie pedidos, acompanhe entregas e importe o cardápio sem precisar alternar entre sistemas.
O que a integração oferece
| Recurso | Descrição |
|---|---|
| Recebimento de pedidos | Pedidos do iFood aparecem no painel em tempo real via polling de eventos |
| Aceite automático | Configure para aceitar pedidos automaticamente, sem intervenção manual |
| Entrega iFood (Shipping API) | Solicite entregadores do iFood para pedidos do seu cardápio próprio |
| Cotação de frete | Obtenha cotações de entrega do iFood antes de confirmar o despacho |
| Importação de cardápio | Importe categorias, produtos, adicionais e imagens direto do iFood |
| Formas de pagamento | Sincronize automaticamente as formas de pagamento aceitas pelo iFood |
| Rastreamento de entrega | Acompanhe o status do entregador em tempo real |
| Cancelamentos e disputas | Gerencie solicitações de cancelamento e disputas diretamente no painel |
Pré-requisitos
Antes de configurar a integração, certifique-se de que:
- Possui uma conta ativa no iFood com loja publicada
- Possui acesso ao Portal do Parceiro iFood
- A loja no MeuCardapio.ai está com as formas de pagamento por bandeira habilitadas (obrigatório para ativar Order API e Shipping API)
Somente empresas configuradas com as novas formas de pagamento (bandeiras) podem ativar a Order API e a Shipping API. Configure as formas de pagamento antes de iniciar a integração.
Ativar a integração
Passo 1 - Gerar código de vínculo
-
Acesse Configurações > Integrações > iFood
-
Clique em Vincular loja iFood
-
O sistema gera um código de usuário (User Code) e um link de verificação
-
Copie o código exibido na tela
O código de vínculo possui tempo de expiração. Se expirar, gere um novo código clicando novamente em "Vincular loja iFood".
Passo 2 - Autorizar no portal iFood
- Acesse o link de verificação exibido na tela (ou vá ao Portal do Parceiro iFood)
- Informe o código de usuário gerado no passo anterior
- Autorize o acesso do MeuCardapio.ai à sua loja
Passo 3 - Confirmar autorização
- Volte ao MeuCardapio.ai
- Clique em Confirmar autorização
- Informe o código de autorização recebido do iFood e o ID da loja (merchantId)
- O sistema obtém o token de acesso e vincula a loja automaticamente
Após a confirmação, a integração aparece como ativa na lista de integrações.
Passo 4 - Configurar módulos da API
Escolha quais módulos ativar na integração:
| Módulo | Função |
|---|---|
| Order API | Recebe e gerencia pedidos vindos do iFood |
| Shipping API | Solicita entregadores do iFood para pedidos do seu cardápio próprio |
- Na integração ativa, clique em Editar
- Ative Order API para receber pedidos do iFood
- Ative Shipping API se quiser usar entregadores do iFood para pedidos do seu site
- Clique em Salvar
Se ativar a Shipping API, configure também:
- Solicitar automaticamente: o sistema solicita entregador assim que o pedido é aceito
- Confirmar cotação: exige confirmação manual da cotação antes de solicitar entregador
Fluxo de pedidos
Ciclo de vida do pedido iFood
Novo (PLC) → Confirmado (CFM) → Pronto para Retirada (RTP) → Despachado (DSP) → Concluído (CON)
↘ Cancelado (CAN)
| Etapa | Código | Descrição | Ação no painel |
|---|---|---|---|
| Novo | PLC | Pedido recebido do iFood | Aceite ou rejeite o pedido |
| Confirmado | CFM | Pedido aceito pela loja | Inicie o preparo |
| Pronto | RTP | Pedido pronto para retirada | Aguarde o entregador |
| Despachado | DSP | Pedido saiu para entrega | Acompanhe a entrega |
| Concluído | CON | Pedido entregue ao cliente | Pedido finalizado |
| Cancelado | CAN | Pedido cancelado | Verifique o motivo |
Aceite automático
Ative o aceite automático para que pedidos do iFood sejam confirmados automaticamente assim que chegam. O sistema confirma o pedido e executa as operações pós-aceite (impressão, notificações).
Cancelamentos e disputas
O sistema gerencia três tipos de cancelamento:
| Tipo | Descrição |
|---|---|
| Cancelamento pela loja | Selecione o motivo na lista de razões fornecida pelo iFood |
| Cancelamento pelo cliente | Aceite ou rejeite a solicitação do cliente |
| Disputa (Handshake) | O iFood media a resolução entre loja e cliente |
Fluxo de entrega (Shipping API)
Quando a Shipping API está ativa, acompanhe o entregador em tempo real:
| Status | Descrição |
|---|---|
| Cotado | Cotação de entrega recebida do iFood |
| Pendente | Aguardando alocação de entregador |
| Solicitado | Entregador solicitado ao iFood |
| Negado | iFood não conseguiu alocar entregador |
| Alocado | Entregador atribuído ao pedido |
| A caminho da loja | Entregador indo buscar o pedido |
| Pedido coletado | Entregador retirou o pedido |
| Chegou ao destino | Entregador chegou no endereço do cliente |
| Entrega confirmada | Entrega concluída com sucesso |
| Cancelado | Entrega cancelada |
Cotação de frete
Antes de solicitar o entregador, obtenha uma cotação:
- No pedido, clique em Nova cotação
- O sistema exibe: distância, tempo estimado, valor bruto, desconto e valor líquido
- Confirme a cotação para solicitar o entregador ou cancele para cotar novamente
Informações do entregador
Quando o entregador é alocado, o sistema exibe:
- Nome do entregador
- Tipo de veículo (carro, moto)
- URL de rastreamento em tempo real
- Código de confirmação de entrega (quando aplicável)
Alteração de endereço
O cliente pode solicitar alteração do endereço de entrega pela página de rastreio. Aceite ou rejeite a solicitação no painel.
Importação de cardápio
Importe o cardápio diretamente do iFood para o MeuCardapio.ai.
Importação por link
- Acesse Produtos > Importar > iFood
- Cole o link da loja no iFood (ex:
https://www.ifood.com.br/delivery/.../sua-loja/abcd-1234-efgh) - Opcionalmente, informe um percentual de redução no preço (para ajustar valores entre plataformas)
- Clique em Importar
Importação via API Oficial
Para lojas já integradas via API, a importação utiliza o catálogo oficial do iFood:
- O sistema busca o catálogo completo (categorias, produtos, grupos de opcionais)
- Importa automaticamente: nome, descrição, preço, imagem, adicionais e disponibilidade
- Mapeia os horários de disponibilidade por dia da semana
O que é importado
| Item | Detalhes |
|---|---|
| Categorias | Nome, posição, código iFood |
| Produtos | Nome, descrição, preço, imagem, código PDV, disponibilidade |
| Adicionais | Grupos de escolha simples e múltipla escolha com opções, preços e limites (min/max) |
| Imagens | Baixadas automaticamente do servidor do iFood |
| Disponibilidade | Horários e dias da semana em que cada produto está disponível |
| Templates (Pizza) | Tamanhos, sabores e adicionais de produtos no formato pizza |
A importação cria novos produtos e categorias. Se já existirem produtos cadastrados, os importados serão adicionados sem substituir os existentes.
Formas de pagamento
Ao ativar a integração, o sistema cadastra automaticamente as formas de pagamento do iFood:
- iFood Online: pagamentos feitos pelo app do iFood (Pix, cartão de crédito online)
- iFood na Loja: pagamentos na entrega, com bandeiras separadas (Visa, Master, Elo, etc.)
Para sincronizar novas bandeiras adicionadas pelo iFood:
- Acesse Configurações > Integrações > iFood
- Clique em Sincronizar formas de pagamento
Gerenciar integrações
Desativar temporariamente
Desative a integração sem remover a configuração:
- Na lista de integrações iFood, clique em Desativar
- O sistema para de fazer polling de eventos para essa loja
- Para reativar, clique em Ativar
Remover integração
Para remover completamente a integração:
- Clique em Remover na integração desejada
- Confirme a remoção
Remover a integração apaga as credenciais. Para reconectar, será necessário refazer todo o processo de vinculação.
Múltiplas lojas
O sistema suporta vincular múltiplas lojas iFood a uma mesma empresa. Cada loja possui sua própria integração, token e configurações independentes.
Verificar status da loja
Consulte se a loja está aberta ou fechada no iFood:
- Acesse Configurações > Integrações > iFood
- Clique em Status da loja
- O sistema exibe: estado (aberta/fechada), motivo e mensagem do iFood
Solução de problemas
| Problema | Causa provável | Solução |
|---|---|---|
| Código de vínculo expirou | O código tem validade limitada | Gere um novo código e repita o processo |
| "Nenhuma integração iFood ativa" | Integração não configurada ou desativada | Verifique se a integração está ativa em Configurações |
| Pedidos não chegam | Order API desativada ou token expirado | Ative a Order API e verifique se o token está válido |
| "Somente empresas configuradas com novas formas de pagamento..." | Formas de pagamento por bandeira não habilitadas | Habilite as formas de pagamento por bandeira antes de ativar a API |
| Entregador não é alocado | Região saturada ou fora do horário | Tente solicitar novamente ou use entregador próprio |
| Falha ao importar cardápio | Link inválido ou loja não encontrada | Verifique se o link é de uma loja ativa no iFood |
| Loja aparece como fechada | Horário fora do expediente ou pausa manual | Verifique o status no Portal do Parceiro iFood |
| Erro ao confirmar pedido | Pedido já expirou no iFood | O iFood cancela pedidos não confirmados após o prazo limite |
Perguntas frequentes
Preciso ter uma conta de desenvolvedor no iFood?
Não. O MeuCardapio.ai já possui as credenciais de integração configuradas. Basta vincular sua loja usando o código de usuário gerado no painel.
Posso usar a entrega do iFood para pedidos do meu site?
Sim. Ative a Shipping API na integração e o sistema permite solicitar entregadores do iFood para qualquer pedido, mesmo os que vieram pelo seu cardápio online próprio.
A importação de cardápio substitui meus produtos existentes?
Não. Os produtos importados do iFood são adicionados como novos itens. Produtos já cadastrados permanecem inalterados.
Posso vincular mais de uma loja iFood?
Sim. O sistema suporta múltiplas integrações iFood por empresa. Cada loja tem seu próprio token e configurações. Repita o processo de vinculação para cada loja.
O que acontece se o token expirar?
O sistema renova o token automaticamente usando o refresh token. Se o refresh token também expirar, será necessário refazer o processo de autorização.
Consigo aceitar pedidos automaticamente?
Sim. Ative o aceite automático nas configurações da empresa. Todos os pedidos do iFood serão confirmados assim que chegarem, sem necessidade de intervenção manual.
A taxa de entrega do iFood é repassada ao cliente?
Quando o pedido vem do iFood, a taxa de entrega já está incluída no pedido. Para pedidos do seu site usando a Shipping API, a cotação de frete do iFood é aplicada como taxa de entrega.