# Integração com Ifood, o que preciso saber?

{% hint style="danger" %}
A nossa integração funciona **exclusivamente com contas iFood cadastradas na categoria Restaurante**.

Lojas que operam no iFood em outras categorias, como **Mercado, Farmácia, Pet Shop, etc., não são compatíveis**. Tentar realizar a integração com uma conta dessas categorias resultará em falha.

**Antes de prosseguir, valide a categoria da loja diretamente no portal de parceiros do iFood.**
{% endhint %}

{% hint style="warning" %}
**Importante:** Ao utilizar a integração com **iFood** ou **Delivery Legal**, mantenha um **equipamento exclusivo** para recepcionar pedidos. Não utilize **maquininhas de cartão** e certifique-se que este equipamento **não esteja** em ambientes com **compartilhador (Raspberry)** para evitar conflitos na operação.
{% endhint %}

🎥 Prefere assistir? Veja uma visão geral sobre a Integração com Ifood:

{% embed url="<https://www.youtube.com/watch?v=-CVhYL1R3Ks>" %}

## **Como Autorizar a Integração com Ifood?** <a href="#passoapassoparaautorizaraintegrao" id="passoapassoparaautorizaraintegrao"></a>

{% stepper %}
{% step %}

#### **Acesse o Portal IFood:**

{% hint style="warning" %}
Esta autorização só funciona se a loja já tiver concluído o cadastro no iFood.

Se o cadastro ainda estiver incompleto no portal do iFood, a integração não poderá ser liberada.
{% endhint %}

* Faça login no portal IFood com suas credenciais.
* No menu lateral, clique em "Minha Loja"
* Clique na opção: "Loja"
* Copie o ID da loja

<figure><img src="/files/m0rDmy1Ex1EZ8vpOOvao" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Envie as Informações:**

* Envie o **CNPJ + ID da Loja** para o suporte da Tablet Cloud via chamado.
  {% endstep %}

{% step %}

#### **Aguarde a Autorização:**

* 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 e selecione **Permitir**.
* Confirme a permissão na nova tela que será aberta.

<figure><img src="/files/q7mBDKSLq2wfcofwzOzx" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Verifique a Ativação:**

* Após o processo, a integração com o PDV será marcada como **ATIVADO**.

<figure><img src="/files/dpUTh71NFi4NR6fuPLNX" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## **Como configurar a Integração Ifood no Retaguarda Cloud?** <a href="#configurandoaintegraonocloud" id="configurandoaintegraonocloud"></a>

{% stepper %}
{% step %}

#### **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 junto ao responsável pelo controle de licenciamento.

<figure><img src="/files/ZHfvglS4Dmb52guMUH6f" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Acesse a Filial:**

* No Retaguarda Cloud, vá para **Administrativo > Filiais**.
* Selecione a filial que deseja gerenciar o IFood.

<figure><img src="/files/4ywMB5zA9XyUWzNurlOl" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Configurar o Merchant UUID:**

* Insira o **Merchant UUID** (ID da loja do IFood) no campo correspondente.
* Clique em **Verificar Dados** para vincular o Cloud ao IFood.

<figure><img src="/files/mc1kYNxVXXgjOjOyLK2m" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **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 de tempo para notificações de desconexão do PDV (5 a 30 minutos).

<figure><img src="/files/NBuN4pviiu9Qls32Gbvv" alt=""><figcaption></figcaption></figure>

* **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** no canto inferior direito. Ao clicar, o status muda de **EM PREPARO** para **PEDIDO ENVIADO**.

<figure><img src="/files/YyDmtArCocqsFtPWj1VT" alt=""><figcaption></figcaption></figure>

* **Configuração de Usuário e Pagamento**
  * O **Usuário Padrão** deve ser o mesmo cadastrado como **vendedor**.
  * A **Forma de Pagamento Padrão** deve corresponder ao **pagamento online do iFood**.

<figure><img src="/files/JfpkHGtfk8t2ShhqbaxA" alt=""><figcaption></figcaption></figure>

* **Associação de Formas de Pagamento:** No menu **Associar Formas de Pagamento**, o cliente pode vincular as formas de pagamento aceitas no iFood às cadastradas no **Cloud**. Se aceitar todas as opções, **todas devem ser associadas**.

<figure><img src="/files/Y403dyBgkLawSD4stlFp" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## **Como Sincronizar Produtos entre IFood e Retaguarda Cloud?**

{% stepper %}
{% step %}

#### **Sincronizar Produtos:**

* Clique em **Sincronizar** para importar todos os produtos do IFood para o Cloud.
* Lembre-se que isso não significa que os produtos estão prontos para venda.
  {% endstep %}

{% step %}

#### **Sincronizar Produtos do Cloud para o IFood:**

* Recomenda-se retirar todos os produtos do IFood e sincronizar os produtos do Cloud com o IFood para garantir a sincronia de dados.
  {% endstep %}

{% step %}

#### **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. O portal salva a alteração automaticamente.
* Volte ao Cloud e clique em **Sincronizar** para validar o relacionamento dos produtos.
* Quando houver erro, o item ficará sinalizado em vermelho.
* Os erros mais comuns são: **produto desativado**, **produto sem valor** ou **produto sem tributação**.

<figure><img src="/files/rfTcqxeW43Kf3aqU4SGX" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Adicionar Novo Produto:**

* No Cloud, vá para a aba do IFood e clique em **Adicionar Item +**.
* Preencha as informações do produto e envie para o IFood.
  {% endstep %}

{% step %}

#### **Configurar Modificadores:**

* Configure os modificadores na aba **Complementos**.
* Defina a quantidade mínima e máxima de modificadores.

{% hint style="info" %}
Um ponto importante, é que o **IFood não reconhece o status "Remoção" dos modificadores**, então não será possível usar essa rotina. O cliente deve colocar a palavra “**remoção**” antes do nome do modificador, assim o usuário final pode entender o objetivo daquele modificador em específico.
{% endhint %}

<figure><img src="/files/CCPUVw4Rdk1HElXdTi06" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Modo de Preparo:**

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

<figure><img src="/files/PDcNMaqqOGBUkdSG6c2N" alt=""><figcaption></figcaption></figure>

* Sincronize novamente entre Cloud e IFood.
  {% endstep %}
  {% endstepper %}

***

## Baixa de Estoque para Modificadores do iFood

{% hint style="danger" %}
Para utilizar esta funcionalidade, é necessário estar em uma versão 25.07.01.350 ou superior
{% endhint %}

Para realizar a baixa de estoque para modificadores do Ifood, siga o passo a passo abaixo:

### **1. Habilitar a Funcionalidade no Retaguarda Cloud** <a href="#parte1habilitarafuncionalidadenocloud" id="parte1habilitarafuncionalidadenocloud"></a>

O primeiro passo é ativar a função globalmente na sua filial.

{% stepper %}
{% step %}

#### **Acesse as Configurações da Filial** <a href="#acesseasconfiguraesdafilial" id="acesseasconfiguraesdafilial"></a>

* No Retaguarda Cloud, navegue até o menu **Administrativo > Filiais**.
* Localize e clique para **editar** a filial onde a integração iFood está ativa.
  {% endstep %}

{% step %}
**Ative a Baixa de Estoque para Modificadores**

* Dentro da edição da filial, vá para a aba **Integrações > iFood**.
* Localize a nova opção: **"Valida e baixa estoque de modificadores?"**.
* **Marque esta opção como "Sim"**. Se ela permanecer como "Não", a funcionalidade não será ativada.

<figure><img src="/files/zlG7VpsPmPVQe9qSxUhV" alt=""><figcaption></figcaption></figure>

* Salve as alterações na filial.
  {% endstep %}
  {% endstepper %}

### **2. Vincular Modificadores (Retaguarda Cloud e iFood)** <a href="#parte2vincularmodificadorescloudeifood" id="parte2vincularmodificadorescloudeifood"></a>

Para que o sistema saiba qual insumo baixar, cada modificador no iFood precisa ser vinculado ao seu correspondente no Cloud.

> **Entendendo o Código de Vínculo** O sistema gera um **código de relacionamento único** para cada modificador associado a um produto principal.

{% hint style="warning" %}
**Atenção:** Se você usa o mesmo modificador "Bacon Extra" em um "X-Tudo" e em um "X-Bacon", ele terá **códigos de vínculo diferentes** para cada um desses lanches. É fundamental usar o código correto para cada associação.
{% endhint %}

{% stepper %}
{% step %}

#### **Obter o Código de Vínculo no Retaguarda Cloud** <a href="#obterocdigodevnculonocloud" id="obterocdigodevnculonocloud"></a>

* Ainda na aba de configuração do iFood na sua filial, localize a lista de produtos sincronizados.
* Ao lado do nome do produto principal (ex: "X-Tudo do Megablaster"), você verá um novo ícone de "modificadores".
* Ao clicar nele, o sistema exibirá todos os modificadores associados àquele produto. Na frente de cada modificador, você encontrará o **código de vínculo** (ex: `822-5901`). É este código que usaremos.

<figure><img src="/files/KD3noWyFfdFhseeTZ0Yl" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Inserir o Código no Portal iFood**

* Acesse seu portal de parceiro iFood > Cardápios > Entrega

<figure><img src="/files/3AJzIJxqzHf8szDOtqlA" alt=""><figcaption></figcaption></figure>

* Localize o produto, clique nos "Três pontinhos", em seguida: "Editar Item"

<figure><img src="/files/BsYtnIbJmG3b8IpB0uXK" alt=""><figcaption></figcaption></figure>

* Na página de edição do item, vá até a aba: "Complementos"

<figure><img src="/files/SpLXmD57qL8O87FozqhC" alt=""><figcaption></figcaption></figure>

* Na aba "Complementos" visualize os grupos de Acompanhamentos, para editar um grupo de acompanhamentos clique nos "Três pontinhos", sem seguida: "Editar Item"
* Vá até a aba: "Complementos"

<figure><img src="/files/jou98dl9Fzp7h1KsCXet" alt=""><figcaption></figcaption></figure>

* Copie o **código de vínculo** do Retaguarda Cloud.
* Cole este código no campo **"Código PDV"** do modificador correspondente no iFood.

<figure><img src="/files/8pa0dKkknHtn5NMczT7X" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Dica para agilizar:** Em vez de editar item por item, use a tela **"Integração com PDV"** no iFood. Ela permite expandir um produto e preencher os códigos PDV de todos os seus modificadores em massa, de forma muito mais rápida.
{% endhint %}

* Repita o processo para todos os modificadores de todos os produtos que precisam dar baixa no estoque.
  {% endstep %}
  {% endstepper %}

### **3. Configurar o Modificador para Baixa de Estoque** <a href="#parte3configuraromodificadorparabaixadeestoque" id="parte3configuraromodificadorparabaixadeestoque"></a>

Finalmente, precisamos garantir que o modificador no Retaguarda Cloud está configurado para controlar o estoque de um insumo.

{% stepper %}
{% step %}
**Acesse o Cadastro do Modificador**

* No Retaguarda Cloud, vá para **Produtos > Modificadores**.
* Edite o modificador desejado (ex: "Bacon Extra").
  {% endstep %}

{% step %}
**Vincule 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 (ex: "BACON (INSUMO)").
* Defina a **quantidade** que deve ser baixada a cada vez que este modificador for vendido (ex: 0,050 para 50 gramas).
* Salve as alterações.

<figure><img src="/files/E9gEcZ1ke5675CF2o30g" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## **Widget iFood**

> **O que é o Widget iFood?** É uma ferramenta interativa fornecida pelo próprio iFood que se integra ao [**Gestor de Pedidos**](/retaguarda/administrativo/o-que-e-como-configurar-o-gestor-de-pedidos.md). Com ele, você pode ver o status da loja, interagir com clientes via chat, gerenciar pedidos em um KDS (tela de cozinha), acompanhar avaliações e muito mais.

### 1. **Ativação e Autorização do Widget**

Para usar o widget, você precisa primeiro autorizar a conexão com sua conta iFood a partir do Gestor de Pedidos.

{% stepper %}
{% step %}

#### **Inicie a Ativação no Gestor de Pedidos** <a href="#inicieaativaonogestordepedidos" id="inicieaativaonogestordepedidos"></a>

* No seu **Gestor de Pedidos**, localize a seção ou botão para ativar o **Widget iFood**.
* Ao clicar, você será redirecionado para o **Portal do Parceiro iFood**.

<figure><img src="/files/FOeAv5jjF7m7Hszobore" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **Autorize a Conexão** <a href="#autorizeaconexo" id="autorizeaconexo"></a>

* Na página do iFood, você verá uma tela de permissão. Clique em **"Continuar"** e depois em **"Autorizar"**.
* Isso concede ao widget a permissão para acessar e exibir as informações da sua loja.

<figure><img src="/files/3LNqL1Ws8czmXeIiPiiZ" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Finalize a Ativação**

* Após a autorização, você será redirecionado de volta ao seu **Gestor de Pedidos**. O widget agora deve estar ativo e exibindo as informações da sua loja

<figure><img src="/files/0IKStHYPgbF1Be1cACHA" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### **2. Explorando as Funcionalidades do Widget** <a href="#parte2explorandoasfuncionalidadesdowidget" id="parte2explorandoasfuncionalidadesdowidget"></a>

O widget é dividido em várias abas, cada uma com uma função específica:

* **Home:** Uma visão geral das funcionalidades da plataforma

<figure><img src="/files/hbNyAnnILJ4GUrmIqHuq" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/lw7Ex3hDDyXi1cJQXvFc" alt=""><figcaption></figcaption></figure>

* **Chat:** Permite visualizar pedidos em andamento e concluídos. O chat é uma ferramenta crucial para conversar com clientes, mesmo após a entrega, para resolver disputas ou responder a dúvidas.

<figure><img src="/files/2teRbAk1gX3YfgHpbiwc" alt=""><figcaption></figcaption></figure>

* **KDS (Tela da Cozinha):** Uma das funcionalidades mais recentes, exibe os pedidos em um formato de KDS, com status como "Aguardando Retirada", ajudando a organizar o fluxo de produção da sua cozinha.

<figure><img src="/files/gzwegsgjMOIlcqBaKOuN" alt=""><figcaption></figcaption></figure>

* **Configurações:** Permite personalizar o widget, como ativar sons para novas notificações ou criar mensagens pré-definidas para agilizar a comunicação no chat.

<figure><img src="/files/G2iSNNgwr3WXjDScirap" alt=""><figcaption></figcaption></figure>

***

## Como utilizar a função "Forçar Integração com PDV" em pedidos Ifood?

**Quando o PDV está desconectado e o pedido não baixa**, o cliente pode tratar o pedido via Gestor de Pedidos **do próprio iFood**. Quando ele altera o pedido direto no ifood para Enviado/Concluído o pedido não fica mais disponível para o PDV baixar.

Agora, no Gestor de Pedidos, foi criado o botão **Forçar Integração com PDV** para enviar manualmente esses pedidos pendentes ao PDV Legal.

{% stepper %}
{% step %}
**Acesse o Gestor de Pedidos:** No Gestão Legal (Retaguarda Cloud), vá para o menu **Integrações > Gestor de Pedidos**.
{% endstep %}

{% step %}
**Identifique o Pedido que não foi migrado ao PDV:**

* Use o filtro de status para selecionar **"Todos"** e localizar o pedido que não foi importado.
* Você o identificará pelo status **"Enviado"** ou **"Concluído"**. Ao clicar nele, o histórico mostrará que as ações foram realizadas pelo **"iFood"** e não pelo **"PDV"**.

<figure><img src="/files/l7YlU9lgPT9FFQ5BoAbc" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Selecione o Pedido para Ativar a Função:**

Clique sobre o pedido desejado. Se ele for elegível para a ação, um botão azul chamado **"Forçar Integração com PDV"** aparecerá na parte inferior da tela.

<figure><img src="/files/EMGADhop1Um3QoNgmlHB" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
O botão só aparece para pedidos que não foram capturados pelo PDV e que já se encontram em um status final.
{% endhint %}
{% endstep %}

{% step %}
**Confirme a Ação:**

* Clique no botão azul. Uma janela de confirmação aparecerá com o aviso: *"O pedido será reenviado para a conferência, permitindo que o PDV o capture. Deseja continuar mesmo assim?"*
* Clique em **OK**.

<figure><img src="/files/OdbmPZHArY9kD87K1ppV" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Aguarde a Captura pelo PDV:**

* O status do pedido mudará para **"Aguardando o PDV"**.
* Em instantes, o seu terminal PDV (que precisa estar online e com a tela de Delivery aberta) irá capturar o pedido. O histórico será atualizado, mostrando que a descida foi **"forçada"** e, em seguida, capturada pelo PDV.

<figure><img src="/files/npw7IkGGAa5Zwi5sjhAw" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Como Gerenciar um Pedido do iFood no seu PDV <a href="#comogerenciarumpedidodoifoodnoseupdv" id="comogerenciarumpedidodoifoodnoseupdv"></a>

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

{% stepper %}
{% step %}

#### **Habilite a captura no PDV móvel**

* No PDV móvel, vá para **Configurações > Registro do sistema**.
* Habilite o campo **Capturar Pedidos neste terminal**.

{% hint style="warning" %}
Esta configuração é obrigatória para que o terminal recepcione os pedidos corretamente.
{% endhint %}
{% endstep %}

{% step %}

#### **Opcional: identifique o terminal**

* No PDV, acesse **três pontinhos > Registro**.
* Localize o **MAC/tag** do equipamento que você deseja usar como referência.
  {% endstep %}

{% step %}

#### **Defina 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.
  {% endstep %}

{% step %}

#### **Sincronize o terminal**

* Volte ao PDV.
* Acesse **três pontinhos > Baixar Tabelas**.
* Aguarde a sincronização terminar.
  {% endstep %}

{% step %}

#### **Deixe 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.
  {% endstep %}
  {% endstepper %}

Quando um pedido do iFood é integrado, ele segue um fluxo simples e visual dentro do seu PDV. Siga os passos abaixo para gerenciar o pedido do recebimento à finalização.

{% stepper %}
{% step %}
**Identificação do Pedido**

Assim que o pedido chegar, ele aparecerá na aba **DELIVERY**. Para facilitar a identificação, ele terá o símbolo do iFood (🛵) ao lado esquerdo.
{% endstep %}

{% step %}
**Conferência e Expedição**

* Clique sobre o pedido para abri-lo e visualizar os detalhes.
* Valide todos os itens para garantir que o pedido está correto.
* Clique no botão **“Expedir”**. Esta ação irá:
  * Imprimir o cupom fiscal.
  * Solicitar a informação de quem será o entregador.
    {% endstep %}

{% step %}
**Status de Aguardando Retirada**

Após a expedição, o pedido mudará de cor para **amarelo** (🟡). Esta cor é um indicador visual de que o cupom fiscal já foi impresso e o pedido está pronto, apenas aguardando a retirada pelo entregador.
{% endstep %}

{% step %}
**Finalização da Venda**

Quando o entregador do iFood retirar o pedido na loja, clique novamente sobre o pedido (que está amarelo) e finalize a venda, validando a forma de pagamento que foi registrada pelo iFood.
{% endstep %}
{% endstepper %}

<figure><img src="/files/c441xoif13qlGnQQuVGT" alt=""><figcaption></figcaption></figure>

**📚 Materiais Relacionados:**

{% content-ref url="/pages/pOdZ56xCdSly3GmO82Po" %}
[O que é/Como configurar o Gestor de Pedidos?](/retaguarda/administrativo/o-que-e-como-configurar-o-gestor-de-pedidos.md)
{% endcontent-ref %}

***

## <mark style="background-color:green;">**Dicas Rápidas**</mark> <a href="#dicasrpidas" id="dicasrpidas"></a>

{% hint style="success" %}

* **Aceite Automático de Pedidos:** Habilite o aceite automático de pedidos no IFood e desligue a impressão do pedido.
* **Modo Somente Leitura:** Não coloque o Gestor de Pedidos do IFood no modo somente leitura.
* **Sincronize os produtos do Cloud para o IFood** para garantir que todos os dados estejam alinhados.
* **Teste a configuração de aceitação automática de pedidos** para garantir que o sistema funcione corretamente mesmo em caso de falha de comunicação.
  {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.pdvlegal.com.br/integracoes/integracao-com-ifood-o-que-preciso-saber.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.