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 5 Next »

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.

Tipo de Integração

A integração OZmap-Ispbox 2 é do tipo Passiva-direta.

Descrição

O Ispbox 2 é um sistema focado na gestão de vendas e equipes, voltado para provedores de internet.

A integração tem como objetivo a consulta de viabilidade no OZmap para o endereço de clientes interessados em contratação via plataforma de vendas do Ispbox 2.

Resumo de funcionalidades

Funcionalidade

Descrição

Direção da integração

Consulta de Viabilidade com reserva de Porta no OZmap

Consulta de viabilidade de atendimento para clientes, onde é realizada a reserva de porta para o cliente no OZmap;

Ispbox 2 => OZmap

Implantação de Clientes no OZmap

Ispbox 2 => OZmap

Cancelamento de cliente no OZmap

Ispbox 2 => OZmap

Funcionalidades

Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.

Consulta de Viabilidade

A Consulta de Viabilidade com reserva de Porta realizada pelo Ispbox 2 no OZmap consiste em verificar a disponibilidade de atendimento para um novo cliente em determinada localidade e reserva uma porta para sua instalação posterior, ocorrendo da seguinte forma:

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

Saiba mais como configurar esses dados acionando o suporte do Ispbox 2.

OZmap

Parâmetro

Descrição

Exemplo

Url do Servidor

Endereço do OZmap

https://cliente.ozmap.com.br

Porta

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

Liberação de IPs

Caso o servidor OZmap esteja em ambiente ON-Premisses, é necessário liberar nos firewalls o IP do servidor onde está o Ispbox 2 para acessar as portas 80 e 9994 no ambiente do OZmap.

Caso seu servidor seja hospedado pelo OZmap, essas portas já estarão liberadas para o integrador.

Questionário

Pergunta

Resposta

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.