INTEGRAÇÃO COM KEETA DELIVERY

 

---

Com base nas Fontes Contexto_Publico_Interno_ConnectPlug e NOVA INTEGRAÇÃO - 2025/12/04 11:02 GMT-03:00 - Anotações do Gemini (que inclui a transcrição da reunião técnica), segue o artigo estruturado para o HandBook da ConnectPlug.

---

? Integração Keeta Delivery

Este guia orienta a configuração da integração entre a plataforma de delivery Keeta (referida na transcrição como "Kita") e o sistema ConnectPlug. O foco é habilitar o recebimento centralizado de pedidos no PDV e ERP.

? Contexto: Por que Fazer?

A integração com a Keeta permite que o cliente ConnectPlug receba pedidos desta plataforma diretamente no PDV e KDS, eliminando a necessidade de re-digitação e centralizando a gestão da operação de delivery.

Para o Cliente: Agilidade operacional e redução de erros, pois o pedido cai direto na tela de produção/venda. Status Atual: A integração atual foca exclusivamente na importação de pedidos. A exportação/sincronização de cardápio está em desenvolvimento. Portanto, o vínculo dos produtos deve ser feito via código de integração. Cenário Logístico: A Keeta está iniciando operações no Brasil utilizando entregadores terceiros (integradores), o que torna a configuração de Frete dentro do sistema crucial para o controle financeiro da loja.

---

✅ Pré-Requisitos

Antes de iniciar a configuração, certifique-se de que o cliente possui:

Conta ativa na Keeta: O cliente já deve ter o acesso ao portal da plataforma. Módulo Delivery/Integrações: Contratado e ativo no plano ConnectPlug. Versão do PDV: O PDV deve estar atualizado para a versão 2.119 ou superior. Acesso ao ERP: Permissão de administrador para acessar as configurações de integração.

---

?️ Passo a Passo

Siga as etapas abaixo para realizar a autenticação e configuração.

1. Acesse a área de Integrações No ERP ConnectPlug, navegue até o módulo de Integrações e selecione a opção Keeta.

[PRINT 1: Tela de Seleção de Integrações no ERP - Ícone Keeta em destaque]

2. Inicie a Autorização Ao abrir as configurações, o cliente encontrará um botão para iniciar o processo. Esta ação redirecionará o usuário para uma URL fixa da Keeta contendo as informações do aplicativo ConnectPlug.

Clique no botão para gerar as credenciais. Se o cliente não estiver logado, a tela de login da Keeta aparecerá.

[PRINT 2: Botão "Obter Credenciais/Autorizar" dentro do ERP]

3. Confirme a Integração no Portal Keeta Após o login, o cliente será direcionado para a tela de ativação do aplicativo ConnectPlug.

O cliente deve confirmar a autorização do aplicativo. Atenção: Se houver erro de carregamento ou "conta inexistente", sugira realizar o processo utilizando uma guia anônima no navegador.

[PRINT 3: Tela de Autorização no portal da Keeta]

4. Capture as Credenciais Após autorizar, a plataforma Keeta exibirá duas informações essenciais na tela:

Código da Loja (Store Code) Código de Autorização (Authorization Code)

Copie esses códigos exatamente como exibidos.

[PRINT 4: Tela da Keeta exibindo o Código da Loja e Código de Autorização]

5. Finalize no ERP ConnectPlug Retorne ao ERP ConnectPlug e cole as informações nos campos correspondentes.

Campo Código da Loja: Cole o código obtido. Campo Código de Autorização: Cole o token obtido. Configure as opções adicionais:

Aceite Automático: Defina conforme a preferência da loja. Frete: Configure se a loja absorverá ou repassará o custo, lembrando que a logística é feita por integradores da Keeta.

[PRINT 5: Campos de preenchimento de credenciais e flags de configuração no ERP]

6. Salve a Configuração Clique em salvar. A integração estará ativa para recebimento de pedidos.

---

❓ Dúvidas Frequentes (FAQ)

1. Consigo enviar meu cardápio da ConnectPlug para a Keeta? Não neste momento. A integração atual é apenas de pedidos. O cardápio deve ser cadastrado na Keeta e os produtos devem ter seus códigos de integração (PDV/SKU) vinculados para que o pedido entre corretamente no sistema.

2. O cliente clicou para autorizar, mas a página não carrega ou dá erro. Dica de Suporte: Isso pode ocorrer devido a cache ou cookies de sessões anteriores. Peça para o cliente tentar realizar o processo (passos 2 e 3) utilizando uma aba anônima do navegador.

3. Como funciona a entrega? A Keeta utiliza parceiros logísticos. No ERP, verifique a configuração da flag de Frete para garantir que os valores dos pedidos batam com o repasse financeiro, já que a loja pode não ter entregadores próprios nessa modalidade.

4. A integração não aparece no PDV. Verifique a versão. A funcionalidade está disponível apenas a partir da versão 2.119 do ConnectPlug PDV.

 

• Melhora a eficiência e reduz erros, no cenário de integração.

• Integração com PDV 2.0 (a partir da versão 2.11.8):
  
  Para configurar a integração no sistema da ConnectPlug, o cliente deve solicitar a chave de autenticação ao time da PEDIZAP e informar a URL do domínio da loja.

• Vínculo de método de pagamento online e nome do vendedor.

• Recebimento automático de pedidos e conciliação.

• Integração manual do cardápio, sem exportação.

• Possuir API no plano (apenas se desejar integrar o cardápio, se a integração for manual, não é necessário.)

• Sincronização do cadastro de produtos: realizada pela PEDIZAP via API CP <> PEDIZAP.
  
  Para que a sincronização do cadastro de produtos seja realizada, cabe ao time de Suporte abrir a demanda para N2, e ao time de N2 registrar a issue para Produtos, seguindo modelo estabelecido ->
  
  

  Título da Issue:
  [CP] Criação de usuários na API V3 (Integrador PediZap)
  
  

  ---

  
  Descrição da Issue:
  Solicitação de criação de usuário para API V3.

  Dados do cliente:
  Schema(s):
  Empresa(s): 
  Login Code (Opcional):
  CompanyID (Opcional): —

  Dados Complementares

  E-mail:
  Para o integrador: pedizap
  
  

  ---

  
  Link do modelo da Issue: https://git.tray.net.br/cplug/chamados/board-chamados/-/issues/641