Ir para o conteúdo principal

INTEGRAÇÃO COM KEETA DELIVERY

 

I4drjChy2IFM9n69-image-1764859300173.pngI4drjChy2IFM9n69-image-1764859300173.png

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.

  • Direciona Paraautomaticamente 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 deos 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 controlePDV financeiroElimina daentradas loja.manuais e melhora a eficiência Gerenciamento em tempo real, com relatórios detalhados 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.

 

 
✅ Pré-Requisitos

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

  1. Conta ativa na Keeta: O cliente já deve ter o acesso ao portal da plataforma.
  2. Módulo Delivery/Integrações: Contratado e ativo no plano ConnectPlug.
  3. Versão do PDV: O PDV deve estar atualizado para a versão 2.119 ou superior.
  4. 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]wDrXaGOcWBYT2NEL-image-1764859700568.png

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:

  1. Código da Loja (Store Code)
  2. 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]cp6AMkS5WhBoLZNO-image-1764859791316.png

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]Z3EzZKIokKsPiWcr-image-1764859814980.png

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.3. 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
    Voltar ao topo