Consultar o SCR da Empresa

Esse endpoint permite a realização da consulta do SCR de uma Empresa previamente cadastrada na plataforma da Celcoin.

SCR, Sistema de Informações de Créditos, é um instrumento de registro gerido pelo BC e alimentado mensalmente pelas instituições financeiras. Permite à supervisão bancária a adoção de medidas preventivas, com o aumento da eficácia de avaliação dos riscos inerentes à atividade. Por meio dele, o BC consegue verificar operações de crédito atípicas e de alto risco, sempre preservando o sigilo bancário.

Parâmetros da URL

• business_id (string, uuid v4): Identificador do cadastro da Empresa a ser consultada.

• refresh (boolean): Campo para informar se deve utilizar a última consulta realizada (cache) ou se deve ser feita uma nova consulta.

• reference_date (opcional, date): Campo de data para ser usada como referência para consulta. Formato aceito "AAAA-MM".

Parâmetros da Requisição

Não é necessário o envio de nenhum dado no corpo da requisição.

Resposta

Em caso de sucesso será retornado um status 200 e um arquivo JSON no seguinte formato:

• sucesso (boolean): Campo do tipo boolean para indicar o sucesso da consulta realizada.

• mensagem (string): Campo para retorno de uma mensagem referente a consulta realizada.

• dados (object): Objeto contendo o detalhamento do SCR da Empresa.

Objeto "dados"

• cnpjDaIFSolicitante (string): Número do CNPJ da IF (Instituição Financeira) solicitante para o SCR.

• codigoDoCliente (string): Código de identificação do cliente.

• coobrigacaoAssumida (integer): Campo para indicar se a pessoa consultada assumiu uma coobrigação. Possíveis valores: 0 ou 1.

• coobrigacaoRecebida (integer): Campo para indicar se a pessoa consultada recebeu uma coobrigação. Possíveis valores: 0 ou 1.

• dataBaseConsultada (date): Data de referência utilizada na consulta no formato "AAAA-MM".

• dataInicioRelacionamento (date): Data de inicio do relacionamento do cliente com a IF solicitante. Formato "AAAA-MM-DD".

• listaDeResumoDasOperacoes (array): Objeto contendo uma lista de objetos com os dados das operações contratadas.

• percentualDocumentosProcessados (string): Valor que representa a porcentagem da quantidade de documentos que foram processadas na análise realizada.

• percentualVolumeProcessado (string): Valor que representa a porcentagem do volume de transações da análise.

• quantidadeDeInstituicoes (string): Quantidade de instituições financeiras consideradas na análise.

• quantidadeDeOperacoes (string): Quantidade de operações consideradas para a análise.

• quantidadeOperacoesDiscordancia (string):

• quantidadeOperacoesSubJudice (string):

• responsabilidadeTotalDiscordancia (string):

• responsabilidadeTotalSubJudice (string):

• riscoIndiretoVendor (string):

• tipoDoCliente (string):

• analise (object): Objeto contendo os detalhes da anáilse.

Objeto "listaDeResumoDasOperacoes"

• listaDeVencimentos (array): Objeto contendo uma lista dos vencimentários.

• modalidade (string): Código da modalidade do crédito contratado.

• variacaoCambial (string): Indica se tem aplicação de variação cambial. Possíveis valores: "N", "S"

Objeto "listaDeVencimentos"

• codigoVencimento (string): Código de identificação do vencimento.

• valorVencimento (string): Valor do vencimentário da operação de crédito para a data em questão.

Objeto "analise"

• limiteDeCreditoEmDias -> ate360 (float): Valor disponibilizado para limite de crédito no período de até 360 dias.

• limiteDeCreditoEmDias -> acimaDe360 (float): Valor disponibilizado para limite de crédito no período acima de 360 dias.

• creditoALiberarEmDias -> ate360 (float): Valor de crédito a ser liberado em até 360 dias.

• creditoALiberarEmDias -> acima360 (float): Valor de crédito a ser liberado em até 360 dias.

• total -> aVencer (float): Valor total a vencer.

• total -> vencido (float): Valor total vencido.

• prejuizoEmMeses -> ate12 (float): Valor total do considerado prejuizo calculado em até 12 meses.

• prejuizoEmMeses -> acimaDe12Ate48 (float): Valor total do considerado prejuizo calculado no período de 12 até 48 meses.

• prejuizoEmMeses -> acimaDe48 (float): Valor total do considerado prejuizo calculado no período de 12 até 48 meses.

• vencidoEmDias -> de1a14 (float): Valor total vencido considerando a faixa de 1 à 14 dias de atraso.

• vencidoEmDias -> acimaDe15Ate30 (float): Valor total vencido considerando a faixa de 15 à 30 dias de atraso.

• vencidoEmDias -> acimaDe31Ate60 (float): Valor total vencido considerando a faixa de 31 à 60 dias de atraso.

• vencidoEmDias -> acimaDe61Ate90 (float): Valor total vencido considerando a faixa de 61 à 90 dias de atraso.

• vencidoEmDias -> acimaDe91Ate120 (float): Valor total vencido considerando a faixa de 91 à 120 dias de atraso.

• vencidoEmDias -> acimaDe121Ate150 (float): Valor total vencido considerando a faixa de 121 à 150 dias de atraso.

• vencidoEmDias -> acimaDe151Ate180 (float): Valor total vencido considerando a faixa de 151 à 180 dias de atraso.

• vencidoEmDias -> acimaDe181Ate240 (float): Valor total vencido considerando a faixa de 181 à 240 dias de atraso.

• vencidoEmDias -> acimaDe241Ate300 (float): Valor total vencido considerando a faixa de 241 à 300 dias de atraso.

• vencidoEmDias -> acimaDe301Ate360 (float): Valor total vencido considerando a faixa de 301 à 360 dias de atraso.

• vencidoEmDias -> acimaDe361Ate540 (float): Valor total vencido considerando a faixa de 361 à 540 dias de atraso.

• vencidoEmDias -> acimaDe540 (float): Valor total vencido considerando a faixa acima dos 540 dias de atraso.

• detalhamento (array): Objeto contendo uma lista com o detalhamento das operações consideradas na análise.

Objeto "detalhamento"

• modalidade -> titulo (string): Titulo da modalidade. Possíveis valores: Empréstimos, Limites, Financiamentos, Outros créditos.

• modalidade -> subtitulo (string): Sub titulo, detalhamento da modalidade.

• variacaoCambial (string): Indica se tem aplicação de variação cambial. Possíveis valores: "Não", "Sim".

• vencimentos (array): Objeto do tipo lista contendo os detalhes dos vencimentários.

• vencimentos -> categoria (string): Campo para identificar a categoria do vencimento. Possíveis valores: "avencer", "vencidos", "prejuizo".

• vencimentos -> descricao (string): Descrição para detalhar a faixa de de dias da categoria.

• vencimentos -> valor (string): Valor referente ao vencimento.

• valor (float): Valor total de todos os vencimentários daquela modalidade.