> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Pontuação de confiança > Veja como o Matcher calcula uma pontuação de confiança de 0–100 a partir das verificações de valor, moeda, data e referência, e como as regras EXACT, TOLERANCE, DATE_LAG e FUZZY pontuam. 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 ![Pontuação de confiança do Matcher](https://mintcdn.com/lerian-49cb71fc/x3AMJBzW0rsKreuz/images/pt/d2/matcher-confidence-scoring.svg?fit=max\&auto=format\&n=x3AMJBzW0rsKreuz\&q=85\&s=4496889af7bc06a13b36a980b3e1a842) Pontuação de confiança do Matcher. ## 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 | > [!NOTE] > > **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](#possible-scores) abaixo. > [!WARNING] > > **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](https://docs.lerian.studio/pt/products/matcher/reference/matcher-multi-currency.md#fx-rate-variance-band). 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](#rule-types-that-never-auto-confirm). ## 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: 1. Se a pontuação for **90 ou mais** e a regra for EXACT ou TOLERANCE, o Matcher confirma a correspondência automaticamente. 2. 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 *** > [accordion] 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. > [accordion] 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. > [accordion] 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". ## Próximos passos *** > [card] [Regras de correspondência](https://docs.lerian.studio/pt/products/matcher/configuration/matcher-match-rules.md) > > Configure as regras que influenciam a pontuação. > [card] [Multimoeda](https://docs.lerian.studio/pt/products/matcher/reference/matcher-multi-currency.md) > > Como o câmbio afeta a pontuação de confiança. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.