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 no OZmap buscar 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 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 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.

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.