> ## 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.
# Gestión de esquemas de comisiones
> Define comisiones fijas, porcentuales, escalonadas o basadas en expresiones para que el motor de conciliación pueda verificar y marcar automáticamente discrepancias de comisiones en las coincidencias.
La página **Fee Schedules** en la interfaz de Matcher te permite definir las comisiones esperadas: fijas, porcentuales, escalonadas o basadas en expresiones. El motor de conciliación las usa para verificar y marcar automáticamente discrepancias de comisiones entre transacciones coincidentes. La página también aloja las **Fee rules** de alcance por contexto, que vinculan esquemas a transacciones.
## Cómo acceder a la página Fee Schedules
***
Navega a **Matcher > Settings > Fee Schedules** en la barra lateral izquierda.
## Tabla de esquemas de comisiones
***
Cada fila de la tabla de datos muestra las siguientes columnas:
| Columna | Descripción |
| --------------------- | --------------------------------------------------------------------------------------------------- |
| **Name** | El nombre del esquema de comisiones |
| **Currency** | El código de moneda (por ejemplo, BRL) |
| **Application order** | Cómo se aplican los elementos de comisión, mostrado como una insignia: **PARALLEL** o **CASCADING** |
| **Rounding** | El modo y la escala de redondeo, por ejemplo: "HALF\_UP @ 2" |
| **Items** | La cantidad de elementos de comisión en el esquema |
| **Used by** | Cuántos contextos referencian el esquema a través de reglas de comisión, o "Not in use" |
| **Created** | La fecha en que se creó el esquema |
| **Actions** | Botones en línea **View**, **Simulate**, **Edit** y **Delete** |
### Orden de aplicación
| Modo | Descripción |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Parallel** | Todos los elementos de comisión se calculan de forma independiente sobre el monto bruto original |
| **Cascading** | Los elementos de comisión se aplican de forma secuencial: cada elemento usa el monto neto después de que se dedujo la comisión del elemento anterior |
### Modos de redondeo
| Modo | Descripción |
| ------------ | --------------------------------------------------------------------------------------- |
| **Half Up** | Redondea al vecino más cercano; en un límite de 0.5, redondea hacia arriba |
| **Bankers** | Redondea al vecino más cercano; en un límite de 0.5, redondea al dígito par más cercano |
| **Floor** | Siempre redondea hacia el infinito negativo |
| **Ceil** | Siempre redondea hacia el infinito positivo |
| **Truncate** | Descarta los decimales sobrantes sin redondear |
### Tipos de estructura
| Tipo | Descripción |
| -------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Flat** | Un monto monetario fijo (por ejemplo, 5.00) |
| **Percentage** | Una tasa decimal aplicada sobre el monto base (por ejemplo, 0.015 = 1.5%) |
| **Tiered** | Tramos marginales según el monto base: cada nivel cobra su tasa sobre la porción hasta su límite superior |
| **Expression** | Una fórmula sobre el monto bruto más las claves de metadatos de la transacción, analizada y validada por el servidor |
## Cómo crear un esquema de comisiones
***
Haz clic en el botón **New schedule** en la parte superior de la página. Se abre un panel deslizante con las siguientes secciones.
### Campos del esquema
| Campo | Descripción |
| --------------------- | -------------------------------------------------------------------------------------------------------- |
| **Name** | Un nombre descriptivo para el esquema (por ejemplo, "Bank Fees BRL") |
| **Currency** | El código de moneda de tres letras (por ejemplo, BRL). No se puede cambiar después de crear el esquema |
| **Application order** | Selecciona Parallel o Cascading. El valor predeterminado es Parallel |
| **Rounding mode** | Selecciona una opción entre Half Up, Bankers, Floor, Ceil y Truncate. El valor predeterminado es Half Up |
| **Rounding scale** | Cantidad de posiciones decimales para el redondeo (0–12). El valor predeterminado es 2 |
### Elementos de comisión
Después de completar los campos del esquema, agrega al menos un elemento de comisión. Haz clic en **Add item**:
| Campo | Descripción |
| ------------- | ----------------------------------------------------------------------------- |
| **Name** | Un nombre descriptivo para el elemento de comisión (por ejemplo, "Wire Fee") |
| **Priority** | Determina el orden en que se aplican los elementos (número entero, 0 o mayor) |
| **Structure** | Selecciona Flat, Percentage, Tiered o Expression |
Según la estructura seleccionada, aparecen campos adicionales:
| Estructura | Campos adicionales | Descripción |
| -------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Flat** | **Amount** | El monto fijo en la moneda del esquema (por ejemplo, "5.00") |
| **Percentage** | **Rate** | Una tasa decimal entre 0 y 1 (por ejemplo, "0.015" para 1.5%) |
| **Tiered** | **Tiers** | Un editor de niveles estructurado: cada fila tiene una **Rate** y un límite **Up to**. Agrega o quita filas con **Add tier** y el control de eliminación; los límites deben aumentar estrictamente, y puedes dejar en blanco el límite del último nivel para crear un nivel abierto |
| **Expression** | **Expression** | Una fórmula sobre el monto `gross` inyectado más las claves de metadatos de la transacción: operadores `+ - * /` y paréntesis, además de las funciones `days_late(a, b)`, `days_between(a, b)`, `max(…)`, `min(…)`, `abs(x)` y `clamp(x, lo, hi)`. Se valida al guardar |
Puedes agregar varios elementos antes de enviar. Haz clic en **Create schedule** para guardar el esquema de comisiones.
Los elementos de comisión son inmutables después de creados. Para cambiar la estructura de un elemento, crea un esquema nuevo.
## Cómo editar un esquema de comisiones
***
Haz clic en **Edit** en la fila de un esquema de comisiones. Se abre el panel deslizante con los valores actuales precargados.
Puedes modificar el nombre del esquema, el orden de aplicación, el modo de redondeo y la escala de redondeo. El campo de moneda queda bloqueado después de crear el esquema, y los elementos de comisión se muestran de solo lectura. Haz clic en **Save changes** para aplicar los cambios.
## Cómo simular un esquema de comisiones
***
Haz clic en **Simulate** en la fila de un esquema de comisiones para estimar las comisiones de un monto dado sin registrar nada.
El diálogo **Simulate fees** solicita:
| Campo | Descripción |
| ---------------- | -------------------------------------------------------- |
| **Gross amount** | El monto sobre el que se simula (por ejemplo, "1000.00") |
| **Currency** | Se precarga con la moneda del esquema |
Haz clic en **Run simulation**. Los resultados muestran:
* **Gross**: el monto ingresado
* **Total fee**: el total de comisiones deducidas
* **Net**: el monto restante después de las comisiones
Si el esquema tiene varios elementos de comisión, una tabla de desglose lista cada **Item** con la **Base used** para su cálculo y la **Fee** cobrada.
## Cómo eliminar un esquema de comisiones
***
Haz clic en **Delete** en la fila de un esquema de comisiones. El cuadro de diálogo de confirmación advierte que eliminarlo lo quita de forma permanente y puede invalidar las reglas de comisión que lo referencian. Haz clic en **Delete schedule** para continuar.
Si todavía existen reglas de comisión que referencian el esquema, la eliminación queda bloqueada. El error identifica los contextos que lo referencian (hasta 20) e informa el total. Elimina primero esas reglas de comisión.
## Fee rules
***
Debajo del catálogo de esquemas, la página aloja una sección **Fee rules**: reglas de alcance por contexto que vinculan esquemas a predicados de coincidencia. Selecciona un contexto y luego:
* Haz clic en **New fee rule** para vincular un esquema de comisiones a un lado de coincidencia y un conjunto de predicados de campo. Los predicados comparan campos de la transacción con operadores como igual a, distinto de, es uno de, está presente, mayor que, al menos, menor que, como máximo y en el rango inclusivo.
* Usa los botones **Edit** y **Delete** en línea, en la fila de una regla, para modificarla o eliminarla.