Ir para o conteúdo principal

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:

Requisito Informação
Link de autorização Deve ser solicitado ou recebido do time de PPI. O link é gerado semanalmente, às segundas-feiras, e expira ao final do período.
Acesso remoto Necessário estar conectado à máquina do cliente, por exemplo, via TeamViewer.
Portal 99Food O cliente deve estar logado na conta da loja no 99Food Admin.
SLA de liberação Após a solicitação, o time de PPI possui SLA de 08 horas úteis para realizar a liberação final da integração.
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.

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.

XFEpXFpIf37esgMc-image-1772733638352.png

ED6AwDRzbFBc6QwL-image-1772733703106.png

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:

b7PH47BRSUxMQslI-image-1787855203073.png

Integrações > 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

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

Wh7DuvrB8HwKJ17n-image-1772734100536.png

GCYx7167fSKVPPUB-image-1772734129864.png

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:

Funcionalidade Situação
Multilojas Não disponível
Desativação automática por falta de estoque Não disponível
Exclusão automática de produtos Não disponível
Exportação de cardápio Disponível no ERP 2.0
Pedido teste Disponível pelo painel da 99Food

Mesmo que a interface apresente opções relacionadas à seleção de lojas, o recurso de multilojas ainda não está disponível na integração.

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

Dúvidas frequentes
Dúvida Resposta
Onde informo o ID da Loja no ERP? No ERP ConnectPlug, o campo utilizado é Chave da Integração. É nele que deve ser informado o ID numérico fornecido pela 99Food/PPI.
O link de autorização está dando erro ou expirou. O que fazer? O link de autorização é gerado semanalmente e expira. Solicite um novo link ao time de PPI.
Por que criar um vendedor e um método de pagamento chamados "99food"? Essa padronização facilita a identificação e a filtragem das vendas da 99Food nos relatórios financeiros e de vendas.
Posso abrir o chamado no Octadesk sem o print da autorização? Não. O print da aba Estabelecimentos autorizados é obrigatório para a validação e liberação da integração.
Preciso realizar uma compra real para testar a integração? Não. Utilize a opção Pedido Teste, disponível no Gerenciador de Pedidos da 99Food, para validar o recebimento do pedido no PDV.
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 multilojas, exclusão de produtos e controle automático de estoque, antes de definir o fluxo de operação do cliente.