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 relatório GYRA+ é composto por fontes independentes (cadastral, bureau, processos, SCR, vínculos, etc.), orquestradas automaticamente em cada análise. Cada fonte tem custo, latência e nível de relatório exigido. Esta página é o mapa das fontes disponíveis e como escolher o nível certo.

Categorias

CategoriaO que entregaExemplos de uso
CadastralIdentidade oficial do documentoBloqueio por situação irregular, idade mínima
Bureau de CréditoScore de mercado + restritivos comerciaisScore mínimo, faixa de risco
Processos JudiciaisAções como autor e réuRisco trabalhista, tributário, cível
ProtestosCartórios de protesto em todo o BrasilRestritivo cartorial
PEFIN / REFINRestritivos comerciais ativosBloqueio por inadimplência ativa
SCR / Open FinanceEndividamento bancário realCapacidade, concentração, atraso
PEP e SançõesExposição política e listas restritivasCompliance, KYC, PLD
Vínculos SocietáriosQSA, sócios, filiais, grupo econômicoAnálise de grupo, concentração
Contatos e LocalizaçãoTelefones, e-mails, endereços, mapa, fotos de fachadaValidação cadastral, anti-fraude, cobrança
FinanceiraFaturamento/renda presumidos, balanço, indicadores contábeisCapacidade, limite proporcional ao faturamento
VeículosPropriedade de veículos (RENAVAM)Patrimônio, colateral
Mídia e ReputaçãoExposição em mídia, sinais onlineDue diligence reputacional
Benefícios SociaisBolsa Família, BPC, Seguro DesempregoCapacidade, segmentação PF
Cada fonte tem página dedicada no menu lateral.

Níveis de relatório

NívelCoberturaLatência típica
SIMPLESCadastral + Contatos e Localização (mapa e fachada inclusos)2 a 5 s
ESSENCIAL+ Bureau, Vínculos 1º nível, Processos (desde 2014)5 a 15 s
COMPLETO+ PEFIN/REFIN, Bad Check, Protestos, SCR (com consentimento), PEP/Sanções, Criminal, Mídia, Benefícios, Certidões (parciais)10 a 30 s
COMPLETO++ Processos desde 1980, certidões completas, histórico estendido em fontes aplicáveis15 a 45 s
A janela histórica estendida do COMPLETO+ (desde 1980) aplica-se especificamente a processos judiciais. No COMPLETO, processos cobrem desde 2014. Nível é definido na política, não na chamada. Uma organização pode ter políticas em níveis diferentes para produtos diferentes.

Como as fontes se combinam

Toda análise passa por duas fases:
  1. Coleta: fontes são consultadas em paralelo. A latência total é dominada pela fonte mais lenta (tipicamente SCR via Open Finance).
  2. Avaliação: cada regra da política puxa o campo da fonte relevante (ex: creditBureauScoreSummary.score puxa da fonte bureau).
Fonte indisponível no momento da consulta não bloqueia o relatório: o campo fica nulo e as regras que dependem dele são tratadas conforme o comportamento configurado (normalmente ALERT).

Natureza dos dados

TipoExemploConsentimento exigido
PúblicoCNPJ na Receita, processos em tribunaisNão
Semi-públicoProtestos em cartórioNão (agregador autorizado)
Restrito LGPD (PF)Dados cadastrais de pessoa físicaConsentimento de negócio
Consentimento explícitoSCR via Open FinanceSim, Termo BCB
ContratadoBureau (Serasa, Boa Vista, ProScore)Sim, via contrato
Cada página de fonte detalha a base legal específica.

Custo e latência

Nem toda análise precisa ser completa. A recomendação geral:

SIMPLES

Triagem inicial, pré-análise, onboarding leve. Baixo custo, alta velocidade.

ESSENCIAL

Concessão de crédito pequeno ticket, cartão, antecipação de recebíveis pequena.

COMPLETO

Concessão padrão, capital de giro, crédito PJ médio ticket.

COMPLETO+

Análise profunda, crédito grande ticket, M&A, due diligence.

Escolher fontes na política

No editor de política, painel lateral Dados Consultados. Ativa ou desativa cada fonte individualmente. Regra geral:
  • Ativar só o que você usa. Cada fonte habilitada gera custo, mesmo que nenhuma regra consulte.
  • Regras órfãs são bloqueadas. Se uma regra usa SCR e SCR está desativado, o editor bloqueia o salvar.
  • Janelas configuráveis. Processos (12, 24, 60 meses), SCR (meses de histórico), vínculos (profundidade).
Detalhes em Criar Política e Editar Política.

Perguntas frequentes

Sim. Uma organização tipicamente tem políticas SIMPLES para triagem, ESSENCIAL para pequeno ticket e COMPLETO para concessão. A escolha é por política, não por organização.
Timeouts são gerenciados pela GYRA+ e calibrados por fonte. Se uma fonte falha por timeout, o campo volta nulo e o relatório completa com ALERT ou ERROR dependendo da configuração. A reanálise depois costuma resolver.
Três razões possíveis: (1) fonte não foi habilitada na política; (2) fonte foi habilitada mas falhou na consulta; (3) documento não tem o dado (ex: CPF sem histórico de SCR).
A granularidade de custo por fonte/análise é fornecida pela equipe financeira da GYRA+ conforme contrato. Hoje não há tela no toolbox para esse breakdown.
Hoje o BYOC (bring your own credential) é suportado para Serasa. Outras fontes consumimos pelo contrato agregado da GYRA+.

Próximos passos

Cadastral

Ponto de partida de qualquer análise.

Bureau de Crédito

Score e restritivos comerciais.

SCR / Open Finance

Endividamento bancário real.

Relatório (conceito)

Como o relatório se monta.