Puntuación de confianza

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

Matcher Confidence Scoring — Puntuación de confianza de Matcher.

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

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:

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 es menor que 60, no se crea ninguna coincidencia y la transacción se convierte en una excepción.
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

Supervisa la distribución de niveles

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.

Usa el modo dry run para probar 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 las coincidencias cercanas al límite de 60 puntos

Revisa periódicamente las coincidencias justo por encima del umbral de excepción. Suelen revelar oportunidades de mejora en las reglas.

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

Resumen

Guías

Matcher UI

Servidor MCP

Operaciones

Puntuación de confianza

Resumen

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)

Confianza baja (puntuación: 40)

Niveles de confianza

Cómo se aplican los niveles de confianza

Las coincidencias FUZZY nunca se confirman automáticamente

Umbrales de confianza

Pesos

Mejores prácticas

Próximos pasos

Reglas de coincidencia

Coincidencia multimoneda

​Resumen

​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)

​Confianza baja (puntuación: 40)

​Niveles de confianza

​Cómo se aplican los niveles de confianza

​Las coincidencias FUZZY nunca se confirman automáticamente

​Umbrales de confianza

​Pesos

​Mejores prácticas

​Próximos pasos

Reglas de coincidencia

Coincidencia multimoneda

Resumen

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)

Confianza baja (puntuación: 40)

Niveles de confianza

Cómo se aplican los niveles de confianza

Las coincidencias FUZZY nunca se confirman automáticamente

Umbrales de confianza

Pesos

Mejores prácticas

Próximos pasos