O OLT Cloud é um sistema de provisionamento e monitoramento focado no gerenciamento de PONs, CTOs, OLTs e ONUs de maneira isolada ou compartilhada.


A integração é responsável por sincronizar as caixas entre os sistemas, gerenciar a criação e o cancelamento de clientes no OZmap com base nos dados do OLT Cloud e realizar a atualização de portas dos clientes. 


A frequência da sincronização é definida pela equipe do OLT Cloud e varia conforme o número de caixas que você possui no OZmap: pode ser a cada 1 hora para poucas caixas ou duas vezes ao dia (às 5h e às 17h) para bases maiores.


  • Sincronização de caixas - É possível configurar quais tipos de caixas do OZmap serão sincronizadas e de quais projetos elas serão extraídas. As caixas são vinculadas ao OLT Cloud por meio de seus respectivos IDs no OZmap, informação armazenada em um campo específico da tabela de CTOs no OLT Cloud chamado “ex_id”.

As caixas sincronizadas incluirão dados como quantidade de portas, nome, status de implementação e coordenadas. Durante cada sincronização, a integração criará ou excluirá caixas no OLT com base nas informações do OZmap, além de atualizar os dados de nome, coordenadas e quantidade de portas.


  • Criação de clientes - A criação de clientes no OZmap ocorre ao vincular um cliente a uma caixa no OLT Cloud. A integração verifica se o cliente já existe no OZmap, seguindo este fluxo:


  1. Busca aos imóveis vinculados à caixa no OZmap.

  2. Verifica clientes com o mesmo ID de contrato.

  3. Caso não encontre, busca pelo campo "user_PPPoE" e, depois, pelo Serial Number da ONU.

  4. Se o cliente não for identificado, ele é criado no OZmap, vinculado à caixa e à porta, com status "implantado". Os dados da ONU são registrados com uma observação indicando criação via OLT Cloud.


  • Atualização de Porta de Clientes - Por padrão, a atualização das portas dos clientes no OLT Cloud é realizada com base nos dados do OZmap. Caso a porta de um cliente seja alterada no OZmap, essa informação será automaticamente replicada no OLT Cloud. 

Caso a configuração "Gravar dados no OZmap" estiver ativa no OLT Cloud, a atualização passa a ser bilateral. Nesse caso, alterações de porta realizadas no OLT Cloud também serão replicadas no OZmap, garantindo que as informações estejam sincronizadas em ambos os sistemas.


  • Cancelamento de Clientes - O cancelamento de clientes ocorre quando o cliente é desvinculado de uma caixa no OLT Cloud. Nesse caso, a integração identifica o cliente no OZmap e após localizá-lo, ele é desconectado da caixa no OZmap, mantendo o imóve no sistema. Vale destacar que, mesmo após o cancelamento no OZmap, o cliente continuará existindo no OLT Cloud.




Dados necessários


Por se tratar de uma integração passiva da parte do OZmap, é necessário informar ao OLT Cloud as seguintes informações:


  • API URL - É a URL do seu OZmap junto com o segmento “:9994/api/v2” .                

 Exemplo: https://exemplo.ozmap.com.br:9994/api/v2


  • Token - É necessário gerar uma chave de API do OZmap. Você pode aprender a realizar esse processo clicando aqui


Além disso, caso o servidor do seu OZmap esteja em ambiente on-premises, é necessário liberar no firewall o IP do servidor onde está o OLT Cloud 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.