O NuvoACS não substitui o ERP do provedor: entra ao lado dele. A integração é do plano Plus e configurada em Configuração › ERP e equipe técnica, com o token de API do ERP.
Regra de ouro
Do ERP o NuvoACS lê. As únicas escritas são OS — e sempre com prévia e aprovação humana (ou modo automático escolhido pelo provedor numa automação). Cobrança, cadastro e nota fiscal nunca são tocados.
O que a integração entrega
| Função | Para quê |
|---|---|
| Clientes e contratos | vincular cada equipamento ao assinante — pelo login PPPoE e, quando o equipamento não tem PPPoE, pelo serial GPON |
| Bairro, região, coordenadas | Mapa da operação, grupos, técnico por região |
| Telefone do contrato | Avisos a assinantes afetados, troca de Wi-Fi do titular pelo Atendente de IA, código de acesso do app |
| Sessões por concentrador | gatilho Concentrador caiu / voltou — veja Modelo — concentrador caiu, faltou energia? |
| Técnicos e carga de OS | escolher o técnico certo — veja OS para aprovar |
| Status do contrato (ativo, reduzido, bloqueado, cancelado) | abrir casos de Logística reversa (recolhimento) e pesar no Risco de cancelamento |
| Faturas em aberto (só leitura) | o Atendente de IA manda 2ª via/PIX só ao titular |
| Abrir OS | automações e aprovação |
| Encerrar OS | App do técnico |
De onde vem cada dado (SGP e IXC)
- SGP: o login PPPoE de cada contrato vem da lista de ONUs do SGP (no FTTH) e, para o que não é fibra, de uma consulta por login ou serial, feita aos poucos. O telefone vem do contrato. A lista de contratos do SGP não traz o login, por isso o NuvoACS não depende dela para vincular.
- IXC: o status do contrato vem do contrato (status e status de internet), não do login — é assim que o cancelamento e o bloqueio aparecem.
- O NuvoACS não guarda telefone, CPF, senhas nem dados de fatura: telefone e fatura são lidos na hora em que são usados.
- Para OS no IXC, informe em Configuração › ERP e equipe técnica o setor e a filial padrão (o IXC exige os dois).
O que pedir ao provedor para ligar
- SGP: endereço, um app próprio (ex.:
nuvoacs) com token, com acesso às rotas de URA, OS, FTTH e RADIUS. - IXC: endereço e token de um usuário dedicado com acesso ao webservice; se o IXC tiver "Redes permitidas", liberar o IP do NuvoACS; setor e filial padrão das OS.
Status por ERP
| ERP | Leitura | Abrir OS | Encerrar OS |
|---|---|---|---|
| SGP | implementado com os campos medidos em SGPs reais, a homologar no 1º provedor | implementado, não homologado | implementado, não homologado |
| IXC | implementado com os campos medidos em IXC real, a homologar no 1º provedor | implementado, não homologado | implementado, não homologado |
| Hubsoft | em homologação | em homologação | — |
| MK-Auth | em homologação | em homologação | — |
"Não homologado" quer dizer que o código existe e foi testado em simulação, mas ainda não rodou contra o ERP real de um cliente. Até a primeira OS real conferida no sistema do provedor, a tela avisa. Códigos que variam por instalação (por exemplo, o status de "encerrada") são configuráveis.
Sem ERP
Tudo o que depende só do ACS funciona: inventário, ações, firmware, copiloto, apps (o assinante entra com PPPoE + serial), estoque e logística reversa com casos abertos à mão.