Skip to main content

O que é uma Política de Crédito

Uma política de crédito é o conjunto de regras e critérios que define como a GYRA+ avalia um CPF ou CNPJ e chega a uma decisão automática. Ela responde a três perguntas:
  1. Quais dados consultar? → Define quais bureaus e integrações serão acionadas
  2. Quais critérios aplicar? → Define as regras de avaliação (score mínimo, limite de dívida, etc.)
  3. Qual a decisão? → Define quando aprovar, alertar ou negar
Toda chamada ao POST /report exige um policyId. Esse ID determina completamente o comportamento da análise.

Hierarquia de uma política

Policy
├── IntegrationGroup          → Fontes de dados consultadas (Bureau, SCR, Dados Cadasrais...)
├── PolicyRuleGroup[]         → Grupos de regras (ex: "Cadastral", "Financeiro")
│   ├── scoreApproved         → Pontuação mínima para aprovação no grupo
│   ├── scoreAlert            → Pontuação para alerta
│   ├── scoreDenied           → Pontuação para negação
│   └── PolicyRuleSettingJoin[]
│       ├── operationType     → Como as regras se combinam (AND, ADD, SUB...)
│       ├── statusToApply     → Resultado se a condição for verdadeira
│       └── PolicyRuleSetting → Regra configurada com seus parâmetros
└── Risk[]                    → Faixas de score final → status final
    └── { from, to, statusToApply }

Status possíveis de uma decisão

StatusCódigoDescrição
NOT_EXECUTED0Regra não foi avaliada
PENDING1Aguardando avaliação
APPROVED3Aprovado automaticamente
DENIED4Negado automaticamente
ALERT5Requer revisão manual
NOT_APPLIED8Regra não aplicável ao documento

Templates disponíveis

A GYRA+ oferece políticas prontas para os cenários mais comuns. Use o policyId correspondente ao chamar a API.
TemplatepolicyIdTipoRelatórioUso recomendado
Abertura de Conta67be2e43d6c1064a759601bfCPFEssencialKYC e onboarding de PF
Background Check679955e0485aa2f033203f98CNPJCompletoDue diligence de fornecedores
Financiamento LP67c07e841997d65ab3dc74cdCNPJCompletoCrédito para empresas
Você pode usar um template como ponto de partida e personalizar as regras, pesos e faixas de risco pelo painel do Toolbox ou pela API.

Como as regras são combinadas

Dentro de um grupo, as regras podem ser combinadas de formas diferentes usando o campo operationType:
OperadorComportamento
NONERegra avaliada de forma independente
ANDTodas as regras do grupo devem ser verdadeiras
ADDSoma os scores das regras
SUBSubtrai o score
DIVDivide o score
MULTMultiplica o score

Opções de uso

Você tem três formas de trabalhar com políticas:

Usar template pronto

Escolha um dos templates da GYRA+ e comece a analisar imediatamente. Ideal para quem está começando.

Personalizar template

Parta de um template existente e ajuste regras, pesos e critérios para a sua estratégia de risco.

Criar do zero

Configure uma política completamente nova com suas próprias variáveis, condições e faixas de decisão.
Para criar ou editar políticas pelo painel, acesse Políticas de Decisão no menu do Toolbox. Para gerenciar via API, veja a referência do endpoint de políticas.