Integração com ERPs
O RC ACS possui uma API REST completa que permite a integração com os principais ERPs do mercado de ISPs. Com a integração, o ERP pode automatizar tarefas de gestão de CPEs — como provisionamento de novos clientes, alteração de configurações e diagnóstico remoto — sem que o operador precise alternar entre sistemas.
Em vez de abrir dois sistemas (ERP e ACS) para cada atendimento, o atendente realiza tudo pelo ERP. O ERP envia comandos via API para o ACS, que executa no CPE e retorna o resultado. O ACS é o motor — o ERP é o volante.
Modelo de integração
A integração segue o modelo de API REST sobre HTTPS. O fluxo é:
ERPs homologados
A lista definitiva de ERPs homologados será fornecida pelo time de produto. A tabela abaixo apresenta a situação preliminar:
| ERP | Status | Observações |
|---|---|---|
| Hubsoft | A confirmar | Em avaliação. API compatível com endpoints REST padrão. |
| SGP | A confirmar | Em avaliação. Time de integração em contato. |
| MK Solution | A confirmar | Em avaliação. Documentação de integração em elaboração. |
Informação: Se o seu ERP não está listado, entre em contato via WhatsApp. A RC Consultoria trabalha com o time de desenvolvimento do ERP para viabilizar a integração. O prazo típico para homologação de um novo ERP é de 2 a 4 semanas.
Passo a passo para integração
- Criar usuário de API: no painel do RC ACS, acesse Administração → Usuários → Chaves de API e crie uma chave para o ERP. Atribua permissões mínimas necessárias (ex: apenas leitura de status + escrita de configuração).
- Obter endpoint: a URL base da API é o domínio do seu ACS seguido de
/api/v1/. Exemplo:https://acs.seuisp.com.br/api/v1/. A documentação completa e interativa (Swagger) está disponível em/api-docsna sua instância. - Configurar permissões: verifique se a chave de API tem acesso aos endpoints necessários. Recomendamos criar chaves separadas para ambientes de teste e produção.
- Testar conexão: utilize ferramentas como cURL ou Postman para validar a autenticação e os principais endpoints antes de implementar no ERP. Comece com uma requisição simples:
GET /api/v1/cpesdeve retornar a lista de CPEs gerenciados. - Implementar no ERP: com a conexão validada, o time de desenvolvimento do ERP implementa as chamadas de API no fluxo de atendimento. Exemplo: "ao cadastrar um novo assinante no ERP, chamar
POST /api/v1/cpesno ACS automaticamente."
Comandos via API
Com a integração ativa, o ERP pode executar estas ações no ACS (e, por consequência, nos CPEs):
- Ativar CPE: provisionar um novo CPE com configuração inicial (SSID, senha, VLAN, PPPoE) em segundos, diretamente do fluxo de cadastro do assinante.
- Alterar configuração Wi-Fi: modificar SSID, senha, canal, banda (2.4 GHz / 5 GHz) remotamente.
- Reboot: reiniciar o CPE remotamente — útil para "primeira tentativa" de resolução quando o cliente reporta lentidão.
- Consultar status: verificar se o CPE está online, qual firmware, potência de sinal, temperatura PON e outras métricas.
- Atualizar firmware: agendar atualização de firmware em um CPE específico ou em lote.
- Teste de velocidade: executar speed test a partir do CPE e obter o resultado diretamente no ERP.
- Consultar log de auditoria: verificar histórico de alterações de um CPE diretamente no ERP.
Casos de uso
Ao cadastrar um novo cliente no ERP, o CPE é automaticamente configurado no ACS
O atendente cadastra o novo assinante no ERP (nome, endereço, plano). O ERP envia POST /api/v1/cpes com o serial do CPE e o identificador do preset desejado. O ACS provisiona o CPE automaticamente — o cliente sai da loja com o Wi-Fi funcionando, sem intervenção manual do técnico.
Ao atender um chamado de "internet lenta", o atendente faz reboot pelo ERP
O cliente liga reclamando de lentidão. O atendente, pelo ERP, consulta o status do CPE (GET /api/v1/cpes/123) e envia um reboot (POST /api/v1/cpes/123/reboot) — tudo em menos de 30 segundos, sem abrir o ACS. Se o reboot resolver, o chamado é fechado ali mesmo.
Migração de plano: alterar configuração automaticamente
O cliente faz upgrade de plano (ex: de 100 Mbps para 300 Mbps). O ERP altera a velocidade no contrato e, via API, envia a nova configuração de velocidade para o ACS. O ACS aplica no CPE imediatamente — sem visita técnica, sem chamado, sem atraso.
Boas práticas de segurança
Dica de segurança: Ao configurar a integração com o ERP, siga estas recomendações:
- Princípio do menor privilégio: crie um usuário de API com permissões estritamente necessárias. Se o ERP só precisa ler status e fazer reboot, não dê permissão de alterar firmware ou excluir CPEs.
- IP allowlist: restrinja o acesso à API por IP de origem. Apenas o IP do servidor do ERP deve ter acesso à chave de API de produção.
- Log de auditoria: toda ação via API é registrada no log de auditoria do RC ACS. Monitore regularmente as ações originadas do ERP para detectar uso indevido.
- Chaves separadas: use chaves de API diferentes para ambiente de teste/homologação e produção. Nunca reuse a mesma chave.
- Revogação rápida: em caso de comprometimento de uma chave, revogue-a imediatamente pelo painel do ACS e emita uma nova.
Perguntas frequentes
Meu ERP não tem integração pronta com RC ACS. Como proceder?
Entre em contato via WhatsApp. Nossa equipe entra em contato com o time de desenvolvimento do seu ERP e fornece toda a documentação técnica necessária para implementar a integração. Se o ERP tiver uma API aberta do lado deles, o processo é ainda mais rápido.
Posso usar a API sem um ERP (scripts próprios)?
Sim. A API REST do RC ACS pode ser consumida por qualquer sistema que faça requisições HTTP. Se você tem scripts internos, automações ou sistemas próprios, basta usar a chave de API conforme documentado na referência de API.