Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

OZneutral-Site-1.png

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 pelo OZmap.

Tipo de Integração

A integração OZmap-OZneutral é do tipo Passiva-indireta.

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

Resumo de funcionalidades

  • Integração Padrão

Funcionalidade

Descrição

Direção da integração

Criação de clientes

Criação de clientes no OZmap com base nos dados de clientes OZneutral

OZneutral => OZmap

Cancelamento de clientes

Cancela clientes no OZmap com base nos dados de clientes OZneutral

OZneutral => OZmap

Informação de caixas e conexões

Repassa as informações das caixas e conexões do cliente no OZmap para os clientes no OZneutral

OZmap => OZneutral

  • Integração Customizada

Funcionalidade

Descrição

Direção da integração

Remoção de clientes

Remove clientes no OZmap, com base nos dados de cliente OZneutral.

OZneutral => OZmap

Atualização de clientes

Atualiza os clientes no OZneutral caso haja alguma alteração no cliente OZmap.

OZmap => OZneutral, OZneutral => OZmap

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

Criação de Clientes

A intregação realiza a criação de clientes OZmap com base nos dados de clientes OZneutral, ocorrendo da seguinte forma:

  • Primeiramente é checada a viabilade do cliente no OZneutral a partir da criação de um lead.

  • Após a criação do lead é possível criar uma ordem, que ao ser criada cria um cliente no próprio OZneutral.

  • Após a criação desse cliente os dados são passados para a integração criar um cliente no OZmap que terá como nome o nome da parceira, o código 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.

Cancelamento de Clientes

Por padrão o cancelamento de clientes no OZneutral ocorre por odem da operadora, com isso quando o cliente é cancelado é 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 dos clientes registrados no OZneutral a partir dos dados do OZmap. Essas informações podem ser visualizadas na lista de ordens, na qual cada cliente 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.

Remoção de Clientes

O processo de remoção ocorre caso uma ordem seja cancelada no OZneutral, 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

Atualização de clientes

A atualização de clientes por parte da integração pode ocorrer tanto na busca de dados do OZmap para o OZneutral, quanto do OZneutral para o OZmap. Isso pode a

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

  • E também ocorre quando o cliente opta que os clientes OZneutral sejam atualizados sempre que haja alguma alteração no OZmap. Com isso a integração busca no OZmap a cada 5 minutos clientes OZneutral que tiveram alteração de coordenadas, caixa/splitter/porta, se foi implantado, removido, etc e atualiza atualiza esses dados no OZneutral.

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.

https://cliente.ozmap.com.br:9994

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

  • No labels