> ## 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
> Conoce cómo Matcher calcula una puntuación de confianza de 0 a 100 a partir de validaciones de monto, moneda, fecha y referencia para evaluar cada coincidencia.
Las puntuaciones de confianza indican la fiabilidad de una coincidencia automatizada en una escala de 0-100. Puntuaciones más altas significan mayor certeza de que dos transacciones representan el mismo evento financiero.
## Descripción general
***
Cuando Matcher identifica una coincidencia potencial, asigna una puntuación de confianza basada en múltiples factores.
Esta puntuación define cómo se maneja la coincidencia:
* Puntuaciones altas (90+) se aprueban automáticamente
* Puntuaciones intermedias (60 – 89) requieren revisión
* Puntuaciones bajas (\<60) se tratan como excepciones
## Componentes de la puntuación
***
Matcher utiliza un **sistema de puntuación binario ponderado** 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 (match / no match) |
| -------------------------- | ---- | ------------------------- |
| 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 a menudo indican transacciones diferentes.
| 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 monto depende del tipo de regla activo. Una regla EXACT requiere montos idénticos; una regla TOLERANCE permite variación dentro de los valores configurados de `percentTolerance` y `absTolerance`.
### Coincidencia de moneda (30%)
La verificación de moneda es binaria — las monedas coinciden o no.
| 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 transacción 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 (respetando `datePrecision`), mientras que una regla DATE\_LAG permite hasta `maxDays` de diferencia.
### Coincidencia de referencia (10%)
Para las reglas EXACT y TOLERANCE, la comparación de referencia es binaria.
| Condición | Puntuación |
| ----------------------------------------------------------------- | ---------- |
| Las referencias coinciden (exacta o sin distinción de mayúsculas) | 10 puntos |
| Las referencias no coinciden o están ausentes | 0 puntos |
**Las reglas FUZZY puntúan la referencia en una escala continua.** Para una regla FUZZY, el slot de referencia del 10% lleva un `ReferenceScore` graduado entre `0.0` y `1.0` (una medida de similitud) en lugar de un estricto `0`/`1`. Una referencia casi idéntica aporta cerca de los 10 puntos completos, mientras que una que apenas supera el umbral difuso 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](#puntuaciones-posibles) 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 independientemente de los valores de referencia. Por lo tanto, la puntuación máxima alcanzable de DATE\_LAG es 90 (40 + 30 + 20 + 0), lo que por diseño mantiene las coincidencias con desfase de fecha en la ruta de revisión manual.
## Fórmula de cálculo
***
La fórmula de 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` (coincide) o `0.0` (no coincide).
Los pesos son constantes fijas y no son configurables 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, los valores intermedios (ej. 87, 72, 55) nunca ocurren. (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 se cumple. Dado que el componente de referencia es un `ReferenceScore` continuo (0.0–1.0), las coincidencias FUZZY pueden producir puntuaciones intermedias como **97** o **99**. Nota que, independientemente de la puntuación resultante, una coincidencia FUZZY **nunca se auto-confirma** — consulta [Las coincidencias FUZZY nunca se auto-confirman](#las-coincidencias-fuzzy-nunca-se-auto-confirman).
## Ejemplos de cálculo
***
### Coincidencia exacta (puntuación: 100)
Dos transacciones con valores idénticos en 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** → Auto-confirmada
### 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** → Auto-confirmada
### Confianza media (puntuación: 70)
Monto y moneda coinciden, pero fecha y 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** → Requiere revisión
### Baja confianza (puntuación: 40)
Solo el monto coincide:
| 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 | — vs — ✗ | 0 |
**Puntuación final: 40** → Excepción (por debajo de 60)
## Niveles de confianza
***
Matcher categoriza las coincidencias en niveles según la puntuación:
| Tier (puntuación) | Comportamiento del sistema | Volumen típico |
| ----------------------------- | ---------------------------- | -------------- |
| **Auto-aprobado** (>= 90) | Confirmado automáticamente | 70-80% |
| **Requiere revisión** (60-89) | En cola para revisión manual | 15-25% |
| **Excepción** (\< 60) | Tratado como no coincidente | 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 está **por debajo de 60**, no se crea coincidencia y la transacción se convierte en excepción.
4. Las coincidencias revisadas pueden confirmarse o rechazarse, actualizando su estado final.
Esto asegura que las coincidencias de alta confianza fluyan automáticamente mientras se mantiene el control humano donde importa.
### Las coincidencias FUZZY nunca se auto-confirman
El comportamiento de auto-confirmación descrito arriba aplica a las reglas EXACT y TOLERANCE, más las coincidencias manuales; las coincidencias FUZZY y DATE\_LAG siempre requieren revisión manual. Las coincidencias producidas por reglas **FUZZY** **nunca se auto-confirman**, independientemente de 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.
Esto es por diseño: una referencia difusa solo aporta el slot de referencia del 10%, 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 auto-confirmación garantiza que una persona revise la referencia difusa antes de que la coincidencia se confirme — "lo difuso propone, nunca confirma".
## Umbrales de confianza
***
Matcher usa umbrales fijos para determinar cómo se manejan las coincidencias:
| Umbral | Puntuación | Comportamiento |
| -------------- | ---------- | ----------------------------------------------------------------- |
| Auto-confirmar | >= 90 | La coincidencia se confirma automáticamente |
| Coincidencia | >= 60 | La coincidencia se propone para revisión manual |
| Excepción | \< 60 | No se crea coincidencia; la transacción se convierte en excepción |
Estos umbrales no son configurables por contexto.
## Pesos
***
Los pesos de los componentes (40/30/20/10) son constantes fijas. 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 discrepancia de moneda generalmente indica transacciones diferentes |
| Fecha | 20% | La proximidad de fecha agrega confianza pero permite retrasos de liquidación |
| Referencia | 10% | Las referencias son útiles pero frecuentemente faltan o son inconsistentes |
## Mejores prácticas
***
Rastrea el porcentaje de transacciones en cada nivel. Cambios inusuales pueden indicar problemas de calidad de datos o mala configuración de reglas.
Dado que la confianza depende de qué reglas coinciden, siempre ejecuta dry-run antes de confirmar cambios de reglas. Esto previene aumentos inesperados en el volumen de revisión manual.
Revisa periódicamente las coincidencias justo por encima del umbral de excepción. Estas a menudo revelan oportunidades para mejorar las reglas.
Para las reglas EXACT, TOLERANCE y DATE\_LAG, la puntuación es binaria, por lo que 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 arrojar puntuaciones intermedias (ej. 97), por lo que una puntuación FUZZY debe leerse como "los campos financieros coincidieron más una similitud parcial de referencia".
## Próximos pasos
***
Configura reglas que influyen en la puntuación.
Cómo FX afecta la puntuación de confianza.