Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 2 Next »

logo.png

Essa documentação trata da integração com o sistema Scord. 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-Scord é do tipo Passiva-direta, desenvolvida pela equipe Scord.

Descrição

O Scord é um sistema desenvolvido para atender as necessidades das empresas de telecomunicações, oferecendo ferramentas que otimizam os processos, tornando-os mais seguros e confiáveis.

As funcionalidades desta integração entre OZmap e Scord tem como foco principal a realização de consulta de viabilidade com reserva de porta, implantação, adição de tags e alteração de portas do Cliente no OZmap. Além disso também realiza a sincronização de Caixas e Postes no Scord de acordo com os dados no OZmap.

Resumo de funcionalidades

Funcionalidade

Descrição

Direção da integração

Viabilidade com Reserva de Porta no OZmap

Verifica a viabilidade técnica no OZmap para um endereço e reserva uma porta para instalação.

Scord => OZmap

Implantação de Clientes no OZmap

Implanta Clientes no OZmap a partir do estado de ativação no Scord.

Scord => OZmap

Adição de tags ao Cliente OZmap

Adiciona uma tag no Cliente OZmap de acordo com seu estado financeiro no Scord (ativo ou inadimplente).

Scord => OZmap

Atualização de porta do Cliente

Replica a informação de Caixa/Porta do Cliente ao OZmap, quando atualizado no Scord.

Scord => OZmap

Sincronização de Caixas e Postes no Scord

Sincroniza as informações de Caixas e Postes do OZmap para o Scord.

OZmap => Scord

Funcionalidades

Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.

Viabilidade com reserva de porta no OZmap

A consulta de viabilidade técnica no Scord verifica se é possível atender um novo cliente em uma determinada localidade, considerando um raio predefinido. Caso a viabilidade seja confirmada, uma porta será reservada no OZmap para instalação. Essa viabilidade ocorre da seguinte forma:

  • O Scord busca as caixas e portas disponíveis no OZmap dentro do raio estabelecido.

  • Após a seleção, é criado no OZmap um cliente em estado de reserva, ocupando a porta determinada, com as informações de coordenadas, nome e código do cliente.

  • O cliente criado no OZmap terá o código correspondente ao cliente no Scord, permitindo a vinculação e identificação nas futuras sincronizações.

Implantação de Clientes no OZmap

A implantação de clientes ocorre quando um cliente em estado de reserva no OZmap é ativado no Scord.

  • Ao ativar o cliente no Scord, a integração identifica o cliente correspondente no OZmap por meio do código gerado na reserva.

  • O estado do cliente no OZmap é atualizado para implantado, refletindo sua ativação no Scord.

Adição de Tags ao Cliente no OZmap

A integração adiciona tags no cliente do OZmap para homologar o estado do cliente no Scord, como, por exemplo, "ativo" ou "inadimplente".

  • Sempre que houver uma alteração de estado no Scord, a integração atualizará a tag do cliente no OZmap, permitindo o acompanhamento do status diretamente no OZmap. Caso o cliente esteja ativo no Scord terá a tag “Activo” no OZmap e caso o cliente esteja inadimplente no Scord o mesmo possuirá a tag “Moroso” no OZmap.

Atualização de porta do Cliente

No Scord, clientes podem ser migrados de um ponto a outro utilizando ordens de migração. Quando isso ocorre, as informações de caixa, porta e coordenadas do cliente são atualizadas no OZmap. Essa atualização ocorre da seguinte forma:

  • Durante a migração no Scord, o sistema exibe caixas disponíveis dentro do raio configurado, com base nos dados do OZmap.

  • O usuário seleciona a nova porta para o cliente no Scord.

  • Após a conclusão da migração, a integração replica as informações no OZmap, atualizando as coordenadas e a porta do cliente.

Sincronização de Caixas e Postes no Scord

Para garantir que os dados de infraestrutura estejam sempre atualizados, a integração sincroniza as informações de Caixas e Postes do OZmap para o Scord.

  • Periodicamente, a integração consulta as informações a respeito desses elementos no OZmap.

  • Essas informações são atualizadas no Scord, garantindo consistência nos dois sistemas.

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 Scord.

OZmap

Parâmetro

Descrição

Exemplo

API URL

Endereço da API OZmap

https://cliente.ozmap.com.br:9994/api/v2

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 Scord 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

  • No labels