# INTEGRAÇÃO COM 99FOOD

# INTEGRAÇÃO 99FOOD

A integração entre a **99Food e a ConnectPlug** permite que os pedidos realizados pelo aplicativo da 99Food sejam recebidos diretamente no PDV, centralizando a operação de delivery e reduzindo a necessidade de lançamentos manuais.

Este artigo apresenta o processo completo de implantação, desde a autorização da integração até a configuração, vinculação dos produtos, exportação de cardápio e realização de testes.

##### **Pré-requisitos**

Antes de iniciar a implantação, certifique-se de que possui:

<div id="bkmrk-requisito-informa%C3%A7%C3%A3o"><div><div><table class="w-fit min-w-(--thread-content-width)" data-end="1080" data-start="557"><thead data-end="583" data-start="557"><tr data-end="583" data-start="557"><th class="last:pe-10" data-col-size="sm" data-end="569" data-start="557">Requisito</th><th class="last:pe-10" data-col-size="lg" data-end="583" data-start="569">Informação</th></tr></thead><tbody data-end="1080" data-start="594"><tr data-end="751" data-start="594"><td data-col-size="sm" data-end="620" data-start="594">**Link de autorização**</td><td data-col-size="lg" data-end="751" data-start="620">Deve ser solicitado ou recebido do time de PPI. O link é gerado semanalmente, às segundas-feiras, e expira ao final do período.</td></tr><tr data-end="853" data-start="752"><td data-col-size="sm" data-end="772" data-start="752">**Acesso remoto**</td><td data-col-size="lg" data-end="853" data-start="772">Necessário estar conectado à máquina do cliente, por exemplo, via TeamViewer.</td></tr><tr data-end="939" data-start="854"><td data-col-size="sm" data-end="874" data-start="854">**Portal 99Food**</td><td data-col-size="lg" data-end="939" data-start="874">O cliente deve estar logado na conta da loja no 99Food Admin.</td></tr><tr data-end="1080" data-start="940"><td data-col-size="sm" data-end="963" data-start="940">**SLA de liberação**</td><td data-col-size="lg" data-end="1080" data-start="963">Após a solicitação, o time de PPI possui SLA de **08 horas úteis** para realizar a liberação final da integração.</td></tr></tbody></table>

</div></div></div>> **Atenção:** o link de autorização é semanal. Caso esteja expirado ou inválido, solicite um novo link ao time de PPI.

##### **Passo a Passo**

O processo é dividido em três etapas principais:

1. Autorização no portal do cliente
2. Ativação da integração no ERP
3. Configuração, vinculação e testes no PDV

##### **1. Autorize a integração no portal 99Food**

Com o acesso remoto ativo na máquina do cliente, abra o navegador em que o cliente está conectado ao **99Food Admin**.

Cole o **link semanal de autorização** fornecido pelo time de PPI.

O portal apresentará a tela de autorização do integrador.

1. Selecione a **loja do cliente**.
2. Clique em **Confirmar autorização e continuar**.
3. Na janela seguinte, marque a caixa de seleção ao lado do nome do estabelecimento.
4. Clique novamente em **Confirmar**.

##### Envie a evidência da autorização

Após concluir a autorização:

1. Acesse a aba **Estabelecimentos autorizados**.
2. Tire um print legível da tela.
3. Certifique-se de que estejam visíveis o **nome da loja** e **CONNECTPLUG DESENVOLVIMENTO DE SOFTWARE LTDA**.
4. Abra um chamado interno no **Octadesk**.
5. Informe os dados completos da loja.
6. Anexe obrigatoriamente o print da tela de estabelecimentos autorizados.

Aguarde a validação e a liberação final pelo time de PPI.

> **Atenção:** o print da aba **Estabelecimentos autorizados** é uma evidência obrigatória para que o processo possa seguir. Chamados sem esse anexo não poderão ter a liberação finalizada.

![](https://manual.cplug.com.br/uploads/images/gallery/2026-03/scaled-1680-/XFEpXFpIf37esgMc-image-1772733638352.png)

![](https://manual.cplug.com.br/uploads/images/gallery/2026-03/scaled-1680-/ED6AwDRzbFBc6QwL-image-1772733703106.png)

![](https://manual.cplug.com.br/uploads/images/gallery/2026-03/scaled-1680-/JYshsxXr1BtYJMHC-image-1772733837049.png)

##### **2. Configure a integração no ERP**

Após o time de PPI realizar a liberação e fornecer o **ID da Loja**, acesse no ERP:

![](https://manual.cplug.com.br/uploads/images/gallery/2026-08/scaled-1680-/b7PH47BRSUxMQslI-image-1787855203073.png)

**Integrações &gt; 99Food**

Localize o campo **Chave da Integração** e informe o ID da Loja recebido do PPI.

> **Atenção:** confira se não existem espaços antes ou depois do número informado.

##### Configure o método de pagamento e o vendedor

Na configuração da integração:

1. Crie um **método de pagamento** específico com o nome **99food**.
2. Crie um **usuário/vendedor** com o nome **99food**.
3. Vincule ambos à integração.
4. Salve a configuração.

A utilização de um método de pagamento e vendedor específicos facilita a identificação, visualização e filtragem das vendas da 99Food nos relatórios financeiros e de vendas.

##### Valide o status da integração

Após salvar a configuração, sincronize o PDV e verifique se o status da integração consta como:

**AUTENTICADA**

**![](https://manual.cplug.com.br/uploads/images/gallery/2026-03/scaled-1680-/4uNR5mXb2gE8T1cQ-image-1772735583202.png)**

##### **3. Vincule os produtos no 99Food**

Após a liberação da integração, é necessário vincular os produtos cadastrados na 99Food aos produtos correspondentes da ConnectPlug.

No **99Food Admin**, acesse:

**Cardápios &gt; Cardápio da Loja**

Depois:

1. Localize o produto desejado.
2. Clique nos **três pontinhos**.
3. Selecione **Editar**.
4. Localize o campo **Código PDV**.
5. Informe o código correspondente ao produto na ConnectPlug.
6. Clique em **Enviar**.

Repita o procedimento para os **produtos, complementos e itens adicionais**.

> **Atenção:** a vinculação dos códigos é necessária para que os produtos recebidos nos pedidos sejam identificados corretamente pela ConnectPlug.

![](https://manual.cplug.com.br/uploads/images/gallery/2026-03/scaled-1680-/Wh7DuvrB8HwKJ17n-image-1772734100536.png)

![](https://manual.cplug.com.br/uploads/images/gallery/2026-03/scaled-1680-/GCYx7167fSKVPPUB-image-1772734129864.png)

![](https://manual.cplug.com.br/uploads/images/gallery/2026-03/scaled-1680-/p7lZdmkFMS5mYRjj-image-1772734185583.png)

##### **4. Teste o recebimento de pedidos**

Para validar o funcionamento da integração sem a necessidade de realizar uma compra real, utilize a ferramenta de **Pedido Teste** disponibilizada no próprio painel da 99Food.

No **Gerenciador de Pedidos da 99Food**:

1. Acesse **Configurações**.
2. Localize a opção **Pedido Teste**.
3. Dispare um pedido de teste.
4. Verifique se o pedido foi recebido corretamente no PDV ConnectPlug.

Essa é a forma indicada para validar o fluxo completo da integração, incluindo a comunicação e a identificação dos produtos.

> **Dica:** sempre realize o pedido teste antes de considerar a implantação concluída. A ferramenta permite validar a integração sem precisar realizar uma venda real para o cliente final.

##### **Importação de cardápio pela 99Food**

Caso o cliente já possua um cardápio cadastrado em outra plataforma, como **iFood** ou **Delivery Direto**, é possível solicitar à 99Food a importação desse cardápio.

Esse procedimento pode reduzir o tempo de implantação e evitar o cadastro manual de todos os produtos.

##### Como solicitar

O próprio cliente deve:

1. Abrir um chamado diretamente com o **suporte da 99Food**.
2. Solicitar a **importação do cardápio de outra plataforma**.
3. Informar a plataforma de origem.

A 99Food pode realizar a importação de cardápios provenientes de plataformas como:

- iFood
- Delivery Direto
- Outras plataformas compatíveis

##### Após a importação

A importação replica o cardápio dentro da 99Food, mas **não realiza automaticamente a vinculação com a ConnectPlug**.

Após a importação, ainda será necessário:

- Vincular os produtos.
- Ajustar os códigos internos, como **SKU/ID**.
- Realizar os demais ajustes necessários em nomes, categorias e adicionais.

> **Importante:** a importação do cardápio não substitui a etapa de codificação e vinculação dos produtos com a ConnectPlug.

##### **Exportação de cardápio 99Food**

A exportação de cardápio da 99Food está disponível **exclusivamente no ERP 2.0 da ConnectPlug**.

##### **Particularidades e limitações**

##### Produtos com preço zerado

A 99Food não aceita produtos cujo preço esteja definido somente nas variações.

Um exemplo é uma pizza em que:

- O produto base possui valor **R$ 0,00**.
- Os valores estão definidos apenas nos sabores ou tamanhos.

Nesse cenário, a 99Food pode recusar a exportação do produto.

##### Como contornar

Defina um valor mínimo para o produto base.

**Exemplo: R$ 0,01**

Dessa forma, o produto poderá ser exportado.

##### Exclusão de produtos

A 99Food não possui exclusão automática de produtos por meio da exportação.

Os produtos podem permanecer:

- Disponíveis
- Pausados

Caso seja necessário excluir definitivamente um produto, a remoção deve ser realizada manualmente no portal da 99Food.

> **Atenção:** se um produto for removido manualmente da 99Food e posteriormente for realizada uma **exportação completa do cardápio**, o produto poderá ser criado novamente.

Para evitar isso, remova o produto também da **lista de preços utilizada na exportação**.

##### **Limitações atuais**

Atualmente, existem algumas limitações importantes na integração:

<div id="bkmrk-funcionalidade-situa"><div><table class="w-fit min-w-(--thread-content-width)" data-end="8352" data-start="8040"><thead data-end="8069" data-start="8040"><tr data-end="8069" data-start="8040"><th class="last:pe-10" data-col-size="md" data-end="8057" data-start="8040">Funcionalidade</th><th class="last:pe-10" data-col-size="sm" data-end="8069" data-start="8057">Situação</th></tr></thead><tbody data-end="8352" data-start="8080"><tr data-end="8184" data-start="8116"><td data-col-size="md" data-end="8166" data-start="8116">**Desativação automática por falta de estoque**</td><td data-col-size="sm" data-end="8184" data-start="8166">Não disponível</td></tr><tr data-end="8241" data-start="8185"><td data-col-size="md" data-end="8223" data-start="8185">**Exclusão automática de produtos**</td><td data-col-size="sm" data-end="8241" data-start="8223">Não disponível</td></tr><tr data-end="8296" data-start="8242"><td data-col-size="md" data-end="8271" data-start="8242">**Exportação de cardápio**</td><td data-col-size="sm" data-end="8296" data-start="8271">Disponível no ERP 2.0</td></tr><tr><td>**Exportação de cardápio multi-lojas**</td><td>Disponível, porém precisa ser realizado individualmente</td></tr><tr data-end="8352" data-start="8297"><td data-col-size="md" data-end="8316" data-start="8297">**Pedido teste**</td><td data-col-size="sm" data-end="8352" data-start="8316">Disponível pelo painel da 99Food</td></tr></tbody></table>

</div></div>A integração também não desativa automaticamente produtos quando o estoque chega a zero.

##### **Dúvidas frequentes**

<div id="bkmrk-d%C3%BAvida-resposta-onde"><div><table class="w-fit min-w-(--thread-content-width)" data-end="1245" data-is-last-node="" data-is-only-node="" data-start="97"><thead data-end="118" data-start="97"><tr data-end="118" data-start="97"><th class="last:pe-10" data-col-size="md" data-end="106" data-start="97">Dúvida</th><th class="last:pe-10" data-col-size="lg" data-end="118" data-start="106">Resposta</th></tr></thead><tbody data-end="1245" data-is-last-node="" data-start="129"><tr data-end="346" data-start="129"><td data-col-size="md" data-end="169" data-start="129">**Onde informo o ID da Loja no ERP?**</td><td data-col-size="lg" data-end="346" data-start="169">No ERP ConnectPlug, o campo utilizado é **Chave da Integração**. É nele que deve ser informado o ID numérico fornecido pela 99Food/PPI.</td></tr><tr data-end="549" data-start="347"><td data-col-size="md" data-end="416" data-start="347">**O link de autorização está dando erro ou expirou. O que fazer?**</td><td data-col-size="lg" data-end="549" data-start="416">O link de autorização é gerado semanalmente e expira. Solicite um novo link ao time de PPI.</td></tr><tr data-end="785" data-start="550"><td data-col-size="md" data-end="626" data-start="550">**Por que criar um vendedor e um método de pagamento chamados "99food"?**</td><td data-col-size="lg" data-end="785" data-start="626">Essa padronização facilita a identificação e a filtragem das vendas da 99Food nos relatórios financeiros e de vendas.</td></tr><tr data-end="1006" data-start="786"><td data-col-size="md" data-end="854" data-start="786">**Posso abrir o chamado no Octadesk sem o print da autorização?**</td><td data-col-size="lg" data-end="1006" data-start="854">Não. O print da aba **Estabelecimentos autorizados** é obrigatório para a validação e liberação da integração.</td></tr><tr data-end="1245" data-is-last-node="" data-start="1007"><td data-col-size="md" data-end="1072" data-start="1007">**Preciso realizar uma compra real para testar a integração?**</td><td data-col-size="lg" data-end="1245" data-is-last-node="" data-start="1072">Não. Utilize a opção **Pedido Teste**, disponível no Gerenciador de Pedidos da 99Food, para validar o recebimento do pedido no PDV.</td></tr></tbody></table>

</div></div>##### **Conclusão**

A integração com a **99Food** permite centralizar os pedidos da plataforma diretamente no PDV ConnectPlug. Para uma implantação correta, é importante seguir todas as etapas de autorização, liberação pelo PPI, configuração no ERP, vinculação dos produtos e realização do pedido teste.

Também é importante considerar as limitações atuais, principalmente em relação a **exclusão de produtos e controle automático de estoque**, antes de definir o fluxo de operação do cliente.