> ## 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
> Crea y gestiona reglas de coincidencia EXACT, TOLERANCE, DATE_LAG y FUZZY desde la pestaña Rules de la página de configuración de un contexto en la interfaz de Matcher.
Usa la pestaña **Rules** en la página de configuración de un contexto para definir y gestionar las reglas de coincidencia. Las reglas controlan cómo el motor de coincidencia empareja transacciones durante la conciliación. Las reglas especifican los criterios que usa el motor de coincidencia para identificar transacciones correspondientes entre fuentes de datos.
## Cómo acceder a la pestaña Rules
***
Navega a **Configure → Contexts** en la barra lateral izquierda.
Selecciona un contexto de la lista para abrir su página de configuración.
Selecciona la pestaña **Rules**.
El **Context Switcher** global en la barra lateral permite cambiar el contexto de conciliación activo en cualquier momento.
## Lista de reglas
***
La pestaña Rules lista las reglas de coincidencia en orden de prioridad. Las reglas se evalúan de arriba abajo. Gana la primera coincidencia. Cada fila visible muestra la estrategia de la regla y un resumen corto de su configuración. La fila también tiene las flechas **Move rule up** / **Move rule down**, un botón **Edit rule** y un botón **Delete rule**.
Para los contextos con 100 reglas o menos, la prioridad se asigna automáticamente cuando creas una regla. Una regla nueva va al final de la cadena. Para cambiar la precedencia, reordena la lista con las flechas hacia arriba y hacia abajo. No hay un campo de prioridad en el formulario.
La pestaña Rules carga solo las primeras 100 reglas por prioridad y no ofrece paginación. Aquí no puedes ver ni gestionar las reglas posteriores. El botón **Add rule** deriva la prioridad nueva de esas 100 reglas. Una vez que una regla en la prioridad 101 queda oculta, el siguiente intento de creación entra en conflicto con ella y falla.
## Cómo crear una regla
***
En la pestaña **Rules**, haz clic en el botón **Add rule**.
Se abre un diálogo. Selecciona una **Strategy**:
| Estrategia | Descripción |
| ------------- | ---------------------------------- |
| **Exact** | Igualdad campo por campo |
| **Tolerance** | Monto/fecha dentro de una banda |
| **Date lag** | Ventana de retraso de liquidación |
| **Fuzzy** | Similitud aproximada de referencia |
Según la estrategia, aparecen campos diferentes (consulta más abajo).
Haz clic en **Create rule**.
No puedes cambiar la estrategia después de crear la regla. Para cambiar la estrategia de una regla, elimínala y vuelve a crearla.
## Tipos de regla
***
### EXACT
Hace coincidir transacciones al comparar campos por igualdad exacta.
Toggles de nivel superior:
| Campo | Descripción |
| ------------------- | --------------------------------------- |
| **Match amount** | Compara los montos de las transacciones |
| **Match currency** | Exige igualdad de moneda |
| **Match date** | Compara las fechas de las transacciones |
| **Match reference** | Compara los campos de referencia |
La sección **Advanced** agrega:
| Campo | Descripción |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Date precision** | Precisión para la comparación de fechas: `DAY` o `TIMESTAMP` |
| **Case-insensitive reference compare** | Ignora mayúsculas y minúsculas al comparar referencias |
| **Reference must be present** | Cuando **Match reference** está habilitado, exige un valor de referencia no vacío |
| **Match base amount** | Hace coincidir también por el monto base (previo a la conversión) |
| **Match base currency** | Hace coincidir también por la moneda base |
| **Sign mode** | Cómo se comparan los signos de los montos: `same` hace coincidir signos iguales, `opposite` hace coincidir una devolución con su cargo, `ignore` solo compara magnitudes |
| **Match score** | Valor de configuración aceptado (0–100). Se almacena, pero no determina la confianza otorgada, que usa los componentes de comparación ponderados fijos del motor |
| **Base-match score** | Valor de configuración aceptado (0–100). Se almacena, pero no determina la confianza otorgada |
| **Allocation (1:N / N:1)** | Ajustes de asignación parcial (consulta más abajo) |
| **Match fields** | Editor de clave compuesta para hacer coincidir campos nombrados adicionales, combinado con los toggles anteriores |
### TOLERANCE
Hace coincidir transacciones dentro de una banda de tolerancia numérica o de fecha.
Campos de nivel superior:
| Campo | Descripción |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Absolute tolerance** | Tolerancia de monto fija. La banda de monto efectiva usa el mayor entre esta y la tolerancia de monto derivada del porcentaje |
| **Percent tolerance** | Tolerancia de monto derivada de un porcentaje (por ejemplo, `0.005` = 0.5%). La banda de monto efectiva usa el mayor entre esta y la tolerancia absoluta |
| **Date window (days)** | Desviación de fecha permitida entre lados (0–3650) |
| **Match currency** | Exige igualdad de moneda |
Las tolerancias en cero son válidas. Ambos valores tienen `0` como predeterminado, lo que hace que la banda de monto exija igualdad después del redondeo `HALF_UP` predeterminado con escala `2`.
La sección **Advanced** agrega:
| Campo | Descripción |
| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Rounding mode** | Cómo se redondean los valores antes de comparar: `HALF_UP`, `BANKERS`, `FLOOR`, `CEIL` o `TRUNCATE` |
| **Rounding scale** | Decimales para el redondeo (0–10) |
| **Percentage base** | Contra qué lado se mide la tolerancia porcentual: `MAX`, `MIN`, `AVERAGE`, `LEFT` o `RIGHT` |
| **Match reference** | Compara los campos de referencia |
| **Case-insensitive reference compare** | Ignora mayúsculas y minúsculas al comparar referencias |
| **Reference must be present** | Cuando **Match reference** está habilitado, exige un valor de referencia no vacío |
| **Match base amount** / **Match base currency** | Hace coincidir también por el monto o la moneda base |
| **Sign mode** | `same`, `opposite` o `ignore` (igual que en EXACT) |
| **Match score** / **Base-match score** | Valores de configuración aceptados (0–100). Se almacenan, pero no determinan la confianza otorgada, que usa los componentes de comparación ponderados fijos del motor |
| **FX variance band** | Tolerancia adicional entre monedas por encima de la banda de coincidencia, como fracción decimal (`0.0001` = 1 punto básico). Un residuo dentro de ella igual coincide y registra una excepción de variación del tipo de cambio; `0` la deshabilita |
| **Lockbox deduction band** | Tolerancia de pago insuficiente para la coincidencia lockbox N:M, como fracción decimal del valor nominal de la factura (`0.05` = 5%); `0` la deshabilita |
| **Business-day & timezone** | Calendario de feriados y zona horaria para la comparación de fechas |
| **Allocation (1:N / N:1)** | Ajustes de asignación parcial (consulta más abajo) |
| **Match fields** | Editor de clave compuesta, igual que en EXACT |
### DATE\_LAG
Hace coincidir transacciones que ocurren dentro de un número configurable de días entre sí.
Campos de nivel superior:
| Campo | Descripción |
| -------------------- | ------------------------------------------------------------------------------------------------ |
| **Min days** | Desfase mínimo de días permitido (0–3650; el predeterminado es `0`) |
| **Max days** | Desfase máximo de días permitido (0–3650; el predeterminado es `0`) |
| **Direction** | Qué lado se espera que sea anterior: `ABS` (absoluta), `LEFT_BEFORE_RIGHT` o `RIGHT_BEFORE_LEFT` |
| **Inclusive bounds** | Incluye los límites de días mínimo y máximo |
**Max days** debe ser mayor o igual que **Min days**. Los límites exclusivos (`Inclusive bounds` desactivado) con **Min days** en `0` se rechazan, porque eso excluiría las transacciones del mismo día.
La sección **Advanced** agrega:
| Campo | Descripción |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fee tolerance** | Diferencia absoluta máxima entre los montos de las transacciones (el predeterminado es `0`) |
| **Match currency** | Exige igualdad de moneda |
| **Match reference** | Desactivado de forma predeterminada; habilítalo para exigir igualdad de referencia |
| **Case-insensitive reference compare** | Ignora mayúsculas y minúsculas al comparar referencias |
| **Reference must be present** | Cuando **Match reference** está habilitado, exige un valor de referencia no vacío |
| **Match score** | Valor de configuración aceptado (0–100). Se almacena, pero no determina la confianza otorgada, que usa los componentes de comparación ponderados fijos del motor |
| **Business-day & timezone** | **Holiday calendar** (`US Federal` o `Brazil ANBIMA`), **Timezone** (zona IANA, el predeterminado es UTC) y **Count business days only** — mide el desfase en días hábiles y omite los fines de semana y feriados del calendario. Requiere un calendario |
| **Allocation (1:N / N:1)** | Ajustes de asignación parcial (consulta más abajo) |
Las reglas DATE\_LAG no tienen opciones de monto base (`Match base amount` / `Match base currency` solo están disponibles en EXACT y TOLERANCE).
### FUZZY
Hace coincidir transacciones por similitud aproximada de referencia, con verificaciones financieras configurables de monto, moneda y fecha. Las coincidencias fuzzy siempre se proponen para revisión. Nunca se confirman automáticamente.
Campos de nivel superior:
| Campo | Descripción |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Minimum similarity** | Umbral de similitud de referencia como razón de 0 a 1 (`0.80` = 80% de similitud). Las referencias por debajo se rechazan; si lo superan y pasan las verificaciones financieras habilitadas, el par recibe una puntuación de confianza graduada. Predeterminado `0.80` |
| **Match amount** | Compara los montos de las transacciones |
| **Match currency** | Exige igualdad de moneda |
| **Match date** | Compara las fechas de las transacciones |
La sección **Advanced** agrega:
| Campo | Descripción |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Date precision** | `DAY` o `TIMESTAMP` |
| **Reference must be present** | Activado de forma predeterminada — de lo contrario, dos referencias vacías se compararían como totalmente similares |
| **Sign mode** | `same`, `opposite` o `ignore` |
| **Match score** | Valor de configuración aceptado (0–100; predeterminado `70`). Se almacena, pero no determina la confianza otorgada; la confianza fuzzy usa los componentes ponderados fijos del motor y la similitud de referencia graduada |
| **Allocation (1:N / N:1)** | Ajustes de asignación parcial (consulta más abajo) |
Las reglas FUZZY no tienen un toggle de igualdad de referencia ni opciones de monto base.
## Configuración de asignación
***
Las reglas EXACT, TOLERANCE, DATE\_LAG y FUZZY incluyen un bloque **Allocation (1:N / N:1)** dentro de la sección **Advanced**:
| Campo | Descripción |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Allow partial allocation** | Hace coincidir un conjunto de partidas con una contraparte y divide el monto entre ellas; un remanente sin asignar se arrastra como una partida abierta |
| **Fee-aware split** | Consume de la contraparte la parte bruta de cada tramo (neto + comisión) en lugar de solo su monto neto. Desactivado usa solo el neto |
| **Allocation direction** | Orden en que se consumen los tramos; el predeterminado es de izquierda a derecha |
| **Allocation tolerance mode** | Cómo se acota el residuo: `ABS` (monto absoluto) o `PERCENT` (fracción, `0.01` = 1%). El predeterminado es `ABS` |
| **Allocation tolerance value** | Residuo que puede dejar la división; el predeterminado es `0` |
| **Allocate on base amount** | Usa el monto base en lugar del monto convertido para la asignación |
## Cómo previsualizar una regla
***
El diálogo de la regla incluye un panel **Preview matches**. Haz clic en **Run preview** para probar la regla antes de guardarla. La vista previa permanece de solo lectura. Usa hasta 5,000 transacciones no conciliadas con extracción completa, forma solo pares 1:1 y no aplica normalización de comisiones, bandas de variación de FX ni asignación. El panel muestra cuántos pares **Would match**, los conteos no conciliados de los lados izquierdo y derecho, y hasta 25 pares con mayor puntuación que coincidirían. La vista previa no guarda nada.
## Cómo editar una regla
***
Haz clic en el botón **Edit rule** de una regla para abrir el diálogo. El selector **Strategy** permanece inactivo, porque no puedes cambiar la estrategia después de la creación. Actualiza los campos restantes y haz clic en **Save changes**.
## Cómo reordenar las reglas
***
Usa las flechas **Move rule up** / **Move rule down** de la lista para cambiar la precedencia de las reglas. Las reglas se evalúan de arriba abajo. Gana la primera coincidencia.
## Cómo eliminar una regla
***
Haz clic en el botón **Delete rule** de una regla y confirma en el diálogo **Delete rule?**. La regla se quita de la cadena. Las reglas restantes mantienen su orden.