> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Reglas del contexto

> Define reglas de matching que controlen cómo el motor empareja transacciones entre fuentes de datos para resultados precisos.

Usa la sección **Reglas** en la Matcher UI para definir y gestionar las reglas de matching que controlan cómo se emparejan las transacciones durante la reconciliación. Las reglas especifican los criterios que utiliza el motor de matching para identificar transacciones correspondientes entre fuentes de datos. Las reglas se gestionan desde la página de detalle del contexto.

## Acceder a la sección de Reglas

***

<Steps>
  <Step>
    Navega a **Reconciliación > Contextos** en la barra lateral izquierda.
  </Step>

  <Step>
    Selecciona un contexto de la lista para abrir su página de detalle.
  </Step>

  <Step>
    Desplázate hasta la sección **Reglas de matching**.
  </Step>
</Steps>

<Note>
  El **Selector de contexto** global en la barra lateral te permite cambiar el contexto de reconciliación activo en cualquier momento.
</Note>

## Lista de reglas

***

La tabla lista todas las reglas de matching configuradas para el contexto seleccionado, incluyendo su prioridad, tipo y configuración.

## Crear una regla

***

<Steps>
  <Step>
    En la sección **Reglas de matching** de la página de detalle del contexto, haz clic en el botón **Nueva regla**.
  </Step>

  <Step>
    Se abre un panel lateral. Completa los detalles de la regla:

    | Campo                         | Descripción                                                            |
    | ----------------------------- | ---------------------------------------------------------------------- |
    | **Prioridad** (requerido)     | Orden de ejecución (1–1000). Números menores se ejecutan primero.      |
    | **Tipo de regla** (requerido) | La estrategia de matching a aplicar: `EXACT`, `TOLERANCE` o `DATE_LAG` |

    Dependiendo del tipo de regla, aparecen campos adicionales (ver abajo).
  </Step>

  <Step>
    Haz clic en **Guardar regla** para crear la regla.
  </Step>
</Steps>

## Tipos de regla

***

### EXACT

Empareja transacciones comparando uno o más campos para igualdad exacta.

La sección **Configuración avanzada** expone los siguientes campos y opciones:

| Campo                         | Descripción                                                             |
| ----------------------------- | ----------------------------------------------------------------------- |
| **Amount**                    | Actívalo para emparejar por monto de transacción                        |
| **Match currency**            | Actívalo para requerir coincidencia de moneda                           |
| **Date**                      | Actívalo para emparejar por fecha de transacción                        |
| **Match reference**           | Actívalo para emparejar por campo de referencia                         |
| **Date Precision**            | Nivel de precisión para el matching de fechas: `DAY` o `TIMESTAMP`      |
| **Case insensitive matching** | Actívalo para ignorar mayúsculas/minúsculas al comparar campos de texto |
| **Reference must be set**     | Actívalo para requerir un valor de referencia para el match             |

### TOLERANCE

Empareja transacciones dentro de un rango de tolerancia numérico o de fecha.

| Campo                              | Descripción                                                     |
| ---------------------------------- | --------------------------------------------------------------- |
| **Tolerancia de monto (absoluta)** | Diferencia absoluta máxima permitida en el monto                |
| **Tolerancia de monto (%)**        | Diferencia porcentual máxima permitida (p. ej., `0.05` para 5%) |
| **Ventana de fecha (días)**        | Número de días de tolerancia para el matching de fechas         |

<Note>
  Al menos un valor de tolerancia debe ser proporcionado y debe ser mayor que cero.
</Note>

La sección **Configuración avanzada** para reglas TOLERANCE también incluye:

| Campo                         | Descripción                                                                                               |
| ----------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Rounding Mode**             | Cómo se redondean los valores antes de la comparación: `HALF_UP`, `BANKERS`, `FLOOR`, `CEIL` o `TRUNCATE` |
| **Rounding Scale**            | Número de decimales para el redondeo (0–10)                                                               |
| **Percentage Base**           | Valor base para cálculos porcentuales: `MAX`, `MIN`, `AVERAGE`, `LEFT` o `RIGHT`                          |
| **Match currency**            | Actívalo para requerir coincidencia de moneda                                                             |
| **Match reference**           | Actívalo para emparejar por campo de referencia                                                           |
| **Case insensitive matching** | Actívalo para ignorar mayúsculas/minúsculas al comparar campos de texto                                   |
| **Reference must be set**     | Actívalo para requerir un valor de referencia                                                             |

### DATE\_LAG

Empareja transacciones que ocurren dentro de un número configurable de días entre sí.

| Campo                    | Descripción                                                        |
| ------------------------ | ------------------------------------------------------------------ |
| **Min Days** (requerido) | Días mínimos de desfase permitidos entre las fechas de transacción |
| **Max Days** (requerido) | Días máximos de desfase permitidos entre las fechas de transacción |

La sección **Configuración avanzada** para reglas DATE\_LAG también incluye:

| Campo               | Descripción                                                                           |
| ------------------- | ------------------------------------------------------------------------------------- |
| **Inclusive range** | Actívalo para incluir los días límite en el rango                                     |
| **Direction**       | Restricción de dirección: `ABS` (absoluto), `LEFT_BEFORE_RIGHT` o `RIGHT_BEFORE_LEFT` |
| **Fee Tolerance**   | Monto de tolerancia de tarifas para el matching de date lag                           |
| **Match currency**  | Actívalo para requerir coincidencia de moneda                                         |

## Configuración avanzada (todos los tipos de regla)

***

Todos los tipos de regla comparten estas opciones avanzadas:

| Campo                   | Descripción                                                             |
| ----------------------- | ----------------------------------------------------------------------- |
| **Match base amount**   | Actívalo para también emparejar por el monto base (antes de conversión) |
| **Match base currency** | Actívalo para también emparejar por la moneda base                      |
| **Match Score**         | Puntuación de confianza asignada a un match primario (0–100)            |
| **Base Match Score**    | Puntuación de confianza asignada a un match de monto base (0–100)       |

## Configuración de asignación

***

Todos los tipos de regla incluyen una sección **Configuración de asignación** para configurar el comportamiento de asignación parcial:

| Campo                              | Descripción                                                                       |
| ---------------------------------- | --------------------------------------------------------------------------------- |
| **Allow partial allocation**       | Actívalo para permitir emparejar una transacción con múltiples contrapartes       |
| **Use base amount for allocation** | Actívalo para usar el monto base en lugar del monto convertido para la asignación |
| **Allocation Direction**           | Dirección de asignación: `LEFT_TO_RIGHT` o `RIGHT_TO_LEFT`                        |
| **Tolerance Mode**                 | Cómo se mide la tolerancia de asignación: `ABS` (absoluto) o `PERCENT`            |
| **Tolerance Value**                | Umbral de tolerancia de asignación (absoluto o porcentual según el modo)          |

## Editar una regla

***

Haz clic en el ícono de edición junto a una regla para abrir el panel de edición. Actualiza los campos según sea necesario y haz clic en **Actualizar regla**.

## Eliminar una regla

***

Haz clic en el ícono de eliminar junto a una regla y confirma la eliminación.
