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
| Categoria | O que entrega | Exemplos de uso |
|---|---|---|
| Cadastral | Identidade oficial do documento | Bloqueio por situação irregular, idade mínima |
| Bureau de Crédito | Score de mercado + restritivos comerciais | Score mínimo, faixa de risco |
| Processos Judiciais | Ações como autor e réu | Risco trabalhista, tributário, cível |
| Protestos | Cartórios de protesto em todo o Brasil | Restritivo cartorial |
| PEFIN / REFIN | Restritivos comerciais ativos | Bloqueio por inadimplência ativa |
| SCR / Open Finance | Endividamento bancário real | Capacidade, concentração, atraso |
| PEP e Sanções | Exposição política e listas restritivas | Compliance, KYC, PLD |
| Vínculos Societários | QSA, sócios, filiais, grupo econômico | Análise de grupo, concentração |
| Contatos e Localização | Telefones, e-mails, endereços, mapa, fotos de fachada | Validação cadastral, anti-fraude, cobrança |
| Financeira | Faturamento/renda presumidos, balanço, indicadores contábeis | Capacidade, limite proporcional ao faturamento |
| Veículos | Propriedade de veículos (RENAVAM) | Patrimônio, colateral |
| Mídia e Reputação | Exposição em mídia, sinais online | Due diligence reputacional |
| Benefícios Sociais | Bolsa Família, BPC, Seguro Desemprego | Capacidade, segmentação PF |
Níveis de relatório
| Nível | Cobertura | Latência típica |
|---|---|---|
| SIMPLES | Cadastral + 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áveis | 15 a 45 s |
Como as fontes se combinam
Toda análise passa por duas fases:- Coleta: fontes são consultadas em paralelo. A latência total é dominada pela fonte mais lenta (tipicamente SCR via Open Finance).
- Avaliação: cada regra da política puxa o campo da fonte relevante (ex:
creditBureauScoreSummary.scorepuxa da fonte bureau).
ALERT).
Natureza dos dados
| Tipo | Exemplo | Consentimento exigido |
|---|---|---|
| Público | CNPJ na Receita, processos em tribunais | Não |
| Semi-público | Protestos em cartório | Não (agregador autorizado) |
| Restrito LGPD (PF) | Dados cadastrais de pessoa física | Consentimento de negócio |
| Consentimento explícito | SCR via Open Finance | Sim, Termo BCB |
| Contratado | Bureau (Serasa, Boa Vista, ProScore) | Sim, via contrato |
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).
Perguntas frequentes
Posso ter níveis diferentes em políticas diferentes?
Posso ter níveis diferentes em políticas diferentes?
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.
Uma fonte ficou lenta, posso aumentar o timeout?
Uma fonte ficou lenta, posso aumentar o timeout?
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.Por que o campo X veio nulo?
Por que o campo X veio nulo?
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).
Tem como ver quanto cada fonte custou?
Tem como ver quanto cada fonte custou?
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.
E fontes que eu tenho contrato próprio?
E fontes que eu tenho contrato próprio?
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.

