Page Comparison

...

...

A integração OZmap-IXC é do tipo Ativa.

Descrição

O IXC Soft é uma ferramenta de gestão para provedores de internet, focado no controle financeiro, estoque e documentação.

...

Resumo das funcionalidades

Funcionalidades

Implantação e Sincronização de Clientes IXC no OZmap

...

• É feito a leitura de todos os clientes no IXC que possuem o tipo de conexão fibra (tipo_conexao_mapa = “f”) e o status de login ativo (ativo = “s”);

• A integração busca clientes no OZmap com código igual ao atributo de login IXC definido para a integração;

• Caso seja encontrado, se a configuração “Implantar Clientes Automaticamente no OZmap“ estiver ativada e o cliente IXC possuir uma ONU, o estado de implantação deste cliente no OZmap é atualizado para “implantado”;

• Se o parâmetro ”Atualização de status dos Clientes OZmap” estiver ativo, e o status de conexão do cliente no IXC esteja diferente do OZmap, é atualizado o valor do status da conexão no OZmap com base no valor lido no atributo “online” no IXC seguindo a seguinte tabela.

• Se o parâmetro “Atualização de potência dos Clientes OZmap” estiver ativo, e a potência do cliente no IXC divergir da potência no cliente OZmap (considerando o parâmetro “Limite de alteração de potência“), é atualizado o campo de potência lida da ONU no OZmap com o valor encontrado no IXC. Abaixo uma tabela exemplificando os casos de atualização de potência, considerando o “Limite de alteração de potência“ sendo 0.5:

• Caso o cliente não possuir nome no OZmap ou o valor diferir do IXC, é atualizado o nome do cliente no OZmap com o valor encontrado no IXC. O campo de nome utilizado no IXC para a verificação é o “razão”;

• Se o parâmetro “Atualização de endereço dos Clientes OZmap” estiver ativo, e o campo de endereço da propriedade do cliente no OZmap estiver diferente do endereço lido para o cliente no IXC, o endereço da propriedade do cliente no OZmap é atualizado com os dados de endereço do IXC.

...

• É feito a leitura de todos os clientes no IXC que possuem o tipo de conexão fibra (tipo_conexao_mapa = “f”) e o status de login não ativo (ativo = “n”);

• A partir destes clientes, a integração busca clientes no OZmap com código igual ao atributo de login IXC definido para a integração;

• Se o cliente estiver sem contrato ou o contrato esteja como “inativo” no IXC, o cliente é removido da propriedade no OZmap, por padrão a propriedade é mantida e o drop permanece conectado ao splitter OZmap e, uma observação de nome do cliente e data de remoção é adicionada ao imóvel.

• Se o status do contrato do cliente no IXC está como “desistiu”, o cliente e imóvel são removidos do OZmap;

Atualização da Porta do Cliente

ImportanteObservação: não é recomendado usar essa funcionalidade sem usar a configuração para utilizar splitters OZmap como caixas no IXC, já que ela é necessária para identificar o splitter do cliente no OZmap corretamente se exista mais de um splitter na caixa onde ele se encontra.

...

• É feito a leitura de todos os clientes no IXC que possuem o tipo de conexão fibra (tipo_conexao_mapa = “f”) e o status de login ativo (ativo = “s”);

• A integração busca clientes no OZmap com código igual ao atributo de login IXC definido para a integração;

• Caso o sistema escolhido como fonte seja o OZmap:

  • Caso o cliente no IXC esteja em uma caixa diferente no OZmap, é atualizado a caixa e a porta do cliente no IXC, replicando os dados do OZmap. Se o cliente estiver utilizando a configuração de utilizar splitters OZmap como caixas no IXC, se sofrer alteração de splitter no OZmap, ele será atualizado de caixa no IXC.

  • Caso o cliente no IXC esteja na mesma caixa no OZmap, porém, esteja em portas diferentes, é atualizado a porta IXC do cliente com o valor existente no OZmap;

  • Caso o cliente não tenha informações de porta no OZmap e a configuração ‘Desconexão de clientes em trocas de porta caso não tenham informações de conexão no sistema fonte’ esteja ativa, também faz a desconexão do cliente no IXC.

  Caso o sistema escolhido como fonte seja o IXC:

  • Caso o cliente no OZmap esteja IMPORTANTE:

    • A atualização de caixa e/ou porta somente será feita caso haja uma caixa no IXC vinculada com a caixa OZmap do cliente.

    • Caso a configuração “Atualizar fibra de cliente IXC” esteja ativa, também será atualizado as informações de porta da ONU/fibra do cliente no IXC.

• Caso o sistema escolhido como fonte seja o IXC:

  • Caso o cliente no OZmap esteja em uma caixa diferente no IXC, e:

    • Não use a configuração “Utilizar o Splitter OZmap como Caixa no IXC”:

      • É atualizado a caixa e a porta do cliente no OZmap, utilizando o primeiro splitter que permita a conexão de cliente dentro da caixa OZmap.

      • Caso o cliente no OZmap esteja na mesma caixa no IXC, porém esteja em portas diferentes, é atualizado a porta OZmap do cliente com o valor existente no IXC.

    • Use a configuração “Utilizar o Splitter OZmap como Caixa no IXC”:

      • É atualizado a caixa e a porta do cliente no OZmap, utilizando o splitter OZmap que foi vinculado com a caixa IXC e a caixa em que esse splitter se encontra no OZmap.

      • Caso o cliente no OZmap esteja na mesma caixa no IXC, porém esteja em portas diferentes, é atualizado a porta OZmap do cliente com o valor existente no IXC.

  • Caso o cliente não tenha informações de porta no IXC e a configuração ‘Desconexão de clientes em trocas de porta caso não tenham informações de conexão no sistema fonte’ esteja ativa, também faz a desconexão do cliente no OZmap.

...

• • IMPORTANTE: A atualização de caixa e/ou porta somente será feita caso haja uma caixa no OZmap vinculada com a caixa IXC do cliente.

Atualização das Coordenadas do Cliente

...

A atualização de coordenadas consiste em atualizar as coordenadas do cliente IXC com base na leitura do OZmap, e ocorre da seguinte forma:

• É feito a leitura de todos os clientes no IXC que possuem o tipo de conexão fibra (tipo_conexao_mapa = “f”) e o status de login ativo (ativo = “s”);

• A integração busca clientes no OZmap com código igual ao atributo de login IXC definido para a integração;

• A integração compara os valores de latitude e longitude cadastrados no login IXC, com a latitude e longitude da propriedade do cliente no OZmap.

• Caso haja (Importante: O vínculo é estabelecido entre o atributo de login no IXC e o código do cliente no OZmap. Portanto, se houver qualquer alteração no atributo de login de um cliente no IXC que já esteja vinculado a um cliente no OZmap, esse vínculo será desfeito e não será refeito automaticamente);

• A integração compara os valores de latitude e longitude cadastrados no login IXC, com a latitude e longitude da propriedade do cliente no OZmap.

• Caso haja divergência entre os valores de IXC e OZmap e:

  • O sistema fonte para as coordenadas seja o OZmap:

    • Os dados de latitude e longitude do cliente no IXC são atualizados com os valores presentes no OZmap.

  • O sistema fonte para as coordenadas seja o IXC:

    • A integração verifica se o cadastro de login do cliente no IXC teve alguma alteração desde a última sincronização ou se é um cliente novo:

    • Caso o cliente se enquadre nessas condições, os dados de latitude e longitude do cliente no OZmap são atualizados com os valores presentes no login do IXC.

...

• São buscados no OZmap todos os condomínios que foram criados ou sofreram alteração desde o ultimo intervalo de sincronização e, além disso, condominios que não estiverem em projeto e o splitter que o splitter OZmap tenha o atributo de permitir conexão de cliente ativo.

• Caso seja um condomínio que não exista ainda no IXC, para cada splitter que tenha portas livres deste condomínio, será criado uma caixa no IXC. Após a criação dessas caixas no IXC, elas são identificados pelo nome do condomínio OZmap mais o nome do splitter OZmap; Um exemplo de nome seria: COND. RIO BRANCO - Splitter-01

• Caso seja um condomínio existente no IXC que teve alteração no OZmap, essa alteração é replicada na caixa IXC;

• Uma vez ao dia, é tentado realizar a criação/atualização de condominios que houveram erros em sincronizações anteriores;

Criação de Clientes no OZmap

...

• São buscados no OZmap as caixas que foram criadas ou sofreram alteração desde o ultimo intervalo de sincronização e, além disso, a caixa OZmap deve possuir a capacidade para atender clientes, não pode estar em projeto e, serão considerados para criação/atualização somente splitters que permitam conexão de cliente;

• Caso a caixa não existir no IXC, a mesma será criada no IXC com as informações obtidas na sincronização, essas informações se encontra na tabela abaixo, mostrando qual o valor será pego do OZmap e atribuido no IXC. Por padrão, o OZmap cria apenas uma caixa no IXC e soma a quantidade de portas considerando o total de portas de splitters de atendimento na caixa OZmap e atribui essa informação no IXC;

• Caso seja uma caixa existente no IXC que teve alteração no OZmap, essa alteração é replicada na caixa IXC;

• É possível habilitar a configuração de utilizar os splitters OZmap como caixas no IXC, onde cada splitter de atendimento presente dentro de uma caixa no OZmap que não esteja “Em projeto” ou dentro de um condomínio vertical, é criado como caixa no IXC. Isso se dá ao fato do IXC não reconhecer o conceito de splitters, então, cada splitter no OZmap equivale a uma caixa no IXC com essa configuração.

• Se for uma caixa existente no IXC, e que foi removida do OZmap (caixa removida no OZmap para quem usa caixas OZmap como caixas IXC, ou caso o cliente use splitters OZmap como caixas IXC, seja o splitter ou caixa do splitter removida no OZmap) é feita uma atualização do status da caixa IXC para inativo (status = “i”) e adicionado um prefixo de (INATIVA).

  • Se a configuração ‘Remover caixas IXC que foram deletadas no OZmap’ estiver ativa, a caixa é então removida no IXC.

Configurações Base

...

Parâmetro

...

Descrição

...

Padrão

...

Tempo entre Sincronizações

...

Tempo aguardado entre as sincronizações realizadas pela integração.

Retentativa de elementos com erro

Por padrão, elementos que possuíram erros de tratamento 5 vezes seguidas são limitados automaticamente pela integração, sendo somente retentados novamente de 24 em 24 horas, uma lista dos elementos sendo retentados pode ser visualizada na auditoria da integração.

Configurações Base

Configurações Específicas - Caixas

Configurações Específicas - Caixas

Configurações Específicas - Clientes

...

Dados Acesso

https://docs.google.com/forms/u/2/d/1ujtHdsXTYYTD1mH8jzikW6eK6TVuVdfNqeTSRtEvtnw/edit?usp=drive_web

...

Dados de acesso necessários para buscar informações via API no sistema IXC. (Estes dados devem ser fornecidos no questionário inicial)

OZmap

Insert excerpt
CP:Base variables CP:Base variables name ozmap_token nopanel true

...

Também se faz necessária a liberação dos mesmos IPs acima no próprio IXC, normalmente por solicitação do cliente ao suporte IXC.

Logs

Os logs desta integração estão disponíveis no endereço:

...

Auditoria

A integração possui uma auditoria de elementos que pode ser acessada pelo dashboard do OZmap ou com as instruções disponibilizadas pela rota de logs da integração, mais informações sobre essa auditoria podem ser encontradas neste link.

Questionário

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