# INTEGRAÇÃO ACOM ERP # 🍽️ 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.

##### [🎙️ Podcast: Escute para aprender](https://drive.google.com/file/d/1-at9SQc-jXJqmfZ_7CJiCYtZGdumX_Ea/view?usp=sharing) ##### [📽️ Vídeo: Assista para entender](https://drive.google.com/file/d/1NSNuGW8kr5jOvdmbki3o_pFDqljwQWfI/view?usp=sharing) --- ##### **🎯 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"** . ![XWrPEiSu7OhCKM8t-image-1786535687912.png](https://manual.cplug.com.br/uploads/images/gallery/2026-08/scaled-1680-/XWrPEiSu7OhCKM8t-image-1786535687912.png) --- ##### **🧠 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*). ![3aTLUaDGbaznEoTu-image-1786535768674.png](https://manual.cplug.com.br/uploads/images/gallery/2026-08/scaled-1680-/3aTLUaDGbaznEoTu-image-1786535768674.png) --- ##### **🚨 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. **Atenção para correções e reenvios:** Caso seja necessário reenviar uma determinada venda que já existe no ACOM ERP (por motivo de correção ou ajuste), é necessária uma ação do usuário direto na ACOM: excluir o movimento já existente no ACOM ERP. Somente após essa exclusão será possível reenviar as vendas com sucesso.