Essa documentação trata da integração com o sistema ISP Gestión. A integração é realizada através de chamadas de API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.
Tipo de Integração
A integração OZmap-ISP Gestión é do tipo Passiva-direta, desenvolvida pela equipe ISP Gestión.
Descrição
O ISP Gestión é um sistema de Gestão (ERP) focado no controle de rede, servidor radius, controle financeiro e múltiplas opções para gerenciamento dos ISPs.
As funcionalidades desta integração entre OZmap e ISP Gestión ocorrem a partir da vinculação de uma rede criada no ISP Gestión com um projeto existente no OZmap. A integração tem como foco principal a criação, conexão e cancelamento de clientes no OZmap, garantindo que os dados sejam sincronizados entre os dois sistemas.
Resumo de funcionalidades
Funcionalidade | Descrição | Direção da integração |
---|---|---|
Criação de Clientes no OZmap | Criação de Clientes no OZmap, com base na ativação do equipamento no ISP Gestión. | ISP Gestión => OZmap |
Cancelamento de Clientes no OZmap | Remoção de clientes no OZmap, através do cancelamento ou desligamento do equipamento no ISP Gestión. | ISP Gestión => OZmap |
Atualização de Caixa, Splitter e Porta de Clientes no OZmap | Replica a informação de Caixa/Splitter/Porta do equipamente no ISP Gestión ao Cliente no OZmap. | ISP Gestión => OZmap |
Funcionalidades
Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
Criação de Clientes no OZmap
A criação de Clientes no OZmap a partir do ISP Gestión requer, inicialmente, que um equipamento esteja vinculado a um PON (que é referido como “nodo de red”) no ISP Gestión.
Para que a criação de um Cliente no OZmap seja possível, o PON no ISP Gestión deve estar vinculado a uma rede que, por sua vez, esteja associada a um projeto no OZmap. Esse vínculo entre a rede do ISP Gestión e o projeto OZmap pode ser realizado durante a criação da rede no ISP Gestión, onde é possível selecionar o projeto OZmap ao qual a rede será vinculada. Alternativamente, é possível editar uma rede já existente no ISP Gestión para vinculá-la a um projeto OZmap.
Após garantir que no ISP Gestión o PON esteja devidamente vinculado a uma rede que está associada a um projeto OZmap, o próximo passo é vincular esse PON a um equipamento. A seguir, o passo a passo para realizar essas ações:
Para realizar esse vínculo no ISP Gestión, abra o menu referente a conexão e na aba "Redes", dentro da seção "Dados generales", selecione a rede que foi vinculada ao projeto OZmap.
Após isso, ainda no ISP Gestión, deve ser realizado o vínculo do equipamento a essa nó de rede que foi vinculada a rede correspondente ao projeto OZmap. Para realizar esse vínculo, abra o menu do Cliente, acesse a aba “General” e na seção “Rede” selecione a conexão que foi vinculada a rede OZmap.
Após realizar esse vínculo no ISP Gestión entre um equipamento e um PON, o processo para criação do Cliente no OZmap ocorre da seguinte forma:
Obrigatoriamente deve ser preenchido no ISP Gestión as coordeandas de instalação do equipamento, no menu do equipamento na aba “Datos instalación", na seção “COORDENADAS DE INSTALACIÓN", para que ao realizar a criação do Cliente no OZmap o mesmo seja criado nas coordenadas registradas no ISP Gestión.
Após registrar as coordenadas do equipamento no ISP Gestión, será possível acessar a aba “OZmap” no seu menu, nesta aba será possível ativar o equipamente a partir do “Alta equipo”. Ao ativar o equipamente o Cliente será criado no OZmap e será possível visualizar seu ID na aba "OZmap” do ISP Gestión.
Com o Cliente OZmap já criado e o equipamento ativo no ISP Gestión, será possível realizar a criação de sua propriedade no OZmap, com isso, na mesma aba "OZmap” no menu do equipamento no ISP Gestión, a partir do botão “ALTA DE PROPRIEAD”. Ao ser criada a propriedade, também será possível visualizar seu ID nessa mesma aba.
Cancelamento de Clientes no OZmap
A remoção de Clientes e Propriedades no OZmap ocorre a partir das ações realizadas no ISP Gestión. Existem duas opções disponíveis, cada uma com impactos específicos:
Desativando a Propriedade no ISP Gestión
No menu do Cliente acessando a aba “OZmap” haverá a opção “BAJA DE PROPRIEDAD”, que caso acionado realizará a desconexão do equipamento no ISP Gestión, e com isso a Propriedade e o Cliente serão removidos no OZmap.
Desvinculando o equipmaneto da Proprieade no ISP Gestión
Utilizando a opção “Baja de equipo” no menu do Cliente, o equipamento será desvinculado da Propriedade no ISP Gestión. Essa ação resulta na remoção automática do Cliente correspondente no OZmap, mas a Proprieade permanecerá existindo no OZmap.
Conexão de Cliente no OZmap
Quando um equipamento no ISP Gestión está vinculado a um Cliente e a uma Propriedade no OZmap, é possível associar uma Caixa e uma Porta a esse equipamento diretamente no ISP Gestión. Durante a edição das informações de CTO, o sistema exibirá, pelo nome, todas as Caixas disponíveis no OZmap. Ao selecionar uma dessas Caixas, serão listados os Splitters correspondentes e as Portas disponíveis, permitindo a escolha da conexão desejada.
Após a seleção, as informações configuradas no ISP Gestión serão automaticamente sincronizadas com o OZmap, conectando a Propriedade vinculada à Caixa, ao Splitter e à Porta especificados.
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo integrador são:
Saiba mais como configurar esses dados acionando o suporte do ISP Gestión.
OZmap
Parâmetro | Descrição | Exemplo |
---|---|---|
API URL | Endereço da API OZmap | |
Token | Token associado a conta do usuário de integração cadastrado no OZmap. (O usuário deve ter acesso aos projetos que a integração irá trabalhar (Escolha do usuário). Tutorial de como gerar usuário/chave.) | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE |
Liberação de IPs
Caso o servidor OZmap esteja em ambiente ON-Premisses, é necessário liberar nos firewalls o IP do servidor onde está o ISP Gestión para acessar as portas 80 e 9994 no ambiente do OZmap.
Caso seu servidor seja hospedado pelo OZmap, essas portas já estarão liberadas para o integrador.
Questionário
Pergunta | Resposta | Funcionalidade |
---|---|---|
Add Comment