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

# Gestionar Paquetes de Tarifas

> Crea, edita y elimina Paquetes de Tarifas desde la Console de Midaz para controlar cómo se aplican cargos a las Transacciones y mantener tus reglas al día.

Los **Fee Packages** son la unidad base del [Fees Engine](/es/midaz/fees/console/fees-engine-overview). Cada paquete define un conjunto de Reglas de tarifas y las condiciones bajo las cuales se aplican a las Transacciones.

<Note>
  Habilita el Fees Engine en la [configuración de Midaz Module](/es/platform/console/plugin-settings) antes de usar esta página.
</Note>

## Qué contiene un Paquete de Tarifas

***

Un Paquete de Tarifas te permite:

* **Definir reglas de cálculo de tarifas** — tarifas planas, tarifas basadas en porcentaje o cálculos combinados.
* **Establecer rangos de importes** — aplicar tarifas solo a transacciones dentro de un rango mín/máx.
* **Vincular a Rutas de Transacción** — apuntar a flujos de transacción específicos.
* **Eximir tarifas para cuentas específicas** — excluir cuentas de origen seleccionadas.
* **Priorizar la aplicación de tarifas** — controlar el orden en que el Fees Engine aplica varias tarifas.

Los Paquetes de Tarifas se combinan con [Rutas Contables](/es/midaz/console/managing-accounting-routes) y [Segmentos](/es/midaz/console/managing-segments) para un control granular.

## Acceder a la página Fee Packages

***

En la barra lateral de Midaz Module, expande **Fees Engine**. Selecciona **Fee Packages**. La página lista todos los paquetes configurados.

<Note>
  Si no tienes ningún Paquete de Tarifas, la lista está vacía y muestra una indicación para crear tu primer paquete.
</Note>

### Acciones disponibles

Desde la página **Fee Packages**, puedes:

<Columns cols={2}>
  <Card title="Crear un Paquete de Tarifas" icon="plus" horizontal href="/es/midaz/fees/console/fe-creating-a-package">
    Define nuevas reglas de cálculo de tarifas para transacciones
  </Card>

  <Card title="Editar un Paquete de Tarifas" icon="pen" horizontal href="/es/midaz/fees/console/fe-editing-a-package">
    Actualiza configuraciones y reglas de tarifas
  </Card>

  <Card title="Eliminar un Paquete de Tarifas" icon="trash" horizontal href="/es/midaz/fees/console/fe-deleting-a-package">
    Elimina un paquete de tarifas de tu configuración
  </Card>
</Columns>

<Note>
  Selecciona un paquete de la lista para abrir su **vista de detalles**. Allí puedes revisar la configuración del paquete — tipo, alcance y reglas — antes de editarlo. Para previsualizar las tarifas que un período genera entre los paquetes, usa los [Billing Runs](/es/midaz/fees/console/billing-runs).
</Note>

## Entender la estructura de un Paquete de Tarifas

***

Cuando creas o editas un paquete de tarifas en Midaz Module, trabajas con estos campos:

### Información básica

* **Fee Group Label** (requerido) - Un nombre descriptivo para el paquete de tarifas
* **Description** (opcional) - Explicación del propósito del paquete y cuándo aplica
* **Transaction Route** (opcional) - Vincula a una Ruta de Transacción específica
* **Segment** (opcional) - Asocia con un Segmento específico
* **Ledger** (requerido) - El Ledger al que aplica este paquete

### Rango de importe

* **Minimum Amount** (requerido) - Importe de transacción más bajo para aplicar la tarifa
* **Maximum Amount** (requerido) - Importe de transacción más alto para aplicar la tarifa
* **Waived Accounts** (opcional) - Lista de alias de cuentas exentos de estas tarifas

### Reglas de tarifas

Cada paquete de tarifas puede contener varias Reglas de tarifas con:

* **Fee Label** - Nombre que identifica esta tarifa
* **Application Rule** - Cómo el Fees Engine calcula la tarifa:
  * `flatFee` - Importe fijo independiente del valor de la transacción
  * `percentual` - Porcentaje del importe de la transacción
  * `maxBetweenTypes` - El valor más alto entre el cálculo plano y el porcentaje
* **Calculation Type** - `flat` o `percentage`
* **Calculation Value** - El importe o porcentaje de la tarifa
* **Reference Amount** - Base para el cálculo del porcentaje:
  * `originalAmount` - Calcular sobre el valor original de la transacción
  * `afterFeesAmount` - Calcular después de que el Fees Engine aplica otras tarifas
* **Priority** - Orden de aplicación de la tarifa (los números más bajos se aplican primero)
* **Is Deductible From** - Si el Fees Engine deduce esta tarifa de la transacción
* **Credit Account** - Cuenta que recibe el importe de la tarifa

## Casos de uso comunes

***

<AccordionGroup>
  <Accordion title="Tarifa plana simple por transacción">
    Aplica una tarifa fija a todas las transacciones dentro de un rango de importes:

    * **Application Rule**: `flatFee`
    * **Calculation**: `flat` con valor `2.50`
    * **Ejemplo**: Tarifa de $2.50 en cada transacción entre $10 y \$1000
  </Accordion>

  <Accordion title="Tarifa basada en porcentaje">
    Cobra un porcentaje del importe de la transacción:

    * **Application Rule**: `percentual`
    * **Calculation**: `percentage` con valor `1.5`
    * **Ejemplo**: Tarifa del 1.5% sobre transferencias, donde una transferencia de $100 = $1.50 de tarifa
  </Accordion>

  <Accordion title="Estructura de tarifas por niveles">
    Crea múltiples paquetes con diferentes rangos de importe:

    * Paquete 1: $0-$100 → 2% de tarifa
    * Paquete 2: $100-$1000 → 1.5% de tarifa
    * Paquete 3: \$1000+ → 1% de tarifa
    * Tarifas más bajas para transacciones de mayor valor
  </Accordion>

  <Accordion title="Combinación plana + porcentaje (máximo)">
    Aplica el valor más alto entre plano y porcentaje:

    * **Application Rule**: `maxBetweenTypes`
    * **Calculations**: `flat: 1.00` y `percentage: 2.0`
    * **Ejemplo**: En transacción de $30: max($1.00, $0.60) = $1.00 de tarifa
    * **Ejemplo**: En transacción de $100: max($1.00, $2.00) = $2.00 de tarifa
  </Accordion>

  <Accordion title="Exención de tarifas para cuentas premium">
    Exime cuentas específicas de las tarifas:

    * Crea el paquete con reglas de tarifa estándar
    * Añade los alias de cuentas premium a la lista **Waived Accounts**
    * Estas cuentas transaccionan sin las tarifas configuradas
  </Accordion>
</AccordionGroup>

## Buenas prácticas

***

<Steps>
  <Step title="Planifica tu estructura de tarifas">
    Diseña tus paquetes de tarifas antes de implementarlos. Considera los tipos de transacción, rangos de importe y segmentos de cliente que requieran tratamientos de tarifa diferentes.
  </Step>

  <Step title="Usa etiquetas descriptivas">
    Elige etiquetas y descripciones claras para el fee group que expliquen cuándo y por qué aplican las tarifas. Esto ayuda en auditoría y comunicación con clientes.
  </Step>

  <Step title="Define rangos de importe adecuados">
    Define cuidadosamente los importes mínimo y máximo para evitar vacíos o solapamientos en tu estructura de tarifas.
  </Step>

  <Step title="Prueba los cálculos de tarifas">
    Usa la función [Fee Estimation](/es/midaz/fees/console/fe-fee-simulation) para previsualizar los cálculos de tarifas antes de habilitar los paquetes en producción.
  </Step>

  <Step title="Gestiona la prioridad cuidadosamente">
    Cuando uses varias tarifas en un paquete, establece prioridades para que el Fees Engine aplique las tarifas en el orden correcto.
  </Step>

  <Step title="Documenta las cuentas exentas">
    Registra por qué eximes de tarifas a ciertas cuentas. Esto respalda la auditoría y el cumplimiento.
  </Step>
</Steps>

## Flujo de cálculo de tarifas

***

Cuando el Fees Engine procesa una transacción:

1. Identifica los paquetes de tarifas aplicables según la Ruta de Transacción y el Segmento
2. Filtra los paquetes por rango de importe (la transacción debe caer dentro del mín/máx)
3. Verifica si la cuenta está en la lista de Waived Accounts
4. Aplica las Reglas de tarifas en orden de Prioridad
5. Calcula cada tarifa según la Application Rule y el Reference Amount
6. Acredita los importes de las tarifas en las cuentas designadas

<Note>
  Habilita un paquete de tarifas para que se aplique a las transacciones. Para pausar un paquete, deshabilítalo. Un paquete deshabilitado permanece en tu configuración.
</Note>