Saltar al contenido principal
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
Puntuación de confianza de Matcher

​
Componentes de la puntuación

Matcher utiliza un sistema de puntuación ponderado con cuatro componentes:
ComponentePesoDescripción
Coincidencia de monto40%Qué tan cerca están los montos
Coincidencia de moneda30%Verificación de misma moneda
Proximidad de fecha20%Cercanía de las fechas de transacción
Satisfacción de regla10%Criterios de regla de coincidencia cumplidos

​
Coincidencia de monto (40%)

El componente de monto tiene el peso más alto porque las discrepancias de monto a menudo indican transacciones diferentes. Cálculo: 
puntuacion_monto = puntuacion_base - (porcentaje_varianza * penalizacion_por_porcentaje)
VarianzaImpacto en puntuaciónEjemplo
0% (exacta)40/40 puntos1,000.00vs1,000.00 vs 1,000.00
0.1% - 0.5%38-40 puntos1,000.00vs1,000.00 vs 1,003.00
0.5% - 1.0%35-38 puntos1,000.00vs1,000.00 vs 1,008.00
1.0% - 2.0%30-35 puntos1,000.00vs1,000.00 vs 1,015.00
2.0% - 5.0%20-30 puntos1,000.00vs1,000.00 vs 1,040.00
> 5.0%0-20 puntos1,000.00vs1,000.00 vs 1,060.00
Configuración: 
{
  "scoring": {
    "amount": {
      "weight": 40,
      "exact_match_score": 40,
      "penalty_per_percent": 5,
      "min_score": 0
    }
  }
}

​
Coincidencia de moneda (30%)

La verificación de moneda es binaria—las monedas coinciden o no.
EscenarioPuntuación
Misma moneda30/30 puntos
Moneda diferente (sin contexto FX)0/30 puntos
Moneda diferente (FX habilitado)Calculado según varianza de tasa
Con contexto FX habilitado: 
{
  "scoring": {
    "currency": {
      "weight": 30,
      "same_currency_score": 30,
      "fx_enabled": true,
      "fx_rate_tolerance_percent": 2.0,
      "fx_penalty_per_percent": 10
    }
  }
}

​
Proximidad de fecha (20%)

La puntuación de fecha recompensa transacciones que ocurren el mismo día y penaliza las diferencias de fecha.
Diferencia de fechaImpacto en puntuación
Mismo día20/20 puntos
1 día18/20 puntos
2 días16/20 puntos
3 días14/20 puntos
4-5 días10-12/20 puntos
6-7 días6-8/20 puntos
> 7 días0-5/20 puntos
Configuración: 
{
  "scoring": {
    "date": {
      "weight": 20,
      "same_day_score": 20,
      "penalty_per_day": 2,
      "max_days": 14,
      "use_posting_date": false
    }
  }
}

​
Satisfacción de regla (10%)

Este componente recompensa coincidencias que satisfacen criterios de regla determinísticos más allá de las comparaciones básicas.
Calidad de coincidencia de reglaPuntuación
Todas las condiciones de regla cumplidas10/10 puntos
Patrón de referencia coincidente+3 puntos
ID externo coincidente+5 puntos
Contraparte coincidente+2 puntos
La satisfacción de regla puede exceder 10 puntos como bonificación, pero el componente está limitado a 10 en el cálculo final.

​
Fórmula de cálculo

La fórmula completa de puntuación de confianza: 
puntuacion_confianza =
 (puntuacion_monto * 0.40) +
 (puntuacion_moneda * 0.30) +
 (puntuacion_fecha * 0.20) +
 (puntuacion_regla * 0.10)

​
Respuesta de API

Cuando Matcher propone una coincidencia, la respuesta incluye la puntuación detallada: 
{
  "match_id": "match_001",
  "confidence": 87,
  "confidence_breakdown": {
    "amount": {
      "weight": 40,
      "score": 38,
      "weighted_score": 15.2,
      "details": {
        "variance_amount": 5.0,
        "variance_percent": 0.5
      }
    },
    "currency": {
      "weight": 30,
      "score": 30,
      "weighted_score": 9.0,
      "details": {
        "source_currency": "USD",
        "target_currency": "USD",
        "match": true
      }
    },
    "date": {
      "weight": 20,
      "score": 16,
      "weighted_score": 3.2,
      "details": {
        "source_date": "2024-01-15",
        "target_date": "2024-01-17",
        "gap_days": 2
      }
    },
    "rule": {
      "weight": 10,
      "score": 10,
      "weighted_score": 1.0,
      "details": {
        "rule_id": "rule_002",
        "rule_name": "1% Tolerance",
        "conditions_met": [
          "amount_tolerance",
          "date_tolerance"
        ]
      }
    }
  },
  "transactions": {
    "source": {
      "id": "txn_001",
      "amount": 1000.0
    },
    "target": {
      "id": "txn_002",
      "amount": 1005.0
    }
  }
}

​
Ejemplos de cálculo

​
Coincidencia exacta (puntuación: 100)

Dos transacciones con valores idénticos en el mismo día:
CampoOrigenDestinoPuntuación del componente
Monto$1,000.00$1,000.0040/40
MonedaUSDUSD30/30
Fecha2024-01-152024-01-1520/20
ReglaCoincidencia exacta—10/10
Puntuación final: 100 
{
  "confidence": 100,
  "confidence_breakdown": {
    "amount": {
      "score": 40,
      "weighted_score": 16.0
    },
    "currency": {
      "score": 30,
      "weighted_score": 9.0
    },
    "date": {
      "score": 20,
      "weighted_score": 4.0
    },
    "rule": {
      "score": 10,
      "weighted_score": 1.0
    }
  }
}

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

Pequeña varianza de monto con diferencia de 2 días:
CampoOrigenDestinoPuntuación del componente
Monto$1,000.00$1,005.00 (0.5%)38/40
MonedaUSDUSD30/30
Fecha2024-01-152024-01-1716/20
ReglaCoincidencia con tolerancia—10/10
Cálculo:
  • Monto: 38 × 0.40 = 15.2
  • Moneda: 30 × 0.30 = 9.0
  • Fecha: 16 × 0.20 = 3.2
  • Regla: 10 × 0.10 = 1.0
  • Total: 28.4 → Normalizado a 87

​
Confianza media (puntuación: 72)

Mayor varianza que requiere revisión:
CampoOrigenDestinoPuntuación del componente
Monto$1,000.00$1,025.00 (2.5%)28/40
MonedaUSDUSD30/30
Fecha2024-01-152024-01-1912/20
ReglaCoincidencia con tolerancia—8/10
Cálculo:
  • Monto: 28 × 0.40 = 11.2
  • Moneda: 30 × 0.30 = 9.0
  • Fecha: 12 × 0.20 = 2.4
  • Regla: 8 × 0.10 = 0.8
  • Total: 23.4 → Normalizado a 72

​
Baja confianza (puntuación: 55)

Varianzas significativas—tratada como excepción:
CampoOrigenDestinoPuntuación del componente
Monto$1,000.00$1,080.00 (8%)15/40
MonedaUSDUSD30/30
Fecha2024-01-152024-01-254/20
ReglaCoincidencia débil—5/10
Puntuación final: 55 (Por debajo del umbral, se convierte en excepción)

​
Niveles de confianza

Matcher categoriza las coincidencias en niveles según la puntuación:
NivelRango de puntuaciónComportamiento del sistemaVolumen típico
Auto-aprobado>= 90Confirmado automáticamente70-80%
Requiere revisión60-89En cola para revisión manual15-25%
Excepción< 60Tratado como no coincidente5-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.
  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.

​
Personalización de umbrales

​
Configuración a nivel de contexto

Puede establecer umbrales por contexto de conciliación al crear o actualizar el contexto: 
{
  "settings": {
    "confidence": {
      "auto_approve_threshold": 95,
      "review_threshold": 70,
      "exception_threshold": 70
    }
  }
}
Referencia de API: Crear contexto, Actualizar contexto

​
Recomendaciones de umbrales

Caso de usoAuto-aprobarRevisiónExcepción
Alto volumen, bajo riesgo>= 8555-84< 55
Conciliación estándar>= 9060-89< 60
Alto valor, alto riesgo>= 9570-94< 70
Crítico para cumplimiento>= 9880-97< 80

​
Personalización de pesos

Ajuste los pesos de los componentes según sus necesidades de conciliación en la configuración del contexto: 
{
  "weights": {
    "amount": 50,
    "currency": 20,
    "date": 20,
    "rule": 10
  },
  "penalties": {
    "amount_per_percent": 8,
    "date_per_day": 3
  }
}

​
Guías de pesos

EscenarioPesos recomendados
Conciliación de extractos bancariosMonto: 40%, Moneda: 30%, Fecha: 20%, Regla: 10%
Pasarela de pagosMonto: 35%, Moneda: 25%, Fecha: 15%, Regla: 25%
IntercompañíaMonto: 30%, Moneda: 20%, Fecha: 10%, Regla: 40%
Retail de alto volumenMonto: 45%, Moneda: 30%, Fecha: 15%, Regla: 10%

​
Mejores prácticas

Los pesos predeterminados 40/30/20/10 funcionan bien para la mayoría de los escenarios de conciliación. Solo ajuste después de analizar los patrones de coincidencia.
Rastree el porcentaje de transacciones en cada nivel. Cambios inusuales pueden indicar problemas de calidad de datos o mala configuración de umbrales.
Siempre simule los cambios de puntuación antes de aplicarlos. Esto previene aumentos inesperados en el volumen de revisión manual.
Registre por qué se eligieron umbrales específicos. Esto ayuda durante auditorías y al incorporar nuevos miembros del equipo.
Revise periódicamente las coincidencias justo por encima del umbral de excepción. Estas a menudo revelan oportunidades para mejorar las reglas.
Umbrales de auto-aprobación más altos reducen el riesgo pero aumentan el trabajo manual. Encuentre el equilibrio apropiado para su organización.

​
Próximos pasos

Reglas de coincidencia

Configure reglas que influyen en la puntuación.

Multi-moneda

Cómo FX afecta la puntuación de confianza.