Skip to main content
Você não precisa ser desenvolvedor para configurar uma política. O painel do Toolbox tem uma interface visual completa. Esta página cobre os dois caminhos: o painel gráfico e a API.

​
O que é uma política de crédito?

Pense numa política de crédito como um conjunto de regras do jogo que define quem pode e quem não pode fazer negócio com você — e em quais condições. Na GYRA+, a política fica salva no sistema e é aplicada automaticamente toda vez que um relatório é gerado. O resultado final é sempre um de três status:

✅ Aprovado

Todos os critérios foram atendidos. O cliente passou na análise automática.

⚠️ Alerta

Passou na maioria dos critérios, mas algum ponto merece atenção manual.

❌ Negado

Pelo menos um critério de exclusão foi ativado. Análise encerrada.

​
Pra que serve uma política personalizada?

A GYRA+ já oferece templates prontos para os casos mais comuns. Use um template se você está começando — é mais rápido e já cobre a maioria dos cenários. Crie uma política personalizada quando precisar:
  • Definir um score mínimo diferente do padrão (ex: exigir score acima de 600 para B2B)
  • Bloquear categorias específicas de empresa (ex: não atender MEIs ou empresas com menos de 1 ano)
  • Adicionar critérios do seu setor (ex: cooperativas que só atendem determinados CNAEs)
  • Configurar limites de dívida proporcionais ao faturamento (ex: PEFIN inferior a 20% do faturamento)
  • Criar faixas de risco com nomes próprios (ex: “Ouro”, “Prata”, “Bronze”)

​
Como criar pelo painel (sem código)

1

Acesse Políticas de Decisão

No menu lateral do Toolbox, clique em Políticas de Decisão. Você verá a lista das políticas ativas da sua organização.
2

Crie uma nova política ou clone um template

Clique em Nova Política. Escolha entre:
  • Partir de um template (recomendado): selecione o modelo mais próximo do seu caso e personalize
  • Criar do zero: para casos muito específicos
Templates disponíveis: Score Básico PJ, Crédito B2B, Onboarding KYC, Varejo PF, Cooperativa/Fintech. Cada um já tem grupos e regras pré-configurados.
3

Dê um nome e selecione o tipo de documento

Digite um nome descritivo (ex: “Crédito Distribuidor PJ 2024”) e selecione se a política é para CNPJ, CPF ou ambos.
4

Configure os Grupos de Regras

Cada grupo é um tema de análise (ex: “Financeiro”, “Cadastral”, “Processos”). Dentro de cada grupo, você adiciona as regras — veja a seção abaixo com todas as opções disponíveis.Para cada grupo, defina as pontuações de corte:
  • Pontuação para Aprovado (ex: ≥ 70 pontos no grupo)
  • Pontuação para Alerta (ex: entre 40 e 69 pontos)
  • Pontuação para Negado (ex: abaixo de 40 pontos)
5

Configure as Faixas de Risco (Risk Bands)

As faixas de risco transformam a pontuação composta (soma dos grupos) em uma decisão final. Exemplo:
Score compostoDecisão final
700 – 1000APPROVED
400 – 699ALERT
0 – 399DENIED
Você nomeia cada faixa como quiser (ex: “A”, “B”, “C” ou “Premium”, “Standard”, “Risco”).
6

Salve e ative a política

Clique em Salvar. A política fica em rascunho até você clicar em Ativar. Apenas políticas ativas são aplicadas nos relatórios.

​
Entendendo as Regras

Cada regra tem três partes: 
[O QUE AVALIAR]  [COMO COMPARAR]  [QUAL VALOR]
    SCORE              maior que         500
    PEFIN_AMOUNT       igual a            0
    COMPANY_SITUATION  igual a        "Ativa"
Se a condição for verdadeira, a regra aplica um resultado (APPROVED, ALERT ou DENIED) ou uma pontuação ao grupo.

​
Regras disponíveis

​
Dados da Empresa (CNPJ)

RegraO que verificaUso típico
COMPANY_SITUATIONSituação cadastral na Receita FederalBloquear empresas inativas, inaptas ou baixadas
COMPANY_OPENING_TIMETempo de existência em mesesExigir mínimo de 12 ou 24 meses de atividade
CAPITAL_STOCK_AMOUNTCapital social declarado em R$Exigir capital mínimo (ex: R$ 50.000)
CORPORATE_TAX_REGIMERegime tributário (Simples, Lucro Real, etc.)Excluir MEIs ou selecionar apenas Lucro Real
TOTAL_PARTNERSQuantidade de sócios na empresaLimitar empresas com muitos sócios
BUSINESS_PARTNERS_RESTRICTIVESócios com restriçõesNegar se algum sócio está negativado
COMPLETE_QSA_CHANGEMudança completa no quadro societárioAlertar quando todos os sócios foram trocados recentemente

​
Dados da Pessoa (CPF)

RegraO que verificaUso típico
AGE_PERSONIdade em anosExigir idade mínima de 21 anos
DEATHÓbito registradoNegar automaticamente se há registro de falecimento
PROFESSIONSProfissão declaradaFiltrar por categoria profissional

​
Score de Crédito

RegraO que verificaUso típico
SCOREScore do bureau (0–1000)Exigir pontuação mínima (ex: ≥ 500) para aprovação
O score de 0 a 1000 representa o risco do cliente: quanto maior, melhor. Score 700+ é considerado baixo risco na maioria dos modelos.

​
Dívidas e Negativações

RegraO que verificaUso típico
PEFIN_AMOUNTTotal de dívidas no PEFIN (R$)Negar se há qualquer dívida (= 0) ou até um limite
PEFIN_CALCULATED_REVENUEDívidas PEFIN como % do faturamentoAceitar até 20% do faturamento em dívidas
REFIN_AMOUNTTotal de refinanciamentosLimitar volume de refinanciamentos
TOTAL_DEBTDívida total consolidada (R$)Teto absoluto de dívidas
BANKRUPTFalência ou recuperação judicialNegar automaticamente em qualquer caso

​
Protestos em Cartório

RegraO que verificaUso típico
NOTARIES_COUNTQuantidade de protestosNegar se há mais de X protestos
NOTARIES_AMOUNTValor total em protestos (R$)Teto de R$ para protestos
NOTARIES_LAST_DAYSProtestos recentes (em dias)Alerta se protestou nos últimos 180 dias

​
Histórico Bancário (SCR — Banco Central)

RegraO que verificaUso típico
SCR_TOTAL_LOSSESPerdas registradas no BC (R$)Negar se há qualquer perda bancária
SCR_CALCULATED_REVENUE_EXPIREDCréditos vencidos como % do faturamentoAceitar até 5% do faturamento vencido
SCR_TOTAL_RISKExposição total no sistema financeiro (R$)Limite de endividamento bancário

​
Processos Judiciais

RegraO que verificaUso típico
LAWSUITS_PASSIVE_COUNTQuantidade de processos como réuNegar se há mais de X processos
LAWSUITS_PASSIVE_AMOUNTValor total em processos passivos (R$)Teto de R$ em processos
LAWSUITS_CALCULATED_REVENUEProcessos como % do faturamentoAceitar até 20% do faturamento em litígios
OWNER_LAWSUITS_HAS_CRIMINALSócios com processos criminaisNegar se qualquer sócio tem processo criminal

​
Operadores de comparação

OperadorSignificadoExemplo
>Maior queScore > 500
>=Maior ou igualScore >= 500
<Menor quePEFIN < 3 ocorrências
<=Menor ou igualDívida <= 50000
=Igual aSituação = "Ativa"
BETWEENDentro de um intervaloScore entre 400 e 700
CONTAINSInclui um textoProfissão contém “médico”
NOT_CONTAINSNão inclui um textoSanções não contém “OFAC”
IS_TRUEFlag ativadaÓbito verdadeiro → Negar
IS_FALSEFlag não ativadaFalência falso → OK

​
Dicas práticas

A maioria das empresas começa com o template de Score Básico PJ ou Crédito B2B e vai refinando as regras com o tempo. Não tente criar a política perfeita logo de início — calibre com dados reais.
Regras como “Negar se óbito” ou “Negar se falência” devem ficar em um grupo chamado “Exclusão” ou “Hard Rules”, com resultado direto DENIED — independente de qualquer pontuação. Isso deixa a lógica mais clara e fácil de auditar.
Ao solicitar um relatório, passe o externalId com o ID do cliente ou negócio no seu sistema. Assim, quando a decisão chegar pelo webhook, você sabe exatamente qual registro atualizar — sem precisar cruzar dados manualmente.
Nas primeiras semanas de operação, observe a distribuição de scores dos seus clientes. Se a maioria está na faixa de “Alerta”, talvez seus cortes estejam muito rígidos. Ajuste as Risk Bands a cada 30–60 dias no início.
Sempre rode alguns CNPJs ou CPFs de teste com a nova política antes de ativá-la para todos. O Toolbox permite simular análises sem consumir créditos.
Não é necessário criar uma política por cliente. Crie políticas por perfil de risco ou produto (ex: “Política PJ 30 dias”, “Política PF Consignado”) e reutilize em todos os relatórios daquele segmento.

​
Para desenvolvedores — via API

Consulte as políticas ativas da sua organização: 
curl https://gyra-core.gyramais.com.br/credit-policy/policy \
  -H "Authorization: Bearer {access_token}"
Ao criar um relatório, passe o policyId para aplicar uma política específica: 
curl -X POST https://gyra-core.gyramais.com.br/report \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "43591367000130",
    "type": "CNPJ",
    "reportType": "COMPLETO",
    "policyId": "64a1b2c3d4e5f6a7b8c9d0e1"
  }'
O resultado da política aparece na seção CREDIT_POLICY do relatório. Veja a referência completa em Seção: Política de Crédito.