🍽️ GUIA COMPLETO: INTEGRAÇÃO CONNECTPLUG X ACOM ERP (ERP 2.0)

NOTA INTERNA (PARA O TIME CONNECTPLUG): Este documento é um manual de referência técnica e operacional para os times de Comercial, Implantação e Suporte.

Público-Alvo e Contexto Estratégico: A integração com a ACOM Sistemas foi desenvolvida para atender à base de clientes migrados da Chef Solutions. O cliente mantém o seu software de retaguarda histórico (ACOM ERP) para gestão financeira e de estoque, enquanto passa a utilizar o PDV da ConnectPlug na frente de caixa.

REQUISITO FUNDAMENTAL: Esta integração está disponível EXCLUSIVAMENTE no ERP 2.0 . Não há suporte para o ERP Legado.

🎯 1. Visão Geral e Contexto (O que é a ACOM e por que integrar?)

🏢 O que é a ACOM Sistemas?

A ACOM Sistemas é uma empresa especializada em softwares de gestão (ERP) de retaguarda — como o Everest Food Service —, atuando há mais de 20 anos no mercado de alimentação fora do lar (restaurantes, bares, casas noturnas e baladas).

                     A ARQUITETURA DA OPERAÇÃO MIGRAÇÃO
                                     │
      ┌──────────────────────────────┴──────────────────────────────┐
      ▼                                                             ▼
🖥️ FRENTE DE CAIXA (ConnectPlug)                         📊 RETAGUARDA & GESTÃO (ACOM ERP)
• PDV V2 (Mesa, Comanda e Balcão)            • Gestão Central de Estoque
• Emissão de NFC-e na Ponta                  • Contas a Pagar / Receber e DRE
• Operação de Venda e Delivery               • Histórico de +20 Anos do Cliente
      │                                                             │
      └──────────────────────────────┬──────────────────────────────┘
                                     ▼
                      🔗 INTEGRAÇÃO DIRETA (D-1 & Real-Time)
                     • Envio Diário Automático de Vendas (D-1)
                     • Transmissão Instantânea dos XMLs de NFC-e

💡 Por que utilizar a Integração?

Muitos estabelecimentos vindos da Chef Solutions utilizam o ACOM ERP há mais de duas décadas. Para esses clientes, migrar o PDV para a ConnectPlug sem perder o ERP de retaguarda original é uma condição inegociável.

Com essa integração, a ConnectPlug assume o papel de frente de caixa de alta performance, enquanto a ACOM continua gerenciando o estoque master e o financeiro do estabelecimento.

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

Antes de iniciar a configuração no painel da ConnectPlug, valide os seguintes requisitos:

1. Conta Ativa no CPlug ERP 2.0: A funcionalidade não é compatível com o ERP Legado .

2. Contrato e Serviço ACOM Ativo: O cliente deve contratar e possuir o módulo de integração ativo junto à ACOM Sistemas .

3. Credenciais de Integração (Fornecidas pela ACOM):

   • CNPJ / Entidade: CNPJ cadastrado do estabelecimento.

   • Prefixo (Nome da Loja): Identificador único da loja na API da ACOM.

   • URL Base de Produção: Endereço da API de produção fornecido pela ACOM.

   • Token / Credenciais de API: Chaves de autenticação.

⚙️ 3. Passo a Passo de Configuração no ERP 2.0

Para clientes em processo de migração, a configuração é realizada uma única vez no ambiente web do ERP 2.0 .

🛠️ Configurando os Parâmetros da ACOM

1. Acesse o menu lateral do ERP 2.0: Configurações > Integrações Gerais .

2. Localize e clique no card "ACOM".

3. Preencha os campos obrigatórios na aba de autenticação :

   • CNPJ / Entidade: Insira o CNPJ sem pontuação.

   • Prefixo: Digite o nome/código da loja atribuído pela ACOM.

   • URL Base: Cole o link oficial do endpoint da ACOM.

   • Credenciais de API: Informe a chave de autenticação.

4. Verifique os parâmetros de sincronização automática e clique em "Salvar" .

[PRINT 1: ERP 2.0 > Configurações > Integrações Gerais > Tela de Parâmetros e Credenciais da ACOM]

🧠 4. Regras de Negócio e Fluxo de Dados

A transmissão dos dados do PDV ConnectPlug para o ERP da ACOM segue duas dinâmicas distintas:

📊 A. Sincronização de Vendas Diárias (Modelo D-1)

• Como Funciona: O fechamento consolidation das vendas de mesas, comandas e balcão ocorridas no dia atual é enviado automaticamente no dia seguinte (D-1) para o ACOM ERP .

• Estrutura dos Dados (Payload): O envio consolida cabeçalho de vendas, horário de fechamento, itens vendidos, adicionais/opcionais, garçom/atendente, forma de pagamento e ID único da venda .

• Reenvio Manual: Caso ocorra alguma oscilação de internet no dia anterior, a interface permite disparar o reenvio manual de um período .

🧾 B. Transmissão de Cupons Fiscais (NFC-e XML — Tempo Real)

• Como Funciona: Diferente do consolidado de vendas diárias, o arquivo XML da NFC-e emitida no PDV é transmitido em TEMPO REAL logo após a autorização da nota na SEFAZ .

• Garantia Fiscal: O ACOM ERP recebe o documento fiscal instantaneamente, garantindo a escrituração fiscal da ponta .

🛵 C. Operações de Delivery vs. Vendas de Balcão/Mesa

• Os pedidos originados no módulo de Delivery da ConnectPlug seguem exatamente o mesmo padrão de transmissão das vendas presenciais .

• Diferenciação de Taxas: Nas vendas presenciais, o valor adicional é transmitido sob a natureza de Gorjeta/Serviço; nas vendas de Delivery, a taxa é convertida e enviada como Taxa de Entrega .

📊 5. Monitoramento e Leitura de Logs (Troubleshooting)

A aba de Logs integrada ao menu do ERP 2.0 é a ferramenta primária do suporte técnico para identificar falhas de comunicação ou credenciais incorretas .

🔍 Como Auditar as Transmissões:

1. Acesse Configurações > Integrações Gerais > ACOM > Aba Logs .

2. Utilize os filtros de pesquisa para isolar os eventos:

   • Sincronização de NFC-e: Exibe o histórico do envio em tempo real dos XMLs.

   • Vendas Diárias (D-1): Exibe o status da carga diária das vendas consolidadas.

3. Em caso de erro, inspecione a mensagem de retorno informada no payload (ex: CNPJ inválido, URL inatingível, Token desatualizado).

[PRINT 2: ERP 2.0 > Integrações Gerais > ACOM > Tela da Aba Logs destacando os filtros e eventos de erro/sucesso]

🚨 6. Matriz de Troubleshooting (Resolução Rápida de Erros)

❓ 7. Dúvidas Frequentes (FAQ)

1. Posso ativar essa integração no ERP Legado da ConnectPlug?

Não. A integração ACOM foi construída e homologada exclusivamente para a arquitetura do ERP 2.0 .

2. O cliente precisa fazer alguma ação manual na ACOM para receber as vendas do CPlug PDV?

Não. Uma vez preenchidas as credenciais no ERP 2.0 da ConnectPlug, a transmissão do consolidado D-1 e dos XMLs em tempo real roda de forma 100% automatizada nos bastidores .

3. A ConnectPlug baixará o estoque local do CPlug ERP nessa operação?

Os dados de venda trafegam pelo ERP 2.0 da ConnectPlug para fins de registro no PDV, mas a gestão estratégica de estoque e o DRE financeiro do cliente serão alimentados diretamente dentro do ACOM ERP .

4. O que acontece se o cliente tentar reenviar um dia de vendas que já foi processado?

A API da ACOM possui uma trava contra duplicação de dados . Se a venda já tiver sido processada anteriormente no banco de dados da ACOM, a tentativa de reenvio retornará uma mensagem informando que o registro já existe, preservando o financeiro do cliente .