INTEGRAÇÃO ACOM ERP

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

🍽️ 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:

Conta Ativa no CPlug ERP 2.0: A funcionalidade não é compatível com o ERP Legado .
Contrato e Serviço ACOM Ativo: O cliente deve contratar e possuir o módulo de integração ativo junto à ACOM Sistemas .
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

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

Acesse Configurações > Integrações Gerais > ACOM > Aba Logs .
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.
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)

Sintoma Relatado	Causa Raíz Mais Provável	Ação Corretiva no Sistema
Vendas do dia anterior não apareceram no ACOM ERP	Oscilação na API no momento do disparo automático D-1.	Acesse a aba da integração ACOM no ERP 2.0 e execute o Reenvio Manual do dia desejado .
Log apresenta mensagem "Credenciais Inválidas"	Prefixo, CNPJ ou Token digitados com incorreções.	Valide os dados cadastrados na ACOM e reescreva os campos sem espaços ou pontuação no ERP 2.0 .
XML da NFC-e não desceu em tempo real	Rejeição do cupom na SEFAZ ou falha de conexão na ponta.	Verifique primeiramente se a NFC-e foi emitida com sucesso no PDV CPlug; em seguida, filtre o Log por Sincronização de NFC-e .
Reenvio de venda apresenta erro no log	A venda selecionada já havia sido transmitida anteriormente.	O ACOM ERP bloqueia duplicidades. Vendas já enviadas não aceitam sobrescrita .

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