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

# Gerenciando Pacotes de Tarifas

> Navegue, crie, edite e exclua Pacotes de Tarifas no Console Midaz para controlar como cobranças fixas, percentuais e combinadas se aplicam às Transações correspondentes.

**Pacotes de Tarifas** são a unidade base do [Fees Engine](/pt/products/midaz/fees/console/fees-engine-overview). Cada pacote define um conjunto de regras de tarifa e as condições sob as quais elas se aplicam a Transações.

<Note>
  Habilite o Fees Engine nas [configurações do Módulo Midaz](/pt/platform/console/plugin-settings) antes de usar esta página.
</Note>

## O que um Pacote de Tarifas contém

***

Um Pacote de Tarifas permite:

* **Definir regras de cálculo de tarifa**: tarifas fixas, tarifas percentuais ou cálculos combinados.
* **Definir faixas de valores**: aplicar tarifas apenas a transações dentro de uma faixa mínima/máxima.
* **Vincular a rotas de transação**: direcionar fluxos de transação específicos.
* **Isentar contas específicas de tarifas**: isentar contas de origem selecionadas.
* **Priorizar a aplicação de tarifas**: controlar a ordem em que o Fees Engine aplica múltiplas tarifas.

Pacotes de Tarifas se combinam com [Rotas Contábeis](/pt/products/midaz/console/managing-accounting-routes) e [Segmentos](/pt/products/midaz/console/managing-segments) para um controle granular.

## Acessando a página Pacotes de Tarifas

***

Na barra lateral do Módulo Midaz, expanda **Fees Engine**. Selecione **Pacotes de Tarifas**. A página lista todos os pacotes configurados.

<Note>
  Se você não tiver Pacotes de Tarifas, a lista fica vazia e mostra um aviso para criar seu primeiro pacote.
</Note>

### Ações disponíveis

Na página Pacotes de Tarifas, você pode:

<Columns cols={2}>
  <Card title="Criar um Pacote de Tarifas" icon="plus" horizontal href="/pt/products/midaz/fees/console/fe-creating-a-package">
    Defina novas regras de cálculo de tarifa para transações
  </Card>

  <Card title="Editar um Pacote de Tarifas" icon="pen" horizontal href="/pt/products/midaz/fees/console/fe-editing-a-package">
    Atualize configurações e regras de tarifa
  </Card>

  <Card title="Excluir um Pacote de Tarifas" icon="trash" horizontal href="/pt/products/midaz/fees/console/fe-deleting-a-package">
    Exclua um pacote de tarifas da sua configuração
  </Card>
</Columns>

<Note>
  Selecione um pacote na lista para abrir sua **visualização de detalhes**. Lá você pode revisar a configuração do pacote (tipo, escopo e regras) antes de editá-lo. Para pré-visualizar as tarifas que um período gera entre pacotes, use [Execuções de Faturamento](/pt/products/midaz/fees/console/billing-runs).
</Note>

## Entendendo a estrutura de um Pacote de Tarifas

***

Ao criar ou editar um pacote de tarifas no Módulo Midaz, você trabalha com estes campos:

### Informações básicas

* **Rótulo do Grupo de Tarifa** (obrigatório) - Um nome descritivo para o pacote de tarifas
* **Descrição** (opcional) - Explicação do propósito do pacote e de quando ele se aplica
* **Rota de Transação** (opcional) - Vínculo com uma rota de transação específica
* **Segmento** (opcional) - Associação com um segmento específico
* **Ledger** (obrigatório) - O ledger ao qual este pacote se aplica

### Faixa de valores

* **Valor Mínimo** (obrigatório) - Menor valor de transação para aplicação da tarifa
* **Valor Máximo** (obrigatório) - Maior valor de transação para aplicação da tarifa
* **Contas Isentas** (opcional) - Lista de aliases de conta isentos dessas tarifas

### Regras de tarifa

Cada pacote de tarifas pode conter múltiplas regras de tarifa com:

* **Rótulo da Tarifa** - Nome que identifica esta tarifa
* **Regra de Aplicação** - Como o Fees Engine calcula a tarifa:
  * `flatFee` - Valor fixo, independente do valor da transação
  * `percentual` - Percentual do valor da transação
  * `maxBetweenTypes` - Maior valor entre os cálculos fixo e percentual
* **Tipo de Cálculo** - `flat` ou `percentage`
* **Valor do Cálculo** - O valor da tarifa ou o percentual
* **Valor de Referência** - Base para o cálculo do percentual:
  * `originalAmount` - Calcula sobre o valor original da transação
  * `afterFeesAmount` - Calcula depois que o Fees Engine aplica outras tarifas
* **Prioridade** - Ordem de aplicação da tarifa (números menores se aplicam primeiro)
* **É Dedutível De** - Se o Fees Engine deduz esta tarifa da transação
* **Conta de Crédito** - Conta que recebe o valor da tarifa

## Casos de uso comuns

***

<AccordionGroup>
  <Accordion title="Tarifa fixa simples por transação">
    Aplique uma tarifa fixa a todas as transações dentro de uma faixa de valores:

    * **Regra de Aplicação**: `flatFee`
    * **Cálculo**: `flat` com valor `2.50`
    * **Exemplo**: tarifa de $2,50 em toda transação entre $10 e \$1000
  </Accordion>

  <Accordion title="Tarifa baseada em percentual">
    Cobre um percentual do valor da transação:

    * **Regra de Aplicação**: `percentual`
    * **Cálculo**: `percentage` com valor `1.5`
    * **Exemplo**: tarifa de 1,5% em transferências, em que uma transferência de $100 gera tarifa de $1,50
  </Accordion>

  <Accordion title="Estrutura de tarifa em camadas">
    Crie múltiplos pacotes com faixas de valores diferentes:

    * Pacote 1: $0-$100 → tarifa de 2%
    * Pacote 2: $100-$1000 → tarifa de 1,5%
    * Pacote 3: \$1000+ → tarifa de 1%
    * Tarifas menores para transações de maior valor
  </Accordion>

  <Accordion title="Combinada fixa + percentual (máximo)">
    Aplique o que for maior entre o valor fixo e o percentual:

    * **Regra de Aplicação**: `maxBetweenTypes`
    * **Cálculos**: `flat: 1.00` e `percentage: 2.0`
    * **Exemplo**: em transação de $30: max($1,00, $0,60) = tarifa de $1,00
    * **Exemplo**: em transação de $100: max($1,00, $2,00) = tarifa de $2,00
  </Accordion>

  <Accordion title="Isenção de tarifa para contas premium">
    Isente contas específicas de tarifas:

    * Crie o pacote com as regras de tarifa padrão
    * Adicione os aliases das contas premium à lista **Contas Isentas**
    * Essas contas transacionam sem as tarifas configuradas
  </Accordion>
</AccordionGroup>

## Boas práticas

***

<Steps>
  <Step title="Planeje sua estrutura de tarifas">
    Projete seus pacotes de tarifas antes da implementação. Considere os tipos de transação, as faixas de valores e os segmentos de clientes que exigem tratamentos de tarifa diferentes.
  </Step>

  <Step title="Use rótulos descritivos">
    Escolha rótulos de grupo de tarifa e descrições claras que expliquem quando e por que as tarifas se aplicam. Isso ajuda na auditoria e na comunicação com o cliente.
  </Step>

  <Step title="Defina faixas de valores adequadas">
    Defina os valores mínimo e máximo com cuidado para evitar lacunas ou sobreposições na sua estrutura de tarifas.
  </Step>

  <Step title="Teste os cálculos de tarifa">
    Use o recurso de [Estimativa de Tarifa](/pt/products/midaz/fees/console/fe-fee-simulation) para pré-visualizar os cálculos antes de habilitar pacotes em produção.
  </Step>

  <Step title="Gerencie a prioridade com cuidado">
    Ao usar múltiplas tarifas em um pacote, defina prioridades para que as tarifas se apliquem na ordem correta.
  </Step>

  <Step title="Documente as contas isentas">
    Registre por que você isenta certas contas de tarifas. Isso apoia a auditoria e a conformidade.
  </Step>
</Steps>

## Fluxo de cálculo de tarifa

***

Quando o Fees Engine processa uma transação, ele:

1. Identifica os pacotes de tarifas aplicáveis com base na rota de transação e no segmento
2. Filtra os pacotes pela faixa de valores (a transação deve estar dentro do mínimo/máximo)
3. Verifica se a conta está na lista de contas isentas
4. Aplica as regras de tarifa em ordem de prioridade
5. Calcula cada tarifa com base na regra de aplicação e no valor de referência
6. Credita os valores de tarifa nas contas designadas

<Note>
  Habilite um pacote de tarifas para que ele se aplique às transações. Para pausar um pacote, desabilite-o. Um pacote desabilitado permanece na sua configuração.
</Note>