Integração ERP Maqplan com 99 Food

Resumo do que será ensinado

Neste documento você aprenderá, passo a passo, como configurar e utilizar a integração do ERP Maqplan com o 99 Food, incluindo:

• Como preparar os produtos no sistema para envio ao 99 Food.
• Como configurar a integração (APPID, APPCODE).
• Como definir regra de preço (normal ou com margem).
• Como sincronizar o cardápio.
• Como abrir/fechar a loja e acompanhar os pedidos pelo painel de delivery.

Segue um Vídeo explicativo do processo

Detalhamento do uso correto

Com este guia, você deve ser capaz de configurar e operar a integração do ERP Maqplan com o 99 Food. Siga cada passo cuidadosamente e aproveite as funcionalidades do sistema para manter seu cardápio atualizado e gerenciar pedidos diretamente pelo ERP.

Segue o detalhamento de como configurar e utilizar a integração Maqplan x 99 Food

1. Primeiro passo: Preparar os produtos no ERP Maqplan para o 99 Food.

   • Acesse o cadastro de produtos no ERP Maqplan.
   • Localize o produto que será disponibilizado no 99 Food e clique em Editar.
   • Na tela de edição do produto, localize o campo “Disponível na web”.
     
     • Este campo indica se o produto estará disponível para envio às plataformas integradas (Kita, 99 Food, etc.).
   • Marque o campo “Disponível na web” para todos os produtos que você deseja que apareçam no cardápio do 99 Food.
   • Salve o cadastro do produto.
   • Pontos de atenção.
     
     • Apenas produtos com “Disponível na web” marcado serão enviados ao 99 Food quando o cardápio for sincronizado.
     • Verifique se o nome, descrição e preço dos produtos estão corretos, pois essas informações serão exibidas para o cliente final no aplicativo 99 Food.

2. Segundo passo: Acessar o módulo de integrações do ERP Maqplan.

   • No menu principal do ERP Maqplan, acesse a opção Integrações.
   • Em seguida, selecione Configurar integração.
   • Na lista de integrações disponíveis, localize a integração com “99” ou “99 Food”.
   • Verifique se a integração com 99 já está marcada como “veiculado”, indicando que está habilitada para uso.
   • Pontos de atenção.
     
     • Caso a integração não esteja habilitada, consulte o responsável técnico ou o suporte para ativá-la.
     • Somente integrações devidamente habilitadas poderão enviar produtos e receber pedidos do 99 Food.

3. Terceiro passo: Configurar os dados de integração (APPID e APPCODE).

   • Na tela da integração 99, clique em Editar para ajustar as configurações.
   • Serão apresentados campos como:
     
     • APPID.
     • APPCODE (ou código equivalente do aplicativo).
   • APPID.
     
     • Este identificador é fornecido pelo time de desenvolvimento da Maqplan ou é um valor padrão utilizado pelo sistema.
     • Em geral, é um código que identifica o seu sistema junto ao serviço de integração.
   • APPCODE / credenciais do cliente.
     
     • Estes dados devem ser obtidos no site do cliente junto ao 99 Food, no painel de parceiro da plataforma.
     • Normalmente, o cliente (loja) possui um painel no 99 Food onde são exibidos tokens, chaves ou códigos de acesso, que serão inseridos aqui.
   • Preencha corretamente APPID e APPCODE conforme orientações do programador ou do suporte técnico.
   • Após inserir os dados, clique em Salvar.
   • Pontos de atenção.
     
     • APPID incorreto ou APPCODE inválido impedem a comunicação entre o ERP Maqplan e o 99 Food.
     • Se houver dúvida sobre qual valor utilizar, consulte o programador ou o suporte Maqplan antes de salvar.

4. Quarto passo: Definir a política de preço para o 99 Food (campo “Margem”).

   • Ainda na tela de edição da integração do 99, existe um campo/configuração de margem de preço.
   • Este campo foi criado para permitir que o cliente trabalhe com preços diferentes no 99 Food em relação ao preço cadastrado no ERP.
   • Funcionamento da configuração:
     
     • Em branco:
     • Se este campo estiver vazio, o sistema envia para o 99 Food exatamente o preço cadastrado no ERP Maqplan.
     • Exemplo: Produto cadastrado no ERP por R$ 20,00 → será enviado para o 99 Food por R$ 20,00.
     • Com margem:
     • Ao selecionar a opção “com margem”, o sistema envia o preço do ERP acrescido de 10%.
     • Exemplo: Produto cadastrado no ERP por R$ 20,00 → o 99 Food receberá o preço de R$ 22,00 (20 + 10%).
   • Escolha a opção conforme sua estratégia comercial:
     
     • Se deseja manter o mesmo preço do sistema, deixe em branco.
     • Se deseja trabalhar com acréscimo de 10% no 99 Food, selecione “com margem”.
   • Após definir, clique em Salvar.
   • Pontos de atenção.
     
     • Alterar essa configuração impacta todos os produtos enviados ao 99 Food.
     • Caso o cliente deseje margens diferentes por produto, isso deve ser tratado com o suporte ou desenvolvimento, pois a opção padrão é acréscimo fixo de 10%.

5. Quinto passo: Sincronizar o cardápio com o 99 Food.

   • Na tela de integração do 99, existe um botão chamado “Sincronizar cardápio”.
   • Função deste botão:
     
     • Enviar para o 99 Food todos os produtos cadastrados no ERP Maqplan que estejam com o campo “Disponível na web” marcado.
     • Atualizar o cardápio da loja no 99 Food com os itens e preços configurados no ERP.
   • Procedimento:
     
     • Clique em “Sincronizar cardápio”.
     • O sistema iniciará o processo de envio dos dados ao 99 Food.
   • Prazo de sincronização:
     
     • Normalmente, o 99 Food processa e atualiza o cardápio em aproximadamente 5 a 10 minutos.
   • Pontos de atenção.
     
     • Caso o produto não apareça no cardápio do 99 Food, verifique:
     • Se o produto está marcado como “Disponível na web”.
     • Se a integração está corretamente configurada (APPID, APPCODE).
     • Se houve alguma falha de comunicação (consultar logs ou suporte).
     • Sempre que houver alteração de cadastro ou preço de produto, recomenda-se sincronizar o cardápio novamente para garantir que o 99 Food esteja atualizado.

6. Sexto passo: Abrir e fechar a loja pelo ERP Maqplan.

   • Dentro da integração do 99, o sistema disponibiliza opções para abrir ou fechar a loja no 99 Food.
   • Funcionalidade:
     
     • Abrir loja:
     • Ativa a loja no 99 Food, permitindo que clientes façam pedidos.
     • Ao abrir a loja, o sistema exibe um painel de delivery, específico para acompanhar os pedidos integrados.
     • Fechar loja:
     • Desativa temporariamente a loja no 99 Food, impedindo novos pedidos.
     • Utilizado em casos como fim do expediente, falta de equipe, manutenção, etc.
   • Para abrir a loja:
     
     • Clique em “Abrir loja”.
     • Aguarde o sistema comunicar essa ação ao 99 Food.
     • Ao ser aberta, será exibido o painel de delivery com os pedidos.
   • Para fechar a loja:
     
     • Clique em “Fechar loja”.
     • A loja deixará de receber novos pedidos no 99 Food.
   • Pontos de atenção.
     
     • Verifique se os horários de abertura e fechamento estão alinhados com o funcionamento real da operação.
     • Abrir a loja sem equipe ou sem produtos disponíveis pode gerar problemas de atendimento.

7. Sétimo passo: Utilizar o painel de delivery para acompanhar pedidos do 99 Food.

   • Ao abrir a loja, o ERP Maqplan exibe um painel de delivery dedicado às integrações.
   • Neste painel, você verá todos os pedidos recebidos pelo 99 Food que foram integrados ao ERP.
   • Funcionalidades principais do painel:
     
     • Visualizar pedidos disponíveis:
     • Quando um cliente faz um pedido pelo 99 Food, ele é enviado ao ERP e aparece neste painel.
     • Aceitar pedido:
     • Ao clicar em um pedido, você pode aceitá-lo, indicando que será preparado.
     • Separar / preparar pedido:
     • Após aceitar, é possível mudar o status para “Separar”, indicando que o pedido está em preparação.
     • Atualizar status do pedido (movimentar dentro do fluxo):
     • Você pode mover o pedido entre estados (aceito, separado, pronto, etc.), conforme a lógica configurada.
   • Fluxo de funcionamento:
     
     • Pedido é feito pelo cliente no 99 Food.
     • Pedido chega ao ERP Maqplan e aparece no painel de delivery.
     • Operador da loja aceita e prepara o pedido usando as opções do painel.
   • Pontos de atenção.
     
     • Sempre monitore o painel para não deixar pedidos sem ação.
     • Confirmar que os status de pedidos no ERP estão sincronizados com o que o 99 Food espera, evitando divergências de informação para o cliente.

8. Oitavo passo: Conceito geral das integrações de delivery no Maqplan.

   • A integração com o 99 Food segue um conceito padrão de integrações de delivery no ERP Maqplan:
     
     • Cadastro de produtos no ERP.
     • Marcação de produtos como “Disponível na web”.
     • Configuração de integração (credenciais, APPID, APPCODE).
     • Sincronização de cardápio para enviar produtos à plataforma.
     • Abertura/fechamento de loja diretamente pelo ERP.
     • Uso de um painel de delivery para acompanhar e gerenciar pedidos de forma centralizada.
   • Outras integrações (como Kita e similares) tendem a seguir o mesmo fluxo básico, com ajustes específicos conforme cada plataforma.

Informações Importantes

• Resumo das principais orientações.

  • Marque os produtos como “Disponível na web” para que sejam enviados ao 99 Food.
  • Configure corretamente APPID e APPCODE conforme dados fornecidos pelo programador e pelo painel do 99 Food.
  • Utilize a opção de margem se desejar trabalhar com preços 10% maiores no 99 Food.
  • Sempre que alterar produtos ou preços, clique em “Sincronizar cardápio” e aguarde de 5 a 10 minutos para atualização completa.
  • Use o painel de delivery para acompanhar, aceitar e movimentar os pedidos recebidos.

• Dicas de uso.

  • Faça um teste com poucos produtos inicialmente, para validar se a integração está funcionando corretamente.
  • Verifique periodicamente se o cardápio no 99 Food está compatível com o cadastro do ERP, evitando diferenças de preço ou itens.
  • Treine a equipe para utilizar o painel de delivery, garantindo que os pedidos sejam rapidamente aceitos e preparados.

• Recomendações gerais sobre o processo.

  • Em caso de erro de comunicação ou produtos não aparecendo, revise:
  • Se o produto está marcado “Disponível na web”.
  • Se as credenciais (APPID, APPCODE) estão corretas.
  • Se a loja está aberta no painel de integrações.
  • Em dúvidas técnicas, entre em contato com o suporte Maqplan informando que se trata da integração com o 99 Food e descreva o comportamento observado.

• Benefícios de seguir corretamente o procedimento.

  • Garantir que o cardápio do 99 Food esteja sempre atualizado com o ERP, reduzindo erros de preço e disponibilidade.
  • Centralizar o controle de pedidos de delivery diretamente no ERP Maqplan, facilitando o fluxo operacional e financeiro.
  • Melhorar a experiência do cliente final, com informações consistentes entre o aplicativo 99 Food e a operação interna da loja.