Essa documentação trata do serviço externo SGP. O serviço externo é acessado via API. As funcionalidades descritas aqui indicam as capacidades e os requisitos da integração, bem como o questionário e as funcionalidades relacionadas.
Descrição
O Sistema de Gerenciamento para Provedores de Internet é uma ferramenta de gestão completa, com módulos do sistema integrados e prontos para sua empresa funcionar de forma organizada e otimizada, os módulos do sistema são integrados.
As funcionalidades da integração entre OZmap e SGP se baseiam na leitura de ONUs no SGP para atualização destes dados nos clientes OZmap. A integração encontra as ONUs SGP no OZmap através do contrato das ONUs.
OBS: “contrato“ no SGP deve ser igual ao “code” do cliente no OZmap para que seja atualizado.
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)
Parâmetro | Descrição | Exemplo |
---|---|---|
URL | Endereço do servidor SGP. | https://sgp.cliente.com.br |
Token | Token provido pelo cliente para acessar o serviço. | 59123456-2e1d-479a-9b49-5513b2aac54f |
Nome do App | Nome que o cliente deu para a conta de serviço da integração dentro do seu serviço externo. | OZmap |
OZmap
Parâmetro | Descrição | Exemplo |
---|---|---|
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 |
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
Configurações Base
Parâmetro | Descrição | Padrão |
---|---|---|
Tempo entre Sincronizações | Tempo aguardado entre as sincronizações realizadas pela integração | 15 minutos |
Configurações Específicas - Clientes
Parâmetro | Descrição | Padrão |
---|---|---|
Cancelar Clientes Automaticamente no ERP | Clientes com status "Cancelado" ou "Inviabilidade Técnica" no ERP são cancelados no OZmap. | Desativado |
Criar Clientes Automaticamente no OZmap | Clientes que existem no ERP porém não existem no OZmap serão criados no OZmap caso a caixa seja encontrada pelo nome. | Desativado |
Considerar o Projeto na Criação de Novos Clientes no OZmap | Somente será criado o cliente no OZmap cuja o projeto da caixa OZmap tenha o nome igual ao projeto do cliente no SGP. | Desativado |
Logs
Os logs desta integração estão disponíveis no endereço: https://<cliente>.ozmap.com.br/integrations/sgp/logs.
Resumo das funcionalidades
Funcionalidade | Descrição | Direção da integração |
---|---|---|
Sincronização de Dados de Clientes | Sincronização dos dados dos clientes cadastrados no OZmap, podendo incluir status do contrato, status da conexão, potência, nome e endereço. | SGP => OZmap |
Cancelamento de Clientes | Cancelamento de clientes que se encontram cancelados no ERP. | SGP => OZmap |
Ativação de Clientes | Ativação de clientes que se encontram ativados no ERP. | SGP => OZmap |
Criação de Clientes | Criação de clientes que se encontram cadastrados no ERP. | SGP => OZmap |
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 identificados todos os clientes que existem no SGP (contrato) e não existem no OZmap (código do cliente).
A partir desses clientes encontrados, é analisado se ele está conectado a um splitter no SGP. (Para criar no OZmap é necessário estar conectado).
Após confirmar que o cliente possui um splitter, é analisado se o cliente não está com o status de cancelado no SGP.
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, mas não tenha splitter, o cliente é criado na caixa sem conexão.
*Caso a caixa exista e tenha splitter, criamos o cliente no splitter e na porta indicada no SGP.
*Caso a caixa não exista, o cliente não será criado no OZmap.
*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 projeto do cliente no SGP.
*Caso 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.
Atualização de Campos (Nome, Potência (RX), Estado de Ativação, Status de Conexão, ).
A cada X minutos, a integração busca os contratos e conexões atualizadas do SGP.
Identifica os clientes no OZmap pelo código (id) de contrato existente no ERP, e atualiza os campos baseado nas seguintes regras:
Estado de Ativação:
Caso o cliente tenha o Status de Contrato “Ativo” (1) no SGP e, tenha o estado “Não Implantado” no OZmap, ele é atualizado para o estado “Implantado” no OZmap automaticamente.
Caso o cliente tenha o Status de Contrato “Cancelado” (3) no SGP e, tenha o estado “Implantado” no OZmap, ele é atualizado para o estado “Cancelado” no OZmap automaticamente.
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.
“Online” no ERP ⇒ “OK” no OZmap
“Offline” no ERP ⇒ “ERROR” no OZmap
Nome: Se houve alteração no SGP (OZmap != SGP) considera nome do ERP. (Qualquer alteração de nome no OZmap será descartada)
Potência (RX): Caso o SGP retorne essa informação atualizamos o campo “Potência lida” existente no cliente do OZmap. Essa atualização é feita caso a potência seja diferente da existente no OZmap atualmente.
Cancelamento de clientes
A cada X minutos, a integração busca os contratos e conexões atualizadas do SGP.
Identifica os clientes no OZmap pelo código(id) de contrato existente no ERP, e identifica contratos cancelados que ainda existem no OZmap:
Contrato é considerado cancelado se tiver no status: CANCELADO(3) ou INVIABILIDADE_TECNICA(5) no SGP.
Caso o cliente esteja “Implantado” no OZmap, é considerado um cancelamento de cliente já ativo, e o cancelamento se dá dessa forma:
Cliente é removido do Imóvel
Imóvel permanece conectado ao Splitter.
São adicionadas informações do cliente removido(Nome, Código, Data) nas observações do imóvel.
Caso o cliente esteja “Não Implantado” no OZmap, é considerada uma “Desistência” (Quando um cliente não chega a ser ativado, e cancela), e o cancelamento se da dessa forma:
Imóvel e cliente são removidos por completo
Nenhuma conexão com splitter é mantida.
Questionário
Pergunta | Resposta | Funcionalidade |
---|---|---|
//Anotar as perguntas e possíveis respostas e quais as funcionalidades relacionadas às respostas.
Add Comment