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

# Executando uma Estimativa de Taxa

> Use a Calculadora de Taxa para estimar como as taxas serão aplicadas antes de executar Transações reais no seu Ledger.

Use a **Calculadora de Taxa** no Módulo Midaz para estimar cálculos de taxas antes de processar Transações reais. O estimador é somente leitura — não cria uma Transação nem afeta nenhum saldo do Ledger.

## Antes de começar

***

* O plugin **Fees Engine** precisa estar habilitado nas [configurações do Módulo Midaz](/pt/lerian-console/midaz-console/plugin-settings).
* Você precisa de pelo menos um [Pacote de Taxa](/pt/lerian-console/midaz-console/fe-creating-a-package) salvo.
* Você precisa dos aliases das Contas de origem e destino que deseja testar.

## Executando uma estimativa

***

<Steps>
  <Step>
    Na barra lateral do Módulo Midaz, expanda **Fees Engine** e clique em **Calculadora**.
  </Step>

  <Step>
    Preencha a transação estimada. Consulte o [Guia de campos](#guia-de-campos) abaixo para cada entrada.
  </Step>

  <Step>
    Clique em **Calcular Taxas** para executar a estimativa.
  </Step>

  <Step>
    Revise os resultados exibidos abaixo do formulário.
  </Step>
</Steps>

## Guia de campos

***

| Campo              | O que informar                             | Exemplo                 |
| ------------------ | ------------------------------------------ | ----------------------- |
| Valor da Transação | Valor total para estimar as taxas.         | `100.00`                |
| Moeda              | Código do Ativo para a transação estimada. | `BRL`                   |
| Pacote de Taxa     | Pacote de Taxa a ser testado.              | `Standard Transfer Fee` |
| Conta de Origem    | Alias da conta que seria debitada.         | `@customer_123`         |
| Conta de Destino   | Alias da conta que seria creditada.        | `@merchant_456`         |
| Descrição          | Descrição opcional para a estimativa.      | `Pix transfer test`     |

<Note>
  A Calculadora de Taxa é uma ferramenta somente leitura. Ela não afeta o Ledger nem cria nenhuma transação. Você pode executar quantas estimativas precisar com segurança.
</Note>

## Entendendo os resultados

***

Após executar uma estimativa, você verá um detalhamento de como as taxas são calculadas:

### Resumo

* **Taxa Total** - O valor combinado de todas as taxas que seriam cobradas
* **Valor Líquido** - O valor que o destino receberia após as taxas dedutíveis

### Detalhamento de taxas

Para cada Regra de Taxa aplicada, você verá:

| Campo                   | Descrição                         |
| ----------------------- | --------------------------------- |
| **Rótulo da Taxa**      | Nome que identifica a taxa        |
| **Prioridade**          | Ordem em que a taxa foi aplicada  |
| **Tipo de Cálculo**     | `flat` ou `percentage`            |
| **Valor de Referência** | O valor base usado para o cálculo |
| **Valor Calculado**     | O valor real da taxa              |
| **Conta de Crédito**    | Conta que receberia a taxa        |
| **É Dedutível**         | Se a taxa é deduzida da transação |

## Exemplos de estimativa

***

<AccordionGroup>
  <Accordion title="Estimativa de taxa fixa simples">
    **Cenário**: Testar uma taxa fixa de \$2.00 em uma transferência de \$100

    **Entrada**:

    * Pacote de Taxa: `Standard Transfer Fee`
    * Ativo: `USD`
    * Valor: `100.00`
    * Origem: `@customer/checking`
    * Destino: `@merchant/revenue`

    **Resultado esperado**:

    * Taxa Total: \$2.00
    * Valor Líquido: \$98.00 (se dedutível) ou \$100.00 (se não dedutível)
  </Accordion>

  <Accordion title="Estimativa de taxa por porcentagem">
    **Cenário**: Testar uma taxa de 1.5% em uma transferência de \$500

    **Entrada**:

    * Pacote de Taxa: `Percentage Transaction Fee`
    * Ativo: `USD`
    * Valor: `500.00`
    * Origem: `@customer/savings`
    * Destino: `@vendor/payments`

    **Resultado esperado**:

    * Taxa Total: \$7.50 (1.5% de \$500)
    * Cálculo: 500 × 0.015 = 7.50
  </Accordion>

  <Accordion title="Estimativa de taxa combinada">
    **Cenário**: Testar a taxa max(flat, percentage) em valores diferentes

    **Teste 1** - Transação pequena (\$30):

    * Flat: \$1.00
    * Percentage: 2% = \$0.60
    * Resultado: \$1.00 (a fixa é maior)

    **Teste 2** - Transação grande (\$200):

    * Flat: \$1.00
    * Percentage: 2% = \$4.00
    * Resultado: \$4.00 (a porcentagem é maior)
  </Accordion>

  <Accordion title="Estimativa de múltiplas taxas">
    **Cenário**: Pacote com duas taxas aplicadas em ordem de Prioridade

    **Taxa A** (Prioridade 1): 1% sobre o valor original
    **Taxa B** (Prioridade 2): 0.5% sobre o valor após taxas

    **Entrada**: Transação de \$1000

    **Resultado esperado**:

    * Taxa A: \$10.00 (1% de \$1000)
    * Taxa B: \$4.95 (0.5% de \$990)
    * Taxa Total: \$14.95
  </Accordion>
</AccordionGroup>

## Casos de uso para estimativa de taxas

***

### Validar novos Pacotes de Taxa

Antes de habilitar um novo pacote de taxa, execute estimativas com vários valores de transação para garantir que as taxas sejam calculadas corretamente em toda a faixa de valores.

### Testar casos extremos

Estime transações nos limites mínimo e máximo dos valores para verificar o comportamento das taxas nos limites das faixas configuradas.

### Comparar estruturas de taxas

Execute a mesma transação por diferentes pacotes de taxa para comparar resultados e escolher a melhor estrutura para o seu caso de uso.

### Documentar taxas esperadas

Use os resultados das simulações para criar documentação para a sua equipe financeira ou clientes sobre os valores de taxas esperados.

### Depurar problemas de taxas

Se as transações estiverem mostrando taxas inesperadas, use o estimador para reproduzir o cenário e entender o detalhamento do cálculo.

## Boas práticas

***

* **Teste faixas completas de valor** - Não teste apenas um valor; estime transações no mínimo, máximo e vários pontos intermediários.
* **Verifique a ordem de Prioridade** - Quando os pacotes têm várias taxas, confirme se elas são aplicadas na ordem esperada.
* **Verifique as Contas Isentas** - Teste com contas que deveriam estar isentas para confirmar que são excluídas das taxas.
* **Documente seus testes** - Mantenha um registro dos resultados das estimativas para fins de auditoria e conformidade.
* **Compartilhe com stakeholders** - Use os detalhamentos das estimativas para alinhar com as equipes financeiras sobre os resultados de taxas esperados antes de ir para produção.

## O que fazer em seguida

***

Após validar o resultado da taxa, ajuste o Pacote de Taxa se necessário em [Editando um Pacote de Taxa](/pt/lerian-console/midaz-console/fe-editing-a-package), ou crie uma Transação real em [Criando uma Transação](/pt/lerian-console/midaz-console/creating-a-transaction).

<Card title="Equivalente na API" type="info" horizontal>
  [Endpoint Simular Taxas](/pt/reference/midaz/plugins/fees-engine/simulate-fees)
</Card>