Análise de Crédito

O que é a análise de crédito na GYRA+ e como ela chega à decisão final.

Resumo: análise de crédito na GYRA+ é o processo de consultar várias fontes de dados sobre uma pessoa ou empresa, aplicar uma política de regras sobre esses dados e retornar uma decisão final (aprovado, alerta ou negado) com score e justificativa auditável.

O que a GYRA+ faz

Quando você pede uma análise, via Toolbox, API ou MCP, a GYRA+ executa quatro etapas:

1. Coleta: consulta em paralelo todas as fontes configuradas (cadastrais, bureaus de crédito, SCR, processos, protestos, PEP/sanções, etc).
2. Consolidação: normaliza e monta o relatório em seções padronizadas.
3. Avaliação: aplica a política de crédito configurada: cada regra lê um campo do relatório, compara com um threshold e contribui para o score e a decisão.
4. Decisão: retorna status final, score, lista de regras disparadas e o JSON completo do relatório.

Tudo isso é auditável: você vê exatamente qual campo foi avaliado, qual regra disparou, qual peso teve e como o score foi somado.

O que ela não faz

• Não é consultoria financeira. A GYRA+ entrega dados e aplica a política que você definiu, o julgamento do apetite de risco é seu.
• Não garante que o tomador vai pagar. Crédito tem risco residual sempre; a análise reduz, não elimina.
• Não altera o dado da fonte. Se a base de origem está defasada, a GYRA+ entrega o que foi publicado lá.

Ciclo de vida de uma análise

Para o fluxo assíncrono completo, ver Webhooks e Tempo Real.

Tipos de análise

A GYRA+ suporta análise de:

• Pessoa física (CPF): individual, normalmente para crédito pessoal, cartão, consignado, locação, contratação de RH.
• PF + vínculos: analisa o CPF e, em cascata, parentes e empresas relacionadas. Esse fluxo é modelado via Operação.
• Pessoa jurídica (CNPJ): individual, para crédito PJ, vendas a prazo, cartão corporativo, KYC.
• PJ + vínculos: analisa o CNPJ completo e, em cascata, sócios, filiais, parentes ou empresas no mesmo endereço. Esse fluxo é modelado via Operação.

Resultado

A resposta de uma análise sempre inclui:

Campo	O que é
status	Status do relatório: PENDING, APPROVED, DENIED, ALERT. Pode vir da política (modo automático) ou de análise manual. Ver Status do relatório × Status da política.
policyStatus	Decisão vinda da política de crédito aplicada. Sempre calculado, mesmo quando a política está em modo manual.
score	Valor sintético de 0 a 1000 (quando a política usa score).
document / type	Documento analisado e se é CPF ou CNPJ.
Seções do relatório	JSON detalhado com os dados de cada seção (sem detalhamento da fonte de origem).

Para entender como score e status são calculados, ver Score e Decisão.

Quando usar qual caminho

Toolbox (web)

Análise ad-hoc, análise em lote (CSV), revisão humana. Ideal para mesa de crédito e compliance.

API (servidor)

Integração com ERP, onboarding, checkout. Recebe resultado via webhook.

MCP (agentes de IA)

Consulta feita por agente LLM, ex: “rode uma análise no CNPJ X e me resuma”.

n8n / no-code

Workflows automatizados sem escrever código.

Próximos passos

Política de Crédito

Como a análise é parametrizada em regras.

Operações

Como encadear análises em cascata (PJ + sócios + filiais).

Score e Decisão

Como o score final é composto.

Relatório

A estrutura do objeto que sai da análise.