[WiP] Telco by G2

Tipo de Integração

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

Descrição

O Telco by G2 é um ERP SAP Business One implementado para empresas de telecomunicações, focado na gestão de operações finaceiras, comerciais, controle de estoque, entre outros.

A integração se baseia no Telco realizando principalmente viabilidade, reserva de portas, ativação e cancelamento de clientes no OZmap.

Resumo de funcionalidades

Funcionalidades

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

Consulta de viabilidade e reserva de portas no OZmap

A consulta de viabilidade e reserva de portas no OZmap se baseia na consulta de uma localização, verificando se possui viabilidade de atendimento antes de prosseguir com a reserva de portas nos processos de venda ou troca de endereço, e ocorre da seguinte forma:

• O Telco envia ao OZmap a latitude e longitude do cliente interessado em contratação ou em solicitações de alteração de endereço.

• A partir da latitude e longitude informadas pelo Telco, o OZmap realizada a verificação de viabilidade técnica, buscando caixas que não estejam “Em projeto”, e possuam splitter de atendimento com portas disponíveis no OZmap;

• A definição de qual tipo de viabilidade será feita no OZmap é determinada pelo parâmetro “Tipo de viabilidade feita no OZmap”, podendo ser de duas formas:

  • Por raio (padrão): a partir da coordenada passada pelo Telco, busca as caixas mais próximas no OZmap considerando a distância em linha reta do cliente até a caixa. O tamanho máximo em métros para o raio de busca será o que estiver definido nas configurações do OZmap (Configurações > Sistema > API > Raio de busca padrão).

  • Por poste: a partir da coordenada passada pelo Telco, busca o poste mais próximo no OZmap (buscando em um raio de 100 metros), e partindo deste poste, busca caixas considerando a distância do poste até as caixas, passando pelas adjacências disponíveis no OZmap. O tamanho máximo em metros para o drop será o que estiver definido nas configurações do OZmap (Configurações > Projeto > Configuração padrão de drop > Tamanho máximo de drop).

• O OZmap retorna ao Telco a lista de caixas e portas disponíveis para seguimento do processo de venda ou troca de endereço, onde o usuário pode selecionar um caixa e porta no Telco para realizar a reserva de porta.

• Após a seleção de caixa e porta no Telco, um cliente é criado no OZmap ocupando a caixa e porta selecionadas, contendo como código no OZmap o ID de contrato do Telco, e com estado de implantação “Não implantado”.

  • Caso seja uma troca de endereço, será criado um segundo cliente na caixa e porta selecionadas, com também com estado de implantação “Não implantado”, mas no código, terá o ID de contrato do Telco + “-AE” para indicar que se trata de uma alteração de endereço (Ex.: 171717-AE)

Implantação de clientes no OZmap

A Implantação de cliente no OZmap consiste em ativar um cliente no OZmap após a habilitação do seu contrato no Telco, e ocorre da seguinte forma:

• Clientes novos:

  • Ao realizar a habilitação de contrato de um cliente no seu sistema, o Telco ativa esse cliente no OZmap.

  • Para isso, o estado de implantação do cliente no OZmap é alterado de “Não implantado” para “Implantado”.

• Clientes em alteração de endereço:

  • Caso seja um cliente de troca de endereço, o Telco remove o cliente OZmap no endereço antigo, , e por padrão, o imóvel do cliente é mantido no OZmap, e seu drop desconectado do splitter OZmap.

    • Se o parâmetro “Desconectar Drop de Clientes cancelados no OZmap” estiver desabilitado, o imóvel é mantido no OZmap e o drop permanece conectado à porta do splitter OZmap.

  • O cliente do endereço novo tem o estado de implantação alterado de “Não implantado” para “Implantado”, e o “-AE” é removido do código OZmap.

Cancelamento de clientes no OZmap

O Cancelamento de clientes no OZmap consiste na mudança de estado de implantação e posterior exclusão de clientes no OZmap, e ocorre da seguinte forma, em duas situações:

• Quando um contrato de cliente ativo é cancelado no seu sistema, o Telco desativa esse cliente temporariamente no OZmap.

  • Para isso, o estado de implantação do cliente no OZmap é alterado de “Implantado” para “Não implantado”.

  • Quando uma visita de retirada de equipamento do contrato cancelado é concluída, o Telco exclui o cliente do OZmap, e por padrão, o imóvel do cliente é mantido no OZmap, e seu drop desconectado do splitter OZmap.

    • Se o parâmetro “Desconectar Drop de Clientes cancelados no OZmap” estiver desabilitado, o imóvel é mantido no OZmap e o drop permanece conectado à porta do splitter OZmap.

• Quando um cliente com contrato que não foi habilitado é cancelado, o Telco exclui o cliente do OZmap, e por padrão, o imóvel do cliente é mantido no OZmap, e seu drop desconectado do splitter OZmap.

  • Se o parâmetro “Desconectar Drop de Clientes cancelados no OZmap” estiver desabilitado, o imóvel é mantido no OZmap e o drop permanece conectado à porta do splitter OZmap.

Consulta de caixa e porta de clientes no OZmap

A Consulta de caixa e porta de clientes no OZmap consiste no Telco buscando no OZmap a caixa e porta que o cliente Telco está conectado no OZmap, para exibição no mapeamento de contrato do Telco e demais locais onde se faz necessário saber a caixa e porta do cliente dentro do Telco.

Configurações Base

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

OZmap

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 Telco 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

//Anotar as perguntas e possíveis respostas e quais as funcionalidades relacionadas às respostas.