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: 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:
CampoO que é
statusStatus 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.
policyStatusDecisão vinda da política de crédito aplicada. Sempre calculado, mesmo quando a política está em modo manual.
scoreValor sintético de 0 a 1000 (quando a política usa score).
document / typeDocumento analisado e se é CPF ou CNPJ.
Seções do relatórioJSON 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.