Pontuação de confiança

As pontuações de confiança indicam a confiabilidade de uma correspondência automática em uma escala de 0-100. Pontuações mais altas significam mais certeza de que duas transações representam o mesmo evento financeiro.

Visão geral

Quando o Matcher identifica uma correspondência possível, ele atribui uma pontuação de confiança com base em vários fatores. Essa pontuação define como o Matcher trata a correspondência:

Pontuações altas (90+) de regras EXACT e TOLERANCE são aprovadas automaticamente
Todas as outras correspondências propostas exigem revisão

Componentes da pontuação

O Matcher usa um sistema de pontuação com pesos e quatro componentes. Os componentes de valor, moeda e data resultam em correspondência total (1,0) ou nenhuma correspondência (0,0). O componente de referência faz o mesmo nas regras EXACT, TOLERANCE e DATE_LAG. Nas regras FUZZY, ele pontua a similaridade graduada da referência, de 0,0 a 1,0.

Componente	Peso	Pontos (corresponde / não corresponde)
Correspondência de valor	40%	40 / 0
Correspondência de moeda	30%	30 / 0
Proximidade de data	20%	20 / 0
Correspondência de referência	10%	10 / 0

Em uma correspondência proposta, os componentes de valor e de data sempre recebem a pontuação total. Uma regra que verifica esses componentes rejeita um par que falha neles. Uma regra que não os verifica os pontua como correspondentes. Apenas os componentes de moeda e de referência podem baixar a pontuação.

Correspondência de valor (40%)

O componente de valor tem o maior peso porque diferenças de valor costumam indicar transações distintas.

Condição	Pontuação
Os valores coincidem (dentro da tolerância da regra)	40 pontos
Os valores não coincidem	0 pontos

A correspondência de valor depende do tipo de regra ativo. Uma regra EXACT exige valores idênticos. Uma regra TOLERANCE permite variação dentro dos percentTolerance e absTolerance configurados.

Correspondência de moeda (30%)

A verificação de moeda é binária. As moedas coincidem ou não coincidem.

Condição	Pontuação
Mesma moeda	30 pontos
Moeda diferente	0 pontos

Proximidade de data (20%)

A pontuação de data confere se as datas das transações caem dentro da janela configurada.

Condição	Pontuação
Datas dentro da janela permitida	20 pontos
Datas fora da janela permitida	0 pontos

A janela permitida depende da regra. Uma regra EXACT exige a mesma data e respeita datePrecision. Uma regra DATE_LAG aceita uma diferença de dias dentro da faixa [minDays, maxDays] dela. A flag inclusive controla se os próprios minDays e maxDays contam.

Correspondência de referência (10%)

Para regras EXACT e TOLERANCE, a comparação de referência é binária, e matchReference vem ligado por padrão. Com matchReference desligado, uma regra EXACT recebe os 10 pontos totais e uma regra TOLERANCE recebe 0.

Condição	Pontuação
As referências coincidem (exata ou sem diferenciar maiúsculas)	10 pontos
Ambas as referências ausentes	10 pontos (a menos que a regra defina `referenceMustSet`, que pontua qualquer referência ausente como 0)
As referências não coincidem, ou apenas uma está ausente	0 pontos

As regras FUZZY pontuam a referência em uma escala contínua. Para uma regra FUZZY, o espaço de 10% da referência carrega um ReferenceScore graduado entre 0.0 e 1.0. Esse valor é uma medida de similaridade, então não se limita a um 0 ou 1 estrito. Uma referência quase idêntica contribui perto dos 10 pontos completos, enquanto uma que mal passa pelo portão difuso contribui proporcionalmente menos. Como resultado, as correspondências FUZZY podem produzir pontuações que não são múltiplos de 10, como 97 ou 99. Veja Pontuações possíveis abaixo.

As regras DATE_LAG não pontuam referências. Para regras DATE_LAG o ReferenceScore é sempre 0.0, então o componente de referência de 10% contribui com 0 pontos, quaisquer que sejam os valores de referência. A pontuação máxima de DATE_LAG é portanto 90 (40 + 30 + 20 + 0).

Fórmula de cálculo

A fórmula da pontuação de confiança:

confidence = round(
  (amountMatch × 0.40 +
   currencyMatch × 0.30 +
   dateMatch × 0.20 +
   referenceScore × 0.10) × 100
)

amountMatch, currencyMatch e dateMatch valem 1.0 (corresponde) ou 0.0 (não corresponde). referenceScore fica entre 0.0 e 1.0. Os pesos são constantes fixas no código e não são configuráveis por contexto.

Pontuações possíveis

Para regras EXACT, TOLERANCE e DATE_LAG, cada componente é binário, então uma correspondência proposta recebe um destes valores: 60, 70, 90, 100 Uma correspondência DATE_LAG recebe 60 ou 90, porque o componente de referência dela é sempre 0. Uma correspondência por variação da taxa de câmbio tem uma pontuação fixa de 75. Veja Correspondência multimoeda. Para regras FUZZY isso não vale. Como o componente de referência é um ReferenceScore contínuo (0.0–1.0), as correspondências FUZZY podem produzir pontuações intermediárias como 97 ou 99. Qualquer que seja a pontuação resultante, uma correspondência FUZZY nunca é autoconfirmada. Veja Tipos de regra que nunca autoconfirmam.

Exemplos de cálculo

Correspondência exata (pontuação: 100)

Duas transações com valores idênticos no mesmo dia:

Componente	Comparação	Pontos
Valor	$1.000,00 vs $1.000,00 ✓	40
Moeda	USD vs USD ✓	30
Data	2024-01-15 vs 2024-01-15 ✓	20
Referência	PAY-001 vs PAY-001 ✓	10

Pontuação final: 100 → Autoconfirmada

Correspondência de alta confiança (pontuação: 90)

Valor, moeda e data coincidem. A regra é TOLERANCE com matchReference desligado, então a referência pontua 0:

Componente	Comparação	Pontos
Valor	$1.000,00 vs $1.000,00 ✓	40
Moeda	USD vs USD ✓	30
Data	2024-01-15 vs 2024-01-15 ✓	20
Referência	PAY-001 vs — ✗	0

Pontuação final: 90 → Autoconfirmada

Confiança média (pontuação: 70)

Valor, data e referência coincidem. As moedas são diferentes, e a regra não verifica a moeda:

Componente	Comparação	Pontos
Valor	1.000,00 vs 1.000,00 ✓	40
Moeda	USD vs EUR ✗	0
Data	2024-01-15 vs 2024-01-15 ✓	20
Referência	PAY-001 vs PAY-001 ✓	10

Pontuação final: 70 → Precisa de revisão

Faixas de confiança

O Matcher categoriza as correspondências em faixas com base na pontuação:

Faixa (pontuação)	Comportamento do sistema
Aprovada automaticamente (≥ 90)	Confirmada automaticamente quando a regra é EXACT ou TOLERANCE. As correspondências FUZZY e DATE_LAG entram na fila para revisão manual
Precisa de revisão (60-89)	Na fila para revisão manual

Toda correspondência proposta pontua pelo menos 60, porque os componentes de valor e de data sempre pontuam os pontos totais em uma proposta.

Como as faixas de confiança são aplicadas

Quando o Matcher propõe uma correspondência, ele avalia a pontuação de confiança e aplica os seguintes passos:

Se a pontuação for 90 ou mais e a regra for EXACT ou TOLERANCE, o Matcher confirma a correspondência automaticamente.
Caso contrário, o Matcher coloca a correspondência na fila para revisão manual.

Tipos de regra que nunca autoconfirmam

As correspondências produzidas por regras FUZZY e DATE_LAG nunca são autoconfirmadas, qualquer que seja a pontuação de confiança delas. Mesmo uma correspondência FUZZY ou DATE_LAG que pontue 90 ou mais entra sempre na fila para revisão manual. Uma referência difusa contribui apenas com o espaço de 10% da referência, então os campos financeiros (valor + moeda + data) sozinhos já podem alcançar o limiar de 90. Uma regra DATE_LAG não pontua a referência, então a pontuação dela é no máximo 90.

Limiares de confiança

O Matcher usa limiares fixos para determinar como trata as correspondências:

Limiar	Pontuação	Comportamento
Autoconfirmação	>= 90	A correspondência é confirmada automaticamente quando a regra é EXACT ou TOLERANCE
Correspondência	>= 60	A correspondência é proposta para revisão manual

Esses limiares não são configuráveis por contexto.

Pesos

Os pesos dos componentes (40/30/20/10) são constantes fixas no código. Você não pode ajustá-los por contexto nem por regra.

Componente	Peso	Justificativa
Valor	40%	O valor é o indicador mais forte de uma correspondência válida
Moeda	30%	Moeda diferente normalmente significa transações diferentes
Data	20%	A proximidade de data adiciona confiança, mas admite atrasos de liquidação
Referência	10%	As referências ajudam, mas costumam estar ausentes ou inconsistentes

Boas práticas

Monitore a distribuição por faixa

Acompanhe o percentual de transações em cada faixa. Mudanças fora do comum podem indicar problemas de qualidade dos dados ou regras mal configuradas.

Use o modo de teste a seco para testar regras

Como a confiança depende de quais regras correspondem, sempre rode as mudanças de regra em modo de teste a seco antes de gravar. Isso evita aumentos inesperados no volume de revisão manual.

Entenda as pontuações como resultados das regras

Para regras EXACT, TOLERANCE e DATE_LAG, a pontuação é binária. Uma pontuação de 70 significa que valor, data e referência coincidiram e a moeda não. Uma pontuação de 90 significa que a referência recebeu 0. Use isso para diagnosticar problemas de correspondência.As regras FUZZY são a exceção. O componente de referência graduado delas pode gerar pontuações intermediárias (por exemplo, 97). Leia uma pontuação FUZZY como “os campos financeiros coincidiram mais uma similaridade parcial de referência”.

Visão geral

Guias

Console

Operações

Pontuação de confiança

Visão geral

Componentes da pontuação

Correspondência de valor (40%)

Correspondência de moeda (30%)

Proximidade de data (20%)

Correspondência de referência (10%)

Fórmula de cálculo

Pontuações possíveis

Exemplos de cálculo

Correspondência exata (pontuação: 100)

Correspondência de alta confiança (pontuação: 90)

Confiança média (pontuação: 70)

Faixas de confiança

Como as faixas de confiança são aplicadas

Tipos de regra que nunca autoconfirmam

Limiares de confiança

Pesos

Boas práticas

Próximos passos

Regras de correspondência

Multimoeda

​Visão geral

​Componentes da pontuação

​Correspondência de valor (40%)

​Correspondência de moeda (30%)

​Proximidade de data (20%)

​Correspondência de referência (10%)

​Fórmula de cálculo

​Pontuações possíveis

​Exemplos de cálculo

​Correspondência exata (pontuação: 100)

​Correspondência de alta confiança (pontuação: 90)

​Confiança média (pontuação: 70)

​Faixas de confiança

​Como as faixas de confiança são aplicadas

​Tipos de regra que nunca autoconfirmam

​Limiares de confiança

​Pesos

​Boas práticas

​Próximos passos

Regras de correspondência

Multimoeda

Visão geral

Componentes da pontuação

Correspondência de valor (40%)

Correspondência de moeda (30%)

Proximidade de data (20%)

Correspondência de referência (10%)

Fórmula de cálculo

Pontuações possíveis

Exemplos de cálculo

Correspondência exata (pontuação: 100)

Correspondência de alta confiança (pontuação: 90)

Confiança média (pontuação: 70)

Faixas de confiança

Como as faixas de confiança são aplicadas

Tipos de regra que nunca autoconfirmam

Limiares de confiança

Pesos

Boas práticas

Próximos passos