MCP - Integração SPC Brasil

Descrição

O SPC Brasil é o Serviço de Proteção ao Crédito do Brasil, desempenha um papel fundamental como uma das principais instituições de crédito e proteção ao consumidor no país. Ele opera mantendo um registro completo de pessoas e empresas que possuem dívidas em atraso. Quando alguém não cumpre com seus compromissos financeiros, como o pagamento de contas ou empréstimos, essas informações são registradas no SPC. Esse registro pode impactar negativamente sua capacidade de obter crédito no futuro. O sistema Construshow, por sua vez, tem a finalidade de facilitar o processo de registro dessas pessoas que se encontram inadimplentes.


Índice


Pré-Requisitos

  • Entrar em contato com o SPC Brasil e contratar este serviço.

  • Configurar as credenciais que a SPC Brasil irá repassar no sistema Construshow.


Passo a passo

  1. Configurações
    Após obter as credenciais junto a SPC Brasil é necessário configurá-las no sistema Construshow. Em Configurações >> Gerais >> Filial - Integrações, deve ser informado os campos, sendo todos como obrigatórios:

  • Ambiente: Homologação ou Produção;

  • Usuário: Usuário de acesso a API, obtido junto a SPC Brasil;

  • Senha: Senha de acesso a API, obtido junto a SPC Brasil;

  • Entidade: Código da Entidade, obtido junto a SPC Brasil;

  • Associado: Código do Associado obtido junto a SPC Brasil;

  • Motivo Remoção: Motivo padrão que será utilizado ao realizar a remoção automática de um registro no SPC Brasil.

No ‘F3’ da pesquisa lista as opções dos motivos, não há um cadastro de motivos no sistema, essa listagem é retornada pelo SPC Brasil.

  1. Após realizar a configuração, será necessário configurar o Jobs que irá realizar o envio e o retorno dos dados:

  • A configuração pode ser realizada através da rotina 'Cadastros >> Agendador de Tarefas', o Job relacionado é o SPCBrasil. Com dois cliques em cima, é possível realizar a configuração dos dias e horários em que a tarefa agendada será executada.

  • É necessário que o serviço de Job esteja em execução e caso seja alterada a configuração do Agendador, é preciso reiniciar o serviço. Este Job deverá ter o checkbox ‘Inativo’ desmarcado para iniciar a execução.

O Job SPCBrasil será executado conforme a definição de dias e horário no Agendador, ao executar será realizado o envio das duplicatas e cheques que estão na fila e retornará o status deste envio. Ao ser executado, caso tenha algum registro que foi enviado e que já foi baixado no sistema, automaticamente este registro será removido do SPC.

Como forçar a execução do Job manualmente

Caso seja necessário executar o Job manualmente, sem aguardar o horário configurado, em ‘Status’ basta selecionar a Tarefa agendada do SPCBrasil e executar a tarefa, desta forma, o Job estará sendo forçado em sua execução, podendo ser utilizado quando for necessário buscar informações fora do horário agendado.

Filtros da rotina SPC Brasil

  1. A rotina se encontra no menu: Financeiro >> Integração SPC Brasil. Nesta tela, será possível listar as Duplicatas Vencidas de uma ou mais Pessoas filtrando pela ‘Data de Vencimento’ e 'Estabelecimento'.
    No grid, será listado informações de envio dos registros ao SPC e também informações das duplicatas como: Cliente, Data, Valor, Multa, Juros, Valor Baixado, A receber, Portador, atraso (dias) e Situação.

  1. Na rotina também lista os Cheques Recebidos de acordo com a Data de Bom Para filtrada. É listado somente cheques em que os status não sejam Pendentes (A), Baixados (B), Compensados (C) e Acertados (R), demais cheques são listados para sejam enviados ao SPC, exceto cheques cuja 'Data de Bom Para' seja posterior a data atual, visto que nesses casos o cheque ainda não foi compensado.

  1. Em 'Consulta Registro’ permite filtrar por Pessoa , por data e visualizar os registros:

  • Pendentes - Registros pendentes de envio à SPC Brasil.

  • Enviados - Registros (inclusões e remoções) já enviados à SPC Brasil.

  • Removidos - Registros (remoções) já enviados à SPC Brasil.

  • Todos - Todos os registros.

Registro de Duplicatas ao SPC

Passo a Passo

  1. No exemplo abaixo, será realizado o envio do registro de Duplicatas ao SPC. É filtrada as duplicatas vencidas desejadas e marcadas as que serão enviadas.

  1. Posteriormente, serão ‘Enviadas à fila’, neste momento, é preciso informar a ‘Natureza de Inclusão’ desses registros e também o ‘Tipo do devedor’ e enviar esses 3 registros para a fila. Através do ‘F3’ é possível visualizar as opções de Natureza e de Devedor.

  1. Esses registros ficarão com a data e hora de inclusão ao SPC, porém, os registros serão realmente enviados ao SPC, após a execução da tarefa agendada, conforme data e horário definido para a execução.

  1. Logo após a execução da tarefa agendada, ao clicar em ‘Consultar’, poderá ser visualizado que os registros foram enviados ao SPC, mostrando em tela o retorno e o status dos registros.

  1. Os botões de ‘XML’ irão exibir o XML de Envio e o XML de Retorno do registro para conferência do que foi enviado e retornado, caso necessário.

 

  1. Caso seja realizado o envio de um registro com menos de 15 dias de vencimento, irá retornar o status abaixo, informando que o registro só poderá ser incluído ao SPC após 15 dias da data de vencimento.

  1. Em ‘Consulta Registro', se filtrar os registros ‘Enviados’, irá listar os registros enviados conforme a data informada.

 

Remoção do Registro de Duplicata do SPC

Passo a Passo

 

  1. Seguindo com o exemplo das duplicatas acima enviadas, caso sejam baixadas totalmente no sistema, automaticamente na execução da tarefa agendada, os registros serão removidos, sem a necessidade de enviar para a fila.
    Ao consultar novamente os registros das duplicatas, é possível observar que dos três registros, dois não são mais listados no grid, pois, dois registros já foram baixados e um registro foi feito a baixa parcial de somente R$25,00 então, permanece listando no grid de consulta.

2 . No filtro de ‘Enviados’, continua a listagem de ambas as duplicatas relacionadas a ‘Inclusão’ no SPC.

3 . Após a execução da tarefa agendada, nesta mesma consulta, irá listar os Registros de Remoção (R), exceto da duplicata 90426 que foi parcialmente baixada.

 

  1. Em ‘Consulta Registro’, se necessário, pode ser consultado somente registros removidos.

Registro de Cheques ao SPC

Passo a Passo

  1. No exemplo abaixo, será realizado o envio do registro de Cheques ao SPC. É filtrado os Cheques de acordo com a Data de Bom Para e marcado os cheques que serão enviados.

     

 

  1. Posteriormente, serão ‘Enviadas à fila’, neste momento, é preciso informar o ‘Motivo de Inclusão’ desses registros e enviar esses 2 registros para a fila. Através do ‘F3’ é possível visualizar as opções de Motivos.

 

 

  1. Esses registros ficarão com a data e hora de inclusão ao SPC, porém, os registros serão realmente enviados ao SPC, após a execução da tarefa agendada, conforme data e horário definido para a execução. Logo após a execução da tarefa agendada, ao clicar em ‘Consultar’, poderá ser visualizado que os registros foram enviados ao SPC, mostrando em tela o retorno e o status dos registros.

  1. Os botões de ‘XML’ irão exibir o XML de Envio e o XML de Retorno do registro para conferência do que foi enviado e retornado, caso necessário.

  1. Em ‘Consulta Registro', se filtrar os registros ‘Enviados’, irá listar os registros enviados conforme a data informada.

Remoção do Registro de Cheque do SPC

Passo a Passo

  1. Seguindo com o exemplo dos Cheques acima enviados, caso sejam Baixados ou Acertados totalmente no sistema, automaticamente na execução da tarefa agendada, os registros serão removidos, sem a necessidade de enviar para a fila.
    Ao consultar novamente os registros dos Cheques, é possível observar que não são mais listados no grid, pois, um dos registros foi baixado e outro registro foi acertado.

 

2. No filtro de ‘Enviados’, continua a listagem de ambos os Cheques relacionadas a ‘Inclusão’ no SPC.

3 . Após a execução da tarefa agendada, nesta mesma consulta, irá listar os Registros de Remoção (R).

 

  1. Em ‘Consulta Registro’, se necessário, pode ser consultado somente registros removidos.

 

Reenviar Registros de Duplicatas e Cheques ao SPC

Passo a Passo

  1. Em ‘Consulta Registro’ é possível fazer o ‘Reenvio’ de registros que possuem Status de erro de Inclusão, neste caso, não será necessário enviar à fila novamente, somente clicar no botão ‘Reenviar’ e após a execução da tarefa agendada, o registro será reenviado.
    Obs.: Os registros de Remoção, automaticamente a cada execução do Job serão removidos se o status da duplicata estiver Baixado ou dos cheques estiver Baixado e Acertado.

    No exemplo abaixo, caso o retorno seja de que o registro poderá ser incluído somente após 15 dias da data de vencimento, após fechar os 15 dias, os registros poderão ser reenviados.

E na execução da tarefa agendada, será obtido o mesmo retorno caso não tenha concluído os 15 dias ou o retorno de inserido com sucesso.

Erros Comuns

 

  1. É obrigatório ter a Data de Nascimento informada no Cadastro da Pessoa - CPF.

Correção Item 1

1.1. Acesse o Cadastro da Pessoa em: Cadastros >> Pessoas >> Pessoas e informe a Data de Nascimento, salvando o cadastro.

1.2 - Em ‘Consulta Registro’, faça o reenvio dos registros ao SPC. E consulte-os no filtro de ‘Pendentes’.

1.3. Na próxima execução da tarefa agendada os registros serão reenviados e inseridos, exceto o registro da Pessoa 16, pois não foi informado a Data de Nascimento em seu cadastro.

 


  1. No retorno abaixo é informado que a Data de Nascimento é inválida para a Pessoa 2, pois a idade mínima para ser possível enviar um registro ao SPC é de 16 anos.

 

Correção Item 2

2.1. Acesse o Cadastro da Pessoa em: Cadastros >> Pessoas >> Pessoas - Aba Principal e informe a Data de Nascimento correta.

2.2. Em ‘Consulta Registro’, faça o reenvio do Registro ao SPC e na próxima execução da tarefa agendada, este registro será reenviado, retornando o status como inserido.

 


  1. Se no Cadastro da Pessoa o número do Telefone não estiver formatado com o DDD corretamente é retornado o status abaixo.

Correção Item 3

3.1. Acesse Cadastros >> Pessoas >> Pessoas - Aba Endereço e informe o número de Telefone novamente no Cadastro da Pessoa com a formatação correta.

 

 

3.2. Em ‘Consulta Registro’, faça o reenvio do Registro ao SPC e na próxima execução da tarefa agendada, este registro será reenviado, retornando o status como inserido.

 


  1. No endereço do Cadastro da Pessoa o CEP precisa ser um CEP válido, caso contrário, poderá retornar um dos status de erro abaixo. Para ambos os casos, o ajuste do CEP corrigiu o envio.

 

Correção Item 4

4.1. Acesse o Cadastro da Pessoa em: Cadastros >> Pessoas >> Pessoas - aba ‘Endereços’ e informe um CEP válido, salvando o cadastro.

4.2. Em ‘Consulta Registro’, faça o reenvio do Registro ao SPC e na próxima execução da tarefa agendada, este registro será reenviado, retornando o status como inserido.

 


  1. No retorno do SPC pode ocorrer o erro abaixo 'Banco retornado pelo SPC como inválido. Entre em contato com o SPC Brasil.', pois, pode ocorrer do banco utilizado no cheque não ser aceito no SPC, antes de entrar em contato com o SPC, verifique através do código do cheque em Financeiro >> Cheques Recebidos >> Cheques Recebidos, qual é o código do banco e a descrição deste banco que está vinculado ao cheque.

 


  1. O Status Data de Vencimento da duplicata deve ser menor que 60 meses é um retorno do SPC Brasil, no caso abaixo, o vencimento da duplicata é de 2015, ultrapassa os 60 meses. O mesmo ocorre com o cheque na verificação da Data de Emissão, após 01/02/2023 já ultrapassou também os 60 meses.

 

  1. É necessário ter informado o DDD no Cadastro da cidade. Caso não tenha informado, retornará a mensagem abaixo:

Correção Item 7

7.1 Acesse o cadastro da Pessoa em Cadastros >> Pessoas >> Pessoas - Aba ‘Endereços’ e verifique qual é a cidade deste endereço. Acesse Cadastros >> Pessoas >>Cidades e informe o DDD correspondente.

7.2 Faça o reenvio deste registro, e após a execução da tarefa agendada o registro será incluído.

 


Versão

Lote

Versão do Sistema

Versão do Banco de Dados

Versão da Documentação

Autor/Revisor

Lote

Versão do Sistema

Versão do Banco de Dados

Versão da Documentação

Autor/Revisor

 

23.110

23110

1.0

Carine