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

> Crie, edite e exclua Pacotes de Taxa no Console para controlar como as cobranças são aplicadas às Transações.

**Pacotes de Taxa** são os blocos de construção do [Fees Engine](/pt/lerian-console/midaz-console/fees-engine-overview). Cada pacote define um conjunto de Regras de Taxa e as condições sob as quais elas se aplicam às Transações.

<Note>
  O plugin Fees Engine precisa estar habilitado nas [configurações do Módulo Midaz](/pt/lerian-console/midaz-console/plugin-settings) para que esta página fique disponível.
</Note>

## O que um Pacote de Taxa contém

***

Um Pacote de Taxa permite que você:

* **Defina regras de cálculo de taxas** — taxas fixas, taxas baseadas em porcentagem ou cálculos combinados.
* **Defina faixas de valores** — aplique taxas apenas a transações dentro de uma faixa mín/máx.
* **Vincule a Rotas de Transação** — direcione fluxos de transação específicos.
* **Isente taxas para contas específicas** — exclua contas de origem selecionadas.
* **Priorize a aplicação de taxas** — controle a ordem em que múltiplas taxas são aplicadas.

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

## Acessando a página Pacotes de Taxa

***

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

<Note>
  Se você não tiver nenhum Pacote de Taxa, a lista aparecerá vazia com uma indicação para criar seu primeiro pacote.
</Note>

### Ações disponíveis

A partir da página Pacotes de Taxa, você pode:

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

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

  <Card title="Excluir um Pacote de Taxa" icon="trash" horizontal href="/pt/lerian-console/midaz-console/fe-deleting-a-package">
    Remova um pacote de taxa da sua configuração
  </Card>
</Columns>

<Note>
  Selecionar um pacote na lista abre a sua **visão de detalhes**, onde você pode revisar a configuração do pacote — tipo, escopo e regras — antes de editá-lo. Para visualizar uma prévia das tarifas que um período geraria entre os pacotes, use os [Billing Runs](/pt/lerian-console/midaz-console/billing-runs).
</Note>

## Entendendo a estrutura de um Pacote de Taxa

***

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

### Informações básicas

* **Rótulo do Grupo de Taxa** (obrigatório) - Um nome descritivo para o pacote de taxa
* **Descrição** (obrigatório) - Explicação da finalidade do pacote e quando ele se aplica
* **Rota de Transação** (opcional) - Vincula a uma Rota de Transação específica
* **Segmento** (opcional) - Associa a um Segmento específico
* **Ledger** (obrigatório) - O Ledger ao qual este pacote se aplica

### Faixa de valor

* **Valor Mínimo** (obrigatório) - Valor de transação mais baixo para aplicação da taxa
* **Valor Máximo** (obrigatório) - Valor de transação mais alto para aplicação da taxa
* **Contas Isentas** (opcional) - Lista de aliases de contas isentas destas taxas

### Regras de Taxa

Cada pacote de taxa pode conter várias Regras de Taxa com:

* **Rótulo da Taxa** - Nome que identifica esta taxa específica
* **Regra de Aplicação** - Como a taxa é calculada:
  * `flatFee` - Valor fixo independente do valor da transação
  * `percentual` - Porcentagem do valor da transação
  * `maxBetweenTypes` - O maior valor entre o cálculo fixo e o percentual
* **Tipo de Cálculo** - `flat` ou `percentage`
* **Valor de Cálculo** - O valor ou porcentagem da taxa
* **Valor de Referência** - Base para o cálculo do percentual:
  * `originalAmount` - Calcular sobre o valor original da transação
  * `afterFeesAmount` - Calcular após a aplicação de outras taxas
* **Prioridade** - Ordem de aplicação da taxa (números menores são aplicados primeiro)
* **Dedutível De** - Se esta taxa é deduzida da transação
* **Conta de Crédito** - Conta que recebe o valor da taxa

## Casos de uso comuns

***

<AccordionGroup>
  <Accordion title="Taxa fixa simples por transação">
    Aplica uma taxa 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**: Taxa de $2.50 em cada transação entre $10 e \$1000
  </Accordion>

  <Accordion title="Taxa baseada em porcentagem">
    Cobra uma porcentagem do valor da transação:

    * **Regra de Aplicação**: `percentual`
    * **Cálculo**: `percentage` com valor `1.5`
    * **Exemplo**: Taxa de 1.5% em transferências, em que transferência de $100 = $1.50 de taxa
  </Accordion>

  <Accordion title="Estrutura de taxas em faixas">
    Crie vários pacotes com faixas de valores diferentes:

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

  <Accordion title="Combinação fixa + porcentagem (máximo)">
    Aplica o maior valor entre fixo e porcentagem:

    * **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) = $1.00 de taxa
    * **Exemplo**: Em transação de $100: max($1.00, $2.00) = $2.00 de taxa
  </Accordion>

  <Accordion title="Isenção de taxa para contas premium">
    Isenta contas específicas de taxas:

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

## Boas práticas

***

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

  <Step title="Use rótulos descritivos">
    Escolha rótulos e descrições claros para o grupo de taxa que expliquem quando e por que as taxas se aplicam. Isso ajuda em auditoria e comunicação com clientes.
  </Step>

  <Step title="Defina faixas de valor adequadas">
    Defina valores mínimos e máximos com cuidado para evitar lacunas ou sobreposições na sua estrutura de taxas.
  </Step>

  <Step title="Teste os cálculos de taxas">
    Use o recurso [Estimativa de Taxa](/pt/lerian-console/midaz-console/fe-fee-simulation) para verificar os cálculos antes de habilitar os pacotes em produção.
  </Step>

  <Step title="Gerencie a Prioridade com cuidado">
    Quando usar várias taxas em um pacote, defina prioridades para garantir que as taxas sejam aplicadas na ordem correta.
  </Step>

  <Step title="Documente as contas isentas">
    Mantenha registro do motivo pelo qual certas contas estão isentas de taxas para fins de auditoria e conformidade.
  </Step>
</Steps>

## Fluxo de cálculo de taxas

***

Quando uma transação é processada, o Fees Engine:

1. Identifica pacotes de taxa aplicáveis com base na Rota de Transação e no Segmento
2. Filtra os pacotes por faixa de valor (a transação precisa estar dentro do mín/máx)
3. Verifica se a conta de origem está na lista de Contas Isentas
4. Aplica as Regras de Taxa em ordem de Prioridade
5. Calcula cada taxa com base na Regra de Aplicação e no Valor de Referência
6. Credita os valores das taxas nas contas designadas

<Note>
  Pacotes de taxa precisam estar **habilitados** para serem aplicados a transações. Você pode desabilitar pacotes temporariamente sem excluí-los.
</Note>