> ## 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 Taxas do Console para pré-visualizar cobranças em valores, contas e ativos de exemplo antes de criar qualquer Transação real no Ledger. Use a **Calculadora de Taxas** no Módulo Midaz para estimar tarifas antes de processar uma Transação real. A Calculadora de Taxas é 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](https://docs.lerian.studio/pt/platform/console/plugin-settings.md). * Você precisa de pelo menos um [Pacote de Tarifas](https://docs.lerian.studio/pt/products/midaz/fees/console/fe-creating-a-package.md) salvo. * Você precisa dos aliases de Conta de origem e destino que quer usar no teste. ## Executando uma estimativa *** **Step 1** Na barra lateral do Módulo Midaz, expanda **Fees Engine** e clique em **Calculadora**. **Step 2** Preencha a transação estimada. Veja o [Guia de campos](#field-guide) abaixo para cada campo. **Step 3** Clique em **Calcular Taxas** para executar a estimativa. **Step 4** Revise os resultados mostrados abaixo do formulário. ## Guia de campos *** | Campo | O que inserir | Exemplo | | - | - | - | | Valor da Transação | Valor total para estimar as tarifas. | `100.00` | | Ativo | Um dos ativos do ledger atual. Selecione-o na lista. | `BRL` | | Pacote de Taxas | 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 Taxas é 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. ## Entendendo os resultados *** Depois de executar uma estimativa, a Calculadora de Taxas mostra um detalhamento completo do cálculo: ### Totais * **Pagador pagou** - o valor que a origem envia, incluindo as tarifas somadas por cima * **Total de taxas** - a soma de todas as tarifas da transação * **Destinatário recebeu** - **Pagador pagou** menos **Total de taxas** ### Detalhamento de tarifas Para cada regra de tarifa aplicada, você verá: | Campo | Descrição | | - | - | | **Rótulo da Tarifa** | Nome que identifica a tarifa | | **Origem Paga** ou **Destino Paga** | Quem paga a tarifa. A origem paga uma tarifa somada por cima. O destino paga uma tarifa dedutível. | | **Tipo de Cálculo** | **Fixa**, **Percentual** ou **Máx. Entre** | | **Valor Calculado** | O valor real da tarifa | ## Exemplos de estimativa *** > [accordion] 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**: > > * Total de taxas: \$2,00 > * Destinatário recebeu: \$98,00 se a tarifa for dedutível. Se ela não for dedutível, Pagador pagou é \$102,00 e Destinatário recebeu é \$100,00. > [accordion] 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**: > > * Total de taxas: \$7,50 (1,5% de \$500) > * Cálculo: 500 × 0,015 = 7,50 > [accordion] 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] 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, não dedutível > **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: \$5,05 (0,5% de \$1010) > * Total de taxas: \$15,05 ## 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 Taxas 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](https://docs.lerian.studio/pt/products/midaz/fees/console/fe-editing-a-package.md), ou crie uma Transação real em [Criando uma Transação](https://docs.lerian.studio/pt/products/midaz/console/creating-a-transaction.md). > [card] Equivalente na API > > [Endpoint de estimativa de tarifas](https://docs.lerian.studio/pt/reference/products/midaz/v2/estimate-fee-calculation.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.