> ## 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 tarifas

> Define tarifas fijas, porcentuales, escalonadas o basadas en expresiones para que el motor de reconciliación verifique y señale discrepancias automáticamente.

La página **Fee Schedules** en la Matcher UI te permite definir tarifas esperadas — fijas, porcentuales, escalonadas o basadas en expresiones — que el motor de reconciliación usa para verificar y señalar automáticamente discrepancias de tarifas entre transacciones emparejadas. La página también aloja las **Fee rules** con alcance de contexto, que vinculan esquemas a transacciones.

## Acceder a la página de Fee Schedules

***

Navega a **Matcher > Settings > Fee Schedules** en la barra lateral izquierda.

## Tabla de esquemas de tarifas

***

<Frame caption="Figura 1. Lista de Fee Schedules.">
  <img src="https://mintcdn.com/lerian-49cb71fc/SFzzdxyH5SN7w_fC/es/matcher/ui/images/14-fee-schedules.jpg?fit=max&auto=format&n=SFzzdxyH5SN7w_fC&q=85&s=a61354755b3242afadef6404be39607c" alt="Lista de Programaciones de tarifas de Matcher que muestra las definiciones de tarifas esperadas usadas para señalar discrepancias" width="2000" height="1254" data-path="es/matcher/ui/images/14-fee-schedules.jpg" />
</Frame>

Cada fila de la tabla de datos muestra las siguientes columnas:

| Columna               | Descripción                                                                                   |
| --------------------- | --------------------------------------------------------------------------------------------- |
| **Name**              | El nombre del esquema de tarifas                                                              |
| **Currency**          | El código de moneda (p. ej., BRL)                                                             |
| **Application order** | Cómo se aplican los elementos de tarifa, mostrado como insignia: **PARALLEL** o **CASCADING** |
| **Rounding**          | El modo de redondeo y la escala — p. ej., "HALF\_UP @ 2"                                      |
| **Items**             | El número de elementos de tarifa del esquema                                                  |
| **Used by**           | Cuántos contextos referencian el esquema a través de fee rules, o "Not in use"                |
| **Created**           | 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 tarifa se calculan de forma independiente sobre el importe bruto original                                          |
| **Cascading** | Los elementos de tarifa se aplican secuencialmente — cada elemento usa el importe neto después de deducir la tarifa del elemento anterior |

### Modos de redondeo

| Modo         | Descripción                                                                            |
| ------------ | -------------------------------------------------------------------------------------- |
| **Half Up**  | Redondea al vecino más cercano; redondea hacia arriba en el límite de 0.5              |
| **Bankers**  | Redondea al vecino más cercano; redondea al dígito par más cercano en el límite de 0.5 |
| **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 importe monetario fijo (p. ej., 5.00)                                                                               |
| **Percentage** | Una tasa decimal aplicada al importe base (p. ej., 0.015 = 1.5%)                                                       |
| **Tiered**     | Tramos marginales por importe base — cada tramo cobra su tasa sobre el segmento hasta su techo                         |
| **Expression** | Una fórmula sobre el importe bruto más las claves de metadatos de la transacción, analizada y validada por el servidor |

## Crear un esquema de tarifas

***

Haz clic en el botón **New schedule** en la parte superior de la página. Se abre una hoja deslizante con las siguientes secciones.

### Campos del esquema

| Campo                 | Descripción                                                                                 |
| --------------------- | ------------------------------------------------------------------------------------------- |
| **Name**              | Un nombre descriptivo para el esquema (p. ej., "Bank Fees BRL")                             |
| **Currency**          | El código de moneda de tres letras (p. ej., BRL). No puede cambiarse después de la creación |
| **Application order** | Selecciona Parallel o Cascading. Por defecto, Parallel                                      |
| **Rounding mode**     | Selecciona uno de: Half Up, Bankers, Floor, Ceil, Truncate. Por defecto, Half Up            |
| **Rounding scale**    | Número de decimales para el redondeo (0–12). Por defecto, 2                                 |

### Elementos de tarifa

Después de completar los campos del esquema, agrega al menos un elemento de tarifa. Haz clic en **Add item**:

| Campo         | Descripción                                                                 |
| ------------- | --------------------------------------------------------------------------- |
| **Name**      | Un nombre descriptivo para el elemento de tarifa (p. ej., "Wire Fee")       |
| **Priority**  | Determina el orden en que se aplican los elementos (número entero, 0 o más) |
| **Structure** | Selecciona Flat, Percentage, Tiered o Expression                            |

Según la estructura seleccionada, aparecen campos adicionales:

| Estructura     | Campos adicionales | Descripción                                                                                                                                                                                                                                                                   |
| -------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Flat**       | **Amount**         | El importe fijo en la moneda del esquema (p. ej., "5.00")                                                                                                                                                                                                                     |
| **Percentage** | **Rate**           | Una tasa decimal entre 0 y 1 (p. ej., "0.015" para 1.5%)                                                                                                                                                                                                                      |
| **Tiered**     | **Tiers**          | Un editor estructurado de tramos: cada fila tiene un **Rate** y un techo **Up to**. Agrega o elimina filas con **Add tier** y el control de eliminación; los techos deben aumentar estrictamente, y puedes dejar en blanco el techo del último tramo para un tramo sin límite |
| **Expression** | **Expression**     | Una fórmula sobre el importe `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 tarifas.

<Note>
  Los elementos de tarifa son inmutables después de la creación. Para cambiar las estructuras de los elementos, crea un nuevo esquema.
</Note>

## Editar un esquema de tarifas

***

Haz clic en **Edit** en la fila de un esquema de tarifas. La hoja deslizante se abre 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 la creación, y los elementos de tarifa se muestran en modo de solo lectura. Haz clic en **Save changes** para aplicar.

## Simular un esquema de tarifas

***

Haz clic en **Simulate** en la fila de un esquema para estimar tarifas sobre un importe dado sin registrar nada.

El diálogo **Simulate fees** solicita:

| Campo            | Descripción                                          |
| ---------------- | ---------------------------------------------------- |
| **Gross amount** | El importe contra el que simular (p. ej., "1000.00") |
| **Currency**     | Precargado con la moneda del esquema                 |

Haz clic en **Run simulation**. Los resultados muestran:

* **Gross** — El importe de entrada
* **Total fee** — El total de tarifas deducidas
* **Net** — El importe restante después de las tarifas

Si el esquema tiene varios elementos de tarifa, una tabla de desglose lista cada **Item** con la base usada (**Base used**) para su cálculo y la tarifa cobrada (**Fee**).

## Eliminar un esquema de tarifas

***

Haz clic en **Delete** en la fila de un esquema. El diálogo de confirmación advierte que la eliminación es permanente y puede romper las fee rules que lo referencian. Haz clic en **Delete schedule** para continuar.

<Note>
  Si aún hay fee rules que referencian el esquema, la eliminación se bloquea. El error identifica los contextos que lo referencian (hasta 20) e informa el total. Elimina primero esas fee rules.
</Note>

## Fee rules

***

Debajo del catálogo de esquemas, la página aloja una sección de **Fee rules** — reglas con alcance de contexto que vinculan esquemas a predicados de matching. Selecciona un contexto y luego:

* Haz clic en **New fee rule** para vincular un esquema de tarifas a un lado del matching y a un conjunto de predicados de campo. Los predicados comparan campos de la transacción con operadores como igual, distinto, es uno de, está presente, mayor que, al menos, menor que, como máximo y en el rango inclusivo.
* Usa los botones en línea **Edit** y **Delete** en la fila de una regla para cambiarla o eliminarla.
