Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integração com iFood

Use este manual para autorizar a integração com o iFood, configurar a filial no Cloud e operar pedidos no PDV.

O fluxo também cobre sincronização de produtos, widget, baixa de estoque e envio forçado ao PDV.

A integração funciona exclusivamente com contas iFood cadastradas na categoria Restaurante.

Lojas que operam no iFood em outras categorias, como Mercado, Farmácia ou Pet Shop, não são compatíveis.

Antes de prosseguir, valide a categoria da loja diretamente no portal de parceiros do iFood.

Ao utilizar a integração com iFood ou Delivery Legal, mantenha um equipamento exclusivo para recepcionar pedidos.

Não utilize maquininhas de cartão.

Certifique-se de que esse equipamento não esteja em ambientes com compartilhador (Raspberry).

🎥 Prefere assistir? Veja uma visão geral da integração com iFood:

1. Autorizar a integração com iFood

1

Acessar o portal iFood

Essa autorização só funciona se a loja já tiver concluído o cadastro no iFood.

  • Faça login no portal iFood com suas credenciais.

  • No menu lateral, clique em Minha Loja.

  • Clique em Loja.

  • Copie o ID da loja.

2

Enviar os dados para liberação

  • Envie o CNPJ e o ID da Loja para o suporte da Tablet Cloud via chamado.

3

Conceder a permissão no portal

  • Após a autorização, acesse a aba Aplicativos no portal iFood.

  • Encontre o app marcado como Permissão Pendente.

  • Clique nos três pontinhos do aplicativo.

  • Selecione Permitir.

  • Confirme a permissão na nova tela.

4

Confirmar a ativação

  • Ao final do processo, a integração com o PDV aparecerá como Ativado.

2. Configurar a integração no Retaguarda Cloud

1

Habilitar o módulo iFood

  • Verifique se o licenciamento do cliente já está com o módulo iFood habilitado.

  • Caso não esteja, solicite a liberação ao responsável pelo controle de licenciamento.

2

Acessar a filial

  • No Retaguarda Cloud, vá para Administrativo > Filiais.

  • Selecione a filial que irá operar o iFood.

3

Configurar o Merchant UUID

  • Insira o Merchant UUID no campo correspondente.

  • Clique em Verificar Dados para vincular o Cloud ao iFood.

4

Ajustar as configurações adicionais

  • Confirmação Automática: define se os pedidos serão confirmados automaticamente ou manualmente.

  • Tipo de Validação do Produto: para iFood, use sempre a validação somente por código.

  • Aceitar Pedido Automaticamente: permite que o Gestor de Pedidos aceite automaticamente todos os pedidos sem depender do PDV.

  • Tempo de Aviso: configura o intervalo das notificações de desconexão do PDV, entre 5 e 30 minutos.

  • Pedidos Offline: se o cliente optar por receber pedidos via Retaguarda Cloud em caso de falha na internet, o pedido será exibido com o botão Despachar. Ao clicar, o status muda de Em preparo para Pedido enviado.

  • Usuário Padrão: deve ser o mesmo cadastrado como vendedor.

  • Forma de Pagamento Padrão: deve corresponder ao pagamento online do iFood.

  • Associar Formas de Pagamento: no menu Associar Formas de Pagamento, vincule as formas aceitas no iFood às cadastradas no Cloud. Se a loja aceitar todas, todas devem ser associadas.

3. Sincronizar produtos entre iFood e Retaguarda Cloud

1

Sincronizar os produtos do iFood

  • Clique em Sincronizar para importar os produtos do iFood para o Cloud.

  • Essa etapa não significa que os produtos já estão prontos para venda.

2

Sincronizar os produtos do Cloud para o iFood

  • Recomenda-se retirar os produtos do iFood e sincronizar os produtos do Cloud com o iFood para manter a base alinhada.

3

Resolver erros de sincronização

  • No Cloud, vá para Tabela de Preços > Tabela de Preços e copie o código do produto.

  • No portal iFood, vá para Cardápios > Entrega > Integração com o PDV.

  • Preencha o campo Código PDV com o mesmo código do produto no Cloud.

  • Se o campo estiver vazio, basta informar o código correto.

  • Volte ao Cloud e clique em Sincronizar.

  • Quando houver erro, o item ficará sinalizado em vermelho.

Os erros mais comuns são:

  • produto desativado;

  • produto sem valor;

  • produto sem tributação.

4

Adicionar novo produto

  • No Cloud, vá para a aba do iFood.

  • Clique em Adicionar Item +.

  • Preencha as informações do produto e envie para o iFood.

5

Configurar modificadores

  • Configure os modificadores na aba Complementos.

  • Defina a quantidade mínima e máxima de modificadores.

O iFood não reconhece o status Remoção dos modificadores.

Se precisar desse comportamento, inclua a palavra remoção no nome do modificador.

6

Configurar modo de preparo

  • Na aba Configurações do produto, insira a descrição para produção ou modo de preparo.

  • Sincronize novamente entre Cloud e iFood.

4. Baixa de estoque para modificadores do iFood

Para utilizar essa funcionalidade, é necessário estar na versão 25.07.01.350 ou superior.

4.1 Habilitar a funcionalidade no Retaguarda Cloud

1

Acessar as configurações da filial

  • No Retaguarda Cloud, vá para Administrativo > Filiais.

  • Edite a filial onde a integração iFood está ativa.

2

Ativar a baixa de estoque dos modificadores

  • Dentro da edição da filial, vá para Integrações > iFood.

  • Localize a opção Valida e baixa estoque de modificadores?

  • Marque essa opção como Sim.

  • Salve as alterações.

4.2 Vincular os modificadores entre Cloud e iFood

Cada modificador no iFood precisa ser vinculado ao seu correspondente no Cloud.

O sistema gera um código de relacionamento único para cada modificador associado a um produto principal.

Se o mesmo modificador for usado em produtos diferentes, ele terá códigos de vínculo diferentes para cada produto.

1

Obter o código de vínculo no Cloud

  • Ainda na configuração do iFood da filial, localize a lista de produtos sincronizados.

  • Ao lado do produto principal, clique no ícone de modificadores.

  • O sistema exibirá os modificadores associados e o respectivo código de vínculo.

2

Inserir o código no portal iFood

  • Acesse o portal de parceiro iFood em Cardápios > Entrega.

  • Localize o produto e clique nos três pontinhos.

  • Selecione Editar Item.

  • Vá até a aba Complementos.

  • Nos grupos de acompanhamentos, clique nos três pontinhos do grupo e selecione Editar Item.

  • Vá novamente até a aba Complementos.

  • Copie o código de vínculo do Cloud.

  • Cole esse código no campo Código PDV do modificador correspondente no iFood.

Para agilizar, use a tela Integração com PDV no iFood.

Ela permite preencher os códigos PDV dos modificadores em massa.

  • Repita o processo para todos os modificadores que precisam dar baixa no estoque.

4.3 Configurar o modificador para baixa de estoque

1

Acessar o cadastro do modificador

  • No Retaguarda Cloud, vá para Produtos > Modificadores.

  • Edite o modificador desejado.

2

Vincular ao insumo

  • Certifique-se de que a opção Baixar estoque? está marcada.

  • No campo de produto, associe o modificador ao produto de insumo que terá o estoque debitado.

  • Defina a quantidade que deve ser baixada a cada venda.

  • Salve as alterações.

5. Widget iFood

O Widget iFood é uma ferramenta interativa do próprio iFood integrada ao Gestor de Pedidos.

Com ele, você pode acompanhar o status da loja, conversar com clientes, operar pedidos em formato de KDS e acompanhar avaliações.

5.1 Ativação e autorização do widget

1

Iniciar a ativação no Gestor de Pedidos

  • No Gestor de Pedidos, localize a opção de ativar o Widget iFood.

  • Ao clicar, você será redirecionado para o Portal do Parceiro iFood.

2

Autorizar a conexão

  • Na tela de permissão do iFood, clique em Continuar e depois em Autorizar.

  • Isso concede ao widget acesso às informações da loja.

3

Finalizar a ativação

  • Após a autorização, você será redirecionado de volta ao Gestor de Pedidos.

  • O widget passará a exibir as informações da loja.

5.2 Explorar as funcionalidades do widget

O widget é dividido em abas com funções específicas:

  • Home: visão geral das funcionalidades da plataforma.

  • Notificações: mostra se a loja está aberta ou fechada no iFood.

  • Chat: permite visualizar pedidos em andamento e concluídos, além de conversar com clientes.

  • KDS: exibe os pedidos em formato de tela de cozinha.

  • Configurações: permite personalizar sons e mensagens pré-definidas.

6. Usar a função Forçar Integração com PDV

Quando o PDV está desconectado e o pedido não desce, o cliente pode tratar o pedido pelo gestor do próprio iFood.

Se o pedido for alterado diretamente no iFood para Enviado ou Concluído, ele deixa de ficar disponível para captura automática no PDV.

Nesse cenário, use o botão Forçar Integração com PDV.

1

Acessar o Gestor de Pedidos

  • No Gestão Legal, vá para Integrações > Gestor de Pedidos.

2

Identificar o pedido não migrado

  • Use o filtro de status Todos.

  • Localize o pedido com status Enviado ou Concluído.

  • No histórico, confirme que as ações foram realizadas pelo iFood e não pelo PDV.

3

Selecionar o pedido elegível

  • Clique no pedido desejado.

  • Se ele for elegível, aparecerá o botão Forçar Integração com PDV na parte inferior da tela.

O botão só aparece para pedidos que não foram capturados pelo PDV e que já estão em um status final.

4

Confirmar a ação

  • Clique no botão azul.

  • Na mensagem de confirmação, clique em OK.

5

Aguardar a captura pelo PDV

  • O status mudará para Aguardando o PDV.

  • Em seguida, o terminal PDV capturará o pedido.

  • O histórico será atualizado com a indicação de que a descida foi forçada e depois capturada pelo PDV.

7. Gerenciar um pedido do iFood no PDV

Antes de receber pedidos, prepare o terminal que fará a captura.

1

Habilitar a captura no PDV móvel

  • No PDV móvel, vá para Configurações > Registro do sistema.

  • Habilite o campo Capturar Pedidos neste terminal.

Essa configuração é obrigatória para que o terminal recepcione os pedidos corretamente.

2

Identificar o terminal

  • No PDV, acesse três pontinhos > Registro.

  • Localize o MAC/tag do equipamento que você deseja usar como referência.

3

Definir o terminal gestor

  • No Retaguarda Cloud, vá para Administrativo > Filiais > Meus Terminais.

  • Edite o terminal desejado.

  • Altere o campo Gestor de Pedidos para Sim.

  • Grave a alteração.

4

Sincronizar o terminal

  • Volte ao PDV.

  • Acesse três pontinhos > Baixar Tabelas.

  • Aguarde o término da sincronização.

5

Deixar a recepção pronta

  • Entre na tela de vendas.

  • Abra a aba Delivery e mantenha essa tela aberta.

  • Em seguida, acesse Gestor > Navegador para abrir o gestor em segundo plano.

Quando um pedido do iFood é integrado, ele segue este fluxo:

1

Identificar o pedido

  • Assim que o pedido chegar, ele aparecerá na aba Delivery.

  • O símbolo do iFood ajudará na identificação visual.

2

Conferir e expedir

  • Clique no pedido para abrir os detalhes.

  • Valide os itens.

  • Clique em Expedir.

Essa ação irá:

  • imprimir o cupom fiscal;

  • solicitar a informação de quem será o entregador.

3

Aguardar retirada

  • Após a expedição, o pedido mudará para a cor amarela.

  • Isso indica que o cupom fiscal já foi impresso e o pedido está pronto para retirada.

4

Finalizar a venda

  • Quando o entregador retirar o pedido, clique novamente sobre ele.

  • Finalize a venda validando a forma de pagamento registrada pelo iFood.

Materiais relacionados

Boas práticas

  • Habilite o aceite automático de pedidos no iFood e desligue a impressão do pedido.

  • Não coloque o Gestor de Pedidos do iFood em modo somente leitura.

  • Sincronize os produtos do Cloud para o iFood para manter os dados alinhados.

  • Teste a aceitação automática de pedidos após cada ajuste importante.

Atualizado

Isto foi útil?