> ## 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 Fee Packages

> Explora, crea, edita y elimina Fee Packages desde Midaz Console para controlar cómo se aplican los cargos fijos, porcentuales y combinados a las Transacciones correspondientes.

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

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

## Qué contiene un Fee Package

***

Un Fee Package permite:

* **Definir reglas de cálculo de comisiones**: comisiones fijas, comisiones porcentuales o cálculos combinados.
* **Establecer rangos de montos**: aplicar comisiones solo a transacciones dentro de un rango mínimo/máximo.
* **Vincular a rutas de transacción**: dirigir la comisión a flujos de transacción específicos.
* **Eximir de comisiones a cuentas específicas**: exceptuar cuentas de origen seleccionadas.
* **Priorizar la aplicación de comisiones**: controlar el orden en que Fees Engine aplica varias comisiones.

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

## Acceder a la página de Fee Packages

***

En la barra lateral del Módulo Midaz, expande **Fees Engine**. Selecciona **Fee Packages**. La página lista todos los paquetes configurados.

<Note>
  Si no tienes Fee Packages, la lista aparece vacía y muestra una indicación para crear tu primer paquete.
</Note>

### Acciones disponibles

Desde la página de Fee Packages, puedes:

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

  <Card title="Editar un Fee Package" icon="pen" horizontal href="/es/products/midaz/fees/console/fe-editing-a-package">
    Actualiza las configuraciones y reglas de comisión
  </Card>

  <Card title="Eliminar un Fee Package" icon="trash" horizontal href="/es/products/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**. Ahí puedes revisar la configuración del paquete (tipo, alcance y reglas) antes de editarlo. Para previsualizar las comisiones que un período genera en todos los paquetes, usa [Billing Runs](/es/products/midaz/fees/console/billing-runs).
</Note>

## Cómo entender la estructura de un Fee Package

***

Cuando creas o editas un paquete de tarifas en el Módulo Midaz, trabajas con estos campos:

### Información básica

* **Fee Group Label** (obligatorio) - Un nombre descriptivo para el paquete
* **Description** (opcional) - Explicación del propósito del paquete y cuándo se aplica
* **Transaction Route** (opcional) - Vínculo a una ruta de transacción específica
* **Segment** (opcional) - Asociación con un segmento específico
* **Ledger** (obligatorio) - El ledger al que se aplica este paquete

### Rango de montos

* **Minimum Amount** (obligatorio) - Monto de transacción más bajo para la aplicación de la comisión
* **Maximum Amount** (obligatorio) - Monto de transacción más alto para la aplicación de la comisión
* **Waived Accounts** (opcional) - Lista de alias de cuenta exentos de estas comisiones

### Reglas de comisión

Cada paquete de tarifas puede contener varias reglas de comisión con:

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

## Casos de uso comunes

***

<AccordionGroup>
  <Accordion title="Comisión fija simple por transacción">
    Aplica una comisión fija a todas las transacciones dentro de un rango de montos:

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

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

    * **Application Rule**: `percentual`
    * **Calculation**: `percentage` con valor `1.5`
    * **Example**: comisión del 1.5% en transferencias, donde una transferencia de $100 = comisión de $1.50
  </Accordion>

  <Accordion title="Estructura de comisiones escalonada">
    Crea varios paquetes con distintos rangos de montos:

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

  <Accordion title="Combinación de fijo + porcentual (máximo)">
    Aplica el que sea más alto entre el fijo y el porcentual:

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

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

    * Crea el paquete con reglas de comisión estándar
    * Agrega los alias de cuentas premium a la lista **Waived Accounts**
    * Estas cuentas transaccionan sin las comisiones configuradas
  </Accordion>
</AccordionGroup>

## Mejores prácticas

***

<Steps>
  <Step title="Planifica tu estructura de comisiones">
    Diseña tus paquetes de tarifas antes de la implementación. Considera los tipos de transacción, los rangos de montos y los segmentos de clientes que requieren un tratamiento de comisión diferente.
  </Step>

  <Step title="Usa etiquetas descriptivas">
    Elige etiquetas de grupo de comisión y descripciones claras que expliquen cuándo y por qué se aplican las comisiones. Esto ayuda con la auditoría y la comunicación con el cliente.
  </Step>

  <Step title="Establece rangos de montos adecuados">
    Define los montos mínimo y máximo con cuidado para evitar vacíos o superposiciones en tu estructura de comisiones.
  </Step>

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

  <Step title="Gestiona la prioridad con cuidado">
    Cuando uses varias comisiones en un paquete, establece las prioridades para que las comisiones se apliquen en el orden correcto.
  </Step>

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

## Flujo de cálculo de comisiones

***

Cuando 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 montos (la transacción debe estar dentro del mínimo/máximo)
3. Verifica si la cuenta está en la lista de cuentas exentas
4. Aplica las reglas de comisión en orden de prioridad
5. Calcula cada comisión según la regla de aplicación y el monto de referencia
6. Acredita los montos de comisión a 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>