Coincidencia multi-moneda

Matcher permite la conciliación de transacciones en diferentes monedas convirtiendo los montos a una moneda base común antes de la comparación. Esto habilita la coincidencia entre transacciones internacionales, operaciones de tesorería y conciliaciones multi-entidad.

Descripción general

La coincidencia multi-moneda convierte ambos montos de transacción a una moneda base usando la tasa FX apropiada, luego aplica las reglas de coincidencia estándar. Si los montos convertidos están dentro de la tolerancia, Matcher crea una coincidencia. De lo contrario, crea una excepción para revisión.

Habilitando multi-moneda

Configuración de contexto

Habilite la coincidencia multi-moneda a nivel de contexto al crear o actualizar un contexto:

{
  "name": "International Treasury Reconciliation",
  "type": "MULTI_CURRENCY",
  "settings": {
    "multi_currency": {
      "enabled": true,
      "base_currency": "USD",
      "fx_rate_source": "external_provider",
      "fx_tolerance_percent": 2.0,
      "fx_tolerance_absolute": 10.0
    }
  }
}

Referencia de API: Crear contexto, Actualizar contexto

Configuración multi-moneda

Configuración	Tipo	Descripción
`enabled`	Boolean	Habilitar coincidencia multi-moneda
`base_currency`	String	Código ISO 4217 para moneda de comparación
`fx_rate_source`	String	Fuente para tasas FX
`fx_tolerance_percent`	Decimal	Tolerancia porcentual para varianza FX
`fx_tolerance_absolute`	Decimal	Tolerancia absoluta en moneda base
`rate_date_strategy`	String	Cómo determinar qué fecha de tasa usar
`fallback_behavior`	String	Acción cuando la tasa FX no está disponible

Moneda base

La moneda base se usa como denominador común para todas las comparaciones.

Eligiendo una moneda base

Escenario	Base recomendada	Justificación
Empresa con sede en EE.UU.	USD	Coincide con moneda de reporte
Empresa con sede en UE	EUR	Coincide con moneda de reporte
Operaciones multi-región	USD	Más líquida, tasas ampliamente disponibles
Brasil doméstico + internacional	BRL	Coincide con reporte local

Cambiando la moneda base

Cambiar la moneda base afecta todas las coincidencias pendientes. Complete o archive las coincidencias existentes antes de cambiar.

Fuentes de tasas FX

Matcher permite múltiples fuentes para tasas de cambio.

Proveedor externo

Conéctese a APIs de tasas FX de terceros configurando la fuente de tasas FX en la configuración del contexto:

{
  "type": "external_provider",
  "provider": "openexchangerates",
  "settings": {
    "api_key_id": "secret_fx_001",
    "base_url": "https://openexchangerates.org/api/",
    "cache_duration_minutes": 60,
    "fallback_to_previous_day": true
  }
}

Proveedores soportados:

Proveedor	Características	Frecuencia de actualización
Open Exchange Rates	170+ monedas	Cada hora
Fixer.io	170+ monedas	Cada hora
Currency Layer	168 monedas	Cada hora
XE	185+ monedas	Tiempo real
Banco Central Europeo	Cruces EUR	Diario

Motor de tasas de activos Midaz (opcional)

Si está usando Midaz Ledger, puede consultar tasas FX directamente desde él:

{
  "type": "midaz",
  "settings": {
    "ledger_id": "ldg_001",
    "rate_type": "spot",
    "fallback_to_closing": true
  }
}

Esta opción solo está disponible si tiene Midaz integrado. Vea Integración con Midaz para instrucciones de configuración.

Entrada manual

Cargue tasas manualmente para entornos controlados incluyéndolas en la configuración del contexto o usando la gestión dedicada de tasas.

Estrategia de fecha de tasa

Determine qué fecha de tasa FX usar para la conversión.

Opciones de estrategia

Estrategia	Descripción	Caso de uso
`earlier_date`	Usar tasa de la fecha de transacción más temprana	Por defecto, conservadora
`later_date`	Usar tasa de la fecha de transacción más tardía	Cuando importa la fecha de liquidación
`source_date`	Usar tasa de la fecha de fuente interna	Cuando la interna es autoritativa
`target_date`	Usar tasa de la fecha de fuente externa	Cuando la externa es autoritativa
`average`	Promedio de las tasas de ambas fechas	Reducir volatilidad de un solo día

Configurar estrategia de fecha de tasa

{
  "settings": {
    "multi_currency": {
      "rate_date_strategy": "earlier_date",
      "rate_time": "closing",
      "timezone": "America/New_York"
    }
  }
}

Opciones de hora de tasa

Opción	Descripción
`opening`	Tasa de apertura del día
`closing`	Tasa de cierre del día (por defecto)
`midday`	Tasa de las 12:00
`spot`	Tasa en tiempo real al momento de la transacción

Configuración de tolerancia

La coincidencia multi-moneda usa tolerancia combinada para tener en cuenta las fluctuaciones FX.

Fórmula de tolerancia

monto_convertido_a = monto_a * tasa_fx_a_a_base
monto_convertido_b = monto_b * tasa_fx_b_a_base

diferencia = abs(monto_convertido_a - monto_convertido_b)
monto_maximo = max(abs(monto_convertido_a), abs(monto_convertido_b))

pasa = diferencia <= max(tolerancia_absoluta, tolerancia_porcentaje * monto_maximo)

Ejemplos de tolerancia

Ejemplo 1: Dentro de tolerancia

Transacción	Original	Tasa FX	Base (USD)
A (EUR)	1,000.00	1.0850	1,085.00
B (USD)	1,095.00	1.0000	1,095.00

Diferencia: $10.00 (0.92%)
Tolerancia: max( $10.00, 2% ×$ 1,095) = max( $10.00,$ 21.90) = $21.90
Resultado: Coincidencia ( $10.00 <=$ 21.90)

Ejemplo 2: Fuera de tolerancia

Transacción	Original	Tasa FX	Base (USD)
A (EUR)	1,000.00	1.0850	1,085.00
B (USD)	1,150.00	1.0000	1,150.00

Diferencia: $65.00 (5.99%)
Tolerancia: max( $10.00, 2% ×$ 1,150) = max( $10.00,$ 23.00) = $23.00
Resultado: Sin coincidencia ( $65.00 >$ 23.00)

Tolerancia personalizada por par de monedas

Establezca diferentes tolerancias para pares de monedas volátiles:

{
  "settings": {
    "multi_currency": {
      "fx_tolerance_percent": 2.0,
      "fx_tolerance_absolute": 10.0,
      "currency_pair_overrides": [
        {
          "pair": "BRL/USD",
          "tolerance_percent": 5.0,
          "tolerance_absolute": 50.0
        },
        {
          "pair": "ARS/USD",
          "tolerance_percent": 10.0,
          "tolerance_absolute": 100.0
        }
      ]
    }
  }
}

Manejo de tasas FX faltantes

Cuando una tasa FX no está disponible, Matcher sigue el comportamiento de respaldo configurado.

Opciones de respaldo

Comportamiento	Descripción	Nivel de riesgo
`exception`	Crear excepción para manejo manual	Más bajo
`skip`	Saltar intento de coincidencia, continuar procesando	Bajo
`previous_day`	Usar tasa disponible anterior	Medio
`interpolate`	Estimar de fechas circundantes	Medio
`fail`	Fallar todo el trabajo	Más alto

Configurar respaldo

{
  "settings": {
    "multi_currency": {
      "fallback_behavior": "previous_day",
      "max_fallback_days": 3,
      "alert_on_fallback": true
    }
  }
}

Excepción por tasa faltante

Cuando el respaldo es exception, la transacción se convierte en excepción con detalles específicos:

{
  "exception_id": "exc_fx_001",
  "type": "FX_RATE_UNAVAILABLE",
  "severity": "HIGH",
  "details": {
    "from_currency": "TRY",
    "to_currency": "USD",
    "required_date": "2024-01-20",
    "nearest_available": "2024-01-18",
    "gap_days": 2
  },
  "resolution_options": [
    "Proporcionar tasa manual",
    "Usar tasa de respaldo del 2024-01-18",
    "Marcar como sin coincidencia"
  ]
}

Impacto en la puntuación de confianza

La coincidencia multi-moneda afecta la puntuación de confianza a través del componente de moneda.

Cálculo de puntuación de moneda

Escenario	Puntuación de moneda
Misma moneda	30/30 (100%)
Moneda diferente, coincidencia FX exacta	28/30 (93%)
Moneda diferente, dentro de 1% varianza FX	25/30 (83%)
Moneda diferente, dentro de 2% varianza FX	22/30 (73%)
Moneda diferente, >2% varianza FX	15-20/30
Tasa FX no disponible (respaldo usado)	10/30 (33%)

Ejemplo de puntuación

Coincidencia multi-moneda con ligera varianza FX:

{
  "confidence": 82,
  "confidence_breakdown": {
    "amount": {
      "score": 36,
      "weighted_score": 14.4,
      "details": {
        "source_amount": "EUR 1,000.00",
        "target_amount": "USD 1,095.00",
        "converted_source": "USD 1,085.00",
        "variance_percent": 0.91
      }
    },
    "currency": {
      "score": 22,
      "weighted_score": 6.6,
      "details": {
        "source_currency": "EUR",
        "target_currency": "USD",
        "fx_rate_used": 1.085,
        "fx_rate_date": "2024-01-15",
        "fx_variance_from_market": 0.8
      }
    },
    "date": {
      "score": 18,
      "weighted_score": 3.6
    },
    "rule": {
      "score": 10,
      "weighted_score": 1.0
    }
  }
}

Tasas variables por atributos de transacción

Característica avanzada: La coincidencia con tasas variables permite que las tasas cambien según atributos de transacción como MCC, tipo de tarjeta, método de transacción y segmento del comercio. Esto se usa comúnmente en conciliación de adquirencia/red de tarjetas.

En algunos escenarios de conciliación, particularmente en procesamiento de adquirencia y red de tarjetas, la tasa aplicable varía según múltiples atributos de transacción en lugar de ser fija.

Casos de uso comunes

Conciliación de adquirencia (Interchange Plus)

La tasa varía por MCC (Código de Categoría de Comercio)
Diferentes tasas para tarjetas de crédito vs. débito
Precios basados en segmento (retail, restaurante, combustible)
Método de transacción (físico vs. link/online)

Telecomunicaciones

Diferentes tasas por operador
La tasa varía por tipo de plan y región
Precios promocionales vs. estándar

Precios por niveles

Niveles de tasa basados en volumen
Precios por segmento de cliente
Variaciones de tasa basadas en tiempo

Configuración de búsqueda de tasas

Configure la búsqueda de tasas basada en metadatos de transacción en la configuración del contexto:

{
  "name": "Interchange Plus Rate Lookup",
  "rate_type": "variable",
  "lookup_strategy": "multi_attribute",
  "attributes": [
    {
      "field": "metadata.mcc",
      "type": "string",
      "required": true
    },
    {
      "field": "metadata.card_type",
      "type": "string",
      "required": true,
      "values": ["credit", "debit"]
    },
    {
      "field": "metadata.transaction_method",
      "type": "string",
      "required": true,
      "values": ["physical", "online", "link"]
    }
  ],
  "rate_source": {
    "type": "api",
    "endpoint": "https://rates-api.example.com/interchange/v1/rate",
    "method": "POST",
    "auth_type": "bearer",
    "cache_ttl_seconds": 3600
  },
  "fallback": {
    "strategy": "default_rate",
    "default_rate": 2.5,
    "alert_on_fallback": true
  }
}

Mejores prácticas para tasas variables

Cachee las búsquedas de tasas

Habilite el caché para llamadas API de tasas para reducir la latencia. La mayoría de las tasas no cambian dentro de un día.

Versione sus tablas de tasas

Use tablas de tasas versionadas (ej., “2024Q1”) y rastree qué versión se usó para cada coincidencia.

Establezca tolerancia apropiada

Las comisiones de red pueden variar ligeramente. Establezca la tolerancia en 1-2% para evitar excepciones falsas.

Monitoree fallas de búsqueda de tasas

Alerte cuando las búsquedas de tasas fallen frecuentemente - puede indicar códigos MCC faltantes o problemas de API.

Mejores prácticas

Use fuentes de tasas FX confiables

Conéctese a proveedores FX establecidos con datos históricos. Evite fuentes con brechas o actualizaciones retrasadas.

Establezca tolerancias apropiadas por moneda

Las monedas volátiles (mercados emergentes) necesitan tolerancias más altas. Los pares estables (EUR/USD) pueden usar tolerancias más ajustadas.

Monitoree tendencias de varianza FX

Revise regularmente los reportes de varianza FX. El aumento de varianza puede indicar problemas de timing o problemas con la fuente de tasas.

Documente las decisiones de fuente de tasas

Registre por qué se eligieron fuentes de tasas y estrategias específicas. Esto ayuda durante auditorías y resolución de problemas.

Planifique para indisponibilidad de tasas

Configure comportamiento de respaldo sensato y alertas. Tenga un proceso para proporcionar tasas manuales cuando sea necesario.

Considere el timing de liquidación

Las tasas FX pueden cambiar entre las fechas de transacción y liquidación. Elija la estrategia de fecha de tasa basada en sus requisitos contables.

Introduction

Primeros pasos

Configuración

Reconciliación diaria

Integraciones

Referencia

​Descripción general

​Habilitando multi-moneda

​Configuración de contexto

​Configuración multi-moneda

​Moneda base

​Eligiendo una moneda base

​Cambiando la moneda base

​Fuentes de tasas FX

​Proveedor externo

​Motor de tasas de activos Midaz (opcional)

​Entrada manual

​Estrategia de fecha de tasa

​Opciones de estrategia

​Configurar estrategia de fecha de tasa

​Opciones de hora de tasa

​Configuración de tolerancia

​Fórmula de tolerancia

​Ejemplos de tolerancia

​Tolerancia personalizada por par de monedas

​Manejo de tasas FX faltantes

​Opciones de respaldo

​Configurar respaldo

​Excepción por tasa faltante

​Impacto en la puntuación de confianza

​Cálculo de puntuación de moneda

​Ejemplo de puntuación

​Tasas variables por atributos de transacción

​Casos de uso comunes

​Configuración de búsqueda de tasas

​Mejores prácticas para tasas variables

​Mejores prácticas

​Próximos pasos

Puntuación de confianza

División y agregación

Descripción general

Habilitando multi-moneda

Configuración de contexto

Configuración multi-moneda

Moneda base

Eligiendo una moneda base

Cambiando la moneda base

Fuentes de tasas FX

Proveedor externo

Motor de tasas de activos Midaz (opcional)

Entrada manual

Estrategia de fecha de tasa

Opciones de estrategia

Configurar estrategia de fecha de tasa

Opciones de hora de tasa

Configuración de tolerancia

Fórmula de tolerancia

Ejemplos de tolerancia

Tolerancia personalizada por par de monedas

Manejo de tasas FX faltantes

Opciones de respaldo

Configurar respaldo

Excepción por tasa faltante

Impacto en la puntuación de confianza

Cálculo de puntuación de moneda

Ejemplo de puntuación

Tasas variables por atributos de transacción

Casos de uso comunes

Configuración de búsqueda de tasas

Mejores prácticas para tasas variables

Mejores prácticas

Próximos pasos