Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Image Modified

CONTEÚDO


  1. Visão Geral
  2. Parametrização
  3. Manutenção de Liberações
  4. Fluxo de eventos (Explicação)

...

  1. Tela de Certificado
  2. Tela de Servidor
  3. Tela de Arquivos
  4. Tela de Liquidação
  5. Tela Listagem dos Arquivos
  6. Tela Popup Layout Arquivo
  7. Tela Liquidação Antecipada
  8. Tela Listagem dos Arquivos
  9. Tela Popup Importar os arquivos Recebidos
  10. Tela detalhamento dos arquivos da solicitação de Arquivos
  11. Tabelas Utilizadas





01. VISÃO GERAL

Foram introduzidas melhorias significativas no módulo de ConsignadoSistema referente a Autorregulação FEBRABAN, visando simplificar o acompanhamento, manutenção e a troca de informações relacionadas aos correspondentes bancários e operações de crédito consignado. Além disso, foram adicionadas funcionalidades para consultar e avaliar os correspondentes, contribuindo para a tomada de decisões e para o cumprimento das diretrizes da Autorregulação pelas instituições participantes.Image Removed.

A FEBRABAN e a ABBC celebraram uma Convenção para a constituição de uma Autorregulação voltada para as operações de empréstimo pessoal e cartão de crédito com pagamento mediante consignação.
O Sistema de Autorregulação constituído pela Convenção também estabelece o “Documento Correlato de Boas Práticas de Operações de Empréstimo Pessoal e Cartão de Crédito mediante consignação”, o qual determina procedimentos mínimos a serem seguidos pelas Instituições Financeiras aderentes, visando a melhoria da qualidade, transparência, segurança e eficiência nos processos de oferta e contratação de operações de consignado, no País.

• SRCC – Abreviação utilizadas nos documentos e manuais CIP para o Serviço de Registro de Crédito Consignado.

Neste contexto, o serviço SRCC surge com o objetivo a centralização dos eventos definidos pelo Comitê Gestor da Autorregulação do Crédito Consignado como sendo possíveis meios de contorno às boas práticas definidas na autorregulação, possibilitando assim que as Instituições Financeiras signatárias tenham um serviço complementar aos mecanismos já existentes, que possibilite identificar a existência destes eventos e assim tomar a melhor decisão no sentido de cumprir o que estabelece as boas práticas definidas na autorregulação, relacionadas ao comissionamento dos Correspondentes Bancários.

Destina-se à todas as Instituições Financeiras aderentes à CONVENÇÃO DO SISTEMA DE AUTORREGULAÇÃO DE OPERAÇÕES DE EMPRÉSTIMO PESSOAL E CARTÃO DE CRÉDITO COM PAGAMENTO MEDIANTE CONSIGNAÇÃO celebrada entre ABBC e FEBRABAN.

OPERACIONALIZAÇÃO DO PROCESSO

Sempre que uma instituição aderente à autorregulação realizar operações que utilizam um Corban e gerar comissionamento, ela deverá consultar o Registro de Crédito Consignado.

Assim, a instituição poderá apurar se há registro de eventos que configurem más práticas, vedando o pagamento da referida comissão ao Corban.

REGISTRO

O registro ocorre quando a instituição aderente à autorregulação envia as informações referentes às operações de consignado, que teve liquidação antecipada, portabilidade ou refinanciamento
decorrentes de portabilidade com redução de parcela.

CONSULTA

A consulta acontece quando a instituição responsável pelo Corban que realizou uma nova operação de consignado verifica se essa operação é passível de ser comissionada. Desta forma, pode ser consultada toda nova operação de consignado que vier a ser originada pelo canal correspondente, e outras situações específicas em que não seja possível a instituição definir previamente se é devida ou não a remuneração ao Corban.


Projetos envolvidos: 

Sistema

Versão

ConsignadoSPACG_5.4.0
Consignado ServiceJSCG_4.4.0
Consignado SB ServiceJSBCG_1.0.0



Principais mudanças envolvidas nessas implementações:

  • Inclusão de novos meios de pagamentos: "Ordem de pagamento PIX" e "Lançamento C/C Online". Alteração da nomenclatura do antigo meio "Lançamento C/C" para "Lançamento C/C Batch" 
  • Adicionado tratamento no processo de efetivação (*) para separar os lançamentos de liberação parametrizados com os novos meios de pagamentos para que sejam postados em uma fila para tratamento específico e a parte.
  • Adicionado uma nova estrutura de processamento que obtêm os dados das liberações da fila e faz a comunicação online a depender do tipo de pagamento.
    • Nos casos parametrizados com "Lançamento C/C Online", o fluxo irá efetuar a chamada diretamente ao módulo Conta Corrente através de APIs para realizar a movimentação do crédito.
    • No caso do "Ordem de Pagamento PIX", o fluxo irá efetuar a chamada às nossas APIs do integrador TOTVS SPI para assim efetuar uma comunicação com o BACEN. 
  • Adicionado uma estrutura de processamento para tratamento do retorno das chamadas efetuadas, no caso do PIX, tratamento da confirmação da execução da ordem de pagamento. 
  • Uma tela nova para manutenção das liberações, possibilitando a visualizar, editar e controlar a execução das liberações. Essa tela estará disponível no menu Liberações do módulo Operações de Crédito na versão Wildfly Keycloak.

...

  • Adição de novo campo "FINALIDADE" na tela de certificados (Módulo Consignado - Configuração Externa - Certificado) passíveis de seleção os seguintes domínios(EXTERNO, INTERNO).
  • Adição de novo campo "FINALIDADE" na tela de servidores (Módulo Consignado - Configuração Externa - Servidores) passíveis de seleção os seguintes domínios(EXTERNO, INTERNO).
  • Adição de novo campo "FINALIDADE" na tela de oAuth (Módulo Consignado - Configuração Externa - OAuth passíveis de seleção os seguintes domínios(EXTERNO, INTERNO).
  • Adição de novo campo "FINALIDADE" na tela de canal de atendimento (Módulo Consignado - Parâmetros - Canal de Atendimento) passíveis de seleção os seguintes domínios(EXTERNO, INTERNO).
  • Adição de novo campo "FINALIDADE" na tela de canal de atendimento (Módulo Consignado - Parâmetros - Canal de Atendimento) passíveis de seleção os seguintes domínios (EXTERNO, INTERNO).
  • Adição de novo campo "FINALIDADE" na tela de Canal de Liquidação (Módulo Consignado - Parâmetros - Canal de Liquidação) passíveis de seleção os seguintes domínios (EXTERNO, INTERNO).
  • Adição de novo campo "FINALIDADE" na tela de Refinanciamento (Módulo Consignado - Empréstimo - Refinanciamento) passíveis de seleção os seguintes domínios (EXTERNO, INTERNO).
  • Adição de novo campo "FINALIDADE" na tela de Solicitação Averbação (Módulo Consignado - Empréstimo - Solicitação Averbação) passíveis de seleção os seguintes domínios (EXTERNO, INTERNO).
  • Adição de novo campo "FINALIDADE" na tela de Exclusão (Módulo Consignado - Portabilidade - Exclusão) passíveis de seleção os seguintes domínios (EXTERNO, INTERNO).
  • Adição de novo campo "FINALIDADE" na tela de Solicitação Averbação (Módulo Consignado - Portabilidade - Solicitação Averbação) passíveis de seleção os seguintes domínios (EXTERNO, INTERNO)

...

  • .




Histórico de Atualizações:

DataVersãoDescrição
08

02JBA_

JSBA_4.12.15,

SPACG_5.

10

4.

5
  • Inclusão dos meios de pagamentos no básico.
  • Criação de serviço para a listagem dos meios de pagamento.
25/03

0

Consignado

JSBCREDPAG
JSCG_
1
4.
1
4.0
JSBCREDEF_1.3.0, JSCF_4.18.0, JCF_5.17.0, JSBA_4.12.15, JBA_5.10.5
  • Entrega da solução principal.
  • Alterações na efetivação para tratamento das liberações.
  • Adição de parametrização. processamentos e eventos para processamento das liberações.
  • Tratamento de retorno das respostas das liberações.

Consignado Service

JSBCG_1.0.0

Consignado SB Service



02. PARAMETRIZAÇÃO

Para uso das funcionalidades implementadas será preciso alguns pequenos passos antes. 

  • Parametrização do meio de pagamento adequado (no módulo básico) para posterior seleção na momento da inclusão da liberação.
  • Parametrização do histórico de transferência da função histórico de liberações escolhida para a modalidade (no módulo backoffice de crédito - modalidade). 
  • Parametrização da chave PIX na conta do cliente favorecido (no módulo backoffice de crédito - contas) (somente para pagamentos PIX).
  • Parametrização para permitir pagamentos antes da efetivação (caso seja do modelo de negócio da instituição).

Mais detalhes de cada uma das parametrizações acima estão disponíveis no documento de referência: (DR - Configurações da Liberação de Crédito (online))

03. MANUTENÇÃO DE LIBERAÇÕES

Uma tela para manutenção das liberações para facilitar a visualização, edição e mesmo o envio das liberações em caso de problemas.

Em um fluxo natural dessas implementações, durante a efetivação de uma operação, é realizado o envio das liberações aos seus destinos (seja ele lançamento em conta TED ou PIX), esse processo iniciando automaticamente ao final da efetivação. Quando ocorrer algum erro, seja por preenchido de conta inválida, bloqueada, ou mesmo erro pontual em alguma chamada, a liberação fica ainda gravada e através da tela de manutenção é possível alterar alguns dados de liberações não realizadas, e enviar novamente para realizar a transferência.  

Esta nova tela localizada no módulo Operação de Crédito, mais especificamente no menu Liberações > Manutenção de Liberações. Esta tela possui as opções Visualizar, Alterar e Reprocessar.

Image Removed
Image Removed
Image Removed

...

  • Configurar os Certificados corretamente informando a finalidade correta do Certificado.
  • Configurar os Servidores corretamente informando a finalidade correta do Servidor.  
  • Configurar os Arquivos corretamente informando a finalidade correta do Arquivo.



03. TELA DE CERTIFICADO

Foi adicionado um novo campo na tabela de Certificados (T410CERT) chamada Finalidade. Esta coluna receberá os valores (D - INTERNO, S - SRCC).
Este ajuste foi realizado no Consignado e Consignado Service para ser utilizado no front-end. Esta alteração consiste também na adição do objeto tipoFinalidade nos serviços de gerenciamento de certificados contemplando todo o CRUD (GET, POST, PUT e DEL).


Módulo Consignado - Configuração Externa - Certificado

Image Added


Inclusão de Certificado

Image Added



04. TELA DE SERVIDOR

Foi adicionado um novo campo na tabela de Servidores (T410SERV) chamada Finalidade. Esta coluna receberá os valores (EXTERNO, INTERNO).
Este ajuste foi realizado no Consignado e Consignado Service para ser utilizado no front-end. Esta alteração consiste também na adição do objeto tipoFinalidade nos serviços de gerenciamento de servidores contemplando todo o CRUD (GET, POST, PUT e DEL)

Módulo Consignado - Configuração Externa - Servidor

Image Added


Nova Inclusão de Certificado

Image Added


05. TELA DE ARQUIVO

Foi adicionado uma tela para registro das configurações do uso de arquivos no sistema do Consignado. Essa tela tem como objetivo armazenar a localização de pastas no servidor para que o sistema de geração de interfaces possa desempenhar a função de leitura do arquivos de retorno.

Módulo Consignado - Configuração - Arquivo

Image Added


Nova Inclusão de novo registro

Image Added

Image Added


06. TELA DE LIQUIDAÇÃO

Foi adicionado uma telapara parametrizar os canais de liquidação, o Canal da Liquidação será de preenchimento obrigatório quando o “Tipo do Evento” for “Liquidação Antecipada” (1- Boleto, 2- Transferência Bancária, 3- Conta Corrente (Débito em Conta), 4- Outros). 

Módulo Consignado - Parâmetros - Canal Liquidação

Image Added

Inclusão de um novo registro

Image Added

Image Added


07. TELA LISTAGEM DOS ARQUIVOS

Foi adicionado uma nova tela para registro das configurações do uso de arquivos no sistema do Consignado. Essa tela tem como objetivo armazenar a localização de pastas no servidor para que o sistema de geração de interfaces possa desempenhar a função de leitura dos arquivos de retorno.
A tela deverá transitar entre uma tela de listagem e uma tela detalhe para cadastro, visualização e edição do registro

Módulo Consignado - Arquivo - Processamento

Image Added



08. TELA POP-UP

Foi adicionado uma tela pop-up para geração de novo arquivo RCC0001, somente a opção de arquivo ARCC001 deve estar disponível ao selecionar a opção de tipo de layout de arquivo, devera aparecer o filtro de datas (adicionar mais informações).

Módulo Consignado - Arquivo - Processamento - Adicionar Novo

Image Added

Inclusão de novo registro

Image Added


Image Added

Image Added



09. TELA DE LIQUIDAÇÃO ANTECIPADA

Foi adicionada uma tela para armazenar informações da data da liquidação e canal de liquidação, quando a exclusão possuir motivo liquidação por antecipação.

Módulo Consignado - Empréstimo - Solicitação Averbação - Ação Excluir

Image Added


Image Added

Image Added

Image Added



Image Added



10. TELA LISTAGEM ARQUIVO

Foi adicionado uma tela para visualização detalhada do processamento do arquivo, serão exibidas as informações referentes ao processamento, arquivo, conteúdo do arquivo e logo do processamento.


  • Detalhe do processamento

Mostrar os campos situação, etapa, tipo de layout e hora de criação. Também deve ser exibida a lista de arquivos. Nela visualizaremos os campos nome do arquivo, situação, tipo, data de criação e as funções de visualizar detalhe e download do conteúdo. A lista de arquivos deve estar em ordem descrente pela data de criação.


  • Detalhe do arquivo

Mostrar os campos nome do arquivo, situação, tipo, layout, data criação e data atualização e um botão para download do conteúdo. Também deve ser exibida a lista de logs de processamento. Nela visualizaremos os campos tipo, descrição do log e as função de visualizar detalhe. A lista de logs deve estar em ordem descrente pela data de criação.


  • Detalhe do log

Mostrar os campos tipo, descrição do log e descrição da exceção.

Módulo Consignado - Arquivo - Processamento - Adicionar novo

Image Added

Selecionar o Tipo de Layout

Image Added

Consulta de data

Image Added

Image Added



Image Added



11. TELA POP-UP PARA IMPORTAR OS ARQUIVOS RECEBIDOS

Foi adicionado um botão Popup para importar os arquivos recebidos para olhar a pasta leitura de arquivos, somente será feito a leitura dos que forem ARCC001. 

Módulo Consignado - Arquivo - Processamento - Importar

Image Added

Image Added

Image Added




12. TELA PARA DETALHAMENTO DOS ARQUIVOS DA SOLICITAÇÃO DE ARQUIVOS 

Tela para visualização detalhada do processamento do arquivo. Serão exibidas as informações referentes ao processamento, arquivo, conteúdo do arquivo e log do processamento, Mostrar os campos nome do arquivo, situação, tipo, layout, data criação e data atualização e um botão para download do conteúdo. Também é  exibida a lista de logs de processamento, nela visualizamos os campos tipo, descrição do log e as função de visualizar detalhe.

Módulo Consignado - Arquivo - Processamento 

Tela processamento:

Image Added

Lista dos Arquivos:

Image Added


Detalhe:

Image Added


Tela aquivo:

Image Added



Tela aquivo Logs:

Image Added


13. TABELAS UTILIZADAS 

Banco de dados

Tabela

ConsignadoExclusão Portabilidade
ConsignadoSolicitação de Averbação
ConsignadoMotivo Exclusão Emprestimo
ConsignadoSolicitação Pendente SRCC
ConsignadoExclusão Liquidação Antecipação

Consignado

Solicitação Pendente SRCC LOG

Consignado

Solicitação Refinanciamente

Consignado

Contrato Solicitação Refinanciamento

Consignado

Canal

Consignado

Configuração Arquivo

Consignado

Arquivo Processamento

Consignado

Certificado

Consignado

Arquivo

Consignado

Banco

Consignado

Servidor

...

Image Removed

      VISUALIZAR

Na tela detalhe é possível visualizar o último processamento de envio e retorno de cada liberação, além de detalhes do favorecido, da conta e do valor liberado. 

Image Removed

Image Removed

Clicando na lupa de cada evento é possível visualizar o log desse evento, para que seja possível visualizar o log do tipo INFORMAÇÃO ou ERRO.

Image Removed

      ALTERAR

...

Image Removed

Image Removed

Image Removed

      REPROCESSAR

Na tela de reprocessamento irá mostrar as informações e será feito o reprocessamento da liberação selecionada.

Image Removed

Image Removed

04. FLUXO DE EVENTOS (Explicação)

Para facilitar a execução principalmente na questão de performance, o fluxo dos acontecimentos da liberação foi implementada através de eventos. Um evento nada mais é que eu conjunto de tarefas que serão executadas e tratadas de maneira assíncrona, por vezes sendo executadas em paralelo. Desse modo, é possível verificar os detalhes de cada passo, reexecutar procedimentos sem maiores impactos e tratar problemas pontualmente.  

Um registro de liberação (gravado na tabela T402MLIB - Movimento de Liberação) passa diversas situações até que se confirme a liberação efetiva do valor. É possível verificar essas atualizações através das colunas situação da liberação (ID_SIT_LIB) e situação de autorização (ID_SIT_AUT).
Ao gravar um liberação na base, ela entrará na situação PENDENTE (em ambos as colunas). Durante o processamento dos eventos, essas colunas serão atualizadas conforme o processo avança corretamente:
Situação da liberação: PENDENTE (P) e ENVIADO (E)
Situação de autorização: PENDENTE (P), CONFIRMADO (C), BAIXADO (B)

Durante a efetivação da operação (momento em que a operação se torna ativa), os valores a serem liberados que foram parametrizados com os novos meios de pagamento serão separados e colocados em uma fila para outro processo faça a leitura.

O processamento das liberações selecionadas consistirá em duas etapas, o envio da liberação e o retorno da confirmação. Através dos eventos abaixo:

Image Removed

  • Envio das liberações
    • Início do processamento
      • Leitura da fila de liberações selecionadas,
      • Montagem dos eventos (registros nas tabelas de eventos T402PROC e EVTO),
      • Atualização da situação do processamento (para PROCESSANDO).
      • Chama o evento 1.
    • Evento 1: Inicia liberação
      • Atualiza a situação da liberação e da autorização da T402MLIB para P.
      • Verifica se a situação da liberação e da autorização da T402MLIB está como E. Caso esteja não será possível realizar o processamento.
      • Chama o evento 2.
    • Evento 2: Define o tipo de liberação.
      • Verifica se é PIX ou C/C e chama o evento respectivo, eventos 3 ou 4.
    • Evento 3: Enviar liberação PIX
      • Obtém os dados da liberação e monta a chamada para as APIs do integrador TOTVS SPI.
      • Atualiza a situação da liberação para ENVIADO.
      • Finaliza chamando o evento 6 para encerrar o processamento.
    • Evento 4: Enviar liberação C/C
      • Obtêm os dados e monta a chamada para o C/C Digital (produto Dimensa).
      • Atualiza a situação da liberação para ENVIADO.
      • Finaliza chamando o evento 5 para o envio da confirmação direta.
    • Evento 5: Enviar pagamento liberação
      • Com os dados da liberação, coloca em uma fila para tratar o retorno da liberação.
      • Atualmente utilizado apenas para um lançamento C/C, pois o lançamento PIX é retornado através de outra fila.
    • Evento 6: Finalizar processamento de liberação
      • Atualiza situação do processamento para PROCESSADO

Qualquer cenários que resulte em erro no processamento, a situação da liberação permanece PENDENTE (P), enquanto o processamento irá parar e retornar o erro nos logs de evento da T402EVLO. 

A partir do envio da liberação, o sistema estará esperando resposta de confirmação para enfim confirmar a situação da liberação. Esse retorno se dá através dos eventos abaixo:

...

  • Retorno das liberações
    • Início do processamento
      • Leitura da fila de liberações respondidas, 
      • Montagem dos eventos (registros nas tabelas de eventos T402PROC e EVTO), Tipo do processamento: 7 - Ordem de liberação de pagamento.
      • Atualização da situação do processamento (para PROCESSANDO).
      • Chama o evento 1.
    • Evento 1: Tratar retorno do processamento da liberação.
      • Verifica a situação respondida pelo processo externo (resposta da ordem de pagamento PIX ou da execução do C/C nos casos citados)
      • Atualiza a situação de autorização para CONFIRMADO.
    • Evento 2: Efetivar conta vinculada da liberação.
      • Quando a operação necessita informar uma entrada ou saída de valor do Credimaster, gravamos na tabela T402COTM - Conta Transitória Movimento. Esse registro de lançamento é tratado pelo processo batch de troca de arquivos e enviado para outro sistema (na maioria dos caso, para atualizar o C/C da própria Dimensa ou um C/C externo do cliente). As implementações aqui visam disponibilizar uma opção online para essa necessidade, portanto, alguns tratamento precisam ser feitos. 
      • Atualiza a situação do registro de lançamento da conta transitória para PROCESSADO para que o lançamento concluído de forma online não seja feito pelo processo batch de arquivos.
      • Atualiza a situação de autorização para BAIXADO.
    • Evento 3: Finalizar ordem de liberação do pagamento.
      • Atualiza situação do processamento para PROCESSADO

Qualquer cenários que resulte em erro no processamento de retorno, a situação de autorização é atualizada para ERRO (R), enquanto o processamento irá parar e retornar o erro nos logs de evento da T402EVLO. 

05. TABELAS UTILIZADAS

TabelaDescriçãoT402MLIBMovimento LiberaçãoT402COTMConta Transitória MovimentoT402PRLIProcessamento Liberação (Fluxo de envio) T402PRLSProcessamento Liberação Situação (Fluxo de envio) T402PRLHProcessamento Liberação Histórico (Fluxo de envio) 

T402OLPG

Ordem de liberação de Pagamento (Fluxo de retorno)

T402OLPS

Ordem de liberação de Pagamento Situação (Fluxo de retorno)

T402OLPP

Ordem de liberação de Pagamento Processamento (Fluxo de retorno)

T402PROC

Processamento

T402EVTO

Eventos

T402EVLO

Log Eventos

T402COMM

Conciliação dos dados entre T402MLIB e T402COTM

T402LORE

Log de Requisição Externa