INTEGRAÇÃO 99FOOD Podcast: Escute para aprenderVídeo: Assista para entender A integração entre a 99Food e a ConnectPlug permite que os pedidos realizados no aplicativo da 99 sejam recebidos automaticamente no PDV da ConnectPlug, centralizando a operação de delivery e agilizando o atendimento do cliente. Este artigo reúne todo o fluxo de implantação, autenticação, configuração, exportação de cardápio, testes e principais limitações da integração. 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. 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. 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 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. Exportação de Cardápio 99Food A exportação da 99Food está disponível exclusivamente no ERP 2.0 da ConnectPlug. Particularidades e Limitações da Exportação - Produtos com preço zerado A 99Food não aceita produtos cujo preço esteja apenas nas variações. Exemplo comum: Pizza com produto base = R$ 0,00 Valores apenas nos sabores/tamanhos Nesse cenário a 99 pode recusar a exportação. - Como contornar Defina um valor mínimo no produto base: Exemplo: R$ 0,01 Isso permite que o item seja exportado. - Exclusão de produtos A 99Food não possui exclusão automática via exportação. Os produtos podem apenas: Ficar disponíveis Ficar pausados Se o cliente quiser excluir definitivamente: Deve remover manualmente no portal da 99Food - Reexportação automática de produtos Se um produto for removido manualmente da 99Food e o cliente fizer: Exportação completa do cardápio O item poderá ser criado novamente. Como evitar Remova o produto da: Lista de preços utilizada na exportação - Multilojas Atualmente: ❌ Não há suporte multilojas na integração 99Food. Mesmo que a interface mostre seleção de lojas, o recurso ainda não está disponível. - Controle automático de estoque Atualmente: ❌ A integração não desativa automaticamente produtos sem estoque. Motivo: Alto custo operacional de sincronização constante Baixa demanda atual para essa funcionalidade ❓ 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.