Editar Política

Ajustar regras, thresholds, fórmulas e mensagens de uma política existente. Versionamento e como reverter.

Resumo: editar uma política é o trabalho contínuo de calibração: ajustar thresholds à medida que os resultados reais aparecem, adicionar regras novas quando o risco muda, corrigir fórmulas de precificação. Toda edição gera uma nova versão automaticamente, com diff e autor. Esta página cobre o fluxo de edição e as mecânicas de versionamento e reversão.

Quando editar

• Calibrar thresholds a partir de casos reais (taxa de aprovação baixa demais, falsos negativos, default inesperado).
• Adicionar regra para cobrir um cenário novo (ex: novo tipo de restritivo, nova fonte disponível).
• Ajustar precificação (taxa, prazo, valor aprovado) em resposta a mudança de funding ou apetite.
• Desabilitar regra que está gerando ruído sem valor discriminante.

Pré-requisitos

• Papel de administrador ou gestor de crédito.
• Política já existe (criada do zero ou clonada de template).

Fluxo

1. Abrir a política

   Em Política de Crédito, Políticas, clicar na política que você quer editar. O editor abre com o estado atual.

2. Entrar em modo edição

   Toggle Editar no cabeçalho. Enquanto em edição, as alterações ficam em um rascunho não publicado, a política em produção continua rodando a versão anterior para quem disparar análise.

3. Fazer as alterações

   Tudo que pode ser editado:

   • Cabeçalho: nome, nível de relatório, produto vinculado. (O tipo de documento PF/PJ é imutável.)
   • Grupos: adicionar, remover, renomear, mudar score agregado (scoreApproved, scoreAlert, scoreDenied).
   • Regras: adicionar, remover, desabilitar, ajustar campo/operador/threshold/status.
   • Fórmulas: periodFormula, interestFormula, amountFormula. Ver Precificação.
   • Dados consultados: ativar ou desativar SCR, janela de processos, níveis de vínculos societários.
   • Mensagens: textos mostrados para APPROVED, ALERT, DENIED.
4. Ver o diff

   Botão Ver alterações mostra, lado a lado, o que mudou em relação à versão publicada: regras adicionadas, removidas, alteradas, fórmulas antes/depois.

5. Publicar

   Clicar em Publicar. A nova versão passa a ser a vigente imediatamente. Qualquer análise disparada a partir desse momento usa a nova versão.

Análises disparadas antes da publicação continuam rastreáveis à versão antiga da política. A tela de resultado sempre mostra qual versão rodou.

Versionamento

Toda publicação gera uma nova versão da política. Cada relatório gerado registra a versão da política que rodou na análise, o que permite rastrear qualquer decisão ao conjunto exato de regras vigentes no momento.

Na tela da política, a aba Histórico lista todas as versões publicadas com autor, data e o que mudou. A consulta do histórico é feita apenas pelo toolbox (não exposta via API).

Boas práticas

Uma mudança por publicação

Facilita entender o impacto. Evite empilhar 10 ajustes numa única publicação.

Descrição sempre preenchida

O campo descrição na publicação é o commit message da política. Futuro você agradece.

Testar antes de publicar

Ao menos 1 caso APPROVED, 1 DENIED e 1 limítrofe.

Janela de observação

Depois de alterar threshold crítico, observe as próximas 20 a 50 análises antes de consolidar.

Limitações e considerações

• Edição concorrente: se dois usuários editam a mesma política ao mesmo tempo, o último a publicar sobrescreve. A tela alerta se outra edição está em curso.
• Tipo de documento imutável. PF não vira PJ. Para mudar, duplique e edite a cópia.
• Nível de relatório impacta campos disponíveis. Reduzir o nível (ex: de COMPLETO para ESSENCIAL) invalida regras que usam campos SCR; o editor bloqueia a publicação até você remover ou desabilitar.
• Fórmulas com variáveis inexistentes bloqueiam o salvar. Se uma variável referenciada sumiu, corrija antes de publicar.

Perguntas frequentes

Posso editar uma política que está em uso por um lote em processamento?

Pode. O lote em curso continua usando a versão vigente no momento em que foi disparado. Só novas análises pegam a versão nova.

Existe limite de versões por política?

Não. Todas as versões ficam salvas indefinidamente, com diff completo.

Como comparo duas versões não consecutivas?

Na aba Histórico, selecionar duas versões (checkbox) e clicar em Comparar. Mostra o diff acumulado entre as duas.

Desabilitei uma regra, mas ela ainda aparece no breakdown das análises antigas.

Correto. Análises antigas são rastreáveis à versão da política que rodou no momento. A regra não é apagada, só deixa de avaliar em análises futuras.

Qualquer usuário vê o histórico?

Administradores e gestores de crédito veem. Analistas veem apenas a versão vigente.

Próximos passos

Criar Política

Do zero, quando nenhum template serve.

Usar Templates

Partir de um template pronto.

Precificação

Fórmulas de prazo, taxa e valor.

Interpretar Resultado

Calibrar thresholds a partir do breakdown.