Versions Compared

Key

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

Essa documentação trata da integração com o sistema Ispbox 2. A integração é realizada através de chamadas de API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.

...

  • Através do menu “Clientes/Viabilidade” da plataforma Ispbox 2, é acionada a opção “Nova viabilidade”

  • Após preenchimento dos dados do cliente no Ispbox 2, é acionada a opção “Abrir OZmap”

  • O Ispbox 2 abrirá o OZloc, com o mapa mostrando a posição encontrada para o cliente.

    • As configurações de viabilidade usadas para essa viabilidade no OZloc são as que estiverem definidas nas configurações do OZmap

    • Caso o usuário tenha preenchido o campo de coordenadas no Ispbox 2, essa informação será usada pelo OZloc para verificar a disponibilidade de caixas

    • Caso o usuário tenha preenchido somente o endereço no Ispbox 2, o OZloc irá traduzir esse endereço em coordenadas para então verificar a disponibilidade de caixas

  • O OZloc então exibirá a lista de caixas com disponibilidade de atendimento e quantidade de portas livres que possuem

  • O usuário seleciona a caixa a qual deseja efetuar a reserva, e então o menu de confirmação de reserva é exibido, para confirmação dos dados do cliente

  • Após confirmação da reserva, é criado um cliente no OZmap com estado de implantação “Não implantado” (para representar uma reserva de porta), posicionado na mesma localização usada para a viabilidade, e com os dados de nome, código e endereço preenchidos pelo Ispbox 2

  • Por fim, o Ispbox 2 retorna para sua tela de nova viabilidade, onde busca e exibe as informações de caixa e porta a qual a reserva do cliente foi criada no OZmap.

  • A partir do endereço informado, o Ispbox 2 realiza a consulta de viabilidade no OZmap, enviando as coordenadas correspondentes ao endereço do cliente para buscar caixas que não estejam “Em projeto”, e possuam splitter de atendimento com portas disponíveis no 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 nas configurações do Ispbox 2 (Parâmetro “OzMap Raio”).

  • Após a busca de viabilidade no OZmap, são carregados na tela do Ispbox 2 todos os dados de cobertura para o usuário gerar a venda;

  • Tempo em dias para cancelar reserva de porta não utilizada na viabilidade: 30

Dados Acesso

Dados de acesso necessários para as operações realizadas pelo integrador são:

...

Parâmetro

Descrição

Exemplo

Url do Servidor

Endereço do OZmap

https://cliente.ozmap.com.br

Porta API

Porta de serviço padrão do OZmap

9994

Porta OZloc

Porta de serviço padrão do OZloc

9443

API Key

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

...