Puntuación de confianza

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 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.

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:

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.
Si la puntuación está entre 60 y 89, la coincidencia se pone en cola para revisión manual.
Si la puntuación está por debajo de 60, no se crea coincidencia y la transacción se convierte en excepción.
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

Monitorea la distribución de niveles

Rastrea el porcentaje de transacciones en cada nivel. Cambios inusuales pueden indicar problemas de calidad de datos o mala configuración de reglas.

Usa modo dry-run para probar 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 coincidencias cerca del límite de 60 puntos

Revisa periódicamente las coincidencias justo por encima del umbral de excepción. Estas a menudo revelan oportunidades para mejorar las reglas.

Entiende las puntuaciones como resultados de 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”.

Puntuación de confianza

Descripción general

Componentes de la puntuación

Coincidencia de monto (40%)

Coincidencia de moneda (30%)

Proximidad de fecha (20%)

Coincidencia de referencia (10%)

Fórmula de cálculo

Puntuaciones posibles

Ejemplos de cálculo

Coincidencia exacta (puntuación: 100)

Coincidencia de alta confianza (puntuación: 90)

Confianza media (puntuación: 70)

Baja confianza (puntuación: 40)

Niveles de confianza

Cómo se aplican los niveles de confianza

Las coincidencias FUZZY nunca se auto-confirman

Umbrales de confianza

Pesos

Mejores prácticas

Próximos pasos

Reglas de coincidencia

Multi-moneda

​Descripción general

​Componentes de la puntuación

​Coincidencia de monto (40%)

​Coincidencia de moneda (30%)

​Proximidad de fecha (20%)

​Coincidencia de referencia (10%)

​Fórmula de cálculo

​Puntuaciones posibles

​Ejemplos de cálculo

​Coincidencia exacta (puntuación: 100)

​Coincidencia de alta confianza (puntuación: 90)

​Confianza media (puntuación: 70)

​Baja confianza (puntuación: 40)

​Niveles de confianza

​Cómo se aplican los niveles de confianza

​Las coincidencias FUZZY nunca se auto-confirman

​Umbrales de confianza

​Pesos

​Mejores prácticas

​Próximos pasos

Reglas de coincidencia

Multi-moneda

Descripción general

Componentes de la puntuación

Coincidencia de monto (40%)

Coincidencia de moneda (30%)

Proximidad de fecha (20%)

Coincidencia de referencia (10%)

Fórmula de cálculo

Puntuaciones posibles

Ejemplos de cálculo

Coincidencia exacta (puntuación: 100)

Coincidencia de alta confianza (puntuación: 90)

Confianza media (puntuación: 70)

Baja confianza (puntuación: 40)

Niveles de confianza

Cómo se aplican los niveles de confianza

Las coincidencias FUZZY nunca se auto-confirman

Umbrales de confianza

Pesos

Mejores prácticas

Próximos pasos