Skip to main content
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

​
Fluxo

O editor tem um menu Configurar política à esquerda com seis etapas. Você não precisa percorrer todas: só duas são obrigatórias, Fontes de dados (o Relatório base) e Decisão e alçada (o Objetivo). As outras quatro existem para quem precisa delas.
1

Entrar em Nova Política

Política de Crédito, Políticas, Nova política. O editor abre em branco, com o menu de etapas à esquerda e o nome da política no topo, ao lado do status Inativa.
2

Fontes de dados

“Escolha de onde vêm os dados que esta política usa nas análises. Ative só o que fizer sentido para o seu processo.”Comece pelo Relatório base, que é obrigatório e destrava todo o resto:
  • Tipo de documento: Pessoa Jurídica (CNPJ) ou Pessoa Física (CPF).
  • Nível: Simples (cadastral, contatos, renda e sócios diretos), Essencial (+ rede até 3º grau, processos desde 2014 e alterações cadastrais), Completo (+ PEP, sanções e certidões oficiais) ou Completo+ (+ processos desde 1980, licenças e benefícios).
Definido o Relatório base, ligue as fontes que fizerem sentido:
Só o que estiver ligado aqui é coletado quando a análise roda. Esta tela é onde você controla custo e latência da política.Uma exceção: em relatórios COMPLETO e COMPLETO+, a busca por balanços publicados roda de qualquer forma. O cartão Balanço patrimonial controla se o que for encontrado é processado automaticamente, não se a busca acontece.
3

Minhas variáveis, opcional

“Fórmulas reutilizáveis. Use #nome em qualquer regra, classificação de risco ou precificação.”Crie aqui o cálculo que a sua casa repete em toda política, uma vez só. Depois é só referenciar por #nome nas etapas seguintes. Pule se a sua primeira política não precisar.
4

Condições

“Cada condição é um conjunto de regras avaliadas.”É onde a política decide de fato. Cada condição reúne uma ou mais regras (campo, operador e valor) e define o que acontece quando ela é satisfeita: aplicar um veredito (aprovar, alerta ou negar), ou somar e subtrair pontos, se a Classificação de risco estiver ativa.O editor valida enquanto você escreve: campo inexistente, operador incompatível com o tipo do dado e parâmetro faltando são bloqueados antes de salvar.
5

Classificação de risco, opcional

“Defina os ratings dos relatórios por faixas de pontuação (0 a 1000).”Ative se quiser que as condições pontuem em vez de decidir individualmente. Aqui você cria as faixas de score e o veredito de cada uma: aprovar, enviar para análise humana ou reprovar.
A ordem importa. Ative a Classificação de risco antes de voltar às Condições para definir quantos pontos cada uma soma ou subtrai. Com ela ativa, a faixa final prevalece sobre o resultado individual das condições.
6

Precificação, opcional

“Fórmulas que sugerem taxa, prazo e valor a partir das variáveis do relatório.”Três fórmulas em sintaxe de planilha, para limite, taxa e prazo. Catálogo e exemplos em Precificação.
7

Decisão e alçada

“Objetivo da política, decisão automática e quem pode alterar análises.”
  • Objetivo da política, obrigatório para salvar. É o que a operação está decidindo (capital de giro, contratação, abertura de conta), e serve de contexto para a análise de IA.
  • Usar resultado da política no relatório: ligado, o resultado vira o status do relatório automaticamente; desligado, o relatório fica pendente até um analista decidir.
  • Quem pode alterar análises: os papéis com alçada para reverter uma decisão.
  • Comitê de Crédito IA, quando o Relatório base tem pipeline de parecer: se o comitê é convocado sozinho e em qual modo.
8

Salvar e habilitar

Salve e ligue o toggle de status no topo. Enquanto estiver Inativa, a política não aparece no input de análise e não pode ser executada. Ativada, ela passa a aparecer para todos os usuários com permissão ao digitar um documento compatível.
Salvar sem o Objetivo preenchido não passa: o editor avisa, leva você para Decisão e alçada e marca a etapa como obrigatória.
Para a primeira política, o caminho mais curto é: Relatório base, três ou quatro Condições de corte óbvio e Decisão e alçada com o objetivo preenchido. Classificação de risco e Precificação você adiciona depois, quando já tiver volume para calibrar.

​
Estrutura mínima recomendada

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

​
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

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.
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.
Não. Tipo de documento é imutável. Crie uma política PF nova a partir de Duplicar da PJ e ajuste os campos.
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.
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.