Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt

Use this file to discover all available pages before exploring further.

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

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

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.