A conexão com o iFood é feita por um código de vínculo: a Toca gera um código, você autoriza a Toca no Portal do Parceiro do iFood e cola de volta na Toca o código de autorização que o iFood mostra. Nenhuma senha do iFood é digitada na Toca.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
Além disso, o iFood só libera lojas reais para aplicativos homologados por ele. Enquanto o aplicativo da Toca não concluir essa homologação, a conexão funciona apenas com lojas de teste.
Antes de começar
- Quem conecta precisa ser o responsável pela loja no Portal do Parceiro do iFood.
- Faça os passos de uma vez: o código de vínculo vale 10 minutos, e o código de autorização vale 5 minutos depois que você clica em Autorizar no iFood.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card iFood e clique em Conectar.
- No painel, clique em Gerar código de vínculo. A Toca mostra o código.
- Clique em Abrir o Portal do Parceiro e autorizar, entre com o usuário responsável pela loja e clique em Autorizar. Se o link não abrir, entre no Portal do Parceiro, vá em
Serviços e soluções → Integrações → Ativar aplicativo via códigoe digite o código. - Copie o código de autorização que o iFood mostra.
- Volte à Toca, cole o código no campo Código de autorização e clique em Concluir conexão. O card fica marcado como conectado, com o nome da loja.
O que a Toca acessa
Com a conexão ativa, a Toca lê as vendas e o faturamento por pedido, os repasses, taxas e lançamentos financeiros, os indicadores de pedidos (com um dia de atraso), as avaliações e a nota da loja, o cardápio com preços, disponibilidade e estoque, as promoções, o status, as pausas e os horários da loja e o detalhe de um pedido específico. Se a autorização alcançar mais de uma loja, a Toca enxerga todas elas na mesma conexão.
A Toca também altera: pausa a loja e ajusta horários; muda preço, disponibilidade e estoque do cardápio; cria, edita e exclui itens do cardápio; cria e altera promoções; responde avaliações; e avança etapas de pedidos e entregas, inclusive cancelamentos. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat. A resposta a uma avaliação é pública, e a integração não consegue apagá-la depois.
A fila de pedidos em tempo real continua com o seu Gestor de Pedidos ou PDV: a Toca não a consulta, porque ler essa fila deixa a loja online no iFood e tira pedidos da fila do seu sistema.
Manutenção da conexão
A Toca renova o acesso automaticamente. A renovação do iFood deixa de valer depois de 7 dias sem uso, então a Toca a refaz a cada 3 dias para a conexão não vencer.
Se o acesso for revogado no Portal do Parceiro — só o usuário que autorizou pode revogar — ou a renovação falhar, abra o card em Configurações → Integrações pelo botão Gerenciar, gere um novo código de vínculo, autorize de novo no Portal do Parceiro e conclua com Reconectar.
Problemas comuns
- O iFood não aceitou o código de autorização — ele vale 5 minutos depois do Autorizar. Gere um novo código de vínculo e repita os passos sem pausa.
- O código de vínculo expirou — ele vale 10 minutos. Clique em Gerar outro código e comece de novo.
- O iFood autorizou, mas nenhuma loja foi encontrada — o iFood leva até 10 minutos para propagar a permissão. Aguarde e gere um novo código.
- Uma loja real não conecta, ou parte das consultas volta com acesso negado — o que a Toca alcança depende da homologação do aplicativo da Toca no iFood e dos módulos que o iFood libera para ele. Até a homologação, só lojas de teste conectam.
- Períodos longos de vendas — o iFood aceita até 90 dias por consulta de vendas e até 33 dias por consulta de lançamentos financeiros. A Toca divide o período em pedaços menores.
- Foto do cardápio e tempo de preparo — esses ajustes não passam pela Toca. A foto se envia pelo Portal do Parceiro; o tempo de preparo se ajusta no Portal do Parceiro ou no Gestor de Pedidos.