INTEGRAÇÃO COM 99FOOD
INTEGRAÇÃO COM 99FOOD
Como configurar a integração 99Food & Cplug?
O processo consiste em copiar o identificador da sua loja na plataforma da 99 Food e inseri-lo no campo de autorização do ERP.
Passo 1. Acesse a página de administração do 99Food em seu navegador.
Passo 2. No menu principal, navegue até Lojas e clique em Configurações (certifique-se de estar na loja correta).
Passo 3. Nesta página, localize a informação descrita como ID da Loja.
Passo 4. Copie este número.
Passo 5. Em outra aba do navegador, acesse o ERP CPlug.
Passo 6. Vá até a aba de Integrações e selecione a opção 99Food.
Passo 7. Localize o campo chamado Chave da Integração.
Passo 8. Cole o "ID da Loja" (copiado no passo anterior) dentro deste campo.
Passo 9. Salve as configurações para finalizar a integração.
Importante: O campo no ERP chama-se "Chave da Integração", mas o dado que deve ser inserido nele é o "ID da Loja" fornecido pelo portal da 99 Food. Certifique-se de não copiar espaços em branco antes ou depois do número.
Guia de Operação: Integração 99Food
?️ Podcast: Escute para aprender
?️ Vídeo: Assista para entender
? Contexto/Por que Fazer
A integração com o 99Food é fundamental para que os restaurantes recebam os pedidos do aplicativo diretamente no PDV da ConnectPlug, garantindo um controle centralizado e maior agilidade na operação de delivery do cliente.
Para que a comunicação entre os sistemas ocorra de forma segura e respeitando as permissões de API, o processo de ativação exige uma autorização dupla. O time de Implementação (IO) deve conduzir o cliente na autorização via portal 99Food Admin e, em seguida, solicitar a liberação final pelo time de PPI.
A execução correta dessa etapa é o que assegura que o sistema puxe o cardápio e os pedidos sem falhas de permissão.
? Pré-Requisitos
Antes de iniciar a implantação da integração no cliente, certifique-se de ter:
- Link Semanal de Autorização: Solicitado ou recebido do time de PPI. Este link é gerado todas as segundas-feiras e expira semanalmente.
- Acesso Remoto: Estar conectado à máquina do cliente (ex: via TeamViewer).
- Acesso ao Portal 99Food: O cliente deve estar logado na sua conta no painel do 99Food Admin.
- Alinhamento de Prazo (SLA): O cliente deve ser expressamente informado de que, após a solicitação, o time de PPI possui um SLA de 08 horas úteis para realizar a liberação final da integração
⚙️ Passo a Passo
O processo é dividido entre a autorização no ambiente do cliente e a finalização no ERP da ConnectPlug.
Fase 1: Autorização no Portal do Cliente
- Com o acesso remoto ativo na máquina do cliente, cole o link semanal de autorização no navegador onde o cliente está logado no 99Food.
- O portal exibirá uma tela solicitando a permissão. Selecione a loja do cliente e clique no botão amarelo "Confirmar autorização e continuar".
Na janela pop-up seguinte, marque a caixa de seleção ao lado do nome do estabelecimento e clique novamente em "Confirmar".
Após o sucesso da operação, navegue até a aba "Estabelecimentos autorizados". Tire um print legível desta tela, garantindo que o nome da loja e a "CONNECTPLUG DESENVOLVIMENTO DE SOFTWARE LTDA" estejam visíveis.
Atenção: Essa evidência é obrigatória para seguir com o processo.
Abra um chamado interno no sistema Octadesk contendo os dados completos da loja do cliente e anexe obrigatoriamente o print salvo no passo anterior. Aguarde a validação e liberação final pelo time de PPI.
Fase 2: Ativação da Integração no ERP Cplug
Após o PPI retornar com o ID da Loja, acesse o ERP CPlug em Integrações > 99Food.
Cole o "ID da Loja" no campo "Chave da Integração".
Atenção: Certifique-se de que não há espaços em branco antes ou depois do número
Crie e vincule um método de pagamento e um usuário/vendedor com o nome "99food" nas configurações da integração, salve e sincronize o PDV para verificar se o status consta como AUTENTICADA
Fase 3: Configuração e Testes no PDV
Com a confirmação da liberação pelo time interno, utilize o ID da Loja liberado para inserir na integração dentro do ERP da ConnectPlug e ativar a loja com sucesso.
No 99Food Admin, acesse o menu lateral Cardápios > Cardápio da Loja. Clique nos três pontinhos do produto desejado, selecione "Editar" e preencha o campo Código PDV com o código correspondente do sistema ConnectPlug.
Repita o processo para produtos, complementos e itens adicionais, e clique em "Enviar".
Para validar se todo o fluxo foi configurado do começo ao fim, acesse as Configurações no Gerenciador de Pedidos da 99Food e dispare um "Pedido Teste".
Verifique se o pedido caiu corretamente no PDV ConnectPlug do cliente.
Importação de cardápio via suporte (99Food)
Quando usar?
Utilize essa alternativa quando o cliente já possui cardápio cadastrado em outras plataformas (como iFood, Delivery Direto, etc.) e deseja evitar o retrabalho de cadastrar tudo manualmente na 99Food.
Como funciona
O próprio cliente pode:
- Abrir um chamado diretamente com o suporte da 99Food
- Solicitar a importação do cardápio de outra plataforma
A 99 pode realizar a importação de cardápios vindos de:
- iFood
- Delivery Direto (DD)
- Outras plataformas compatíveis
Após a importação
Depois que a 99 concluir a importação:
- O cardápio já estará estruturado dentro da plataforma
- Será necessário apenas:
- Realizar a vinculação dos produtos
- Ajustar os códigos internos (SKU/ID) na integração com a ConnectPlug
Observações importantes
- A importação não vincula automaticamente com o sistema, apenas replica o cardápio
- A etapa de codificação/vinculação ainda é obrigatória
- Pode haver necessidade de pequenos ajustes (nomes, categorias, adicionais)
Dica interna
Sempre que o cliente já tiver cardápio em outra plataforma, vale orientar esse caminho antes de iniciar o cadastro do zero — isso reduz muito o tempo de implantação e evita erros manuais.
❓ Dúvidas Frequentes
- Onde coloco o "ID da Loja" no ERP CPlug? No sistema da ConnectPlug, a nomenclatura do campo é "Chave da Integração". É exatamente neste campo que o ID numérico gerado pelo 99Food deve ser colado.
- O link de autorização está dando erro ou expirou. O que fazer? O link expira semanalmente. Caso esteja inválido, solicite o atualizado ao PPI.
- Por que preciso criar um usuário/vendedor "99food"? Sempre criar esse método de pagamento e usuário facilita a visualização e filtragem correta nos relatórios financeiros e de vendas do cliente
- Posso abrir o chamado no Octadesk sem o print da tela de autorização? Não. O envio do print da aba "Estabelecimentos Autorizados" é uma evidência imprescindível para o time de validação interna. Chamados sem esse anexo não poderão ter a liberação finalizada no portal do desenvolvedor.
- Como ter certeza de que a integração está operando sem precisar de uma compra real do cliente final? Utilize a ferramenta de Pedido Teste fornecida no próprio painel da 99Food. Ela simula a injeção de um pedido e é a maneira mais segura de comprovar se os códigos de PDV e a comunicação com a ConnectPlug estão operando perfeitamente.