SGP

Tipo de Integração

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

Descrição

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

As funcionalidades da integração entre OZmap e SGP se baseiam na leitura de clientes no SGP para atualização, criação e remoção de clientes no OZmap. A integração encontra os clientes SGP no OZmap através do contrato SGP.

OBS: “contrato“ no SGP deve ser igual ao “code” do cliente no OZmap para que seja encontrado.

Resumo das funcionalidades

Funcionalidades

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

Criação de Clientes  

• São buscados todos os clientes que existem no SGP, que possuam ONU e que não existem no OZmap (procurando pelo código do cliente OZmap semelhante ao contrato SGP).

• A partir desses clientes encontrados, é analisado se ele está conectado a um splitter no SGP. (Para criar no OZmap é necessário estar conectado).

• Com o cliente possuindo um splitter e o status não está como cancelado no SGP, vamos buscar no OZmap por padrão uma caixa com nome IGUAL ao nome existente no splitter do SGP, se for encontrada, criamos o cliente no OZmap com os dados necessários e conexão com a caixa.

  • Caso a configuração “Considerar condomínios verticais” esteja ativada, também será levado em consideração os condomínios verticais na busca no OZmap por caixa com nome IGUAL ao nome existente no splitter do SGP.

  • Caso a caixa exista no OZmap, mas não tenha splitter, o cliente é criado na caixa sem conexão.

  • Caso a caixa exista no OZmap e tenha splitter, criamos o cliente no splitter e na porta indicada pelo SGP, se essa porta estiver disponível no OZmap e o valor da porta seja compatível com a quantidade de saídas do splitter.

  • Caso a caixa exista no OZmap, tenha splitter mas no SGP não possua porta, criamos o cliente no splitter e na primeira porta disponível no OZmap.

  • Caso a configuração “Considerar mais de um splitter na caixa OZmap” esteja ativa, será levado em consideração mais de um splitter na caixa, ou seja, sera buscado em todos os splitters da caixa uma porta correspondente a indicada no SGP. Porém para que essa configuração funcione, o splitter deve ter sua numeração no final do seu nome e devem possuir uma sequência númerica correta. Ex: Splitter 1, Splitter 2, Splitter 3.

  • Caso a caixa não exista no OZmap, o cliente não será criado.

  • Caso a configuração de considerar o nome de projeto na criação de novos clientes esteja ativa, o cliente somente será criado no OZmap caso o projeto da caixa OZmap tenha o nome igual ao nome da cidade do cliente no SGP.

  • Caso a configuração de “Criar clientes no OZmap com coordenadas SGP” estiver ativada e, as coordenadas do endereço do cliente estiverem preenchidas no SGP, ao criar o novo cliente no OZmap, ele será posicionado na mesma coordenada do SGP no OZmap.

    • Caso a configuração não estiver ativada ou as coordenadas não estiverem preenchidas no SGP, o cliente será criado em torno da caixa.

Implantação e Atualização de Clientes (Nome, Potência (RX), Coordenadas, Status de Conexão, Endereço e Porta).

Após cada intervalo entre as sincronizações, a integração busca os contratos e conexões atualizadas do SGP.

Identifica os clientes no OZmap pelo código de contrato existente no SGP, e atualiza os campos baseados nas seguintes regras:

Nome

Se houver alteração do nome no SGP e esteja com diferença no OZmap, é considerado o nome que está no SGP. (Qualquer alteração de nome no OZmap será descartada)

Potência (RX)

Atualização do valor de “Potencia lida” do cliente no OZmap é baseado na leitura informada pelo SGP. Essa atualização é feita caso a potência do SGP seja diferente da potência existente no OZmap atualmente.

Coordenadas

Caso a configuração de “Utilizar coordenadas SGP para clientes no OZmap” esteja ativa, a atualização das coordenadas do cliente no OZmap é baseada na leitura informada pelo SGP. Essa atualização no OZmap é feita caso a coordenada do SGP seja diferente da coordenada do cliente no OZmap atualmente.

IMPORTANTE: Todas as coordenadas dos clientes no OZmap serão trocadas para as do SGP.

Estado de Implantação

Atualização do valor do campo estado de implantação para “implantado” no OZmap é baseado na leitura informada pelo SGP.

• Caso o valor presente no OZmap seja diferente do valor trazido pelo SGP, o campo do OZmap é atualizado. O valor segue o seguinte padrão para ser implantado no OZmap:

Status de Conexão

Atualização do valor de status do cliente no OZmap é baseado na leitura informada pelo SGP. O campo “status” é atualizado no OZmap utilizando o “status_conexão” do SGP.

• Caso o valor presente no OZmap seja diferente do valor trazido pelo SGP, o campo do OZmap é atualizado. O valor segue o seguinte padrão:

Endereço

Atualização do valor de endereço do cliente no OZmap é baseado na leitura informada pelo SGP. A atualização é feita caso o endereço do SGP seja diferente do endereço existente no OZmap atualmente.

Porta

A atualização de porta consiste em identificar que um cliente foi alterado de caixa/porta no SGP e replicar essa atualização para o OZmap, e ocorre da seguinte forma:

• É indetificado o cliente no OZmap pelo código de contrato existente no SGP e que contenha no SGP ONU, nome de splitter e uma porta válida.

• Por padrão é buscado no OZmap por uma caixa com nome IGUAL ao nome existente no splitter do SGP, porém caso utilize a configuração “Considerar condomínios verticais” também será considerado os condomínios verticais nessa busca.

• Caso exista uma caixa, por padrão é buscado no primeiro splitter uma porta correspondente a porta do SGP, porém caso a configuração “Considerar mais de um splitter na caixa OZmap“ esteja ativada, será buscado uma porta correspondente levando em consideração todos os splitters presentes na caixa, entretanto usando essa configuração os splitters devem ter no final do seu nome sua numeração e devem apresentar uma sequências numérica correta: Ex: Splitter 1, Splitter 2 e Splitter 3.

• Caso o cliente esteja conectado a uma caixa diferente da caixa encontrada, o cliente é atualizado no OZmap para a caixa e a porta correspondente a do SGP.

Cancelamento de Clientes

Após cada intervalo entre as sincronizações, a integração busca os contratos e conexões atualizadas do SGP.

Identifica os clientes no OZmap pelo código de contrato existente no SGP que contenham ONU, e identifica contratos cancelados que ainda existem no OZmap, clientes são considerados cancelados no OZmap quando:

O cancelamento se dá dessa forma:

Clientes com o status de não implantado no OZmap:

• Imóvel e Cliente são removidos por completo;

• Nenhuma conexão com splitter é mantida;

Clientes com o status de implantado no OZmap:

• Cliente é removido por completo do imóvel;

• São adicionadas informações do cliente removido (Nome, Código, Data) nas observações do imóvel;

• Se a configuração de desconectar o imóvel do cliente cancelado da porta do splitter estiver ativa, o imóvel é desconectado da porta do splitter no OZmap, liberando a porta para novas conexões;

• Se a configuração de remover completamente o imóvel do cliente cancelado estiver ativa, o imóvel e o cliente são removidos por completo e nenhuma conexão com splitter é mantida;

Configurações Base

Configurações Específicas - Clientes

Dados Acesso

https://docs.google.com/forms/d/1ZrFR1QU4xM7ag_EU-whzzz-oA6es7anXZFCM1GvTn8M/edit

SGP

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

OZmap

Liberação de IPs

Para validação e execução da integração no ambiente de produção, é necessário que sejam liberados no servidor do cliente os IPs utilizados pelo OZmap:

• Servidor OZmap do cliente (ping cliente.ozmap.com.br)

• 54.207.162.199

Logs

Os logs desta integração estão disponíveis no endereço: https://cliente.ozmap.com.br/integrations/sgp/logs

Questionário

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