INTEGRAÇÃO GOOMER

🎯 1. Visão Geral e Contexto (Por que utilizar?)
📌 O que é a Goomer?

A Goomer é uma plataforma de soluções digitais para estabelecimentos do segmento de alimentação (restaurantes, bares e lanchonetes), focada em canais de atendimento e venda.

💡 Por que utilizar a integração?

A integração é utilizada para receber os pedidos delivery da Goomer no PDV 2.0:

  • Centralização da Operação: Unifica os pedidos vindos da Goomer no mesmo fluxo de caixa, produção e cozinha do PDV CPlug.

  • Facilitação de Migração: Atende estabelecimentos em transição (como bases advindas da Chef Solutions), permitindo a adoção do ERP/PDV da ConnectPlug sem que o restaurante perca os canais de atendimento já estruturados na Goomer.

  • Padrão Open Delivery: Utiliza a arquitetura Open Delivery para recepcionar e gerenciar o fluxo das ordens no PDV.

⚠️ IMPORTANTE: Esta integração é exclusiva para o ERP 2.0 (a partir da versão 2.12.15 do PDV) e não possui suporte no sistema Legado.

 


📋 2. Pré-requisitos para Ativação

Antes de iniciar a configuração no sistema, certifique-se de que a loja cumpre as seguintes exigências:

  1. Plano Goomer Ativo: Conta do lojista configurada na plataforma Goomer.

  2. Módulo Open Delivery Habilitado: A funcionalidade Open Delivery deve estar liberada dentro da conta da Goomer.

  3. Versão do Sistema: ERP 2.0 ativo e aplicativo do PDV atualizado para a versão 2.12.15 ou superior.

 

⚙️ 3. Passo a Passo de Configuração
🟢 Etapa A — Obter credenciais na Plataforma Goomer
  1. Acesse o painel administrativo da Goomer com os acessos do cliente.

  2. No menu lateral, navegue até a seção Integrações.

  3. Selecione a categoria Logística e escolha a opção Open Delivery.

  4. Copie os códigos gerados: Client ID e Client Secret.

🔵 Etapa B — Parametrizar no ERP 2.0 (ConnectPlug)
  1. Acesse o ERP 2.0 CPlug com usuário administrador.

  2. Navegue em Configurações > Integrações > Goomer.

  3. Preencha os campos obrigatórios com as chaves obtidas na Goomer:

    • Client ID

    • Client Secret

  4. Clique em Salvar para estabelecer a conexão entre os sistemas.


📋 4. Vínculo do Cardápio (Processo Manual)

Devido a limitações técnicas da API da Goomer, não há suporte para a exportação automática de cardápio do ERP 2.0 para a Goomer.

🛠️ Como fazer a amarração do cardápio:
  1. O cardápio deve ser cadastrado manualmente na plataforma da Goomer.

  2. Copie os IDs/Chaves de Integração gerados no cadastro do ERP 2.0 da ConnectPlug.

  3. No painel da Goomer, insira a chave individualmente em cada:

    • Produto

    • Variação/Tamanho

    • Adicional/Opcional

💡 Dica de Suporte/Implementação: O campo para colar a chave de integração na Goomer fica em uma seção avançada do cadastro do produto. Oriente o cliente a preencher todos os adicionais para evitar divergências ou itens caindo sem código no PDV.


⚠️ 5. Limitações Técnicas e Regras de Negócio

Para alinhar expectativas com o cliente e evitar abertura de chamados indevidos, observe as restrições da API Goomer:

  • Fluxo de Pedidos e Aceite: A recepção de pedidos no PDV, o aceite de ordens e a troca de status funcionam normalmente via Open Delivery.

  • Cancelamento de Pedidos (ATENÇÃO!): A API da Goomer não possui endpoint para cancelamento automático de pedidos.

    • Impacto na Operação: Se um pedido for cancelado no PDV da ConnectPlug, ele NÃO será cancelado automaticamente na Goomer.

    • Ação Obrigatória do Operador: O usuário deve acessar o painel da Goomer e realizar o cancelamento manualmente também na Goomer para evitar inconsistência de relatório.

  • Exclusividade ERP 2.0: A funcionalidade não é compatível e não será disponibilizada para o ERP Legado.

 

❓ 6. Dúvidas Frequentes (FAQ)

1. A integração com a Goomer funciona na versão antiga (Legado) da ConnectPlug?

Não. A integração com a Goomer é exclusiva para o ERP 2.0 / PDV versão 2.12.15 em diante.

2. O cardápio do ERP 2.0 sobe automaticamente para a Goomer ao salvar?

Não. A API da Goomer não suporta exportação automática. O vínculo de códigos/chaves de integração em produtos, variações e complementos precisa ser inserido manualmente no painel da Goomer .

3. Cancelei um pedido no PDV CPlug, por que ele continua aberto na Goomer?

Trata-se de uma limitação técnica da própria API da Goomer, que não disponibiliza a função de cancelamento via integração. O operador de caixa precisa obrigatoriamente entrar no painel da Goomer e efetuar o cancelamento manual daquele pedido.

4. Onde encontro o Client ID e Client Secret?

Essas credenciais são obtidas diretamente dentro do painel da Goomer, no menu Integrações > Logística > Open Delivery .