Integração LIV & SPC Brasil (CDL)

Conectamos o nosso sistema, o Solus, diretamente com o SPC Brasil para manter suas informações sempre atualizadas. Essa integração garante que os dados dos clientes sejam incluídos ou removidos do cadastro do SPC de forma automática e segura, através de uma tecnologia chamada WebServices.

• Fluxos
• Fluxo da integração - Inclusão
• Fluxograma integração - Exclusão
• Ambiente
• Arquitetura
• BotSpcLiv

Fluxos

Fluxo da integração - Inclusão

Segue abaixo desenhos do fluxo de integração entre sistema Solus e SPC.

Fluxo de Inclusão no SPC

Detalhamento do fluxo de inclusão:

Registra Envio para SPC: O setor Financeiro da LIV identifica as mensalidades em atraso e registra essa informação no sistema Solus, marcando-as para inclusão no SPC. Leitura adicional recomendada: Envio de mensalidades para SPC

Identifica Nova Inclusão: O BotSpcLIV monitora periodicamente se existe alguma mensalidade nova para ser incluída no SPC. A verificação é realizada através dos campos de "Data de Envio ao SPC" e "Natureza da Inclusão no SPC", considerando sempre que a "Data de Envio ao SPC" é a data de hoje. 

Envia Inclusão Web Service SPC: O BotSpcLiv requisita o Web Service do SPC Brasil para nova inclusão. Se a integração ocorrer com sucesso seguimos para o processo "Registra Atendimento de Cobrança", se não seguimos para o processo "Registra Erro de Inclusão".

Limpa Data e envio e Natureza de inclusão: Em caso de erro no processo de integração o BotSpcLiv vai limpar (deixar nulo) os campo "Data de Envio ao SPC" e "Natureza da Inclusão no SPC" da mensalidade.

Registra Erro de Inclusão: Em caso de erro no processo de integração o BotSpcLiv vai registrar os erros na base de dados do Solus, que estarão disponíveis para a operação através do relatório customizado "INTEGRAÇÃO SPC - ERROS".

Verifica Relatório de Monitoramento: O relatório de erros de integração SPC deve ser emitido para verificar se há mensalidades com algum erro no processo de inclusão. O relatório customizado esta disponível em "Relatórios personalizados / Cobrança / INTEGRAÇÃO SPC -ERROS", note imagem abaixo.

Corrige erros de cadastro/operacionais: A operação deve verificar a causa dos erros no processo de integração. Geralmente esses erros estão associados a problema de cadastros, como CEP invalido ou tentativa de inclusão de um contrato/mês já negativado. Esses erros devem ser corrigidos pela operação e após seguir novamente par ao processo "Registra Envio para SPC"

Registra Atendimento de Cobrança: Caso a integração ocorra com sucesso, incluindo a negativação no SPC, então o Bot de Cobrança (BOTICC) vai realizar o registro de atendimento de cobrança vinculado ao contrato/mensalidade para evidenciar no histórico de atendimento do contrato a inclusão no SPC Brasil. Aqui se conclue o fluxo de inclusão.

 

 

 

Fluxograma integração - Exclusão

Segue abaixo desenhos do fluxo de integração entre sistema Solus e SPC.

Fluxo de Exclusão no SPC

 

Detalhamento do fluxo de exclusão:

Registra Saída do SPC: O setor Financeiro da LIV identifica as mensalidades que devem ter a negativação removida do SPC Brasil.. Leitura adicional recomendada: Retirar contrato do SPC

Identifica Registro de Saída: O BotSpcLIV monitora periodicamente se existe alguma mensalidade para ser excuída no SPC. A verificação é realizada através dos campos de "Data de Saída do SPC" e "Motivo de Exclusão", considerando sempre que a "Data de Saída do SPC" sendo a data de hoje. 

Envia Exclusão Web Service SPC: O BotSpcLiv requisita o Web Service do SPC Brasil para nova exclusão. Se a integração ocorrer com sucesso seguimos para o processo "Registra Atendimento de Cobrança", se não seguimos para o processo "Registra Erro de Exclusão".

Registra Erro de Exclusão: Em caso de erro no processo de integração o BotSpcLiv vai registrar os erros na base de dados do Solus, que estarão disponíveis para a operação através do relatório customizado "INTEGRAÇÃO SPC - ERROS".

Verifica Relatório de Monitoramento: O relatório de erros de integração SPC deve ser emitido para verificar se há mensalidades com algum erro no processo de exclusão. O relatório customizado esta disponível em "Relatórios personalizados / Cobrança / INTEGRAÇÃO SPC -ERROS", note imagem abaixo.

Corrige erros de cadastro/operacionais: A operação deve verificar a causa dos erros no processo de integração. Geralmente esses erros estão associados ao registro não encontrado para a exclusão. Esses erros devem ser corrigidos pela operação e após seguir novamente par ao processo "Registra Envio para SPC".

Registra Atendimento de Cobrança: Caso a integração ocorra com sucesso, escluindo a negativação no SPC, então o Bot de Cobrança (BOTICC) vai realizar o registro de atendimento de cobrança vinculado ao contrato/mensalidade para evidenciar no histórico de atendimento do contrato a exclusção no SPC Brasil. Aqui se conclue o fluxo de exclusão.

 

 

 

Ambiente

Arquitetura

Descrição da Arquitetura da Integração

 

1. Base de Dados Solus (Oracle): Fonte de onde são coletadas as informações de contratos ou clientes que precisam ser incluídos/excluídos do SPC Brasil. Essa base armazena as informações dos registros e também os logs de integração gerados pelo bot.

2. BotSpcLiv - Serviço de Integração: Código em Java que faz a ponte entre o Solus e o SPC Brasil. Esse serviço:

   • Realiza a consulta na base de dados do Solus.
   • Monta e envia as requisições para os Web Services do SPC Brasil.
   • Processa as respostas dos serviços, registrando sucesso ou falha.

3. Web Services do SPC Brasil: WebService (SOAP) externas do SPC que recebem as informações e retornam uma resposta sobre o status da negativação.

4. Bot de Cobrança: Um componente adicional que monitora o fluxo da integração. Ele verifica o status das requisições e registra, no banco de dados Solus, um atendimento de cobrança evidenciando a negativação do contrato ou exclusão do SPC.

Fluxo Básico

• Passo 1: Serviço de integração coleta informações do Solus.
• Passo 2: Envia a solicitação de inclusão/exclusão da negativação para o SPC Brasil via Web Service.
• Passo 3: Web Service do SPC Brasil processa e retorna o status (sucesso ou erro).
• Passo 4: O bot de cobrança registra no Solus o atendimento evidenciando o processo de inclusão/exclusão no SPC tenha ocorrido com sucesso.

 

BotSpcLiv

BotSpcLiv é uma Solução desenvolvida em Java para comunicação entre a Base de dados (Oracle) do sistema Solus e o Web Service (SOAP) do SPC Brasil.

Repositório do código: https://sistemasicc@bitbucket.org/sistemasicc/botspcliv.git

Esse serviço está rodando atualmente no servidor 192.168.1.123, dentro do diretório "/home", através do crontab, que fica responsável pela execução do "botspcliv.jar"

Consulte os dados de conexão ao servidor em
\\srvfs-01\Setores\TI\Projeto Tasy\PROCEDIMENTOS TECNICOS\DOCUMENTOS\CONEXÕES.txt

Crontab:

Observe que, pela configuração realizada, o crontab vai realizar a execução do botspcliv.jar a cada 10 minutos.

Diretório:

Diretório de Logs:

Os logs do processo de integração são guardados dentro do diretório "/home/logsbotspcliv"

Embora os arquivos de logs estejam com a extenção ".botspcliv", são arquivos de texto simples e podem ser abertos por qualquer editor de texto.