Scord (PE) - pt
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 | |
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 |
---|---|---|
|
|
|