Skip to main content
Esta página descreve a Política de Crédito, o conjunto de regras que controla decisões automáticas. A Política produz o Score durante a análise e usa as faixas de risco para chegar à Decisão Automática. Não confundir Política com Score: a Política é o conjunto de regras; o Score é o número final calculado por essas regras.

​
O que é uma Política de Crédito

Uma política de crédito é o conjunto de regras e critérios que define como a GYRA+ avalia um CPF ou CNPJ e chega a uma decisão automática. Ela responde a três perguntas:
  1. Quais dados consultar? → Define quais bureaus e integrações serão acionadas
  2. Quais critérios aplicar? → Define as regras de avaliação (score mínimo, limite de dívida, etc.)
  3. Qual a decisão? → Define quando aprovar, alertar ou negar
Toda chamada ao POST /report exige um policyId. Esse ID determina completamente o comportamento da análise.

​
As seis etapas de uma política

Toda política é montada nas mesmas seis etapas, na ordem em que aparecem no editor. As três primeiras respondem com o que decidir; as três últimas, como decidir.

Fontes de dados

De onde vêm os dados que esta política usa. Começa pelo Relatório base, que define o tipo de documento (CPF ou CNPJ) e o nível da análise, e a partir dele você liga só as fontes que fizerem sentido. Esta etapa destrava as outras: o Relatório base é o que determina quais variáveis existem para escrever regra em cima.

Minhas variáveis

Fórmulas reutilizáveis criadas por você, referenciadas por #nome em qualquer regra, faixa de risco ou fórmula de preço. Serve para escrever uma vez o cálculo que a sua casa repete em toda política.

Condições

O coração da política. Cada condição é um conjunto de regras avaliadas sobre os dados coletados, e cada uma aplica um veredito (aprovar, alerta ou negar) ou soma e subtrai pontos.

Classificação de risco

Opcional. Liga a pontuação e define os ratings por faixa de score, de 0 a 1000, com o veredito de cada faixa. Sem esta etapa ativa, as condições decidem direto; com ela ativa, a faixa final prevalece sobre o resultado individual das condições.

Precificação

Opcional. Fórmulas que sugerem limite, taxa e prazo a partir das variáveis do relatório. Ver Precificação.

Decisão e alçada

O objetivo da política, se o resultado é aplicado automaticamente ao relatório e quem pode alterar análises. É também onde vive a configuração do Comitê de Crédito IA, quando a política tem pipeline de parecer.
Duas etapas são obrigatórias: Fontes de dados, pelo Relatório base, e Decisão e alçada, pelo Objetivo, que o editor exige para salvar. Minhas variáveis, Classificação de risco e Precificação existem para quem precisa delas.

​
Fontes de dados

A primeira etapa é uma lista de cartões que você liga ou desliga. Só o que estiver ativo é coletado em runtime, o que significa que esta tela é também onde você controla custo e latência da análise.
Sem Relatório base definido, as demais etapas ficam bloqueadas: não há variáveis para escrever condição, faixa ou fórmula. É sempre o primeiro passo.
Uma exceção ao “só o que está ligado é coletado”: em relatórios COMPLETO e COMPLETO+, a busca por balanços já publicados roda de qualquer forma. O cartão Balanço patrimonial controla se o que for encontrado é processado automaticamente e se as variáveis de balanço ficam disponíveis nas regras, não se a busca acontece. Ver Análise Financeira.
Cenprot e Núclea são fontes adicionais, com custo por consulta além do relatório base. Ligue quando o dado for mudar a decisão, não por padrão. As demais fontes acompanham o nível do relatório contratado.

​
Status possíveis de uma decisão

Esse é o policyStatus retornado em todo relatório. Se ele deve ou não virar o status do relatório depende da configuração da política — veja Status do relatório × Status da política.

​
Decisão automática vs. análise manual

Cada política tem a opção “Usar resultado da política no relatório”:
  • Ligada: o resultado da política (policyStatus) é aplicado automaticamente ao status do relatório. Ideal para fluxos de alto volume (onboarding, checkout, crédito massificado).
  • Desligada: a política calcula o policyStatus como referência, mas o status do relatório fica PENDING até um analista decidir pela UI do Toolbox ou via POST /report/analyze. Ideal para mesa de crédito, due diligence e casos que exigem julgamento humano.
Mesmo com a opção ligada, a análise manual continua possível e sobrescreve o status do relatório, preservando o policyStatus original para auditoria.

​
Comitê de Crédito IA na política

Além do motor de regras, cada política define se o relatório vai a Comitê de Crédito IA, a deliberação de sete agentes especialistas e um Presidente sobre os pareceres do relatório. A configuração fica no bloco Comitê de Crédito IA da edição da política: O comitê só é convocado depois que os pareceres por seção e o resultado da política concluem, e depende de a política ter o pipeline de parecer habilitado.
Com “Usar resultado da política no relatório” ligado, o comitê só é convocado quando a política aprova. Política rejeitada não vai a comitê (o relatório fica com o comitê em SKIPPED, e ainda assim pode ser levado a comitê manualmente).
Nos planos Business e Enterprise, a mesma tela permite escrever instruções adicionais por agente, com o apetite de risco e os critérios internos da sua instituição. Detalhes em Comitê de Crédito IA.

​
Templates disponíveis

A GYRA+ oferece políticas prontas para os cenários mais comuns. Use o policyId correspondente ao chamar a API.
Você pode usar um template como ponto de partida e personalizar as regras, pesos e faixas de risco pelo painel do Toolbox ou pela API.

​
Como as regras são combinadas

Cada condição dentro de um grupo é formada por uma ou mais regras. As combinações possíveis são:

​
Score da condição

O score é uma dimensão separada da combinação de regras. Para cada status final de uma condição há um valor que é somado ao score acumulado:
  • APPROVED → soma um valor positivo (ex.: +30 pts)
  • ALERT → soma um valor negativo leve (ex.: -50 pts)
  • DENIED → soma um valor negativo forte (ex.: -100 pts)
A política parte de 1000 pts e, após somar os deltas de todas as condições, gera o score final:
  • Faixa válida: 1 a 1000 pts
  • Se o total exceder 1000, mantém-se o limite superior 1000
  • Se ficar abaixo de 1, mantém-se o limite inferior 1
A faixa em que o score final cair determina o statusToApply configurado em Risk[].

​
Opções de uso

Você tem três formas de trabalhar com políticas:

Usar template pronto

Escolha um dos templates da GYRA+ e comece a analisar imediatamente. Ideal para quem está começando.

Personalizar template

Parta de um template existente e ajuste regras, pesos e critérios para a sua estratégia de risco.

Criar do zero

Configure uma política completamente nova com suas próprias variáveis, condições e faixas de decisão.
Para criar ou editar políticas pelo painel, acesse Políticas de Decisão no menu do Toolbox. Para gerenciar via API, veja a referência do endpoint de políticas.
Regra Tem mandato: disponível para uso em políticas de PF (relatórios COMPLETO e COMPLETO+). Avalia se o CPF possui mandado de prisão ativo no CNJ no mês corrente. Veja detalhes na seção CRIMINAL_RECORD.