Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt

Use this file to discover all available pages before exploring further.

Resumo: o SCR (Sistema de Informações de Crédito) é a fonte oficial do Banco Central com o endividamento bancário do CPF ou CNPJ. Mostra quanto a pessoa ou empresa deve para bancos, em quais modalidades, se está em dia e qual a tendência ao longo do tempo.

​
O que é

O SCR é a base de dados mantida pelo Banco Central do Brasil onde todas as instituições financeiras reguladas precisam reportar as operações de crédito dos seus clientes. Diferente de bureaus comerciais, o SCR é obrigatório e oficial: se uma empresa tem empréstimo em qualquer banco regulado, essa dívida aparece aqui. A GYRA+ acessa o SCR via Open Finance (antigo Open Banking), com o consentimento do titular dos dados. A fonte responde duas perguntas centrais:
  1. Quanto esta pessoa ou empresa deve para bancos hoje? (exposição total, vencida, em atraso)
  2. Como esse endividamento evoluiu nos últimos meses? (tendência, histórico)

​
De onde vem

  • Tipo de fonte: base oficial do Banco Central (via Open Finance).
  • Cobertura geográfica: Brasil (nacional, todas as instituições reguladas pelo BACEN).
  • Natureza do dado: oficial, reportado diretamente pelos bancos.
  • Base legal: Resolução BCB 4.571, regulamentação Open Finance, consentimento do titular.

​
Frequência de atualização

ComponenteAtualização
Consulta na fontereal-time ao rodar a análise
Base de origembancos reportam ao SCR mensalmente (fechamento do mês)
Janela entregueaté 12 meses de histórico mês a mês
Na prática: o SCR reflete a posição do mês anterior fechado. Uma operação de crédito tomada em março normalmente aparece no SCR após o dia 15 de abril.

​
Dados entregues

O SCR aparece em duas seções do relatório: HISTORY (visão mensal) e CATEGORIES (breakdown por modalidade).

​
Resumo atual (HISTORY.details)

CampoTipoDescriçãoExemplo
totalRisknumberExposição total a crédito (R$)450000.00
totalExpirednumberTotal vencido agora (R$)15000.00
totalLatenumberTotal em atraso (R$)0
totalLossesnumberPerdas registradas (prejuízo para o banco)0
availableCreditLimitnumberLimite aprovado disponível (R$)120000.00

​
Histórico mês a mês (HISTORY.details.months[])

CampoTipoDescrição
yearMonthstringAno/mês (YYYY-MM)
totalRisknumberRisco total no mês
toExpirenumberA vencer
expirednumberVencido
latenumberEm atraso
lossesnumberPerdas

​
Por categoria (CATEGORIES.details.months[].categories[])

Detalha o endividamento por modalidade: capital de giro, cartão, conta garantida, desconto de recebíveis, financiamento de veículos, financiamento imobiliário, BNDES, risco sacado. Detalhes completos em Seção SCR.

​
Casos de uso

Negar perda registrada

Dívidas baixadas como prejuízo são sinal grave: o banco já deu a dívida como perdida. Regra sugerida: SCR_TOTAL_LOSSES > 0 : DENIED.

Alerta de deterioração

Crescimento do expired mês a mês mesmo com totalRisk estável indica dificuldade crescente de honrar compromissos.

Capacidade de tomar mais crédito

availableCreditLimit próximo de zero indica que o tomador está no limite da capacidade.

Concentração por modalidade

Tomador com 80% da dívida em cartão rotativo tem risco diferente de quem tem a mesma dívida em BNDES.

​
Como usar na política

1

Escolher o campo

scr.totalRisk, scr.totalExpired, scr.totalLosses ou campos mensais de scr.months[].
2

Definir o operador

GREATER_THAN para cortes por valor absoluto, ou use as regras derivadas como SCR_EXPIRED_RATIO (razão sobre total).
3

Definir threshold

Calibrar pelo porte típico dos seus clientes: o que é “muito” para microempresa não é para médio porte.
Exemplo: 
{
  "field": "scr.totalLosses",
  "operator": "GREATER_THAN",
  "value": 0,
  "status": "DENIED"
}

​
Limitações e considerações

  • Depende de consentimento via Open Finance para PF. Sem consentimento, a seção vem vazia.
  • Lag de até 45 dias entre a operação e a aparição no SCR (fechamento mensal do banco + processamento BCB).
  • Não cobre crédito não bancário: fintechs não reguladas, cartões de loja, crediário interno não aparecem aqui.
  • CNPJ com múltiplas filiais: o SCR reporta por raiz do CNPJ (8 primeiros dígitos), não por filial.
  • Disponibilidade: seção disponível nos relatórios COMPLETO e COMPLETO+.

​
Perguntas frequentes

Para PJ, pode ser empresa sem histórico bancário. Para PF, pode ser falta de consentimento ou empresa que só usa crédito não bancário.
SCR mostra a dívida mesmo quando está em dia, é visão do endividamento. Bureau mostra apenas o que está em atraso ou foi ao protesto, é visão de inadimplência.
Por padrão 12 meses. Políticas com regras de tendência (ex: crescimento mês a mês) usam essa janela.
É o saldo devedor (dívida ativa). availableCreditLimit é o limite aprovado ainda disponível.

​
Próximos passos

Seção SCR completa

Todos os campos e exemplos de JSON.

Criar regra com SCR

Passo a passo no Toolbox.

Bureau de Crédito

Complementar ao SCR, visão de inadimplência.

PEFIN e REFIN

Pendências não bancárias.