Interpretar uma Decisão de Crédito

Visão geral

Todo relatório concluído pela GYRA+ traz uma decisão automática com três níveis de informação:

Decisão geral (policyStatus), APPROVED, DENIED ou ALERT
Score composto (score), valor de 0 a 1000 calculado pela política
Raciocínio detalhado (seção CREDIT_POLICY), cada regra avaliada, com valor e resultado

Os três resultados possíveis

APPROVED

O documento passou em todos os critérios da política. Você pode prosseguir com a operação conforme seu processo interno.

ALERT

A análise identificou pontos de atenção que merecem revisão manual. Não é uma negação, é um sinal de que um analista deve avaliar antes de decidir.

DENIED

O documento não atendeu aos critérios mínimos da política. A operação deve ser recusada.

Exemplo de resposta completa

{
  "id": "64a3b2c1d4e5f6a7b8c9d0e1",
  "document": "43591367000130",
  "type": "CNPJ",
  "status": "APPROVED",
  "policyStatus": "APPROVED",
  "score": 720,
  "sections": [
    {
      "type": { "value": "CREDIT_POLICY" },
      "details": {
        "policyStatus": "APPROVED",
        "score": 720,
        "groups": [
          {
            "name": "Cadastral",
            "status": "APPROVED",
            "score": 300,
            "rules": [
              {
                "rule": "COMPANY_OPENING_TIME",
                "status": "APPROVED",
                "value": 48,
                "condition": "GREATER_THAN 12 meses"
              },
              {
                "rule": "COMPANY_SITUATION",
                "status": "APPROVED",
                "value": "Ativa"
              }
            ]
          },
          {
            "name": "Financeiro",
            "status": "ALERT",
            "score": 150,
            "rules": [
              {
                "rule": "SCORE",
                "status": "APPROVED",
                "value": 620
              },
              {
                "rule": "PEFIN_AMOUNT",
                "status": "ALERT",
                "value": 2,
                "condition": "EQUAL_TO 0"
              }
            ]
          }
        ]
      }
    }
  ]
}

Campo a campo

Nível do relatório

Campo	Tipo	Descrição
`status`	string	Status geral do relatório
`policyStatus`	string	Decisão da política: `APPROVED`, `DENIED`, `ALERT`
`score`	number	Score final composto (0–1000)

Nível do grupo de regras

Campo	Tipo	Descrição
`name`	string	Nome do grupo (ex: “Cadastral”, “Financeiro”)
`status`	string	Resultado do grupo
`score`	number	Score acumulado deste grupo

Nível da regra individual

Campo	Tipo	Descrição
`rule`	string	Identificador da regra (ex: `SCORE`, `PEFIN_AMOUNT`)
`status`	string	Resultado: `APPROVED`, `DENIED`, `ALERT`, `NOT_APPLIED`
`value`	any	Valor extraído dos dados para avaliação
`condition`	string	Condição configurada na política

Cenários comuns e como agir

policyStatus: APPROVED

A análise passou em todos os critérios. Seu fluxo de aprovação pode prosseguir automaticamente. Guarde o reportId para rastreabilidade.

policyStatus: ALERT com um grupo DENIED

Verifique qual grupo retornou DENIED e quais regras específicas causaram a negação. Dependendo do critério, pode ser um caso para revisão manual, não necessariamente uma recusa definitiva.

policyStatus: DENIED

O documento não atendeu aos critérios mínimos. Registre o motivo (grupo e regra) para transparência e possível comunicação com o solicitante.

Regra com status NOT_APPLIED

Essa regra não pôde ser avaliada porque os dados necessários não estavam disponíveis (ex: integração sem dados para esse documento). Isso não conta como reprovação.

Score alto, mas policyStatus DENIED

Isso acontece quando uma regra com statusToApply: DENIED foi ativada independentemente do score. Verifique qual regra “hardcoded” foi acionada, geralmente são critérios de exclusão (ex: óbito, falência).

Acessando o relatório completo

Para ver todas as seções (processos, protestos, score do bureau, etc.), acesse o relatório completo pelo painel ou pela API:

# Todas as seções
curl https://gyra-core.gyramais.com.br/report/{id} \
  -H "Authorization: Bearer {token}"

# Uma seção específica
curl https://gyra-core.gyramais.com.br/report/section/{sectionId} \
  -H "Authorization: Bearer {token}"

Consulte o Dicionário de Dados para entender todos os campos de cada seção.

Configurar Webhook Criar uma Política de Crédito

Primeiros Passos

Conceitos Fundamentais

Guia do Toolbox

Fontes de Dados

Guias

Casos de Uso

MCP Server

Referência da API

Dicionário de Dados

Integrações

Referência

Interpretar uma Decisão de Crédito

Visão geral

Os três resultados possíveis

APPROVED

ALERT

DENIED

Exemplo de resposta completa

Campo a campo

Nível do relatório

Nível do grupo de regras

Nível da regra individual

Cenários comuns e como agir

Acessando o relatório completo

​Visão geral

​Os três resultados possíveis

APPROVED

ALERT

DENIED

​Exemplo de resposta completa

​Campo a campo

​Nível do relatório

​Nível do grupo de regras

​Nível da regra individual

​Cenários comuns e como agir

​Acessando o relatório completo

Visão geral

Os três resultados possíveis

Exemplo de resposta completa

Campo a campo

Nível do relatório

Nível do grupo de regras

Nível da regra individual

Cenários comuns e como agir

Acessando o relatório completo