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:- Quais dados consultar? → Define quais bureaus e integrações serão acionadas
- Quais critérios aplicar? → Define as regras de avaliação (score mínimo, limite de dívida, etc.)
- Qual a decisão? → Define quando aprovar, alertar ou negar
POST /report exige um policyId. Esse ID determina completamente o comportamento da análise.
Hierarquia de uma política
Status possíveis de uma decisão
| Status | Código | Descrição |
|---|---|---|
NOT_EXECUTED | 0 | Regra não foi avaliada |
PENDING | 1 | Aguardando avaliação |
APPROVED | 3 | Aprovado automaticamente |
DENIED | 4 | Negado automaticamente |
ALERT | 5 | Requer revisão manual |
NOT_APPLIED | 8 | Regra não aplicável ao documento |
Templates disponíveis
A GYRA+ oferece políticas prontas para os cenários mais comuns. Use opolicyId correspondente ao chamar a API.
| Template | policyId | Tipo | Relatório | Uso recomendado |
|---|---|---|---|---|
| Abertura de Conta | 67be2e43d6c1064a759601bf | CPF | Essencial | KYC e onboarding de PF |
| Background Check | 679955e0485aa2f033203f98 | CNPJ | Completo | Due diligence de fornecedores |
| Financiamento LP | 67c07e841997d65ab3dc74cd | CNPJ | Completo | Crédito para empresas |
Como as regras são combinadas
Dentro de um grupo, as regras podem ser combinadas de formas diferentes usando o campooperationType:
| Operador | Comportamento |
|---|---|
NONE | Regra avaliada de forma independente |
AND | Todas as regras do grupo devem ser verdadeiras |
ADD | Soma os scores das regras |
SUB | Subtrai o score |
DIV | Divide o score |
MULT | Multiplica 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.

