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, caso essa porta esteja 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 e tenha splitter no SGP mas o cliente não possua porta no SGP, criamos o cliente no primeiro splitter e na primeira porta disponível no OZmap. Porém caso a configuração “Considerar mais de um splitter na caixa OZmap” esteja ativada, o cliente não é criado.

  • Caso a caixa exista no OZmap e tenha splitter e 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, será buscado em todos os splitters da caixa uma porta correspondente a indicada no SGP. Porém para que todos os splitters sejam considerados, o splitters devem ser nomeados em ordem numérica válida. Ex: Splitter 1, Splitter 2, Splitter 3, neste exemplo, caso o Splitter 2 não exista o Splitter 3 não será considerado como splitter válido.

  • 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 e Endereço).

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.

Atualização de Caixa, Splitter e Porta dos Clientes OZmap

A Atualização de Caixa, Splitter e Porta de clientes OZmap consiste em identificar alteração de algum desses dados do cliente no SGP e replicar essa alteração para o cliente OZmap correspondente, e ocorre da seguinte forma:

• É identificado o cliente no OZmap pelo código de contrato existente no SGP

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

• Caso a configuração de considerar o nome de projeto esteja ativa, a porta do cliente somente será atualizada no OZmap caso o projeto da caixa OZmap possua o mesmo nome da cidade do cliente no SGP.

• Caso exista uma caixa correspondente no OZmap, 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 para que todos os splitters sejam considerados eles devem ser nomeados em ordem numérica válida. Ex: Splitter 1, Splitter 2, Splitter 3, neste exemplo, caso o Splitter 2 não exista o Splitter 3 não será considerado como splitter válido.

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