Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

...

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

...

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

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

    o

    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.

    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

    no

    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

      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 clientesOrdem no OZneutral

O cliente também pode optar que os dados dos clientes do OZneutral sejam atualizados sempre que haja uma alguma alteração no OZmap. Com isso a 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.

...