Integração ERP Maqplan com Keet

Resumo do que será ensinado

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

• Como configurar a chave de integração do Kita no ERP Maqplan.
• Como definir regra de preço com acréscimo (taxa) para os produtos enviados ao Kita.
• Como preparar os produtos no sistema (SKU e disponibilidade na web).
• Como entender as diferenças de funcionamento entre a integração com Kita e com 99 Food.

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 Kita. Siga cada passo cuidadosamente e aproveite as funcionalidades do sistema para enviar corretamente o cadastro de produtos e trabalhar com preços ajustados às taxas da plataforma.

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

1. Primeiro passo: Entender o conceito da integração com o Kita.

   • A integração com o Kita é um pouco diferente da integração com o 99 Food.
   • No 99 Food, o sistema envia automaticamente o cadastro de produtos, sem necessidade de cadastro manual na plataforma.
   • No Kita, o funcionamento é similar a integrações de restaurante/mercado já conhecidas:
     
     • O cliente cadastra o produto no ERP Maqplan.
     • O cliente cadastra o mesmo produto no painel do Kita.
     • Em seguida, faz a vinculação dos códigos (SKU) entre o ERP e o Kita.
   • Pontos de atenção.
     
     • A integração com o Kita exige cadastro duplo: no ERP e na plataforma Kita.
     • A vinculação correta dos códigos (SKU) é fundamental para que os pedidos sejam identificados e integrados corretamente.

2. Segundo passo: Acessar o módulo de integrações e localizar o Kita.

   • No menu principal do ERP Maqplan, acesse Integrações.
   • Selecione a opção Configurar integração.
   • Na lista de integrações disponíveis, localize a integração Kita.
   • Verifique se a integração está habilitada (veiculada), ou seja, pronta para uso.
   • Caso não esteja habilitada, é necessário que o responsável técnico ou suporte Maqplan faça a ativação.
   • Pontos de atenção.
     
     • Sem a integração habilitada, não será possível salvar as configurações ou transmitir dados ao Kita.

3. Terceiro passo: Configurar a chave de integração (chave do cliente no Kita).

   • Clique na integração Kita e selecione Editar.
   • Na tela de edição, haverá um campo para chave/código de integração do Kita.
   • Essa chave é fornecida pelo cliente através do painel dele no Kita:
     
     • O cliente acessa o painel do Kita.
     • Localiza a chave de integração (token ou código) que a plataforma disponibiliza.
     • Fornece essa chave à equipe que está configurando o ERP Maqplan.
   • Insira a chave do Kita no campo correspondente no ERP Maqplan.
   • Após preencher, clique em Salvar para registrar a configuração.
   • Pontos de atenção.
     
     • Essa chave é específica de cada cliente/loja.
     • Sem essa chave correta, o ERP não conseguirá se comunicar com o Kita.

4. Quarto passo: Configurar a regra de preço (acréscimo de taxa) para o Kita.

   • Ainda na tela de integração do Kita, existe um campo ou botão para trabalhar com dois preços, semelhante ao usado na integração com o 99 Food.
   • Objetivo dessa configuração:
     
     • Permitir que o cliente aplique uma taxa adicional sobre o preço do produto quando vendido pelo Kita.
     • Essa taxa compensa as taxas cobradas pela plataforma (Kita, 99, iFood etc.), evitando prejuízo ao vender pelo mesmo preço da loja física.
   • Funcionamento da configuração:
     
     • Preço base no sistema:
     • Exemplo: produto cadastrado no ERP Maqplan por R$ 10,00.
     • Configuração de acréscimo (10% a mais):
     • Ao ativar a opção de trabalhar com 2 preços / acréscimo, você informa que todos os produtos enviados terão um valor 10% maior para o Kita.
     • No exemplo, o produto será enviado ao Kita com preço de R$ 11,00 (10 + 10%).
   • Como configurar:
     
     • Localize o campo/botão de taxa ou margem.
     • Informe/ative a opção para aplicar 10% a mais sobre o preço do sistema.
     • Clique em Salvar.
   • Pontos de atenção.
     
     • Essa taxa é aplicada sobre todos os produtos enviados ao Kita via integração.
     • É importante explicar ao cliente que esse acréscimo serve para compensar as taxas do aplicativo e não gerar perda financeira.

5. Quinto passo: Preparar os produtos no ERP Maqplan para uso com o Kita (Disponível na web e SKU).

   • Para que um produto possa ser integrado ao Kita, ele deve cumprir dois requisitos no ERP:
   1. Estar cadastrado normalmente com nome, preço, etc.
   2. Estar marcado como “Disponível na web”.
   • Procedimento:
     
     • Acesse o cadastro de produtos no ERP Maqplan.
     • Localize o produto desejado e clique em Editar.
     • Na tela do produto, encontre o campo “Disponível na web”.
     • Marque este campo para permitir que o produto seja considerado para integração.
     • Localize também o campo SKU (código único do produto dentro do ERP).
     • O SKU é o código que será utilizado para vincular o produto entre o ERP e o Kita.
     • Anote ou copie o SKU do produto, pois ele será utilizado posteriormente no painel do Kita.
     • Clique em Salvar para confirmar as alterações.
   • Pontos de atenção.
     
     • Sem a marcação “Disponível na web”, o produto não será considerado para integrações.
     • O SKU deve ser exatamente o mesmo usado na vinculação dentro do Kita, evitando erros de associação.

6. Sexto passo: Vincular o SKU do ERP ao produto cadastrado no Kita.

   • A integração com o Kita não envia automaticamente o cadastro completo de produtos como ocorre com o 99 Food.
   • Em vez disso, é necessário cadastrar o produto diretamente no painel do Kita e depois vincular ao produto do ERP por meio do SKU.
   • Passos gerais (no ponto de vista do processo):
     
     • O cliente cadastra o produto no ERP Maqplan.
     • O cliente cadastra o produto no painel do Kita, com nome, preço e demais informações necessárias.
     • No painel do Kita, existe uma opção para vincular o produto ao sistema externo através de um código (SKU).
     • O cliente então pega o SKU do produto no ERP e informa esse mesmo SKU no cadastro do produto no Kita.
   • Exemplo prático:
     
     • No ERP Maqplan:
     • Produto “Arroz 5kg” → SKU: ARZ5KG01; preço: R$ 20,00; marcado como Disponível na web.
     • No Kita:
     • Produto “Arroz 5kg” cadastrado com preço e detalhes.
     • Campo de SKU (ou código externo) recebe o valor ARZ5KG01.
   • Resultado:
     
     • Quando um pedido do Kita incluir o produto “Arroz 5kg”, o sistema utilizará o SKU ARZ5KG01 para identificar e vincular corretamente esse produto ao cadastro do ERP Maqplan.
   • Pontos de atenção.
     
     • O SKU deve ser idêntico entre ERP e Kita.
     • Erros de digitação ou uso de códigos diferentes impedem a integração correta dos pedidos.

7. Sétimo passo: Comparando a integração do Kita com a integração do 99 Food.

   • Para evitar confusão, é importante entender a diferença entre as duas integrações:
     
     • Integração 99 Food.
     • O sistema envia automaticamente o cardápio ao 99 Food.
     • O cliente não precisa cadastrar produtos diretamente no 99 Food; eles são enviados pelo ERP.
     • Há opção de sincronizar cardápio e de trabalhar com margem de preço (10% a mais).
     • Integração Kita.
     • O sistema não envia automaticamente o cadastro completo dos produtos da mesma forma.
     • O cliente precisa cadastrar o produto no ERP e no Kita.
     • É necessária uma vinculação por SKU para que os pedidos possam ser reconhecidos e integrados.
     • Também existe opção de trabalhar com dois preços, aplicando taxa de 10% a mais sobre o preço do sistema.
   • Resumo da diferença principal.
     
     • No 99 Food, o sistema “faz tudo” em relação ao cadastro de produto.
     • No Kita, o cliente precisa atuar mais: cadastrar em dois locais e vincular códigos.

8. Oitavo passo: Garantir o funcionamento correto da integração com o Kita.

   • Para que a integração funcione corretamente, verifique:
     
     • Chave do Kita está corretamente cadastrada na integração do ERP Maqplan.
     • Todos os produtos que serão vendidos via Kita:
     • Estão cadastrados no ERP.
     • Estão cadastrados no Kita.
     • Possuem SKU vinculado corretamente entre as duas plataformas.
     • Estão marcados como “Disponível na web” no ERP.
     • A regra de preço (taxa/margem) está configurada conforme a estratégia comercial do cliente.
   • Sempre que houver alteração de preço no ERP:
     
     • Avalie se é necessário ajustar também o preço no Kita, principalmente se não estiver usando apenas o acréscimo fixo de 10%.
   • Pontos de atenção.
     
     • Explique claramente ao cliente que, diferente do 99 Food, o Kita exige manutenção de cadastro em dois sistemas.
     • Reforce o uso correto do SKU para evitar problemas de integração de pedidos.

Informações Importantes

• Resumo das principais orientações.

  • Cadastre o produto no ERP Maqplan e no painel do Kita.
  • No ERP, marque “Disponível na web” e copie o SKU do produto.
  • No Kita, informe o mesmo SKU para vincular o produto ao ERP.
  • Configure a chave de integração do Kita na tela de integrações do ERP.
  • Utilize a opção de taxa/margem de 10% quando desejar trabalhar com preços maiores para compensar as taxas da plataforma.

• Dicas de uso.

  • Comece com alguns produtos de teste, vincule corretamente os SKUs e faça pedidos simulados para validar o fluxo.
  • Documente internamente, para o cliente, qual SKU corresponde a cada produto, facilitando futuras manutenções.
  • Caso o cliente utilize várias plataformas (Kita, 99, iFood), mantenha uma estratégia uniforme de preços e taxas para evitar confusão.

• Recomendações gerais sobre o processo.

  • Em caso de problemas de integração (produto não reconhecido, pedido com erro):
  • Verifique se o SKU está correto nas duas plataformas.
  • Confirme se o produto está marcado “Disponível na web” no ERP.
  • Revise a chave de integração cadastrada para o Kita.
  • Em dúvidas técnicas, entre em contato com o suporte Maqplan, informando que se trata de integração com o Kita, e descreva o comportamento observado.

• Benefícios de seguir corretamente o procedimento.

  • Garantir que os pedidos do Kita sejam integrados ao ERP Maqplan com o produto correto, evitando falhas no faturamento e controle de estoque.
  • Permitir que o cliente trabalhe com preços diferenciados, protegendo a margem de lucro contra taxas das plataformas de delivery/marketplace.
  • Padronizar o processo de integração, facilitando o treinamento da equipe e a expansão para outras plataformas seguindo conceitos semelhantes.