Criar Política

Montar uma política de crédito do zero ou a partir de template: regras, grupos, scoring, fórmulas de precificação, habilitação.

Resumo: uma política é o conjunto de regras que decide aprovar, alertar ou negar, mais as fórmulas opcionais que precificam. Criar uma política no toolbox é montar esse conjunto visualmente, validar e habilitar. Esta página cobre o fluxo do zero; para partir de template pronto, ver Usar Templates.

Quando criar do zero

• Nenhum template cobre o seu produto, segmento ou apetite de risco.
• Política muito específica (ex: linha experimental, piloto interno, produto novo).
• Você já tem um modelo mental claro de quais regras precisa.

Se o caso é próximo de algum template, sempre prefira clonar pela opção B de Usar Templates. É mais rápido e menos propenso a erro.

Pré-requisitos

• Papel de administrador ou gestor de crédito.
• Entender o modelo de política e os tipos de fonte disponíveis.

Fluxo

1. Entrar em Nova Política

   Política de Crédito, Políticas, Nova política. O editor abre com uma política em branco.

2. Definir cabeçalho

   • Nome, interno, reconhecível pelo time.
   • Tipo de documento, PF (CPF) ou PJ (CNPJ). A política só pode ser usada no tipo declarado.
   • Nível de relatório, SIMPLES, ESSENCIAL, COMPLETO ou COMPLETO+. Define quais fontes ficam disponíveis para as regras.
   • Produto, vínculo opcional a um produto cadastrado (ex: Capital de Giro, Antecipação).
3. Adicionar grupos de regras

   Uma política é organizada em grupos. Cada grupo reúne regras com uma lógica interna (e.g. “Bloqueios cadastrais”, “Restritivos”, “Endividamento”). Regras dentro do grupo funcionam em E: todas precisam passar.

   Botão Adicionar grupo, nomear e configurar se o grupo contribui para um score agregado (campos scoreApproved, scoreAlert, scoreDenied).

4. Adicionar regras ao grupo

   Cada regra tem:

   • Campo, atributo do relatório a ser avaliado (ex: creditBureauScoreSummary.score, company.situation, pefin.totalAmount).
   • Operador, GREATER_THAN, LESS_THAN, EQUALS, CONTAINS, NOT_CONTAINS, COUNT_GREATER_THAN, entre outros.
   • Valor, threshold ou lista de valores (ex: 400, "BAIXADA,SUSPENSA").
   • Parâmetros, conforme a regra exigir (ex: Category: "Trabalhista" em regras LAWSUITS_BY_COURT_TYPE).
   • Status a aplicar, APPROVED, ALERT ou DENIED quando a regra dispara.

   O editor valida em tempo real: campo inexistente, operador inválido para o tipo do campo, parâmetros ausentes são bloqueados antes de salvar.

5. Configurar fontes de dados

   No painel lateral Dados Consultados, ative ou desative o que a política vai buscar:

   • Bureau (qual bureau, cache, janela).
   • SCR, se ativo, quantos meses de histórico (campo scrMonths).
   • Processos, janela temporal (últimos 12, 24, 60 meses).
   • Vínculos societários, níveis consultados (ROOT, FIRST_LEVEL, etc.).
   • Balanço e integrações externas, via externalIntegrationEnabled.

   Só o que estiver ativado aqui é coletado em runtime, isso afeta custo e latência da operação.

6. Fórmulas de precificação, opcional

   Ativar o bloco Ações pós-política para habilitar as três fórmulas:

   • periodFormula, prazo.
   • interestFormula, taxa.
   • amountFormula, valor final aprovado.

   Sintaxe Excel, catálogo e exemplos em Precificação.

7. Mensagens ao tomador

   Customizar o texto mostrado em cada resultado final (APPROVED, ALERT, DENIED). Útil se você expõe o resultado diretamente ao cliente final em um fluxo self-service.

8. Salvar e validar

   Clicar em Salvar. O editor roda validações cruzadas:

   • Toda regra tem campo, operador e threshold coerentes com o tipo de dado.
   • Fontes referenciadas pelas regras estão ativadas no painel de dados.
   • Fórmulas de precificação (se houver) parseiam.
   • Pelo menos um grupo com pelo menos uma regra.
9. Habilitar

   Toggle Habilitada no cabeçalho. A política só pode ser usada quando está habilitada — enquanto desabilitada, ela não aparece no dropdown do input sempre visível e não pode ser executada. Após habilitar, ela passa a aparecer no dropdown ao digitar um documento compatível, para todos os usuários com permissão.

Estrutura mínima recomendada

Toda política produção-ready tende a ter pelo menos três grupos:

Política "Crédito PJ Giro 2026"

├─ Grupo 1: Bloqueios cadastrais
│   ├─ situation IN ["BAIXADA", "SUSPENSA", "INAPTA"] → DENIED
│   └─ foundationDate < "2024-01-01" → DENIED (menos de 1 ano)

├─ Grupo 2: Restritivos
│   ├─ pefin.totalAmount > 50000 → DENIED
│   ├─ pefin.count > 5 → DENIED
│   └─ protests.count > 0 → ALERT

└─ Grupo 3: Capacidade e score
    ├─ creditBureauScoreSummary.score < 400 → DENIED
    ├─ creditBureauScoreSummary.score < 650 → ALERT
    ├─ scr.totalLosses > 0 → DENIED
    └─ scr.expiredRatio > 0.1 → ALERT

E, se cabe precificação:

amountFormula = MIN(|#solicitado|valor|#|, |#faturamento|faturamento|#| * 0.3)
interestFormula = IF(|#score|score|#| >= 800, 1.49, IF(|#score|score|#| >= 650, 1.99, 2.49))
periodFormula = IF(|#anosAbertura|idade|#| >= 5, 36, 18)

Versionamento

Toda alteração em regras, fórmulas ou fontes gera uma nova versão em PolicyChange com autor, timestamp e diff. O histórico completo fica na aba Histórico da política. Operações antigas continuam rastreáveis à versão exata da política que rodou. Detalhes em Operações.

Limitações e considerações

• Políticas duplicadas por tipo de documento. Política PJ não roda em CPF e vice-versa. Para cobrir ambos, crie duas políticas paralelas.
• Campos disponíveis dependem do nível de relatório. Regra que usa SCR não funciona em política com nível ESSENCIAL. Valide o nível antes de montar.
• Política sem fórmula não precifica. O resultado aprova ou nega, mas o toolbox entrega valor/prazo/taxa em branco. Ver Precificação.

Perguntas frequentes

Posso copiar uma política existente como base?

Sim. Na lista de políticas, botão Duplicar gera cópia com todos os grupos, regras e fórmulas, sem histórico. Equivalente a clonar um template.

O que acontece se eu desabilitar uma política em uso?

Ela some do dropdown de políticas que abre ao digitar um documento no input sempre visível, mas análises anteriores continuam rastreáveis. Reabilitar é instantâneo, sem perder histórico.

Posso mudar o tipo de documento de uma política PJ para PF depois?

Não. Tipo de documento é imutável. Crie uma política PF nova a partir de Duplicar da PJ e ajuste os campos.

Como simular uma política sem ativá-la?

Não há um modo de teste no toolbox: enquanto a política não está habilitada, ela não pode ser executada. Para validar o comportamento, habilite-a em um ambiente de homologação ou crie uma política paralela apenas para experimentação.

Posso ter mais de um score por política?

Sim, via grupos. Cada grupo pode ter score próprio (scoreApproved, scoreAlert, scoreDenied) e o resultado final agrega conforme a configuração de Score sintético da política.

Próximos passos

Editar Política

Ajustar regras e fórmulas existentes.

Usar Templates

Alternativa mais rápida do que criar do zero.

Precificação

Fórmulas, sintaxe, catálogo de funções.

Política (conceito)

Modelo de dados e semântica de decisão.