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:- Quais dados consultar? → Define quais bureaus e integrações serão acionadas
- Quais critérios aplicar? → Define as regras de avaliação (score mínimo, limite de dívida, etc.)
- Qual a decisão? → Define quando aprovar, alertar ou negar
POST /report exige um policyId. Esse ID determina completamente o comportamento da análise. A política precisa ser de uso Relatório: uma política de uso Esteira é recusada com 400 e a mensagem “Esta política é de esteira: rode a esteira que a usa.”
Onde a política é usada
Toda política declara onde roda, em Onde a política é usada. A escolha é obrigatória ao criar a política e pode ser trocada no topo de Fontes de dados. A lista de políticas mostra a coluna Uso e filtra por ela, e o topo do editor mostra o selo Uso: Relatório ou Uso: Esteira.- A camada de aprofundamento (relatório base Nenhum) é sempre de uso Esteira. A opção Nenhum só aparece no uso Esteira.
- Trocar de Esteira para Relatório exige relatório base, e é recusado se a política usa algo que depende de fonte fora do relatório base e das fontes declaradas, ou de dado de formulário.
- A troca de uso muda o catálogo do editor depois de salvar: “As variáveis e regras oferecidas no editor mudam para o novo uso depois de salvar.”
- Depois de salvar uma política de uso Esteira, o editor diz em quais esteiras ela está e o que a conferência de cada uma acusou.
- Uma política usada por esteira ativa não pode ser desativada nem excluída: “Não é possível desativar esta política: ela está na esteira ativa “X”. Troque a política nessas esteiras ou desative-as antes.”
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 nível da análise, e pelo tipo de documento (toda política é de CPF ou de CNPJ), e a partir deles 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 inteligência
O objetivo da política, quem pode sobrepor a decisão, o Parecer IA, a rota de cada resultado e quem revisa, inclusive o Comitê de Crédito IA.
Duas etapas são obrigatórias: Fontes de dados, pelo Relatório base, e Decisão e inteligência, 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.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.
Cada condição precisa de uma fonte declarada
Numa política de uso Relatório, uma regra só pode avaliar um dado que alguma fonte da política traz. (Numa política de uso Esteira, quem confere é a esteira, ao receber a política numa etapa.) Se você escreve uma condição de score e a política não declara nenhum bureau nem um add-on de score, o editor avisa e não salva: A camada não pode ser salva enquanto essa regra estiver sem fonte. O seletor de regra também diz o que falta, por exemplo Escolha um bureau nas Fontes de dados. ou Declare o add-on “Quantidade de credores” nas Fontes de dados. Pela API, salvar uma política nessa situação devolve422 com a condição e a fonte que falta:
Dados de entrada nas regras
Numa política de uso Esteira, além das fontes, uma regra pode usar os dados de entrada do caso: o que chegou pela proposta, pelo formulário, pelos documentos ou pelas verificações. Eles aparecem no seletor de fórmula como variáveisinputs.<chave>, com o rótulo Dado de entrada: …, agrupadas em Proposta, Formulário, Documentos e Verificações.
- O campo de formulário também entra nas Condições como regra própria, sem fórmula.
- A política de uso Relatório não oferece dados de entrada: fora da esteira, eles não chegam.
- A política só espera os dados de entrada quando alguma regra os usa.
- Dado de entrada ausente deixa a regra em erro (Indisponível), em vez de aprovar ou negar por acidente.
- Uma fórmula não mistura dado de entrada com outra fonte: o editor recusa ao salvar.
- No relatório, os valores aparecem na seção Dados de entrada, legíveis (Sim/Não, datas, valores em reais).
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.
Rota por resultado
Em Decisão e inteligência, o bloco Rota por resultado diz o que acontece com cada resultado da política num relatório avulso. Em esteiras, vale a etapa Decisão.- Automático: o resultado da política (
policyStatus) vira ostatusdo relatório. Ideal para fluxos de alto volume (onboarding, checkout, crédito massificado). - Revisão: a política calcula o
policyStatuscomo referência, e ostatusdo relatório ficaPENDINGaté alguém decidir pela tela ou viaPOST /report/analyze. Ideal para mesa de crédito e casos que exigem julgamento humano.
status do relatório, preservando o policyStatus original para auditoria. O cartão Como esta política decide desenha, no topo da seção, o caminho que um relatório da política percorre hoje.
Comitê de Crédito IA na política
Além do motor de regras, cada política define quem revisa os resultados que vão para revisão, inclusive o Comitê de Crédito IA, a deliberação de sete agentes especialistas e um Presidente sobre os pareceres do relatório. A escolha fica em Quem revisa, no bloco Rota por resultado:Parecer IA
O comitê delibera sobre os Pareceres IA, e por isso só fica disponível quando a política tem Parecer IA ativo. Quem liga e desliga o Parecer IA é a GYRA+: no bloco Parecer IA, a política mostra só o status (Ativo nesta política ou Desligado) e o motivo, por exemplo “Incluído no relatório Completo. Habilitado pela GYRA+.” ou “Parecer IA não habilitado nesta política. Fale com a GYRA+ para habilitar.” É um recurso adicional, cobrado por relatório. Se a política estava configurada para o comitê e o Parecer IA foi desligado, a tela avisa que o comitê não vai rodar, sem apagar a configuração. Com o recurso de instruções do comitê habilitado na organização, 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 opolicyId correspondente ao chamar a 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)
- Faixa válida: 1 a 1000 pts
- Se o total exceder
1000, mantém-se o limite superior1000 - Se ficar abaixo de
1, mantém-se o limite inferior1
statusToApply configurado em Risk[].
Versões da política
Cada relatório registra a versão da política que rodou, e a versão só sobe quando algo que afeta a decisão muda.
Assim, rodar a análise de novo no mesmo dia depois de mudar a regra gera um resultado com a versão nova, e nunca mistura regras diferentes sob o mesmo número.
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.
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.
