...
Essa documentação trata da integração com o OZneutral. A integração é realizada através de chamadas API partindo do Integrador e utilizando a API disponibilizada no serviço de integração pelo OZmap.
Table of Contents | ||||
---|---|---|---|---|
|
Tipo de Integração
A integração OZmap-OZneutral é do tipo Passiva-indireta.
Descrição
O OZneutral é uma plataforma responsável por gerenciar a parceria de rede neutras entre clientes e provedores e facilitar a manutenção, cobrança e suporte para parceiro e operadora.
A integração com o OZmap pode ser dividida em duas, uma sendo a integração padrão e outra sendo a customizada de acordo com os pedidos do se baseia no OZneutral realizando principalmente viabilidade, reserva de portas, ativação e cancelamento de clientes no OZmap.
No OZneutral, o principal elemento é uma ordem, essa ordem determina o uso de uma porta e indica se a porta está atualmente em uso por algum cliente.
Resumo de funcionalidades
Integração Padrão
Funcionalidade | Descrição | Direção da integração | Sincronização de clientes OZneutral | Criação e cancelamento de clientes no OZmap, com base nos dados de clientes OZneutral. | OZneutral => OZmap|
---|---|---|---|---|---|
Consulta de Viabilidade e Reserva de Portas no OZmap | Buscar viabilidade técnica no OZloc para um endereço de ordem OZneutral e reservar uma porta no OZmap para sua instalação. | OZneutral => OZmap | |||
Registrar Clientes cancelados no OZmap | Destaca com uma tag clientes no OZmap que tiveram suas ordens canceladas no OZneutral. | OZneutral => OZmap | |||
Informação de Caixas e conexões no OZneutral | Busca dados de caixa, splitter e porta do cliente no OZmap para exibir na lista de ordens do OZneutral. | OZmap => OZneutral |
Integração Customizada
Funcionalidade | Descrição | Direção da integração |
---|---|---|
Sincronização Cancelamento de clientes OZneutralAtualização e exclusão de Clientes OZmap | Remove clientes no OZmap , com base nos dados de ordens canceladas no OZneutral. | OZneutral => OZmap |
Implantação de Clientes OZmap | Atualiza o status de implantação do cliente no OZmap com base na ativação de ordens no OZneutral. | OZneutral => OZmap |
Atualização de dados de clientesOrdem no OZneutral | Atualiza os clientes as ordens no OZneutral caso haja alguma alteração no cliente com base nos dados do cliente no OZmap. | OZmap => OZneutral |
Funcionalidades
Abaixo serão descritas as funcionalidades das duas integraçõesapresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
Integração Padrão
Sincronização de clientes
A sincronização de clientes OZneutral se baseia na criação e cancelamento de clientes no Consulta de viabilidade e reserva de portas no OZmap
A integração realiza a viabilidade e reserva de portas de clientes OZmap com base nos dados do lead e de clientes ordem no OZneutral, ocorrendo da seguinte forma:
Primeiramente é checada a viabilidade do cliente no OZmap, através da criação de um lead no OZneutral que é criado a partir das informações de endereço do cliente.
O processo de criação de clientes ocorre da seguinte forma:
É cadastrado um lead no OZneutral e apartir desse lead é possível criar uma ordem, que ao ser criada é criado um cliente no prórpio OZneutral. Após a criação desse cliente os dados são passados paraviabilidade e reserva de porta é realizado pelo OZloc, que exibe inicialmente o cliente no mapa na posição encontrada através da tradução do endereço textual em coordenadas passadas pelo OZneutral. A posição do Cliente no mapa não pode ser alterada.
Caso haja a viabilidade, por padrão será automaticamente apresentada a caixa de atendimento mais próxima com portas disponíveis (seguindo as opções de viabilidade configuradas para o OZloc no OZmap).
O cliente ainda pode optar por configuração do OZneutral para que a viabilidade considere apenas caixas com tags específicas no OZmap.
Após a confirmação no OZloc, é criado a ordem no OZneutral e na interface do OZneutral é exibido um croqui com os dados do parceiro. A ordem criada é para determinar se uma porta está em uso ou não por um cliente.
Com a criação da ordem no OZneutral, o seus dados são passados para a integração criar um cliente no OZmap que terá como nome o nome da parceira,
oum código que por padrão será o código da ordem (o cliente pode solicitar que seja utilizado outro atributo como código no OZmap) e também receberá as informações de endereço e observações caso hajo alguma, e também é definido um ID de integração no cliente para que depois possa ser vinculado com a ordem no OZneutral.
Em caso de cancelamento da ordem pela operadora no OZneutral,
Registrar Clientes Cancelados no OZmap
O processo de registrar clientes cancelados no OZmap ocorre da seguinte forma:
Primeiramente a ordem é cancelada no OZneutral, que por padrão ocorre por determinação da operadora, mas pode ser parametrizado também que ocorra por determinação da parceira.
Com isso quando a ordem é cancelada no OZneutral é buscado um cliente no OZmap com o id de integração correspondente, e é adicionado uma Tag [cancelado ozn] ao cliente no OZmap.
Informação de Caixas e Conexões
São repassadas as informações de caixas e conexões das ordens registradas no OZneutral a partir dos dados do cliente no OZmap.
Essas informações são buscadas no cliente OZmap a partir do id de integração que vincula a ordem no OZneutral ao cliente no OZmap.
Ao serem retornadas, essas informações podem ser visualizadas na lista de ordens do OZneutral, na qual cada ordem terá as informações de sua respectiva caixa, como nome, nome do splitter e número da porta. Além disso, ainda na interface do OZneutral na parte de detalhes da ordem, poderá ser visualizada a caixa com suas coordenadas e o comprimento de drop.
Integração Customizada
Essa integração é customizada de acordo com as regras de negócios estabelecidas pelo cliente. O cliente pode pedir a customização de certas funcionalidades entrando em contato com o suporte do OZneutral.
Sincronização de clientes
A sincronização de clientes se baseia nos dados dos clientes OZneutral para realizar a atualização ou exclusão dos mesmo no OZmap.
...
Atualização de cliente
Pode ocorrer quando há um provisionamento da ordem no OZneutral e a partir disso o cliente é atualizado no OZmap. Caso a ordem for provisionada o cliente tem seu status atualizado para implantado no OZmap. Já caso a ordem seja desprovisionada o cliente tem seu status atualizado para não implantado.
Exclusão de clientes
...
Cancelamento de Clientes no OZmap
O processo de cancelamento de clientes OZmap segue o seguinte fluxo:
Primeiramente deve ser cancelada uma ordem no OZneutral.
Após esse cancelamento, por padrão a integração busca um cliente com o id de integração correspondente no OZmap e remove o cliente e o imóvel
nodo OZmap. Porém o cliente pode optar por algumas configurações diferentes de acordo com as regras de negócio desejadas, essas podendo ser:
Manter ou remover drop.
Remover o imóvel caso o cliente não esteja implantado
Caso, e caso o cliente esteja implantado, remover apenas o cliente e manter o imóvel.
Implantação de Clientes OZmap
A integração realiza a implantação do cliente no OZmap de acordo com o provisionamento da ordem OZneutral, podendo acontecer da seguinte forma:
Caso a ordem seja provisionada, o cliente com o id de integração correspondente a ordem OZneutral tem seu status atualizado para implantado no OZmap.
Caso a ordem seja desprovisionada, o cliente com o id de integração correspondente a ordem OZneutral tem seu status atualizado para não implantado no OZmap.
Atualização de dados de Ordem no OZneutral
O cliente também pode optar que os dados dos clientes OZneutral sejam atualizados sempre que haja alguma alteração no OZmap. Esse processo ocorre da seguinte forma:
A integração busca no OZmap a cada 5 minutos clientes OZneutral que tem código de integração correspondente a ordem no OZneutral.
Ao encontrar esses clientes, são filtrados os clientes OZmap que tiveram alteração de coordenadas, caixa/splitter/porta, se foi implantado, removida, entre outros.
Os clientes que tiveram alterações no OZmap são atualizados no OZneutral com as informações mais recentes.
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo integrador são:
Saiba mais sobre como configurar esses dados acionando o suporte do OZneutral.
OZmap
Parâmetro | Descrição | Exemplo |
---|---|---|
URL API | Endereço do OZmap, com a porta de serviço padrão. | |
Chave API | 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 |
Questionário
Pergunta | Resposta |
---|---|