Essa documentação trata do serviço externo MKSolutions. O serviço externo é acessado via banco de dados. 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 MKSolutions é um sistema de Gestão (ERP) focado no controle financeiro, estoque e documentação para Provedores de internet.
As funcionalidades da integração entre OZmap e MKSolutions se baseiam na busca ao banco de dados disponibilizado pelo ERP, sendo essas funcionalidades a ativação, atualização e cancelamento de clientes no OZmap, com base nas leituras do MKSolutions.
Dados Acesso
MKSolutions
Dados de acesso necessários para que a integração possa buscar informações via banco de dados no sistema MKSolutions. (Estes dados devem ser fornecidos no questionário inicial)
Parâmetro | Descrição | Exemplo |
|---|---|---|
IP Banco de Dados | IP do banco de dados disponibilizado pelo MKSolutions. |
|
Nome Banco de Dados | Nome do banco de dados disponibilizado pelo MKSolutions. |
|
Porta de acesso Banco de Dados | Porta de acesso ao banco de dados disponibilizado pelo MKSolutions. |
|
Usuário | Nome de usuário no banco de dados criado para a integração. |
|
Senha | Senha de acesso do usuário no banco de dados. | - |
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)
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 |
Logs
A integração ainda não possui logs.
Resumo de funcionalidades
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Implantação de clientes ativos | Ativação (Implantar) cliente no OZmap de acordo com o que é informado pelo MKSolutions | MKSolutions => OZmap |
Remoção de clientes cancelados | Remoção no OZmap de clientes cancelados de acordo com o que é informado pelo MKSolutions, mantendo a propriedade conectada com o splitter no OZmap | MKSolutions => OZmap |
Atualização de dados do cliente | Atualização de nome e endereço de clientes no OZmap de acordo com o que é informado pelo MKSolutions | MKSolutions => OZmap |
Funcionalidades
Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.
Implantação de clientes ativos
Ativação (implantação) dos clientes ativos no OZmap baseado na leitura informada pelo MKSolutions, respeitando as regras abaixo:
São buscados todos os clientes ativos do MKSolutions, ou seja, clientes que tenham uma data de ativação e não tenham motivo de cancelamento no banco de dados do MKSolutions
Para cada cliente encontrado, buscamos um cliente no OZmap com um código semelhante ao código de contrato do MKSolutions
Caso seja encontrado, e o cliente no OZmap esteja em status “Não implantado” o campo do OZmap é atualizado para “implantado”
Remoção de clientes cancelados
Remoção dos clientes cancelados no OZmap baseado na leitura informada pelo MKSolutions, de acordo com as regras abaixo:
São buscados todos os clientes cancelados do MKSolutions, ou seja, clientes que tenham o motivo de bloqueio como cancelado (ou “8” no banco de dados) e tenham um contrato válido.
Para cada cliente encontrado, buscamos um cliente no OZmap com um código semelhante ao código de contrato do MKSolutions
Caso seja encontrado, o cliente é removido do OZmap, mantendo a propriedade conectada com o splitter no OZmap
Atualização de dados de clientes
Atualização de dados de clientes no OZmap baseado na leitura informada pelo MKSolutions, de acordo com as regras abaixo:
São buscados todos os clientes ativos do MKSolutions, ou seja, clientes que tenham uma data de ativação e não tenham motivo de cancelamento no banco de dados do MKSolutions
Para cada cliente encontrado, buscamos um cliente no OZmap com um código semelhante ao código de contrato do MKSolutions
Caso seja encontrado e o valor de nome e/ou endereço no OZmap esteja diferente do trazido pelo MKSolutions, esses campos são atualizados no OZmap
Questionário
Pergunta | Resposta | Funcionalidade |
|---|---|---|
É possível utilizar apenas algumas das funcionalidades acima? | Sim, mas apenas a atualização de nome e endereço de clientes é opcional | Atualização de clientes |
É possível desconectar o imóvel do splitter após cancelamento de cliente no OZmap? | Não, atualmente essa configuração é fixa em manter o imóvel conectado ao Splitter no OZmap | Remoção de clientes cancelados |
0 Comments