> For the complete documentation index, see [llms.txt](https://delivery.ajuda.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://delivery.ajuda.cc/integracoes/logistica/foody-delivery.md).

# Foody Delivery

Integre seu delivery à Foody Delivery pelo padrão OpenDelivery e envie os pedidos automaticamente para a gestão das suas entregas.

A **Foody Delivery** é uma plataforma de gestão de entregas: nela você organiza os pedidos que precisam sair, distribui as rotas entre os seus entregadores e acompanha cada entrega em tempo real.

Com a integração ativa, os pedidos recebidos no seu delivery são enviados automaticamente para a Foody Delivery, e o **status do pedido** é atualizado no seu painel conforme a entrega avança por lá.

{% hint style="info" %}
Esta integração usa o padrão **OpenDelivery**, adotado pelo mercado para a troca de pedidos entre plataformas de delivery e sistemas de gestão. Na Foody Delivery, ela corresponde ao modo **Integração Open Delivery Marketplace**.
{% endhint %}

{% hint style="warning" %}
**Esta é a nova integração com a Foody Delivery.** A integração antiga, feita por Webhook e Token em **Extensões**, será descontinuada. Se a sua loja ainda usa o modelo antigo, faça a migração seguindo este tutorial.
{% endhint %}

**Antes de começar, é necessário se atentar nos seguintes pontos:**

1. É preciso ter uma conta ativa na Foody Delivery. Caso ainda não tenha, acesse o [site da Foody Delivery](https://foodydelivery.com) para contratar a plataforma.
2. A configuração é feita em duas etapas: primeiro você instala o aplicativo no seu painel e copia os **dados de conexão**; depois, informa esses dados na sua conta da Foody Delivery.

## Ativando a integração com a Foody Delivery

Em seu painel, acesse o [**DeliveryStore**](/integracoes/deliverystore.md) e clique em **"Autorizar Aplicativo"**. Informe o seguinte token de autorização:

{% hint style="info" %}
**ee53a2bc-5e61-4d43-9a08-83056a68429e**
{% endhint %}

Depois de informado o token, clique em **"Buscar Aplicativo"**. O sistema vai localizar o aplicativo da **Foody Delivery**. Confira as permissões solicitadas e clique em **"Instalar"**.

Após a instalação, o aplicativo abre no seu painel exibindo o **MERCHANT\_ID** — o código que identifica a sua loja.

{% hint style="warning" %}
**A instalação sozinha ainda não ativa a integração.** Falta informar os **dados de conexão** na sua conta da Foody Delivery — é o que fazemos nos próximos passos.
{% endhint %}

## Copiando os dados de conexão

Os dados que a Foody Delivery precisa ficam em **Gerenciar app**.

**1.** Com o aplicativo aberto, clique no menu **⋮** no canto superior direito e escolha **"Gerenciar app"**.

**2.** No painel que abre à direita, localize o bloco **Extensão OpenDelivery**. Enquanto a integração não estiver ativa, ele aparece com o status **pendente**.

**3.** Clique em **"Copiar dados de conexão"** e cole o conteúdo em um bloco de notas. Você vai usar três informações dele na Foody Delivery:

| Dado no DeliveryVip | Campo na Foody Delivery  |
| ------------------- | ------------------------ |
| **Client ID**       | ID do Cliente (clientID) |
| **Client Secret**   | Senha (clientSecret)     |
| **URL base da API** | URL Base                 |

{% hint style="danger" %}
O **Client Secret** é uma credencial de acesso à sua loja. Informe os dados de conexão **apenas na sua conta da Foody Delivery** e não os compartilhe publicamente.
{% endhint %}

## Configurando na Foody Delivery

Agora acesse a sua conta na **Foody Delivery** para criar a integração.

**1.** No **Menu Principal**, acesse **Minha Conta**.

**2.** No menu lateral, clique em **Integrações** e depois no botão **Criar Integração**.

**3.** Preencha um nome para a integração e, no campo **Tipo**, escolha a opção **Open Delivery** dentro da seção **Pedidos**. Em seguida, clique em **Criar Integração**.

{% hint style="info" %}
O nome da integração deve ter **no mínimo 6 caracteres**, sem letras maiúsculas e sem caracteres especiais (como ! @ \* /). Por exemplo: `pedidos.deliveryvip`.
{% endhint %}

{% hint style="warning" %}
Escolha a opção **Open Delivery** da seção **Pedidos**, e não a da seção **Operador Logístico** — são tipos de integração diferentes.
{% endhint %}

**4.** De volta à lista de integrações, clique em **Ações \[ ⁝ ]** na integração criada e escolha **Configurar**.

**5.** Preencha os campos **ID do Cliente (clientID)**, **Senha (clientSecret)** e **URL Base** com os dados de conexão copiados do seu painel.

**6.** Logo abaixo, confira as opções de sincronização de **Despacho** e **Entrega** e escolha em que momento os pedidos devem ser integrados:

* **Somente Pedidos Confirmados**: o pedido só chega à Foody Delivery depois de aceito no seu painel.
* **Pedidos Pendentes e Confirmá-los**: o pedido chega à Foody Delivery assim que é criado e é confirmado em seguida.

**7.** Clique em **Testar Credenciais** para validar a conexão. Estando tudo certo, mude a integração para **Ligado** e clique em **Salvar**.

O passo a passo com as telas da Foody Delivery você confere na central de ajuda deles:

{% embed url="<https://help.foodydelivery.com/knowledge-base/how-to-configure-open-delivery-integration/>" %}

## Funcionamento

Com a integração ligada, o fluxo passa a ser o seguinte:

* **Recebimento dos pedidos:** os pedidos da sua loja são enviados automaticamente para a Foody Delivery, onde você organiza as rotas e distribui as entregas entre os seus entregadores.
* **Atualização de status:** conforme a entrega avança na Foody Delivery, o status do pedido é atualizado automaticamente no seu painel — e o seu cliente acompanha pela página do pedido.

{% hint style="info" %}
Nesta integração, a Foody Delivery **apenas recebe os pedidos e atualiza o status deles**. Cardápio, preços e demais configurações da loja continuam sendo gerenciados normalmente pelo seu painel.
{% endhint %}

## Acompanhando a ativação

Assim que a conexão for validada pela Foody Delivery, o status **pendente** da **Extensão OpenDelivery** deixa de aparecer em **Gerenciar app**. Nesse mesmo painel você ainda encontra as **permissões concedidas** e o **histórico do app**, com a data de instalação.

{% hint style="success" %}
O aplicativo fica disponível como um card no **DeliveryStore** — clique nele sempre que precisar consultar o MERCHANT\_ID ou copiar os dados de conexão novamente.
{% endhint %}

## Migrando da integração antiga

Se a sua loja já usava a Foody Delivery pela integração antiga (Webhook e Token em **Extensões**):

1. Ative a nova integração seguindo os passos acima e confirme que os pedidos estão chegando à Foody Delivery.
2. No seu painel, acesse **Extensões > Foody Delivery**, desmarque a opção **Ativo** e clique em **Salvar**.
3. Na Foody Delivery, em **Minha Conta > Configurações Avançadas**, remova o gatilho (webhook) criado para a integração antiga.

{% hint style="warning" %}
Não mantenha as duas integrações ativas ao mesmo tempo, para evitar pedidos duplicados na Foody Delivery.
{% endhint %}

{% hint style="warning" %}
Em caso de dúvidas sobre a configuração dentro da Foody Delivery, entre em contato diretamente com a equipe da **Foody Delivery**.
{% endhint %}