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.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.
Antes de começar
- O plugin Fees Engine precisa estar habilitado nas configurações do Módulo Midaz.
- Você precisa de pelo menos um Pacote de Taxa salvo.
- Você precisa dos aliases das Contas de origem e destino que deseja testar.
Executando uma estimativa
Preencha a transação estimada. Consulte o Guia de campos abaixo para cada entrada.
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 |
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.
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
Estimativa de taxa fixa simples
Estimativa de taxa fixa simples
Cenário: Testar uma taxa fixa de $2.00 em uma transferência de $100Entrada:
- Pacote de Taxa:
Standard Transfer Fee - Ativo:
USD - Valor:
100.00 - Origem:
@customer/checking - Destino:
@merchant/revenue
- Taxa Total: $2.00
- Valor Líquido: $98.00 (se dedutível) ou $100.00 (se não dedutível)
Estimativa de taxa por porcentagem
Estimativa de taxa por porcentagem
Cenário: Testar uma taxa de 1.5% em uma transferência de $500Entrada:
- Pacote de Taxa:
Percentage Transaction Fee - Ativo:
USD - Valor:
500.00 - Origem:
@customer/savings - Destino:
@vendor/payments
- Taxa Total: $7.50 (1.5% de $500)
- Cálculo: 500 × 0.015 = 7.50
Estimativa de taxa combinada
Estimativa de taxa combinada
Cenário: Testar a taxa max(flat, percentage) em valores diferentesTeste 1 - Transação pequena ($30):
- Flat: $1.00
- Percentage: 2% = $0.60
- Resultado: $1.00 (a fixa é maior)
- Flat: $1.00
- Percentage: 2% = $4.00
- Resultado: $4.00 (a porcentagem é maior)
Estimativa de múltiplas taxas
Estimativa de múltiplas taxas
Cenário: Pacote com duas taxas aplicadas em ordem de PrioridadeTaxa A (Prioridade 1): 1% sobre o valor original
Taxa B (Prioridade 2): 0.5% sobre o valor após taxasEntrada: Transação de $1000Resultado esperado:
- Taxa A: $10.00 (1% de $1000)
- Taxa B: $4.95 (0.5% de $990)
- Taxa Total: $14.95
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, ou crie uma Transação real em Criando uma Transação.