Essa integração tem como objetivo a consulta de viabilidade no OZmap com reserva de porta, implantação e cancelamento de clientes via Ispbox 2. Sendo todas essas funcionalidades realizadas a partir do Ispbox 2.
Consulta de Viabilidade com reserva de Porta no OZmap - No menu "Clientes/Viabilidade" do Ispbox 2, escolha "Nova viabilidade". Preencha os dados do cliente e clique em "Abrir OZmap". O Ispbox 2 abrirá o OZloc, mostrando o mapa com a posição do cliente.
As configurações de viabilidade são ajustadas conforme as configurações definidas no OZmap. Se for fornecido um endereço ao invés de coordenadas, o OZloc automaticamente realizará a conversão do endereço para coordenadas. Se existirem caixas disponíveis no OZmap para essa área, o OZloc exibirá uma lista delas, junto com a quantidade de portas livres para que o usuário possa selecionar a opção desejada e efetuar a reserva. O cliente será criado no OZmap como "Não implantado".
Cancelamento de reservas no OZmap - O cancelamento de reservas no OZmap consiste em remover clientes de reservas de porta que não serão mais instalados. Para realizar o cancelamento, no menu "Clientes/Viabilidade" do Ispbox 2, localize a reserva no OZmap e selecione "Fechar" no menu "Opções". É necessário definir o status como "Sem sinal" no Ispbox 2 para que a reserva seja removida do OZmap. O sistema busca no OZmap um imóvel com o mesmo ID da reserva cancelada e, se encontrado, o remove completamente. Além disso, reservas não ativadas dentro do tempo definido nas configurações da integração no Ispbox 2 (normalmente o padrão é de 30 dias) são automaticamente canceladas pelo Ispbox 2.
Implantação de Clientes no OZmap - A Implantação de Clientes no OZmap funciona ativando reservas de porta para clientes que tiveram seus serviços de internet ativados no Ispbox 2 através do menu "Clientes/Viabilidade", onde a reserva poderá ser localizada. No menu "Opções" é preciso selecionar a opção “Fechar” e é crucial usar um status que permita a geração de cadastro para ativar a reserva no OZmap.
Ao criar um cadastro para o cliente, é necessário incluir um serviço de internet em "Serviços" e depois "Novo Serviço" -> "Internet". Quando o serviço é salvo no cadastro, o Ispbox 2 procura no OZmap um imóvel com o mesmo ID da reserva do cliente. Se encontrado, o cliente é ativado no OZmap e seu estado de implantação muda para "implantado".
Dados necessários
Por se tratar de uma integração passiva da parte do OZmap, é necessário informar ao Ispbox 2 as seguintes informações:
URL do Servidor - A URL será o endereço do seu OZmap.
Exemplo: https://exemplo.ozmap.com.br
Porta API - A porta de serviço padrão do OZmap: 9994.
Porta OZloc - É a porta de serviço padrão do OZloc: 9443
API Key - É necessário gerar uma chave de API do OZmap. Você pode aprender a realizar esse processo clicando aqui.
Além disso, caso o servidor do seu OZmap esteja em ambiente on-premises, é necessário liberar no firewall 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.