Skip to main content

​
Visão geral

Todo relatório concluído pela GYRA+ traz uma decisão automática com três níveis de informação:
  1. Decisão geral (policyStatus) — APPROVED, DENIED ou ALERT
  2. Score composto (score) — valor de 0 a 1000 calculado pela política
  3. 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

CampoTipoDescrição
statusstringStatus geral do relatório
policyStatusstringDecisão da política: APPROVED, DENIED, ALERT
scorenumberScore final composto (0–1000)

​
Nível do grupo de regras

CampoTipoDescrição
namestringNome do grupo (ex: “Cadastral”, “Financeiro”)
statusstringResultado do grupo
scorenumberScore acumulado deste grupo

​
Nível da regra individual

CampoTipoDescrição
rulestringIdentificador da regra (ex: SCORE, PEFIN_AMOUNT)
statusstringResultado: APPROVED, DENIED, ALERT, NOT_APPLIED
valueanyValor extraído dos dados para avaliação
conditionstringCondição configurada na política

​
Cenários comuns e como agir

A análise passou em todos os critérios. Seu fluxo de aprovação pode prosseguir automaticamente. Guarde o reportId para rastreabilidade.
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.
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.
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.
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.