# 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.

{% hint style="danger" %}
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.
{% endhint %}

{% hint style="warning" %}
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)**.
{% endhint %}

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

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

### 1. Autorizar a integração com iFood

{% stepper %}
{% step %}

### Acessar o portal iFood

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

* Faça login no portal iFood com suas credenciais.
* No menu lateral, clique em **Minha Loja**.
* Clique em **Loja**.
* Copie o **ID da loja**.

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

{% step %}

### Enviar os dados para liberação

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

{% step %}

### 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.

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

{% step %}

### Confirmar a ativação

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

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

***

### 2. Configurar a integração no Retaguarda Cloud

{% 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 ao responsável pelo controle de licenciamento.

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

{% step %}

### Acessar a filial

* No **Retaguarda Cloud**, vá para **Administrativo > Filiais**.
* Selecione a filial que irá operar o iFood.

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

{% step %}

### Configurar o Merchant UUID

* Insira o **Merchant UUID** no campo correspondente.
* Clique em **Verificar Dados** para vincular o Cloud ao iFood.

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

{% step %}

### 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**.

<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**. Ao clicar, o status muda de **Em preparo** para **Pedido enviado**.

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

* **Usuário Padrão:** deve ser o mesmo cadastrado como **vendedor**.
* **Forma de Pagamento Padrão:** deve corresponder ao **pagamento online do iFood**.

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

* **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**.

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

***

### 3. Sincronizar produtos entre iFood e Retaguarda Cloud

{% stepper %}
{% step %}

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

{% step %}

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

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

{% step %}

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

{% step %}

### Configurar modificadores

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

{% hint style="info" %}
O iFood não reconhece o status **Remoção** dos modificadores.

Se precisar desse comportamento, inclua a palavra **remoção** no nome do modificador.
{% endhint %}

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

{% step %}

### 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.

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

***

### 4. Baixa de estoque para modificadores do iFood

{% hint style="danger" %}
Para utilizar essa funcionalidade, é necessário estar na versão **25.07.01.350** ou superior.
{% endhint %}

#### 4.1 Habilitar a funcionalidade no Retaguarda Cloud

{% stepper %}
{% step %}

### Acessar as configurações da filial

* No Retaguarda Cloud, vá para **Administrativo > Filiais**.
* Edite a filial onde a integração iFood está ativa.
  {% endstep %}

{% step %}

### 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.

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

#### 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.

{% hint style="warning" %}
Se o mesmo modificador for usado em produtos diferentes, ele terá **códigos de vínculo diferentes** para cada produto.
{% endhint %}

{% stepper %}
{% step %}

### 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**.

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

{% step %}

### Inserir o código no portal iFood

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

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

* Localize o produto e clique nos **três pontinhos**.
* Selecione **Editar Item**.

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

* Vá até a aba **Complementos**.

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

* Nos grupos de acompanhamentos, clique nos **três pontinhos** do grupo e selecione **Editar Item**.
* Vá novamente até a aba **Complementos**.

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

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

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

{% hint style="success" %}
Para agilizar, use a tela **Integração com PDV** no iFood.

Ela permite preencher os códigos PDV dos modificadores em massa.
{% endhint %}

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

#### 4.3 Configurar o modificador para baixa de estoque

{% stepper %}
{% step %}

### Acessar o cadastro do modificador

* No Retaguarda Cloud, vá para **Produtos > Modificadores**.
* Edite o modificador desejado.
  {% endstep %}

{% step %}

### 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.

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

***

### 5. Widget iFood

O **Widget iFood** é uma ferramenta interativa do próprio iFood integrada ao [Gestor de Pedidos](/retaguarda/administrativo/gestor-de-pedidos.md).

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

{% stepper %}
{% step %}

### 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**.

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

{% step %}

### 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.

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

{% step %}

### 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.

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

#### 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.

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

* **Notificações:** mostra se a 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, além de conversar com clientes.

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

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

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

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

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

***

### 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**.

{% stepper %}
{% step %}

### Acessar o Gestor de Pedidos

* No **Gestão Legal**, vá para **Integrações > Gestor de Pedidos**.
  {% endstep %}

{% step %}

### 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**.

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

{% step %}

### 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.

<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á estão em um status final.
{% endhint %}
{% endstep %}

{% step %}

### Confirmar a ação

* Clique no botão azul.
* Na mensagem de confirmação, clique em **OK**.

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

{% step %}

### 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.

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

***

### 7. Gerenciar um pedido do iFood no PDV

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

{% stepper %}
{% step %}

### 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**.

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

{% step %}

### Identificar o terminal

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

{% step %}

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

{% step %}

### Sincronizar o terminal

* Volte ao PDV.
* Acesse **três pontinhos > Baixar Tabelas**.
* Aguarde o término da sincronização.
  {% endstep %}

{% step %}

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

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

{% stepper %}
{% step %}

### Identificar o pedido

* Assim que o pedido chegar, ele aparecerá na aba **Delivery**.
* O símbolo do iFood ajudará na identificação visual.
  {% endstep %}

{% step %}

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

{% step %}

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

{% step %}

### Finalizar a venda

* Quando o entregador retirar o pedido, clique novamente sobre ele.
* Finalize a venda validando a forma de pagamento registrada pelo iFood.
  {% endstep %}
  {% endstepper %}

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

***

### Materiais relacionados

* [Gestor de Pedidos](/retaguarda/administrativo/gestor-de-pedidos.md)

### Boas práticas

{% hint style="success" %}

* 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.
  {% 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.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.