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 resultado de um relatório responde três perguntas: a política aprovou? Se sim, em que condições (prazo, taxa, valor)? Se não, qual regra bloqueou? Esta página é o guia para ler a tela de resultado e a estrutura de saída.
Anatomia da tela de resultado
A tela é dividida em cinco áreas:- Cabeçalho, documento, nome, política usada, status final.
- Decisão,
APPROVED,ALERT,DENIEDouERROR, com cor destacada. - Precificação, se a política tiver fórmulas (prazo, taxa, valor final aprovado).
- Breakdown por regra, cada regra da política listada com resultado individual, threshold configurado e valor real encontrado.
- Relatório completo, todas as seções de dados coletados (cadastral, processos, bureau, SCR, etc.).
Status possíveis
| Status | Significado | Ação sugerida |
|---|---|---|
APPROVED | Todas as regras aprovaram ou os gatilhos de alerta não são bloqueantes. | Seguir com a operação no termo precificado. |
ALERT | Nenhuma regra bloqueou, mas alguma levantou sinal de atenção. | Revisar manualmente antes de liberar; reforçar colateral. |
DENIED | Ao menos uma regra marcada como bloqueante disparou. | Recusar. Ver motivo no breakdown. |
ERROR | Falha técnica na coleta ou avaliação, política não rodou. | Reanalisar após checar fonte indisponível. |
Breakdown por regra
Cada regra da política aparece com quatro colunas:| Coluna | Descrição | Exemplo |
|---|---|---|
| Regra | Nome da regra na política | Score bureau >= 400 |
| Threshold | Valor ou condição configurada | >= 400 |
| Valor real | Valor encontrado no relatório | 720 |
| Resultado | APPROVED, ALERT ou DENIED da regra individual | ✅ APPROVED |
- Verde (
APPROVED): regra passou. - Amarelo (
ALERT): regra sinalizou mas não bloqueia. - Vermelho (
DENIED): regra bloqueou, este é o motivo de negação.
creditBureauScoreSummary.score), a origem do dado (bureau, cadastral, SCR) e o trecho do JSON do relatório que gerou o valor.
Precificação
Se a política tem fórmulas configuradas, aparece na área de precificação:| Campo | Descrição | Exemplo |
|---|---|---|
amount | Valor final aprovado em R$ | 80000.00 |
period | Prazo em meses (ou dias, conforme o produto) | 24 |
interest | Taxa (mensal ou anual, conforme configuração da política) | 1.99 |
Relatório completo
Abaixo das áreas de decisão, o relatório completo com tudo que a GYRA+ coletou. Navegue pelas abas laterais:- Cadastral, situação, CNAE, data de abertura, endereço. Ver Cadastral.
- Processos Judiciais, ações como autor e réu, por tipo de vara. Ver Processos Judiciais.
- PEFIN / REFIN, restritivos ativos. Ver PEFIN e REFIN.
- Bureau, score e breakdown. Ver Bureau de Crédito.
- SCR, endividamento bancário mês a mês. Ver SCR e Open Finance.
- Vínculos societários, QSA e grupo econômico. Ver Vínculos Societários.
- Outras seções conforme o nível do relatório contratado.
Exportar o resultado
No menu de três pontos ao lado do nome da empresa, no topo do relatório, você escolhe entre três opções:- PDF, layout pronto para arquivo regulatório ou compartilhamento com o tomador.
- XLS, planilha com os dados do relatório para ingestão em sistemas próprios, conciliação ou análise manual.
- PDF + XLS, os dois formatos juntos.
Casos comuns
Aprovado mas com alerta: posso confiar?
Aprovado mas com alerta: posso confiar?
ALERT significa “passou, mas a regra disse para olhar”. Usar como gatilho para revisão manual ou para aplicar colateral extra. Ao longo do tempo, calibre os thresholds de alerta com base no que converge em default.Negado: onde vejo exatamente qual regra bloqueou?
Negado: onde vejo exatamente qual regra bloqueou?
No breakdown, a regra marcada em vermelho é a que bloqueou. Se múltiplas vermelhas, todas contribuíram (uma política pode ter várias regras com status
DENIED, qualquer uma basta para negar).Score alto mas política negou, por quê?
Score alto mas política negou, por quê?
Score é só uma das regras. Se a política também consulta PEFIN, SCR ou situação cadastral, qualquer uma pode bloquear mesmo com score bom. A lógica é E, não OU: basta uma regra bloquear para o resultado ser
DENIED.Precificação veio zerada em um aprovado, por quê?
Precificação veio zerada em um aprovado, por quê?
A política não tem fórmulas configuradas. Sem
periodFormula, interestFormula ou amountFormula, a área de precificação fica vazia. Configurar em Precificação.Por que aparece 'dado indisponível' em alguma regra?
Por que aparece 'dado indisponível' em alguma regra?
A fonte não retornou dado para aquela regra (ex: PF sem consentimento Open Finance, CNPJ muito novo sem histórico). O comportamento padrão é
ALERT, mas cada regra pode ser configurada para tratar ausência como DENIED ou APPROVED.Próximos passos
Score e Decisão
Como a decisão final é calculada.
Operações (conceito)
Modelo de versionamento e níveis.
Editar política
Calibrar thresholds a partir de casos reais.
Webhooks
Receber o resultado em tempo real.