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
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:
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:APPROVED, ALERT ou DENIED) ou uma pontuação ao grupo.
Regras disponíveis
Dados da Empresa (CNPJ)
Dados da Pessoa (CPF)
Score de Crédito
Dívidas e Negativações
Protestos em Cartório
Histórico Bancário (SCR, Banco Central)
Processos Judiciais
Operadores de comparação
Dicas práticas
Por onde começar? Use um template e ajuste aos poucos
Por onde começar? Use um template e ajuste aos poucos
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 de exclusão (bloqueio total) ficam em grupo separado
Regras de exclusão (bloqueio total) ficam em grupo separado
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.Use o campo externalId para rastrear análises no seu sistema
Use o campo externalId para rastrear análises no seu sistema
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.Calibre as faixas de risco com dados reais
Calibre as faixas de risco com dados reais
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.
Teste antes de ativar em produção
Teste antes de ativar em produção
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.
Uma política pode ser usada por múltiplos relatórios
Uma política pode ser usada por múltiplos relatórios
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:policyId para aplicar uma política específica:
CREDIT_POLICY do relatório. Veja a referência completa em Seção: Política de Crédito.