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

> Execute uma estimativa de tarifa com a Calculadora de Tarifas do Console para pré-visualizar cobranças em valores, contas e moedas de exemplo antes de criar qualquer Transação real no Ledger.

Use a **Calculadora de Tarifas** no Módulo Midaz para estimar tarifas antes de processar uma Transação real. A Calculadora de Tarifas é somente leitura. Ela não cria uma Transação nem altera nenhum saldo do Ledger.

## Antes de começar

***

* Habilite o **Fees Engine** em [Configurações do Módulo Midaz](/pt/platform/console/plugin-settings).
* Você precisa de pelo menos um [Pacote de Tarifas](/pt/products/midaz/fees/console/fe-creating-a-package) salvo.
* Você precisa dos aliases de Conta de origem e destino que quer usar no teste.

## 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. Veja o [Guia de campos](#field-guide) abaixo para cada campo.
  </Step>

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

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

<h2 id="field-guide">
  Guia de campos
</h2>

***

| Campo              | O que inserir                              | Exemplo                 |
| ------------------ | ------------------------------------------ | ----------------------- |
| Valor da Transação | Valor total para estimar as tarifas.       | `100.00`                |
| Moeda              | Código do ativo para a transação estimada. | `BRL`                   |
| Pacote de Tarifas  | Pacote de Tarifas a testar.                | `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 Tarifas é uma ferramenta somente leitura. Ela não afeta o ledger nem cria transações. Você pode executar quantas estimativas forem necessárias com segurança.
</Note>

## Entendendo os resultados

***

Depois de executar uma estimativa, a Calculadora de Tarifas mostra um detalhamento completo do cálculo:

### Totais

* **Tarifa Total** - a soma de todas as tarifas da transação
* **Valor Líquido** - o valor que o destino receberia depois das tarifas dedutíveis

### Detalhamento de tarifas

Para cada regra de tarifa aplicada, você verá:

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

## Exemplos de estimativa

***

<AccordionGroup>
  <Accordion title="Estimativa de tarifa fixa simples">
    **Cenário**: teste uma tarifa fixa de \$2,00 em uma transferência de \$100

    **Entrada**:

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

    **Resultado Esperado**:

    * Tarifa Total: \$2,00
    * Valor Líquido: \$98,00 (se dedutível) ou \$100,00 (se não dedutível)
  </Accordion>

  <Accordion title="Estimativa de tarifa percentual">
    **Cenário**: teste uma tarifa de 1,5% em uma transferência de \$500

    **Entrada**:

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

    **Resultado Esperado**:

    * Tarifa Total: \$7,50 (1,5% de \$500)
    * Cálculo: 500 × 0,015 = 7,50
  </Accordion>

  <Accordion title="Estimativa de tarifa combinada">
    **Cenário**: teste a tarifa de máximo entre fixa e percentual em valores diferentes

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

    * Fixa: \$1,00
    * Percentual: 2% = \$0,60
    * Resultado: \$1,00 (a fixa é maior)

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

    * Fixa: \$1,00
    * Percentual: 2% = \$4,00
    * Resultado: \$4,00 (a percentual é maior)
  </Accordion>

  <Accordion title="Estimativa de múltiplas tarifas">
    **Cenário**: pacote com duas tarifas aplicadas em ordem de prioridade

    **Tarifa A** (Prioridade 1): 1% sobre o valor original
    **Tarifa B** (Prioridade 2): 0,5% sobre o valor após tarifas

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

    **Resultado Esperado**:

    * Tarifa A: \$10,00 (1% de \$1000)
    * Tarifa B: \$4,95 (0,5% de \$990)
    * Tarifa Total: \$14,95
  </Accordion>
</AccordionGroup>

## Casos de uso para estimativa de tarifa

***

### Validar novos pacotes de tarifas

Antes de habilitar um novo pacote de tarifas, execute estimativas em vários valores de transação. Confirme que as tarifas estão corretas em toda a faixa de valores.

### Testar casos extremos

Estime transações nos limites mínimo e máximo de valor para verificar o comportamento da tarifa nos extremos das faixas configuradas.

### Comparar estruturas de tarifa

Rode a mesma transação em pacotes de tarifas diferentes para comparar os resultados e escolher a melhor estrutura para o seu caso de uso.

### Documentar as tarifas esperadas

Use os resultados da estimativa para criar documentação para a equipe financeira ou os clientes sobre os valores de tarifa esperados.

### Depurar problemas de tarifa

Se uma transação mostrar tarifas inesperadas, use a Calculadora de Tarifas para reproduzir o cenário e entender o detalhamento do cálculo.

## Boas práticas

***

* **Teste toda a faixa de valores** - não teste apenas um valor. Estime transações no mínimo, no máximo e em vários pontos intermediários.
* **Verifique a ordem de prioridade** - quando os pacotes têm múltiplas tarifas, confirme que elas se aplicam na ordem esperada.
* **Verifique as contas isentas** - teste com contas que o pacote de tarifas isenta. Confirme que os resultados as excluem das tarifas.
* **Documente seus testes** - mantenha um registro dos resultados das estimativas para fins de auditoria e compliance.
* **Compartilhe com as partes interessadas** - use os detalhamentos das estimativas para alinhar com as equipes financeiras os resultados de tarifa esperados antes de entrar em produção.

## O que fazer a seguir

***

Depois de validar o resultado da tarifa, ajuste o Pacote de Tarifas se necessário em [Editando um Pacote de Tarifas](/pt/products/midaz/fees/console/fe-editing-a-package), ou crie uma Transação real em [Criando uma Transação](/pt/products/midaz/console/creating-a-transaction).

<Card title="Equivalente na API" type="tip" horizontal>
  [Endpoint de estimativa de tarifas](/pt/reference/products/midaz/v2/estimate-fee-calculation)
</Card>