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.
Pré-requisitos
- Papel de administrador ou gestor de crédito.
- Entender o modelo de política e os tipos de fonte disponíveis.
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 inteligência (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. Na criação, escolha Onde a política é usada, obrigatório:
- Relatório: roda sozinha pelo campo de CPF/CNPJ e pelos disparos; mostra só o que as fontes do relatório trazem.
- Esteira: roda como etapa de esteira; mostra todas as variáveis, inclusive de formulário, e a esteira confere ao inserir.
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 destrava todo o resto. Ele é obrigatório no uso Relatório; no uso Esteira, existe também a opção Nenhum, que faz da política uma camada de aprofundamento:
- 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).
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 inteligência
“Configure como a inteligência da GYRA+ apoia a deliberação de crédito nesta política.”
- 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.
- Quem pode sobrepor a decisão: quem tem alçada para reverter uma decisão.
- Parecer IA: só leitura. Quem liga é a GYRA+; a tela mostra se está ativo e por quê.
- Rota por resultado: para Aprovado, Alerta e Alerta severo, decidir sozinha ou Enviar para revisão. Vale para relatórios avulsos; em esteiras, vale a etapa Decisão.
- Quem revisa: Analista, Comitê IA recomenda, analista decide ou Comitê IA decide. As opções do Comitê de Crédito IA só ficam disponíveis com Parecer IA ativo.
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, uma política de uso Relatório passa a aparecer para todos os usuários com permissão ao digitar um documento compatível; uma de uso Esteira fica disponível para as etapas das esteiras.
Salvar sem o Objetivo preenchido não passa: o editor avisa, leva você para Decisão e inteligência e marca a etapa como obrigatória.
Estrutura mínima recomendada
Toda política produção-ready tende a ter pelo menos três grupos:Versionamento
Toda alteração em regras, fórmulas ou fontes gera uma nova versão emPolicyChange com autor, timestamp e diff. O histórico completo fica na aba Histórico da política. Cada relatório e cada execução de esteira continuam rastreáveis à versão exata da política que rodou. Detalhes em Versões da política.
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?
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?
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?
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?
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?
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.

