...
Essa documentação trata da integração com o sistema Melhor Plano. A integração é realizada através de chamadas de API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.
...
O Melhor Plano é uma plataforma voltada para consulta e comparação de planos de internet e telefonia, onde os clientes podem encontrar planos disponíveis para suas regiões.
...
Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
Consulta de Viabilidade no OZmap
A Consulta de Viabilidade realizada pelo Melhor Plano no OZmap consiste em verificar a disponibildiade disponibilidade de atendimento para um cliente que está consultando planos em para uma determinada localidade, dentro da plataforma Melhor Plano, e ocorre da seguinte forma:
Através da interface de consulta de planos do Melhor Plano, o cliente preenche seu CEP e número da residência.
Após preencher e enviar os dados, o sistema do Melhor Plano irá consultar a viabilidade no OZmap do provedor, buscando caixas que não estejam “Em projeto”, e possuam splitter de atendimento com portas disponíveis no OZmap;
A localização enviada ao OZmap para a viabilidade é em coordenadas, ou seja, o Melhor Plano converte o CEP e Número número que o cliente informou em coordenadas, para então mandar a busca ao OZmap.
A busca de viabilidade realizada no OZmap é feita por raio, e a distância máxima para este raio de busca será a que estiver definida no cadastro do provedor na plataforma Melhor Plano.
Se o provedor possuir disponibilidade de atendimento para o CEP e número informados pelo cliente, os planos do provedor são apresentados para o cliente junto à lista de dos demais planos disponíveis para sua localizaçãoseu CEP e número.
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo integrador são:
...
Parâmetro | Descrição | Exemplo |
|---|---|---|
URL | Endereço do OZmap, com a porta de serviço padrão. | https://cliente.ozmap.com.br:9994/api/v2 |
Token | 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 |
...
Caso o servidor OZmap esteja em ambiente ON-Premisses, é necessário liberar nos firewalls o IP do servidor onde está o Melhor Plano para acessar as portas 80 e 9994 no ambiente do OZmap.
...