Page Comparison

...

Tipo de Integração

A integração OZmap-RBX é do tipo Ativa, desenvolvida pela equipe OZmap.

Descrição

O RBX é 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 RBX se baseiam na busca ao banco de dados disponibilizado pelo ERP, sendo essas funcionalidades a ativação, atualização de status e códigos e cancelamento de clientes no OZmap, com base nas leituras do RBX.

Dados Acesso

https://docs.google.com/forms/d/1UtFOKSpoxTkHO8MqGUfqW3e73x_0JLFXiWbAzJ47ZyA

RBX

Dados de acesso necessários para que a integração possa buscar informações via banco de dados no sistema RBX. (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 RBX.

...

190.113.10.3

...

Nome Banco de Dados

...

Nome do banco de dados disponibilizado pelo RBX.

...

isupporhs

...

Porta de acesso Banco de Dados

...

Porta de acesso ao banco de dados disponibilizado pelo RBX.

...

5432

...

Usuário

...

Nome de usuário no banco de dados criado para a integração.

...

rbx

...

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

...

10 minutos

Configurações Específicas

...

Parâmetro

...

Descrição

...

Padrão

...

Atualização de código de clientes no OZmap por transferência de contratos no RBX

...

Atualização de código no OZmap com base em pesquisa por transferência de contrato do cliente no RBX

...

Desativado

...

Atualização de código de clientes no OZmap por contratos ativos no RBX

...

do

...

RBX

...

Desativado

...

Remoção de clientes cancelados automaticamente

...

Remove clientes do OZmap com base na leitura de clientes cancelados no RBX

...

Desativado

...

Desconectar propriedade de splitter ao cancelar cliente no OZmap

...

Desconecta do splitter a propriedade de um cliente cancelado no OZmap automaticamente

...

Desativado

Logs

https://<cliente>.ozmap.com.br:17000/rbx/logs

Resumo de funcionalidades

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 RBX, respeitando as regras abaixo:

• São buscados todos os clientes que possuam registro simultaneamente nas tabelas de ClientesUsuarios, Contratos, Planos e radacct, além de possuírem tipo de plano "M" e NAS Central do Assinante no banco de dados RBX;

• Para cada cliente encontrado, buscamos um cliente no OZmap com um código semelhante ao código de contrato do RBX;

• Caso seja encontrado, esteja com situação de contrato ativo (“A”) no RBX e o cliente no OZmap esteja em estado de implantação “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 RBX, de acordo com as regras abaixo:

• São buscados todos os clientes que possuam registro simultaneamente nas tabelas de ClientesUsuarios, Contratos, Planos e radacct, além de possuírem tipo de plano "M" e NAS Central do Assinante no banco de dados RBX.;

• Para cada cliente encontrado, buscamos um cliente no OZmap com um código semelhante ao código de contrato do RBX.;

• Caso seja encontrado e esteja com situação de contrato cancelado (“C”) no RBX, o cliente é removido do OZmap, é adicionada uma observação na propriedade contendo o nome do cliente e data de remoção. Por padrão é mantida a propriedade no OZmap e a mesma fica conectada com o seu splitter no OZmap, mas caso o cliente deseje, há uma configuração específica para desconectar a propriedade do splitter em todos os cancelamentos.

Atualização de status de clientes

Atualização de status de clientes no OZmap baseado na leitura informada pelo RBX, de acordo com as regras abaixo:

• São buscados todos os clientes que possuam registro simultaneamente nas tabelas de ClientesUsuarios, Contratos, Planos e radacct, além de possuírem tipo de plano "M" e NAS Central do Assinante no banco de dados RBX;

• Para cada cliente encontrado, buscamos um cliente no OZmap com um código semelhante ao código de contrato do RBX;

• Caso seja encontrado e o status OZmap esteja diferente do status (StatusRadius) trazido pelo RBX, o status é atualizado. O valor de status segue o seguinte padrão:

Atualização de código de clientes

Atualização de código de clientes no OZmap baseado na leitura informada pelo RBX, de acordo com a configuração específica definida para isso e seguindo as regras abaixo:

• São buscados todos os clientes que possuam registro simultaneamente nas tabelas de ClientesUsuarios, Contratos, Planos e radacct, além de possuírem tipo de plano "M" e NAS Central do RBX.Assinante no banco de dados RBX;

• Para os clientes que possuem código no OZmap mas não foram encontrados no RBX por este código de contrato, é feita a atualização de códigos pela opção definida pelo cliente:

  • Caso o cliente use a configuração para buscar por contratos transferidos:

    • É buscado o contrato atual do cliente no RBX de acordo com o código no OZmap, e através do campo “TrasnferidoPara” no RBX, encontramos o contrato novo e, atualizamos então o código do cliente no OZmap com esse número de contrato.

  • Caso o cliente use a configuração para buscar por contratos ativos:

  Para cada cliente que foi encontrado e não tem um cliente no OZmap com um código semelhante ao RBX, é pesquisado o seu contrato novo para atualização do código respeitando as seguintes regras:

  • De acordo com a configuração do cliente (buscar ou não por transferência de contrato ou por contratos ativos), são buscados todos os contratos relacionados ao código ou somente um.

    • Se só um for buscado e este tiver um contrato para qual foi transferido para (campo “TransferidoPara”), o código do cliente no OZmap é mudado para esse qual foi transferido.

    • Se múltiplos forem buscados, é buscado o contrato RBX com código semelhante ao cliente no OZmap e todos os contratos abertos do cliente no RBX (situação de contrato ativo “A”) de acordo com esse código.

      Se o contrato RBX com código semelhante ao código de cliente no OZmap tem como situação cancelado (“C”) e

    • Só há um outro contrato aberto no RBX relacionado ao cliente: é buscado o imóvel do cliente do contrato cancelado e o cliente do contrato RBX aberto no OZmap

      • Se o imóvel OZmap do contrato RBX cancelado existir e o cliente OZmap do contrato RBX aberto não existir: o cliente OZmap cancelado é removido do imóvel e o cliente com contrato RBX aberto é criado no OZmap e movido para ele.

    Há múltiplos contratos abertos relacionados ao cliente no RBX: é buscado o imóvel do contrato RBX cancelado e os clientes OZmap relacionados a esses contratos RBX abertos

    Se a propriedade do contrato RBX cancelado existir e só existir um cliente existente no OZmap com código semelhante aos contratos RBX abertos: o cliente OZmap cancelado é removido da propriedade e o cliente com contrato aberto é criado e movido para ele

    É verificado se o cliente tem mais de um contrato no RBX, se o contrato referente ao código do cliente no OZmap está cancelado no RBX e se existe algum outro contrato novo ativo:

    • Se existir somente um contrato ativo, atualiza o código do cliente no OZmap com o número deste contrato ativo

    • Se existirem múltiplos contratos ativos, pesquisa por contratos RBX deste cliente que não possuem cliente com código semelhante no OZmap, se só existir um mesmo, atualiza o código deste cliente no OZmap, usando este código de contrato RBX que não estava atrelado a nenhum cliente OZmap. Se existir mais de um cliente nessas condições no OZmap, não é possível fazer a atualização de código.

Configurações Base

Configurações Específicas

Dados Acesso

https://docs.google.com/forms/d/1UtFOKSpoxTkHO8MqGUfqW3e73x_0JLFXiWbAzJ47ZyA

RBX

Dados de acesso necessários para que a integração possa buscar informações via banco de dados no sistema RBX. (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)

Logs

https://cliente.ozmap.com.br/integrations/rbx/logs

Questionário