...
Table of Contents | ||||
---|---|---|---|---|
|
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
Funcionalidade | Descrição | Direção da integração |
---|---|---|
Consulta de viabilidade e reserva de portas no OZmap | Telco envia latitude e longitude de um cliente para o OZmap, que retorna a viabildiade de atendimento para aquela localização, e a partir disso, podendo realizar a reserva de portas no OZmap. | Telco => OZmap |
Implantação de clientes no OZmap | Alteração de status de implantação de clientes ativados no OZmap. | Telco => OZmap |
Cancelamento de clientes no OZmap | Alteração de status de implantação e exclusão de clientes cancelados no OZmap. | Telco => 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 e reserva de portas no OZmap
A consulta de viabilidade e reserva de portas no OZmap se baseia na consulta 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 métros 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 realizare 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 um 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”.
Cliente com 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.
Configurações Base
Parâmetro | Descrição | Padrão |
---|---|---|
Tipo de viabilidade feita no OZmap | Tipo de viabilidade que será feita pelo OZmap com base nas coordenadas informadas, podendo ser por raio ou por poste (adjacências). | Raio. |
Desconectar Drop de Clientes cancelados no OZmap | Quando um cliente for removido do OZmap por cancelamento de conexão Telco, o drop do imóvel será desconectado da porta do splitter OZmap. | Ativado. |
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
Parâmetro | Descrição | Exemplo |
---|---|---|
URL | Endereço do OZmap, com a porta de serviço padrãoda API OZmap disponibilizada para o Telco. | https://cliente.ozmap.com.br:9994/integrations/telco/api/v2v1 |
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 |
...
Questionário
Pergunta | Resposta |
---|---|
Quando um cliente é cancelado no Telco, o mesmo é removido imediatamente do OZmap? | Não. O Telco altera o estado de implantação para “Não implantado” e só remove um cliente cancelado do OZmap após a retirada de seu equipamento. |
Os clientes criados pelo Telco no OZmap seguem as adjacências disponíveis? | Não. Atualmente o Telco cria clientes somente em linha reta até a caixa no OZmap. |
//Anotar as perguntas e possíveis respostas e quais as funcionalidades relacionadas às respostas.