Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 26 Next »

Essa documentação trata do serviço externo RBX. 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.

Tipo de Integração

A integração OZmap-RBX é do tipo Ativa.

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:

Error rendering macro 'excerpt-include' : No link could be created for 'IN:Base variables'.

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

Atualização de código do cliente no OZmap com base em pesquisa por contratos ativos do cliente no 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

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 RBX

RBX => OZmap

Remoção de clientes cancelados

Remoção no OZmap de clientes cancelados de acordo com o que é informado pelo RBX

RBX => OZmap

Atualização de status de conexão do cliente

Atualização de status de conexão de clientes no OZmap de acordo com o que é informado pelo RBX

RBX => OZmap

Atualização de código de cliente

Atualização de código de clientes no OZmap de acordo com o que é informado pelo RBX

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

  • São buscados todos os clientes do 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 do 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 do 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:

Status (StatusRadius) RBX

Status OZmap

Conectado

OK (0)

Desconectado

ERROR (1)

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 do RBX.

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

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

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

    • É 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 ativo, atualiza o código do cliente no OZmap

      • Se existir múltiplos ativos, pesquisa contratos que não possuem cliente no OZmap, se só existir um, atualiza o código do cliente no OZmap

Questionário

Pergunta

Resposta

Funcionalidade

É possível desconectar o imóvel do splitter após cancelamento de cliente no OZmap?

Sim, a desconexão do imóvel após cancelamento é uma configuração disponível

Remoção de clientes cancelados

  • No labels