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:
| 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. |
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:
- Autorização no portal do cliente
- Ativação da integração no ERP
- 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.
- Selecione a loja do cliente.
- Clique em Confirmar autorização e continuar.
- Na janela seguinte, marque a caixa de seleção ao lado do nome do estabelecimento.
- Clique novamente em Confirmar.
Envie a evidência da autorização
Após concluir a autorização:
- Acesse a aba Estabelecimentos autorizados.
- Tire um print legível da tela.
- Certifique-se de que estejam visíveis o nome da loja e CONNECTPLUG DESENVOLVIMENTO DE SOFTWARE LTDA.
- Abra um chamado interno no Octadesk.
- Informe os dados completos da loja.
- 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.
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:
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:
- Crie um método de pagamento específico com o nome 99food.
- Crie um usuário/vendedor com o nome 99food.
- Vincule ambos à integração.
- 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
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:
- Localize o produto desejado.
- Clique nos três pontinhos.
- Selecione Editar.
- Localize o campo Código PDV.
- Informe o código correspondente ao produto na ConnectPlug.
- 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.
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:
- Acesse Configurações.
- Localize a opção Pedido Teste.
- Dispare um pedido de teste.
- 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:
- Abrir um chamado diretamente com o suporte da 99Food.
- Solicitar a importação do cardápio de outra plataforma.
- 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 |
|---|---|
| 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 |
| Exportação de cardápio multi-lojas | Disponível, porém precisa ser realizado individualmente |
| Pedido teste | Disponível pelo painel da 99Food |
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 exclusão de produtos e controle automático de estoque, antes de definir o fluxo de operação do cliente.