> ## 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.
# Puntuación de confianza
> Descubre cómo Matcher calcula una puntuación de confianza de 0–100 a partir de las verificaciones de monto, moneda, fecha y referencia, y cómo puntúan las reglas EXACT, TOLERANCE, DATE_LAG y FUZZY.
Las puntuaciones de confianza indican la fiabilidad de una coincidencia automática en una escala de 0-100. Las puntuaciones más altas indican mayor certeza de que dos transacciones representan el mismo evento financiero.
## Resumen
***
Cuando Matcher identifica una posible coincidencia, asigna una puntuación de confianza basada en múltiples factores.
Esta puntuación define cómo se gestiona la coincidencia:
* Las puntuaciones altas (90+) se aprueban automáticamente
* Las puntuaciones intermedias (60 – 89) requieren revisión
* Las puntuaciones bajas (\<60) se tratan como excepciones
## Componentes de la puntuación
***
Matcher usa un **sistema de puntuación ponderada binaria** con cuatro componentes. Cada componente se evalúa como coincidencia completa (1.0) o sin coincidencia (0.0). No hay puntuaciones parciales dentro de un componente.
| Componente | Peso | Puntos (coincidencia / sin coincidencia) |
| -------------------------- | ---- | ---------------------------------------- |
| Coincidencia de monto | 40% | 40 / 0 |
| Coincidencia de moneda | 30% | 30 / 0 |
| Proximidad de fecha | 20% | 20 / 0 |
| Coincidencia de referencia | 10% | 10 / 0 |
### Coincidencia de monto (40%)
El componente de monto tiene el peso más alto porque las discrepancias de monto suelen indicar transacciones distintas.
| Condición | Puntuación |
| ---------------------------------------------------------- | ---------- |
| Los montos coinciden (dentro de la tolerancia de la regla) | 40 puntos |
| Los montos no coinciden | 0 puntos |
La coincidencia de montos depende del tipo de regla activa. Una regla EXACT requiere montos idénticos. Una regla TOLERANCE permite variación dentro de `percentTolerance` y `absTolerance` configurados.
### Coincidencia de moneda (30%)
La verificación de moneda es binaria. Las monedas coinciden o no coinciden.
| Condición | Puntuación |
| ---------------- | ---------- |
| Misma moneda | 30 puntos |
| Moneda diferente | 0 puntos |
### Proximidad de fecha (20%)
La puntuación de fecha verifica si las fechas de las transacciones están dentro de la ventana configurada.
| Condición | Puntuación |
| ------------------------------------- | ---------- |
| Fechas dentro de la ventana permitida | 20 puntos |
| Fechas fuera de la ventana permitida | 0 puntos |
La ventana permitida depende de la regla. Una regla EXACT requiere la misma fecha y respeta `datePrecision`. Una regla DATE\_LAG acepta una diferencia de días dentro de su banda `[minDays, maxDays]`. El indicador `inclusive` controla si `maxDays` en sí cuenta.
### Coincidencia de referencia (10%)
Para las reglas EXACT, la comparación de referencia es binaria. Las reglas TOLERANCE puntúan este componente solo cuando habilitas `matchReference`. De lo contrario, su puntuación de referencia es `0`.
| Condición | Puntuación |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Las referencias coinciden (exacta o sin distinción entre mayúsculas y minúsculas) | 10 puntos |
| Ambas referencias están ausentes | 10 puntos (a menos que la regla configure `referenceMustSet`, que puntúa cualquier referencia ausente como 0) |
| Las referencias no coinciden, o solo una está ausente | 0 puntos |
**Las reglas FUZZY puntúan la referencia en una escala continua.** Para una regla FUZZY, el 10% asignado a la referencia lleva un `ReferenceScore` graduado entre `0.0` y `1.0`. Este valor es una medida de similitud, no un `0`/`1` estricto. Una referencia casi idéntica aporta cerca de los 10 puntos completos, mientras que una que apenas supera el umbral fuzzy aporta proporcionalmente menos. Como resultado, las coincidencias FUZZY pueden producir puntuaciones que no son múltiplos de 10, como 97 o 99. Consulta [Puntuaciones posibles](#possible-scores) más abajo.
**Las reglas DATE\_LAG no puntúan referencias.** Para las reglas DATE\_LAG, el `ReferenceScore` siempre es `0.0`, por lo que el componente de referencia del 10% aporta `0` puntos sin importar los valores de referencia. La puntuación máxima alcanzable para DATE\_LAG es, por lo tanto, 90 (40 + 30 + 20 + 0), lo que por diseño mantiene las coincidencias con retraso de fecha en la ruta de revisión manual.
## Fórmula de cálculo
***
La fórmula de la puntuación de confianza:
```
confidence = round(
(amountMatch × 0.40 +
currencyMatch × 0.30 +
dateMatch × 0.20 +
referenceScore × 0.10) × 100
)
```
Donde cada factor es `1.0` (coincidencia) o `0.0` (sin coincidencia).
Los pesos son constantes fijas en el código y no se pueden configurar por contexto.
Puntuaciones posibles
Para las reglas **EXACT**, **TOLERANCE** y **DATE\_LAG**, cada componente es binario, por lo que la puntuación de confianza siempre es uno de estos valores:
**0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100**
Para estos tipos de regla, nunca aparecen valores intermedios (por ejemplo, 87, 72, 55). (Para DATE\_LAG el componente de referencia siempre es `0`, por lo que sus puntuaciones nunca incluyen los 10 puntos finales.)
Para las reglas **FUZZY** esto no aplica. Como el componente de referencia es un `ReferenceScore` continuo (0.0–1.0), las coincidencias FUZZY pueden producir puntuaciones intermedias como **97** o **99**. Sin importar la puntuación resultante, una coincidencia FUZZY **nunca se confirma automáticamente**. Consulta [Las coincidencias FUZZY nunca se confirman automáticamente](#fuzzy-matches-never-auto-confirm).
## Ejemplos de cálculo
***
### Coincidencia exacta (puntuación: 100)
Dos transacciones con valores idénticos el mismo día:
| Componente | Comparación | Puntos |
| ---------- | -------------------------- | ------ |
| Monto | $1,000.00 vs $1,000.00 ✓ | 40 |
| Moneda | USD vs USD ✓ | 30 |
| Fecha | 2024-01-15 vs 2024-01-15 ✓ | 20 |
| Referencia | PAY-001 vs PAY-001 ✓ | 10 |
**Puntuación final: 100** → Confirmada automáticamente
### Coincidencia de alta confianza (puntuación: 90)
Todos los campos coinciden excepto la referencia:
| Componente | Comparación | Puntos |
| ---------- | -------------------------- | ------ |
| Monto | $1,000.00 vs $1,000.00 ✓ | 40 |
| Moneda | USD vs USD ✓ | 30 |
| Fecha | 2024-01-15 vs 2024-01-15 ✓ | 20 |
| Referencia | PAY-001 vs — ✗ | 0 |
**Puntuación final: 90** → Confirmada automáticamente
### Confianza media (puntuación: 70)
El monto y la moneda coinciden, pero la fecha y la referencia no:
| Componente | Comparación | Puntos |
| ---------- | -------------------------- | ------ |
| Monto | $1,000.00 vs $1,000.00 ✓ | 40 |
| Moneda | USD vs USD ✓ | 30 |
| Fecha | 2024-01-15 vs 2024-01-25 ✗ | 0 |
| Referencia | PAY-001 vs REC-999 ✗ | 0 |
**Puntuación final: 70** → Necesita revisión
### Confianza baja (puntuación: 40)
Solo coincide el monto:
| Componente | Comparación | Puntos |
| ---------- | -------------------------- | ------ |
| Monto | $1,000.00 vs $1,000.00 ✓ | 40 |
| Moneda | USD vs EUR ✗ | 0 |
| Fecha | 2024-01-15 vs 2024-01-25 ✗ | 0 |
| Referencia | PAY-001 vs REC-999 ✗ | 0 |
**Puntuación final: 40** → Excepción (menor que 60)
## Niveles de confianza
***
Matcher clasifica las coincidencias en niveles según la puntuación:
| Nivel (puntuación) | Comportamiento del sistema | Volumen típico (ilustrativo) |
| ----------------------------------- | ---------------------------- | ---------------------------- |
| **Aprobada automáticamente** (≥ 90) | Se confirma automáticamente | 70-80% |
| **Necesita revisión** (60-89) | En cola para revisión manual | 15-25% |
| **Excepción** (\< 60) | Se trata como no conciliada | 5-10% |
### Cómo se aplican los niveles de confianza
Cuando Matcher propone una coincidencia, evalúa la puntuación de confianza y aplica los siguientes pasos:
1. Si la puntuación es **90 o superior**, la coincidencia se confirma automáticamente para las reglas EXACT y TOLERANCE; las coincidencias FUZZY y DATE\_LAG siempre requieren revisión manual.
2. Si la puntuación está **entre 60 y 89**, la coincidencia se pone en cola para revisión manual.
3. Si la puntuación es **menor que 60**, no se crea ninguna coincidencia y la transacción se convierte en una excepción.
4. Las coincidencias revisadas pueden confirmarse o rechazarse, lo que actualiza su estado final.
Las coincidencias FUZZY nunca se confirman automáticamente
El comportamiento de confirmación automática descrito arriba aplica a las reglas EXACT y TOLERANCE. Las coincidencias FUZZY y DATE\_LAG siempre requieren revisión manual. Las coincidencias producidas por reglas **FUZZY** **nunca se confirman automáticamente**, sin importar su puntuación de confianza. Incluso una coincidencia FUZZY con puntuación de 90 o superior siempre se pone en cola para revisión manual.
Una referencia fuzzy solo aporta el 10% asignado a la referencia, por lo que los campos financieros (monto + moneda + fecha) por sí solos ya pueden alcanzar el umbral de 90. Limitar FUZZY por debajo de la confirmación automática garantiza que una persona revise la referencia difusa antes de confirmar la coincidencia.
## Umbrales de confianza
***
Matcher usa umbrales fijos para determinar cómo se gestionan las coincidencias:
| Umbral | Puntuación | Comportamiento |
| ----------------------- | ---------- | ----------------------------------------------------------------------------- |
| Confirmación automática | >= 90 | La coincidencia se confirma automáticamente |
| Coincidencia | >= 60 | La coincidencia se propone para revisión manual |
| Excepción | \< 60 | No se crea ninguna coincidencia; la transacción se convierte en una excepción |
Estos umbrales no se pueden configurar por contexto.
## Pesos
***
Los pesos de los componentes (40/30/20/10) son constantes fijas en el código. No se pueden ajustar por contexto ni por regla.
| Componente | Peso | Justificación |
| ---------- | ---- | --------------------------------------------------------------------------- |
| Monto | 40% | El monto es el indicador más fuerte de una coincidencia válida |
| Moneda | 30% | Una moneda distinta suele indicar transacciones diferentes |
| Fecha | 20% | La proximidad de fecha suma confianza, pero permite retrasos de liquidación |
| Referencia | 10% | Las referencias ayudan, pero a menudo faltan o son inconsistentes |
## Mejores prácticas
***
Registra el porcentaje de transacciones en cada nivel. Los cambios inusuales pueden indicar problemas de calidad de datos o una configuración incorrecta de las reglas.
Como la confianza depende de qué reglas coinciden, haz siempre un dry run de los cambios de reglas antes de confirmarlos. Esto evita aumentos inesperados en el volumen de revisión manual.
Revisa periódicamente las coincidencias justo por encima del umbral de excepción. Suelen revelar oportunidades de mejora en las reglas.
Para las reglas EXACT, TOLERANCE y DATE\_LAG, la puntuación es binaria. Una puntuación de 70 significa exactamente "monto + moneda coincidieron, fecha + referencia no." Usa esto para diagnosticar problemas de coincidencia. Las reglas FUZZY son la excepción. Su componente de referencia graduado puede producir puntuaciones intermedias (por ejemplo, 97). Interpreta una puntuación FUZZY como "los campos financieros coincidieron más una similitud parcial de referencia."
## Próximos pasos
***
Configura las reglas que influyen en la puntuación.
Cómo el tipo de cambio afecta la puntuación de confianza.