Ir para o conteúdo principal

INTEGRAÇÃO COM KEETA DELIVERY

 

I4drjChy2IFM9n69-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.

  • 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:

  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]

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]

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