OZneutral

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

• Integração Customizada

Funcionalidades

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

Integração Padrão

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 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 viabilidade 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, 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), ou caso o cliente opte por realizar a viabilidade apenas em caixas específicas pode ser passado uma configuração para o OZloc ou por parâmetro de URL “?viabilityTags=[]“ indicando as caixas desejadas.

• 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, um 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.

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.

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 do 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, 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

Questionário