> ## 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. # Usando o Fees Engine > Use o Fees Engine para aplicar pacotes de tarifas por transação e pacotes de faturamento por período que correspondam aos seus ledgers, segmentos e rotas de transação. O Fees Engine aplica tarifas por transação e calcula cobranças de faturamento periódicas. Este guia cobre os dois fluxos: pacotes de tarifas (por transação) e pacotes de faturamento (por período). > [!TIP] > > Os pacotes de tarifas aplicam cobranças no momento da transação. Os pacotes de faturamento calculam cobranças ao longo de um período (diário, semanal ou mensal) para o seu orquestrador executar. Você pode usar os dois simultaneamente. ## Pacotes de tarifas: fluxo por transação *** Os pacotes de tarifas aplicam cobranças de forma síncrona quando você cria uma transação v2. Esta seção mostra o processo, da configuração da tarifa até os resultados. ### Passo 1 - Crie seus pacotes de tarifas Primeiro, configure **pacotes de tarifas** que definem como o mecanismo aplica as tarifas. Use o endpoint [Criar um Pacote](https://docs.lerian.studio/pt/reference/products/midaz/v2/create-package.md). Cada pacote contém um conjunto de regras de tarifa e critérios de correspondência. Você pode adaptar os pacotes a diferentes ledgers, segmentos e rotas de transação com estes campos: * **transactionRoute** - O ID de uma rota de transação, quando você precisa de correspondência no nível da rota. * **segmentId** - O ID do segmento ao qual as contas de origem pertencem, quando você precisa de correspondência no nível do segmento. * **metadataSelector** - Pares de metadados que a transação precisa ter, quando você precisa de correspondência no nível de metadados. * **Escopo do ledger** - A URL da requisição identifica qual ledger registra a transação; não envie `ledgerId` no corpo do pacote. * Valor **mínimo** e **máximo** - Limites para a aplicação da tarifa. * **routeFrom** / **routeTo** - Definem como cada tarifa se move pelos fluxos contábeis. Esses campos permitem aplicar tarifas distintas para cada cenário, de configurações baseadas em conta a configurações baseadas em valor. **Gerenciando pacotes** Os seguintes endpoints também estão disponíveis para você gerenciar os pacotes: * [Listar Pacotes](https://docs.lerian.studio/pt/reference/products/midaz/v2/get-all-packages.md) - Lista todos os pacotes criados. * [Buscar um Pacote](https://docs.lerian.studio/pt/reference/products/midaz/v2/get-package-by-id.md) - Busca informações de um pacote específico. * [Atualizar um Pacote](https://docs.lerian.studio/pt/reference/products/midaz/v2/update-package.md) - Atualiza as informações de um pacote específico. * [Excluir um Pacote](https://docs.lerian.studio/pt/reference/products/midaz/v2/delete-package.md) - Faz o soft delete de um pacote. ### (opcional) Passo 2 - Execute uma estimativa Para visualizar como um pacote de tarifas se comporta antes de confirmar uma transação real, use o endpoint [Estimar Tarifas de Transação](https://docs.lerian.studio/pt/reference/products/midaz/v2/estimate-fee-calculation.md). Essa estimativa ajuda a validar: * Quais regras de tarifa se aplicam. * Como o pacote vai se comportar com os valores informados. * Se alguma isenção se aplica. ### Passo 3 - Crie uma transação Depois de configurar os pacotes, crie a transação pela API de transações v2, por exemplo com o endpoint [criar uma transação no modelo direto v2](https://docs.lerian.studio/pt/reference/products/midaz/v2/create-transaction-direct.md). Apenas transações v2 aplicam tarifas, incluindo os itens diretos e de hold de um lote v2. Para corresponder a um pacote com escopo de rota, envie o ID da rota de transação em `routeId`. O Midaz lê o segmento das contas de origem. ### Passo 4 - O Fees Engine avalia os pacotes O Fees Engine é executado no mesmo processo quando o Midaz cria a transação. Ele avalia se um pacote se aplica, com base em: * **transactionRoute**, quando configurado * **segmentId**, quando configurado * **metadataSelector**, quando configurado * **Escopo do ledger a partir da URL da requisição** * Valor **mínimo** e **máximo** * **waivedAccounts**, quando configurado para isenções de tarifa > [!NOTE] > > O Fees Engine seleciona no máximo um pacote por transação: a correspondência mais específica. Cada par de `metadataSelector` torna um pacote mais específico. Quando dois pacotes correspondem igualmente, o Midaz recusa a transação com o erro `0198`. Uma conta de origem com um [plano de tarifas](https://docs.lerian.studio/pt/products/midaz/fees/account-plans.md) ativo paga as tarifas do plano dela, e o pacote não a cobra. ### Passo 5 - Verifique as isenções O sistema verifica: * Se nenhum pacote correspondente cobre o valor da transação. * Se todas as contas de origem são isentas. Se qualquer uma das condições for verdadeira, o Fees Engine não aplica tarifas e a transação segue normalmente. Uma tarifa cujo cálculo totaliza zero não adiciona lançamento de tarifa, por exemplo uma tarifa definida como `0` em um pacote para uma faixa de valores. Quando uma tarifa definida como `0` deixa a transação sem lançamento de tarifa, os metadados da transação registram `feeExemption` com o motivo `zero_fee_amount`, e `packageAppliedID` indica o pacote. A conta externa (`@external/`) que o Midaz adiciona a uma transação entre ledgers nunca paga tarifa. ### Passo 6 - Cálculo e aplicação da tarifa Se um pacote se aplica, o Fees Engine: * Calcula os valores da tarifa com base no `applicationRule` selecionado. * Aplica as tarifas proporcionalmente entre as contas, se necessário. * Usa `isDeductibleFrom` para definir se adiciona ou deduz a tarifa. * Direciona as tarifas para o `creditAccount` correto com o `routeFrom` e o `routeTo` configurados. * Retorna o resultado completo da transação junto com o `packageAppliedID` nos metadados. ### Passo 7 - Atualizações no ledger Depois que o Fees Engine calcula as tarifas, o componente **Transactions** assume. Ele processa: * Débitos das contas de origem * Créditos para os destinos da tarifa * Detalhamento da tarifa por rota e conta O ledger armazena cada movimento para rastreabilidade e auditabilidade completas. ### Passo 8 - Revise e confirme Depois da execução, você pode: * Inspecionar a transação final e os valores por conta. * Confirmar qual pacote de tarifas foi aplicado. * Verificar todos os movimentos de tarifa por meio dos metadados e dos registros do ledger. ## Precifique um TED ou Pix por um contexto de tarifa *** Um contexto de tarifa é um rótulo que você escolhe para uma transferência de saída, por exemplo `ted_salario`. Um pacote de tarifas que seleciona pelo rótulo precifica a transferência. Isso exige o Midaz 4.2.0 ou posterior, com o Bank Transfer 3.4.0 ou posterior para TED e o Pix JD 1.5.0 ou posterior para Pix. Versões anteriores dos dois plugins recusam o campo com `400`. Envie o rótulo em `feeContext`, no nível mais alto do corpo da requisição de [POST /v1/transfers/initiate](https://docs.lerian.studio/pt/reference/interfaces/ted-jd/initiate-transfer.md) para TED e P2P, ou de [POST /v1/transactions](https://docs.lerian.studio/pt/reference/interfaces/pix-jd/create-transaction.md) para Pix. O rótulo é uma letra minúscula, seguida de até 49 letras minúsculas, dígitos ou sublinhados. Nunca coloque dados pessoais nele. Uma leitura da transferência retorna `feeContext`. ### Crie o pacote do rótulo Crie o pacote no ledger do pagador, com `metadataSelector` igual a `{"feeContext": "