Visão geral
Quando o Matcher identifica uma correspondência potencial, ele atribui uma pontuação de confiança com base em múltiplos fatores. Esta pontuação define como a correspondência é tratada:
- Pontuações altas (90+) são aprovadas automaticamente
- Pontuações intermediárias (60 – 89) requerem revisão
- Pontuações baixas (<60) são tratadas como exceções
Componentes da pontuação
O Matcher usa um sistema de pontuação ponderada binária com quatro componentes. Cada componente resulta em match completo (1.0) ou sem match (0.0) — não existem pontuações parciais dentro de um componente.
| Componente | Peso | Match | Sem match |
|---|---|---|---|
| Correspondência de valor | 40% | 40 pontos | 0 pontos |
| Correspondência de moeda | 30% | 30 pontos | 0 pontos |
| Proximidade de data | 20% | 20 pontos | 0 pontos |
| Correspondência de referência | 10% | 10 pontos | 0 pontos |
Correspondência de valor (40%)
O componente de valor tem o maior peso porque discrepâncias de valor frequentemente indicam transações diferentes.| Condição | Pontuação |
|---|---|
| Valores correspondem (dentro da tolerância da regra) | 40 pontos |
| Valores não correspondem | 0 pontos |
percentTolerance e absTolerance.
Correspondência de moeda (30%)
A verificação de moeda é binária — as moedas correspondem ou não.| Condição | Pontuação |
|---|---|
| Mesma moeda | 30 pontos |
| Moeda diferente | 0 pontos |
Proximidade de data (20%)
A pontuação de data verifica se as datas das transações estão dentro da janela configurada.| Condição | Pontuação |
|---|---|
| Datas dentro da janela permitida | 20 pontos |
| Datas fora da janela permitida | 0 pontos |
datePrecision), enquanto uma regra DATE_LAG permite até maxDays de diferença.
Correspondência de referência (10%)
A comparação de referência também é binária.| Condição | Pontuação |
|---|---|
| Referências correspondem (exata ou sem distinção de maiúsculas) | 10 pontos |
| Referências não correspondem ou estão ausentes | 0 pontos |
Fórmula de cálculo
A fórmula da pontuação de confiança:
1.0 (match) ou 0.0 (sem match).
Os pesos são constantes fixas no código e não são configuráveis por contexto.
Pontuações possíveis
Como cada componente é binário, a pontuação de confiança é sempre um destes valores: 0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100 Valores intermediários (ex: 87, 72, 55) nunca ocorrem.Exemplos de cálculo
Correspondência exata (pontuação: 100)
Duas transações com valores idênticos no mesmo dia:| Componente | Origem | Destino | Match? | Pontos |
|---|---|---|---|---|
| Valor | $1.000,00 | $1.000,00 | Sim | 40 |
| Moeda | USD | USD | Sim | 30 |
| Data | 2024-01-15 | 2024-01-15 | Sim | 20 |
| Referência | PAY-001 | PAY-001 | Sim | 10 |
Alta confiança (pontuação: 90)
Todos os campos correspondem exceto referência:| Componente | Origem | Destino | Match? | Pontos |
|---|---|---|---|---|
| Valor | $1.000,00 | $1.000,00 | Sim | 40 |
| Moeda | USD | USD | Sim | 30 |
| Data | 2024-01-15 | 2024-01-15 | Sim | 20 |
| Referência | PAY-001 | — | Não | 0 |
Confiança média (pontuação: 70)
Valor e moeda correspondem, mas data e referência não:| Componente | Origem | Destino | Match? | Pontos |
|---|---|---|---|---|
| Valor | $1.000,00 | $1.000,00 | Sim | 40 |
| Moeda | USD | USD | Sim | 30 |
| Data | 2024-01-15 | 2024-01-25 | Não | 0 |
| Referência | PAY-001 | REC-999 | Não | 0 |
Baixa confiança (pontuação: 40)
Apenas o valor corresponde:| Componente | Origem | Destino | Match? | Pontos |
|---|---|---|---|---|
| Valor | $1.000,00 | $1.000,00 | Sim | 40 |
| Moeda | USD | EUR | Não | 0 |
| Data | 2024-01-15 | 2024-01-25 | Não | 0 |
| Referência | — | — | Não | 0 |
Níveis de confiança
O Matcher categoriza as correspondências em níveis com base na pontuação:
| Nível | Faixa de Pontuação | Comportamento do Sistema | Volume Típico |
|---|---|---|---|
| Aprovado Automaticamente | >= 90 | Confirmado automaticamente | 70-80% |
| Necessita Revisão | 60-89 | Enfileirado para revisão manual | 15-25% |
| Exceção | < 60 | Tratado como não correspondido | 5-10% |
Como os níveis de confiança são aplicados
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 superior, a correspondência é automaticamente confirmada.
- Se a pontuação for entre 60 e 89, a correspondência é enfileirada para revisão manual.
- Se a pontuação for abaixo de 60, nenhuma correspondência é criada e a transação se torna uma exceção.
- Correspondências revisadas podem ser confirmadas ou rejeitadas, atualizando seu status final.
Limites de confiança
O Matcher usa limites fixos para determinar como as correspondências são tratadas:
| Limite | Pontuação | Comportamento |
|---|---|---|
| Confirmação automática | >= 90 | Correspondência é automaticamente confirmada |
| Correspondência | >= 60 | Correspondência é proposta para revisão manual |
| Exceção | < 60 | Nenhuma correspondência criada; transação se torna uma exceção |
Pesos
Os pesos dos componentes (40/30/20/10) são constantes fixas no código. Eles não podem ser ajustados por contexto ou por regra.
| Componente | Peso | Justificativa |
|---|---|---|
| Valor | 40% | O valor é o indicador mais forte de uma correspondência válida |
| Moeda | 30% | Moeda diferente geralmente significa transações diferentes |
| Data | 20% | Proximidade de data adiciona confiança mas permite atrasos de liquidação |
| Referência | 10% | Referências são úteis mas frequentemente ausentes ou inconsistentes |
Melhores práticas
Monitore a distribuição por níveis
Monitore a distribuição por níveis
Acompanhe a porcentagem de transações em cada nível. Mudanças incomuns podem indicar problemas de qualidade de dados ou configuração incorreta de regras.
Use modo dry-run para testar regras
Use modo dry-run para testar regras
Como a confiança depende de quais regras fazem match, sempre faça dry-run de mudanças nas regras antes de confirmar. Isso evita aumentos inesperados no volume de revisão manual.
Revise correspondências próximas ao limite de 60 pontos
Revise correspondências próximas ao limite de 60 pontos
Periodicamente revise correspondências logo acima do limite de exceção. Estas frequentemente revelam oportunidades para melhorias nas regras.
Entenda pontuações como resultados de regras
Entenda pontuações como resultados de regras
Como a pontuação é binária, uma pontuação de 70 significa exatamente “valor + moeda corresponderam, data + referência não corresponderam.” Use isso para diagnosticar problemas de correspondência.
Próximos passos
Regras de Correspondência
Configure regras que influenciam a pontuação.
Multi-Moeda
Como FX afeta a pontuação de confiança.