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.
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 Ordem de uso de uma porta que determina se a porta está em uso por algum cliente.
Resumo de funcionalidades
Integração Padrão
Funcionalidade | Descrição | Direção da integração |
---|---|---|
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 | Desta 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 |
---|---|---|
Cancelamento de Clientes OZmap | Remove clientes no OZmapcom 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 ordem no OZneutral | Atualiza as ordens no OZneutral com base nos dados do cliente no OZmap. | OZmap => OZneutral |
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 intregaçã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 passado pelo OZneutral. A posição do Cliente no mapa não pode ser refinada.
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).
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 é setado 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 ordem da operadora, mas pode ser parametrizado também que ocorra por ordem da parceira.
Com isso quando a ordem é cancelada no OZneutral é buscado um cliete 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 registrados 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 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 e 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 remove o cliente e o imóvel no 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 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 privisionamento da ordem OZneutral, podendo acontecer da seguinte forma:
Caso a ordem for provisionada o cliente tem seu status atualizado para implantado no OZmap.
Caso a ordem seja desprovisionada o cliente 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. Essa atualização ocorre da seguinte forme:
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, removido, etc
Esses clientes filtrados então são passados para o OZneutral que atualiza os dados da ordem correspondente.
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 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 |
---|---|
0 Comments