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.
Esta página descreve a Decisão Automática, o resultado que a Política de Crédito atribui ao relatório. A Decisão Automática usa o Score como uma das entradas. Para entender como a política é configurada, ver Política de Crédito.
O que é a decisão automática
Toda vez que um relatório é gerado, a política de crédito escolhida avalia as informações coletadas e atribui um status à análise. Esse status é a decisão automática. A decisão automática fica registrada no relatório comopolicyStatus (status da política). Se ela vai virar o status final do relatório ou ficar apenas como referência depende de como a política está configurada (ver Modo automático vs modo manual).
Status possíveis
| Status | O que significa |
|---|---|
Aprovada (APPROVED) | A política considerou o caso aceitável. |
Negada (DENIED) | A política recusou automaticamente. |
Alerta (ALERT) | A política indicou que o caso precisa de análise manual. |
Não executada (NOT_EXECUTED) | O relatório ainda não foi avaliado por uma política. |
Pendente (PENDING) | A análise está em andamento. |
Não aplicável (NOT_APPLICABLE) | A política existe mas não se aplica ao caso (por exemplo, política de PJ aplicada a CPF). |
Como a política chega à decisão
A política avalia condições, soma pontos e produz um Score. Em seguida, compara o Score com as faixas de risco configuradas para escolher o status. Por exemplo, com a faixa de risco abaixo:| Score | Decisão |
|---|---|
| 1 a 400 | Negada |
| 401 a 700 | Alerta |
| 701 a 1000 | Aprovada |
policyStatus: APPROVED.
Override por condição crítica
Algumas condições podem forçar uma decisão independente do Score. Por exemplo, “presença em lista de sanções” pode forçarDENIED mesmo que o Score esteja alto. Essas condições são configuradas no editor de política.
Modo automático vs modo manual
Cada política tem um toggle chamado “Usar resultado da política no relatório” que define se a decisão automática vira o status do relatório:- Ligada (modo automático): o
policyStatusé copiado para ostatusdo relatório assim que a política é avaliada. O relatório já chegaAPPROVED,DENIEDouALERTsem precisar de ação humana. Útil em fluxos de alto volume (onboarding, checkout). - Desligada (modo manual): a política calcula o
policyStatusnormalmente (e ele fica visível no relatório como referência), mas ostatusdo relatório só muda quando um operador decide via Toolbox ou viaPOST /report/analyze. Útil quando a política é apoio à mesa de crédito, não decisor final.
status, mesmo no modo automático. O policyStatus original é preservado para auditoria. Ver O que é um Relatório para detalhes.
Decisão automática vs análise manual
A decisão automática é o que a política decide sozinha. Quando opolicyStatus é ALERT (ou quando a política está em modo manual), o caso fica disponível para um operador da mesa de crédito revisar e registrar uma decisão manual. A análise manual não altera o policyStatus original; ela altera o status do relatório, com autoria e timestamp.
Onde ver na plataforma
Ostatus aparece em destaque na lista de operações e na tela do relatório. O detalhamento de quais condições contribuíram para a decisão fica na seção “Política de Crédito” do relatório, junto com o policyStatus original.
Para integradores
Na API, a decisão automática vem comopolicyStatus no relatório. O detalhamento das condições e contribuições de pontos vem na seção CREDIT_POLICY. Ver Seção: Política de Crédito.