Skip to main content
Matcher expone dos endpoints de simulación de solo lectura para que puedas responder “¿qué pasaría?” antes de comprometer una configuración. Son la simulación de coincidencia (¿esta regla va a coincidir?) y la simulación de comisiones (¿qué comisiones cobraría este esquema?). Ninguno persiste nada.

Simulación de coincidencia


Previsualiza cómo una sola regla haría coincidir las transacciones no conciliadas de un contexto, sin comprometer nada. Elige una regla configurada existente (ruleId) o una regla candidata en línea (rule).
Proporciona exactamente uno de:
  • ruleId: previsualiza una regla configurada existente del contexto.
  • rule: previsualiza una definición candidata no persistida (type es uno de EXACT, TOLERANCE, DATE_LAG, FUZZY, más su config).
Proporcionar ambos, o ninguno, devuelve 400. sampleLimit (1–200, 25 de forma predeterminada) limita los pares candidatos que se devuelven. La respuesta informa cuántos grupos 1:1 formaría la regla y los conteos de no conciliados por lado. También devuelve una muestra acotada de pares candidatos, cada uno con una puntuación de confianza y una justificación por componente:
Alcance: la simulación puntúa con el motor de reglas determinista sobre los montos brutos de las transacciones. No aplica la normalización de comisiones en tiempo de ejecución ni la banda de variación FX, y previsualiza solo el agrupamiento por pares 1:1 (sin asignación 1:N/N:M). La simulación no cuenta un par que solo coincide después de la normalización de comisiones, dentro de la banda FX o por asignación.

Simulación de comisiones


Calcula las comisiones de un monto bruto dado con un esquema de comisiones específico. Úsalo para validar las reglas de un esquema antes de asociarlo a un contexto.
La respuesta devuelve el monto neto, la comisión total y un desglose por ítem:
La simulación de comisiones no tiene metadatos de transacción, así que los ítems de comisión por expresión que requieren un identificador de transacción exponen su error de identificador faltante como un 4xx. Un esquema que no existe devuelve 404.

Cuándo usar cada una


Ambos endpoints se mantienen estrictamente de solo lectura. Nunca persisten una ejecución, un grupo, un ítem, una regla ni una transacción. El tenant siempre viene del JWT.

Códigos de respuesta