Skip to main content

Integração OZmap | Guia de Uso

sgptsmx-petroleo.png


1. Introdução

O que é o OZmap?



OZmap é a solução completa para a gestão e documentação da sua rede de fibra óptica.

Através do OZmap, o provedor poderá documentar toda sua rede, visualizar os mapas georreferenciais, consultar e analisar toda sua rede e o que está sendo utilizado. E também realizar o vinculo de clientes nas portas de atendimento.

A integração com plataformas de mapeamento, tem como objetivo disponibilizar os equipamentos de atendimento projetados na plataforma para que o provedor possa vincular os clientes cadastrados no sistema à portas de atendimento.


2. Configurando as OLTs

Após integração do OZmap no SGP é preciso realizar o vínculo as OLTs para que a comunicação ocorra, esse vinculo permite que as CTOs, ONUs e Postes vinculados a OLT sejam sincronizados com o OZmap. Para isso basta acessar o menu: 

Administração
Cadastros
FTTx - OLT
  • Identifique a OLT que deseja vincular ao OZmap, vá em Opções e Editar

    olt-config-edit.png
  • Em Integração selecione o OZmap

    salvarimagemozmap.png
Esse procedimento deve ser realizado tanto nas OLTs já cadastradas no sistema quanto naquelas que serão importadas do OZmap. A execução correta desse processo é fundamental para garantir a sincronização entre as plataformas.

3. Sincronização

Para garantir a exibição correta dos elements no mapa, é essencial que as Coordenadas (Latitude e Longitude) estejam definidas nos seguintes cadastros:

  • Endereço de Instalação (Cliente): deve estar cadastrado corretamente para sincronização da ONU.

  • CTO: obrigatórias para visualização e integração no mapa.

O SGP dispõe de uma rotina responsável pela sincronização das informações, porém, sempre que houver alterações no OZmap — como atualização de coordenadas ou inclusão de novos clientes/postes — é indispensável realizar a sincronização manual no SGP.

Para sincronizar cliente/onu o SGP faz automaticamente em 2 situações: Caso seja inserido no contrato/serviço do cliente CTO e Porta logo após irá sincronizar o cliente. Assim como também há como sincronizar quando a onu é autorizada
usando o módulo de olt.


Endereço de Instalação:

end_isntalacao_lg.png
CTO:

cto_lg.png
3.1 Sincronização em Lote


Neste tópico será apresentado o processo de sincronização manual disponível no SGP, que pode ser realizado nas seguintes opções:

  • Sincronizar CTOs

  • Sincronizar Clientes

Esse processo pode ser realizado através do menu:

Sistema
Gateways
Gateway de Mapa
Sincronizar CTOs
ou
Sincronizar Clientes

sinc-clientecto.png

Ao clicar em Sincronizar CTOs o sistema irá realizar o processo de sincronização automaticamente para todas as CTOs vinculadas as OLT's do OZmap, caso deseje Sincronizar Clientes, será direcionado a tela de sincronização onde é possivel aplicar filtros, após aplicar os filtros e clicar em Consultar, basta selecionar o clientes e depois clicar em Sincronizar.


2025-08-16_11-03.png

3.1.1 Sincronizando CTO (Individual)

Caso não queira sincronizar todas as CTOs, mas apenas uma especifica, basta realizar a sincronização de CTO Avulsa, através do menu:

Administração
Cadastros
FTTx - CTO

Todas as CTOs que tiverem vinculo a uma OLT OZmap terão o botão de Sincronização conforme imagem abaixo:

salvarimagemozmap2.pngAo clicar no botão de sincronização, o processo será iniciado automaticamente, caso seja uma nova CTO, será criada no OZmap, caso seja uma CTO importada será atualizada.

3.1.2 Sincronizando Cliente/ONU (Individual)

Existem situações onde o processo de sincronização de apenas um cliente seja necessário, por exemplo, em caso de erros cadastrais, para isso, precisamos garantir que o cliente tenha as suas coordenadas no endereço de instalação:

end_isntalacao_lg.png

Após confirmar que os dados de Latitude/Longitude foram inseridos corretamente, podemos acessar o Serviço do cliente e na guia FTTx Detalhes podemos realizar a sincronização com o OZmap.

fttx_detalhes_sincronizar_ozmap.png


4. Importação de Dados

Caso já tenha uma rede criada no OZmap e que importar para o SGP, esse processo é possivel, basta acessar o menu:

Sistema
Gateways
Gateway de Mapa
Consultar/Cadastrar

Nesse menu, basta acessar o seu Gateway OZmap e ir nas opções de Importação.

4.1 Importando CTO


  • Para importar as CTOs, basta clicar em Importar CTOS

    ozmap3.png
  • Selecionar a(s) CTO(s) e clicar em Importar Selecionadas

    importar_CTO_ozmap.png
    Após importação as CTOs ficarão disponiveis para vincular as OLTs no SGP.
4.1.1 Como verificar as CTOs importadas

Após importar as CTOs para o SGP eles serão adicionadas no mesmo menu de cadastro das CTO:

Administração
Cadastros
FTTx - CTO

cadastro-cto-1.png
Filtrar CTO: Opção para realizar Filtros de Pesquisa de CTOs.
Buscar: Pesquisar CTO por nome de Identificação.

cadastro-cto-2.png
Utilize os filtros para localizar as CTOs importadas.

cadastro-cto-4.png
⚠️ Verifique se os dados de latitude, longitude da CTO estão corretos assim como a PON (OLT) estejam definidos.

🔗 Para realizar esta consulta, precisamos ir até as configurações da CTO:

Editar

editar-cto-1.png

🔗 PON, Latitude e Longitude (exemplo: -5.853057, -35.1918389) São Obrigatórios para esta integração.

cto_ozmap1.png
⚠️ É obrigatório o vínculo da CTO com uma OLT para garantir o funcionamento correto no mapa e no sistema.


5. Logs Gateways de Mapa

O sistema exibe armazena e exibe os logs das sincronizações com o OZmap, sendo possivel visualizar no menu: 

Sistema
Gateways
Gateway de Mapa
Logs Gateway Mapa


log-erros-2.pngNesses logs podemos verificar tanto o que foi sincronizado com sucesso, quanto as sincronizações que apresentaram erro, informando no response o que é necessário para correção.

6. Consulta de viabilidade

É possível realizar a consulta de viabilidade através do SGP integrado ao OZmap.

Clientes
Viabilidade
Consultar
Logs Gateway Mapa

viabilidade01.png⚠️ Para consulta de viabilidade, o OZmap realiza a consulta de Viabilidade, na consulta é levado em consideração os campos: raio - endereço - latitude e longitude. Qualquer informação inserida que não seja nestes campos será irrelevante, como distância, por exemplo.

tsmx-petroleo.png