Saltar al contenido principal
Matcher permite conciliar transacciones en monedas diferentes al convertir los montos a una moneda base común antes de compararlos. Esto habilita la coincidencia entre transacciones internacionales, operaciones de tesorería y conciliaciones de múltiples entidades.

​
Resumen

La coincidencia multimoneda convierte los montos de ambas transacciones a una moneda base con el tipo de cambio correspondiente y luego aplica las reglas de coincidencia estándar. Si los montos convertidos quedan dentro de la tolerancia, Matcher crea una coincidencia. De lo contrario, crea una excepción para revisión.
Flujo de coincidencia multimoneda.

Flujo de coincidencia multimoneda.

​
Cómo funciona

El soporte multimoneda reside en los tipos de contexto existentes (1:1, 1:N, N:M) y en las reglas de coincidencia. No existe un tipo de contexto “multi-currency” separado. En el momento de la coincidencia, Matcher calcula un monto base y una moneda base para cada transacción a partir de las indicaciones de FX en los metadatos de la propia transacción (consulta FX desde los metadatos de la transacción más abajo). Las reglas que configuran matchBaseAmount o matchBaseCurrency comparan estos valores base. No puedes cargar un monto base directamente. No hay un proveedor de FX externo ni un servicio de consulta de tipos de cambio. El tipo de cambio siempre proviene de la propia fila de la transacción.

​
Componentes clave

​
Cómo configurar reglas para multimoneda

Habilita la comparación multimoneda al configurar matchBaseAmount y matchBaseCurrency en true en la configuración de la regla. Las verificaciones de los valores originales siguen activas. Una regla EXACT compara amount mientras matchAmount está activado, y las reglas EXACT y TOLERANCE comparan currency mientras matchCurrency está activado. Ambos vienen activados de forma predeterminada, así que una regla entre monedas los desactiva.

​
Regla exacta con coincidencia de monto base

cURL
matchBaseAmount compara los montos base, y matchBaseCurrency compara las monedas base. Una transacción sin monto base falla ambas verificaciones.

​
Regla de tolerancia con coincidencia de monto base

cURL
Con matchBaseAmount, una regla TOLERANCE compara los montos base en lugar de los montos originales, y absTolerance está en unidades de la moneda base.

​
Puntuación de confianza

Las reglas de monto base usan los mismos pesos fijos de componentes que todas las demás reglas. Para el modelo de puntuación completo, consulta Puntuación de confianza.

​
FX desde los metadatos de la transacción

Cuando una transacción todavía no tiene un monto base, Matcher la convierte en el momento de la coincidencia con las indicaciones de FX que viajan en el metadata de esa transacción. Matcher no llama a ningún proveedor de tipos de cambio externo. El tipo de cambio viaja con la fila. La conversión solo se ejecuta cuando fx_base_currency está presente. La conversión nunca modifica el amount ni el currency originales, porque solo cambia la comparación. Matcher redondea el monto convertido a la mayor roundingScale entre las reglas TOLERANCE del contexto, o a 2 decimales cuando el contexto no tiene ninguna. La simulación de coincidencias no convierte, así que las reglas de monto base no encuentran coincidencias en una simulación.

​
Campos de metadatos

​
Ejemplo de transacción con metadatos de FX

Para la transacción anterior, Matcher deriva un monto base de 1085.00 USD (1000.00 × 1.085). Luego, una regla con matchBaseAmount y matchBaseCurrency compara ese monto base y esa moneda con el otro lado.
Cuando las indicaciones faltan o no son válidas (tipo de cambio no interpretable, expresión fallida), la transacción no recibe monto base. No puede coincidir bajo una regla de monto base y queda sin conciliar. La ejecución continúa.

​
Banda de variación del tipo de cambio

Los montos entre monedas suelen diferir levemente, porque cada lado convierte con un tipo de cambio distinto o en un día distinto. La clave fxVarianceBand en las reglas TOLERANCE atiende esto. Define un segundo umbral apilado por encima de la tolerancia de coincidencia, expresado como fracción decimal (0.0001 = 1 punto básico). Después de la pasada de tolerancia estricta, Matcher vuelve a escanear los pares 1:1 entre monedas que quedaron no conciliados. Un par cuyo residuo de monto base supera la tolerancia de coincidencia pero se mantiene dentro de la banda igual coincide. El par pasa a ser un grupo propuesto con una confianza fija de 75, por debajo del umbral de confirmación automática, así que siempre requiere revisión humana. Matcher marca ambas transacciones con el motivo de excepción FX_RATE_VARIANCE. El residuo pasa entonces a ser una excepción tipificada en lugar de reducirse a UNMATCHED. La banda solo aplica cuando:
  • ambos lados traen un monto base y la misma moneda base.
  • las monedas originales difieren (la desviación dentro de la misma moneda es un simple desajuste, no un caso de FX).
  • todos los demás controles de la regla (ventana de fechas, referencia, campos compuestos) siguen pasando. La regla debe configurar matchCurrency en false, porque el control de moneda rechaza los pares cuyas monedas originales difieren.
Un fxVarianceBand en cero o ausente deshabilita la banda.
cURL

​
Ejemplo: conciliación entre monedas

Origen (cuenta en EUR): Destino (cuenta en USD): Ambas transacciones traen fx_base_currency: "USD". txn_001 trae fx_rate: "1.085" y txn_002 trae fx_rate: "1". Con una regla TOLERANCE (matchCurrency: false, matchBaseAmount: true, matchReference: false, percentTolerance: 0.02):
  • Montos base: $1,085.00 vs $1,095.00
  • Diferencia: $10.00
  • Umbral: 2% del monto mayor, $21.90
  • Resultado: Coincidencia ($10.00 < $21.90)

​
Mejores prácticas

Adjunta fx_base_currency y fx_rate (o fx_notional_expr) a los metadatos de cada transacción en la fuente, con el tipo de cambio que aplicaba cuando la transacción se liquidó. Como el tipo de cambio viaja con la fila, los resultados son reproducibles entre ejecuciones, sin consultas de tipo de cambio en tiempo de ejecución.
Las conversiones de FX introducen pequeñas variaciones. Usa reglas TOLERANCE con matchBaseAmount para admitir diferencias de redondeo y de momento del tipo de cambio.
Usa una moneda base consistente en todos los contextos. USD es común para operaciones internacionales. Usa tu moneda de reporte para nacional + internacional.

​
Próximos pasos

Puntuación de confianza

Cómo funcionan las puntuaciones de coincidencia y qué umbrales aplican.

Reglas de coincidencia

Referencia completa de los tipos de regla y los campos de configuración.