Matriz de Risco

Para que serve

A Matriz de Risco é a régua que o motor usa para decidir, sozinho, o destino de cada processo: seguir sem intervenção, ir para análise manual ou ser rejeitado. Ela combina uma pontuação de risco, calculada a partir dos dados do caso, com condições que bloqueiam ou mandam o caso para revisão independentemente da pontuação.

A tela aparece no menu para os perfis Administrador e Supervisor. Analista e Visualizador não têm acesso.

Ajustes aqui alteram o volume de trabalho da equipe de análise e o apetite a risco da operação. As alterações valem para os processos analisados depois do salvamento; casos já decididos mantêm a decisão e o score com que foram avaliados.

Qual editor aparece na sua instância

A tela existe em duas versões, e a instância mostra apenas uma delas. O que decide é o idioma do painel da instituição.

Painel da instituição	Editor exibido	Em resumo
Em português	Editor simples	Uma matriz única, com dois limiares e fatores que somam pontos
Em espanhol (instâncias da Argentina e do Uruguai)	Editor por grupos	Matrizes por fluxo e por tipo de pessoa, com quatro grupos de fatores ponderados, faixas de risco e condições de bloqueio e revisão

As duas versões têm o mesmo título, MATRIZ DE RISCO, e os botões Recarregar e Salvar alterações. O restante é diferente, e a lógica de decisão também. Leia apenas a parte que corresponde ao seu painel.

Editor simples (painel em português)

Como o motor decide

A decisão acontece em duas etapas, na ordem abaixo.

1. Fatores de bloqueio. São avaliados primeiro. Se qualquer um for satisfeito, o caso é bloqueado automaticamente e a pontuação não é considerada.
2. Fatores de pontuação. Cada fator cuja condição for satisfeita soma o seu Peso ao score. O total é comparado com os dois limiares.

Score do caso	Resultado
Maior ou igual ao valor de Bloqueio (block)	Bloqueio automático
Maior ou igual ao valor de Revisão (review)	Análise manual
Abaixo do valor de Revisão (review)	A matriz não encaminha o caso para revisão nem o bloqueia

O mesmo resumo aparece no quadro Como funciona o cálculo de risco, no fim da tela.

Mapa da tela

Área	O que mostra
Cabeçalho	O título, o subtítulo e os botões Recarregar e Salvar alterações
Faixa de informações	Escopo, Última atualização, Fatores e o selo Ativa ou Inativa
Limiares de decisão	Os campos Revisão (review) e Bloqueio (block)
Fatores de pontuação	A tabela de fatores que somam pontos
Fatores de bloqueio	A tabela de fatores que bloqueiam o caso
Como funciona o cálculo de risco	O resumo da lógica de decisão

Na faixa de informações, o Escopo mostra sempre Global (todos os flows): este editor trabalha com uma matriz única, que vale para todos os fluxos. O campo Fatores informa quantos fatores de pontuação e quantos de bloqueio existem. O selo Ativa ou Inativa é apenas informativo; a tela não oferece ação para ativar ou desativar a matriz.

Abaixo do título Limiares de decisão, uma frase de ajuda repete os dois valores em uso e acompanha o que você digita.

Fatores

Cada linha das duas tabelas é uma condição sobre um dado do caso.

Coluna	Uso
Código	Identificador do fator. É o nome que aparece nas mensagens de validação
Nome	Descrição curta, para quem lê a tabela
Campo	Nome técnico do dado avaliado
Operador	Como o dado é comparado com o Valor
Valor	O valor de comparação
Peso	Pontos somados quando a condição é satisfeita. Existe só na tabela Fatores de pontuação
Ações	Ícone Remover fator

Operador	Significado
=	Igual a
≠	Diferente de
>	Maior que
≥	Maior ou igual a
<	Menor que
≤	Menor ou igual a

Um exemplo de condição: Campo kyc.is_pep, Operador =, Valor true descreve a situação em que a pessoa é PEP.

A tela não oferece lista de campos e não confere se o nome digitado existe. Digite o nome exato do dado; um erro de digitação não é apontado ao salvar.

Um fator novo de pontuação começa com o operador ≥ e Peso 10. Um fator novo de bloqueio começa com o operador =. O Peso aceita números inteiros a partir de zero.

O cabeçalho da tabela Fatores de pontuação mostra o peso total, a soma dos pesos de todos os fatores de pontuação. É a maior pontuação que um caso consegue somar, e ajuda a escolher limiares coerentes: um limiar de revisão acima do peso total nunca é alcançado.

Ações

Ação	Efeito	Atenção
Adicionar	Cria uma linha vazia no fim da tabela correspondente
Remover fator	Apaga a linha	Apaga na hora, sem confirmação. Só se torna definitivo ao salvar
Salvar alterações	Valida e grava a matriz	Havendo problema, nada é gravado
Recarregar	Busca de novo a matriz salva	Descarta, sem confirmação, tudo que não foi salvo

Se ainda não existe matriz, a tela abre com Revisão (review) 151, Bloqueio (block) 701 e nenhum fator. O primeiro salvamento cria a matriz e mostra o aviso “Matriz de risco criada.”. Nos salvamentos seguintes, o aviso é “Matriz de risco atualizada.”.

A tela não avisa ao sair com alterações pendentes. Trocar de tela ou fechar a aba do navegador perde o que não foi salvo.

Validação ao salvar

A tela confere a matriz antes de gravar e mostra a primeira mensagem encontrada. Corrija e salve de novo.

Mensagem	Como corrigir
Limite de bloqueio precisa ser maior que o de revisão.	Deixe Bloqueio (block) acima de Revisão (review). Valores iguais também são recusados
Limites não podem ser negativos.	Use zero ou mais nos dois limiares
Cada fator precisa de um código.	Preencha Código na linha vazia
Fator “código” precisa de um nome.	Preencha Nome no fator indicado
Fator “código” precisa de um campo (field).	Preencha Campo no fator indicado
Peso negativo no fator “código”.	Use zero ou mais no Peso do fator indicado

Editor por grupos (painel em espanhol)

Como o motor decide

A pontuação vai de 0 a 1000 e é uma média ponderada em dois níveis.

1. Cada subfator recebe de 0 a 100 pontos, conforme a regra que se aplica ao caso.
2. Dentro de cada grupo, os subfatores entram em média ponderada pelo peso de cada um. Os pesos dos subfatores de um grupo somam 100%.
3. Os quatro grupos entram em média ponderada pelo Peso do grupo, que também soma 100%. O resultado é multiplicado por 10, o que leva a escala a 0 a 1000.

Um subfator sem dado, ou sem regra que se aplique ao caso, vale zero, e o peso dele continua na conta: ele puxa a média do grupo para baixo em vez de ser ignorado. A instituição pode pedir ao suporte que esse peso seja redistribuído entre os demais subfatores; essa opção não aparece na tela.

Com o score calculado, a decisão segue as faixas e as condições.

Situação	Resultado
Score maior que Baixo até	Análise manual (ou seja, casos Médio e Alto vão para revisão)
Score maior que o valor de Bloqueio a partir de	Rejeição automática
Algum fator de bloqueio satisfeito	Rejeição automática
Algum override com efeito Rejeição satisfeito	Rejeição automática
Algum override com efeito Forçar Alto ou Revisão manual satisfeito	Análise manual
Algum gatilho de revisão manual satisfeito	Análise manual

As condições só agravam a decisão, nunca a aliviam. Quando mais de uma se aplica, vale a mais severa: rejeição prevalece sobre revisão, e revisão prevalece sobre seguir sem intervenção. Nenhum override desfaz um bloqueio.

Atenção aos limites exatos. Um score exatamente igual a Baixo até não vai para revisão, e um score exatamente igual ao valor de Bloqueio a partir de não é rejeitado: em ambos os casos é preciso ultrapassar o valor. Apesar do nome do campo, a frase de ajuda da tela, “Score maior que”, descreve o comportamento correto.

Limiar de revisão separado. A instituição pode ter um limiar de revisão configurado pelo suporte, independente das faixas. Nesse caso, a revisão manual segue esse limiar, e as faixas passam a servir só para classificar o risco. Esse limiar não aparece na tela, e salvar pela tela não o altera.

Mapa da tela

Área	O que mostra
Cabeçalho	Título, subtítulo e os botões Recarregar, Exportar resumo e Salvar alterações
Ver o registro de listas restritivas	Link para o registro, somente leitura, das listas usadas nos bloqueios
Escopo	O seletor da matriz em edição, com uma frase de ajuda ao lado
Painel de resumo	Escopo, Última atualização, soma dos pesos dos grupos, selos e a barra de distribuição dos pesos
Abas de tipo de pessoa	Pessoa Física (KYC) e Pessoa Jurídica (KYB)
Cartões de grupo	Cliente, Produto e serviço, Zona geográfica e Canal de distribuição
Faixas de risco	Os campos Baixo até, Médio até e Bloqueio a partir de
Overrides automáticos	Condições que forçam uma decisão
Fatores de bloqueio (hard blocks)	Condições que rejeitam o caso
Gatilhos de revisão manual	Condições que mandam o caso para análise manual
Como funciona o cálculo de risco	Quadro com o resumo da lógica

O quadro Como funciona o cálculo de risco é o mesmo do editor simples e fala em limiares de revisão e bloqueio. Neste editor, vale a descrição da seção Como o motor decide acima.

Escopo: matriz global ou por fluxo

Existe uma matriz global, que vale para todos os fluxos, e cada fluxo pode ter a sua própria. O seletor Escopo lista primeiro Global e depois cada fluxo. Entre parênteses, cada opção informa para quais tipos de pessoa aquele escopo tem matriz própria, por exemplo “Pessoa Física (KYC) + Pessoa Jurídica (KYB)”, ou indica “sem matriz própria”.

Ao abrir, a tela seleciona o primeiro escopo que tem matriz. Se nenhum tiver, seleciona Global.

Enquanto houver alterações não salvas, o seletor fica travado e a frase ao lado passa a ser “Há alterações não salvas. Salve ou recarregue antes de trocar de escopo.”.

Fluxo sem matriz própria. Um fluxo sem matriz própria usa a global. Ao selecioná-lo, o painel de resumo avisa: “Este flow não tem matriz própria: você está vendo a matriz global. O que salvar aqui vale para todos os flows.”. Salvar nessa situação altera a matriz global, e portanto todos os fluxos. Para mudar apenas aquele fluxo, use antes o botão Criar uma matriz própria para este flow: ele copia a global para um rascunho ligado ao fluxo, e salvar o rascunho cria a matriz do fluxo sem tocar na global.

Tipo de pessoa

Cada escopo tem uma matriz para Pessoa Física (KYC) e outra para Pessoa Jurídica (KYB), em abas. As duas são independentes: pesos, regras, faixas e condições de uma não afetam a outra.

Se um tipo de pessoa não tem matriz nem no fluxo nem na global, a aba mostra “Este escopo não tem matriz configurada” e o botão Partir da linha de base. Ele monta um rascunho com a configuração padrão, marcado com o selo Rascunho e com o aviso de que ainda não existe no servidor. O rascunho não vale para nenhum caso até ser salvo.

Confira as faixas antes de salvar um rascunho. O rascunho da linha de base traz Baixo até 150, Médio até 350 e Bloqueio a partir de 700. Com esses valores, um score acima de 700 é rejeitado automaticamente. As matrizes iniciais das instâncias da Argentina e do Uruguai usam outros valores, 400, 700 e 1000.

Grupos e subfatores

Cada grupo é um cartão com o nome, uma descrição, a quantidade de subfatores e o campo Peso do grupo, de 0 a 100. Clique no título para abrir ou fechar o cartão.

Grupo	Peso na linha de base	Subfatores na linha de base
Cliente	40%	Condição PEP, Atividade econômica, Sujeito obrigado, Tempo de relacionamento, Idade (só PF), Forma societária (só PJ), Tempo de constituição da empresa (só PJ)
Produto e serviço	15%	Produto contratado, Volume mensal, Volume anual
Zona geográfica	25%	País de nacionalidade (na aba PJ, País de constituição), Código postal
Canal de distribuição	20%	Canal de abertura

A composição acima é a da linha de base. A matriz salva na sua instância pode ter outros pesos.

O painel de resumo soma os pesos dos grupos e mostra “Os pesos somam 100%.” quando a conta fecha, ou a mensagem com o total atual quando não fecha. A barra logo abaixo mostra a participação de cada grupo.

Aberto o cartão, cada subfator mostra o nome, o Campo de origem (o nome técnico do dado lido, apenas para consulta) e o seu peso. O campo de peso do subfator também aparece com o rótulo Peso do grupo; nesse lugar, ele é o peso do subfator dentro do grupo. O cartão informa a soma em “Subfatores: total%” e exibe o selo ≠ 100% quando a soma do grupo não fecha.

Regras de um subfator

O botão Ver valores abre uma janela com o nome do subfator. O conteúdo depende do tipo de subfator.

Subfatores com regras. A janela é uma tabela editável. Cada regra define uma situação, a Faixa e a Pontuação que o caso recebe nela.

Coluna	Uso
De e Até	Intervalo numérico. Aparecem em Tempo de relacionamento, Idade, Tempo de constituição da empresa, Volume mensal e Volume anual. Até vazio significa sem limite superior
Valor	O valor exato, nos demais subfatores
Faixa	Baixo, Médio ou Alto
Pontuação	De 0 a 100

Adicionar regra cria uma linha, e Remover regra a apaga na hora. Sem nenhuma regra, a tabela mostra “Sem regras. Adicione uma.”. Fora da janela, o botão Ver valores exibe quantas regras o subfator tem.

Subfatores de catálogo. Atividade econômica, País de nacionalidade ou de constituição, Código postal e Canal de abertura leem um catálogo, e o botão Ver valores leva o selo Catálogo. A janela é uma lista somente leitura, com busca e as colunas Valor, Descrição e Risco. A pontuação vem do risco registrado no catálogo e não é editada aqui.

Risco no catálogo	Pontuação do subfator
Baixo	0
Médio	50
Alto	100

A lista mostra no máximo 500 valores. Acima disso, aparece “Mostrando os primeiros 500. Refine a busca para encontrar um valor.”.

Faixas de risco

Campo	Efeito
Baixo até	Score até este valor é Baixo. Acima dele, o caso vai para análise manual, salvo limiar de revisão separado
Médio até	Score até este valor é Médio; acima, Alto
Bloqueio a partir de	Score maior que este valor é rejeitado automaticamente

Abaixo dos campos, uma barra de 0 a 1000 mostra as faixas Baixo, Médio, Alto e Bloqueio com os valores em uso.

A regra de ordem é: Baixo até menor que Médio até, e Médio até menor ou igual ao valor de bloqueio.

Overrides, bloqueios e gatilhos de revisão

As três tabelas usam condições sobre um dado do caso, com as colunas Código, Campo, Operador e Valor, e a coluna Ações. As tabelas Fatores de bloqueio (hard blocks) e Gatilhos de revisão manual têm também a coluna Nome, e a tabela Overrides automáticos tem a coluna Efeito. Os operadores são os mesmos do editor simples: =, ≠, >, ≥, < e ≤.

Tabela	Quando a condição é satisfeita	Botão para incluir
Overrides automáticos	Aplica o Efeito escolhido	Adicionar override
Fatores de bloqueio (hard blocks)	Rejeita o caso, sem possibilidade de override	Adicionar bloqueio
Gatilhos de revisão manual	Manda o caso para a fila de análise manual	Adicionar gatilho

Efeito do override	Resultado
Forçar Alto	Análise manual
Rejeição	Rejeição automática
Revisão manual	Análise manual

Um override novo começa com o efeito Forçar Alto.

O Campo é digitado; a tela não oferece lista de campos. Uma condição sobre um dado que o caso não tem nunca é satisfeita, então um nome digitado errado simplesmente não produz efeito. O ícone Remover fator apaga a linha na hora, sem confirmação.

Salvar, recarregar e exportar

Ação	Efeito	Atenção
Salvar alterações	Valida e grava os tipos de pessoa alterados	Indisponível enquanto não houver alteração
Recarregar	Busca de novo os escopos e a matriz salva, mantendo o escopo selecionado	Descarta, sem confirmação, o que não foi salvo
Exportar resumo	Baixa o documento Resumo de configuração da Matriz de Risco do Cliente	Descreve a configuração salva. Indisponível em um rascunho

Ao salvar, a tela grava apenas o tipo de pessoa que foi alterado. Se houver erro de validação, ela muda para a aba com problema, mostra a mensagem e não grava nada. Concluído o salvamento, aparece “Matriz de risco atualizada.”.

O resumo exportado é um anexo técnico que comprova como está parametrizado o modelo de classificação de risco do cliente, e acompanha a Declaração de Tolerância ao Risco assinada pela instituição. Ele cobre o tipo de pessoa da aba ativa, no escopo em uso, e lê o que está gravado: alterações não salvas não aparecem no documento.

A tela não avisa ao sair com alterações pendentes. Se a leitura de uma das abas falhar, só ela mostra o erro, com a opção de tentar de novo, e as alterações da outra aba são preservadas.

Validação ao salvar

Mensagem	Como corrigir
A soma dos pesos dos grupos precisa ser 100% (atual total%).	Ajuste o Peso do grupo nos cartões até fechar 100%
Os pesos dos subfatores de “grupo” precisam somar 100% (atual total%).	Abra o cartão com o selo ≠ 100% e ajuste os pesos dos subfatores
As faixas precisam respeitar: Baixo menor que Médio, e Médio menor ou igual que Bloqueio.	Reordene os três campos de Faixas de risco

Na mensagem sobre os subfatores, o grupo aparece pelo nome interno, e não pelo rótulo do cartão: cliente corresponde a Cliente, producto a Produto e serviço, canal a Canal de distribuição e jurisdiccion a Zona geográfica.

Tarefas comuns

Reduzir a fila de análise manual (editor simples).

1. No campo Revisão (review), aumente o valor em um incremento pequeno.
2. Confira que Bloqueio (block) continua maior que Revisão (review).
3. Clique em Salvar alterações.
4. Acompanhe o efeito na aba Matriz de Risco do Dashboard antes de um novo ajuste.

Criar uma regra de bloqueio (editor simples).

1. Em Fatores de bloqueio, clique em Adicionar.
2. Preencha Código e Nome.
3. Informe o Campo, escolha o Operador e digite o Valor.
4. Clique em Salvar alterações e confira o aviso de confirmação.

Calibrar apenas um fluxo (editor por grupos).

1. No seletor Escopo, escolha o fluxo.
2. Se aparecer o aviso de que o fluxo usa a matriz global, clique em Criar uma matriz própria para este flow.
3. Confira o selo Rascunho no painel de resumo.
4. Faça os ajustes e clique em Salvar alterações. A matriz global não é alterada.

Mudar a pontuação de uma situação (editor por grupos).

1. Escolha o escopo e a aba do tipo de pessoa.
2. Abra o cartão do grupo e clique em Ver valores no subfator.
3. Na tabela de regras, altere a Pontuação ou a Faixa da regra desejada, ou use Adicionar regra.
4. Feche a janela e clique em Salvar alterações.

Reduzir a fila de análise manual (editor por grupos).

1. Na aba do tipo de pessoa, localize Faixas de risco.
2. Aumente Baixo até em um incremento pequeno, mantendo-o menor que Médio até.
3. Clique em Salvar alterações.
4. Se a revisão não mudar, a instituição provavelmente tem um limiar de revisão separado; fale com o suporte.

Gerar o anexo da Declaração de Tolerância ao Risco (editor por grupos).

1. Salve as alterações pendentes, porque o documento descreve apenas o que está gravado.
2. Escolha o escopo e a aba do tipo de pessoa.
3. Clique em Exportar resumo e aguarde o download, enquanto o botão mostra Gerando…
4. Repita na outra aba, se a declaração cobrir os dois tipos de pessoa.

Perguntas frequentes

A minha tela não corresponde a este capítulo. Por quê? Existem dois editores, e o idioma do painel define qual aparece. Confira a seção Qual editor aparece na sua instância e leia a parte correspondente.

A alteração vale para casos já decididos? Não. Vale para os processos analisados depois do salvamento. Casos anteriores mantêm o score e a decisão que receberam.

Salvei a matriz de um fluxo e mudou para todos. O que aconteceu? O fluxo não tinha matriz própria, e a tela mostrava a global, com o aviso correspondente. Salvar nessa situação altera a global. Para ajustar só o fluxo, use Criar uma matriz própria para este flow antes de editar.

Por que nenhum caso é rejeitado pelo score? Nas matrizes iniciais da Argentina e do Uruguai, Bloqueio a partir de vale 1000. Como o score máximo é 1000 e a rejeição exige ultrapassar o valor, o score sozinho nunca rejeita. A rejeição fica por conta dos fatores de bloqueio e dos overrides com efeito Rejeição.

Um caso com score igual a Baixo até foi para revisão. Por quê? Pelo score, não deveria: é preciso ultrapassar o valor. Verifique os overrides e os gatilhos de revisão manual, que mandam o caso para análise independentemente do score, e confirme com o suporte se a instituição tem um limiar de revisão separado.

Por que não consigo editar a pontuação de Código postal ou de Atividade econômica? São subfatores de catálogo. A pontuação vem do risco registrado no catálogo, e a janela Ver valores serve só para consulta.

O seletor Escopo não abre. Por quê? Há alterações não salvas. Salve ou use Recarregar, lembrando que Recarregar descarta o que não foi salvo.

O resumo exportado não mostra o que acabei de mudar. O documento descreve a configuração gravada. Salve as alterações e exporte de novo.

Removi um fator por engano. Dá para recuperar? Se ainda não salvou, sim: use Recarregar, que volta à configuração gravada e descarta todas as alterações pendentes. Depois de salvar, é preciso recriar o fator.

Existe histórico de versões da matriz? Não. A tela mostra apenas a data da Última atualização, e os valores anteriores são sobrescritos. Registre a configuração atual antes de uma mudança relevante; no editor por grupos, o Exportar resumo serve para isso.