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

# Gerenciando tabelas de tarifas

> Defina tarifas fixas, percentuais, por faixas ou por fórmula no módulo Matcher para que o Matcher verifique as tarifas das transações conciliadas e sinalize diferenças.

A página **Tabelas de taxas** do módulo Matcher no Lerian Console lista as suas tabelas de tarifas. Uma tabela de tarifas define as tarifas esperadas: fixas, percentuais, por faixas ou por fórmula. O Matcher usa essas tabelas para verificar as tarifas entre transações conciliadas e para sinalizar diferenças.

Todos os contextos compartilham as mesmas tabelas de tarifas. Para aplicar uma tabela a um contexto, adicione uma regra de tarifa na aba **Regras de Taxas** desse contexto, como descreve [Regras de tarifa do contexto](https://docs.lerian.studio/pt/products/matcher/ui/context-fee-rules.md).

## Abrindo a página Tabelas de taxas

***

No módulo Matcher, vá em **Configurações → Tabelas de taxas**. A página não usa o seletor **Contexto ativo**.

## Lista de tabelas de tarifas

***

A lista mostra até 25 tabelas por página. Ela tem estas colunas:

| Coluna | Descrição |
| - | - |
| **Nome** | O nome da tabela de tarifas |
| **Moeda** | O código da moeda (por exemplo, `BRL`) |
| **Ordem de aplicação** | **Paralela** ou **Cascata** |
| **Arredondamento** | O método de arredondamento e o número de casas decimais (por exemplo, "Metade para cima, 2 casas decimais") |
| **Itens** | O número de itens de tarifa na tabela |
| **Usado por** | O número de contextos cujas regras de tarifa usam a tabela, ou "Não usada por nenhum contexto" |
| **Criado Em** | A data em que a tabela foi criada |
| **Ações** | O menu de ações da linha |

Use **Anterior** e **Próximo** abaixo da lista para navegar entre as páginas.

### Ordem de aplicação

| Ordem | Descrição |
| - | - |
| **Paralela** | Cada item de tarifa usa o valor bruto original |
| **Cascata** | Cada item de tarifa usa o valor líquido que sobra depois dos itens anteriores |

O Matcher aplica os itens de tarifa em ordem de prioridade, o menor número primeiro.

### Métodos de arredondamento

| Método | Descrição |
| - | - |
| **Metade para cima** | Arredonda para o valor mais próximo. Um valor exatamente na metade é arredondado para longe de zero |
| **Bancário** | Arredonda para o valor mais próximo. Um valor exatamente na metade é arredondado para o dígito par mais próximo |
| **Piso** | Arredonda em direção ao infinito negativo |
| **Teto** | Arredonda em direção ao infinito positivo |
| **Truncar** | Remove as casas decimais excedentes sem arredondar |

### Tipos de estrutura

| Tipo | Descrição |
| - | - |
| **FLAT: valor fixo** | Um valor fixo na moeda da tabela (por exemplo, `5.00`) |
| **PERCENTAGE: percentual da base** | Uma alíquota sobre o valor base |
| **TIERED: faixas marginais** | Faixas por valor base. Cada faixa cobra a alíquota dela sobre a parte do valor dentro dessa faixa |
| **EXPRESSION: fórmula** | Uma fórmula sobre o valor bruto e as chaves de metadados da transação |

## Criando uma tabela de tarifas

***

1. Clique em **Nova tabela de taxas**. O painel lateral **Nova tabela de taxas** abre.
2. Preencha os campos da tabela.
3. Preencha o primeiro item de tarifa. Clique em **Adicionar item de taxa** para adicionar mais itens.
4. Clique em **Salvar**.

### Campos da tabela

| Campo | Descrição |
| - | - |
| **Nome** | Um nome para a tabela (por exemplo, "Tarifas bancárias BRL") |
| **Moeda** | O código da moeda (por exemplo, `BRL`). Você não pode alterá-lo depois |
| **Ordem de aplicação** | **Paralela** ou **Cascata**. O padrão é **Paralela** |
| **Método de arredondamento** | **Metade para cima**, **Bancário**, **Piso**, **Teto** ou **Truncar**. O padrão é **Metade para cima** |
| **Casas decimais** | O número de casas decimais depois do arredondamento, de 0 a 10. O padrão é 2 |

### Campos do item de tarifa

| Campo | Descrição |
| - | - |
| **Nome** | Um nome para o item de tarifa (por exemplo, "Tarifa de transferência") |
| **Prioridade** | Um número inteiro, 0 ou maior. Números menores são aplicados primeiro. Cada item de uma tabela precisa de uma prioridade diferente |
| **Estrutura** | O tipo de estrutura do item de tarifa |

O tipo de estrutura adiciona mais campos:

| Estrutura | Campos | Descrição |
| - | - | - |
| **FLAT: valor fixo** | **Valor** | O valor fixo na moeda da tabela |
| **PERCENTAGE: percentual da base** | **Alíquota (fração)** | Uma fração do valor base, de 0 a 1. Por exemplo, `0.029` é 2,9% |
| **TIERED: faixas marginais** | **Alíquota (fração) da faixa 1**, **Faixa 1 até** e um par para cada outra faixa | Cada faixa tem uma alíquota de 0 a 1 e um limite superior. Clique em **Adicionar faixa** para adicionar uma faixa. Cada limite deve ser maior que o limite anterior. Deixe o último limite vazio para que essa faixa não tenha limite superior |
| **EXPRESSION: fórmula** | **Expressão** | Uma fórmula sobre `gross` e as chaves de metadados da transação. Você pode usar `+ - * /`, parênteses e as funções `days_late(a, b)`, `days_between(a, b)`, `max(…)`, `min(…)`, `abs(x)` e `clamp(x, lo, hi)`. Se a fórmula apenas multiplicar ou dividir `gross` por números, a alíquota dela deve ser de 0 a 1. O Matcher verifica a fórmula quando você salva |

> [!NOTE]
>
> Você não pode alterar os itens de tarifa depois de salvar a tabela. Para alterá-los, crie uma nova tabela.

## Vendo uma tabela de tarifas

***

Abra o menu de ações da linha e clique em **Ver**. Uma caixa de diálogo mostra a moeda, a ordem de aplicação e o arredondamento da tabela. Ela lista os itens de tarifa em ordem de prioridade.

## Editando uma tabela de tarifas

***

1. Abra o menu de ações da linha e clique em **Editar**. Um painel lateral abre com os valores atuais.
2. Altere **Nome**, **Ordem de aplicação**, **Método de arredondamento** ou **Casas decimais**.
3. Clique em **Salvar**.

O campo **Moeda** fica bloqueado. O painel lateral mostra os itens de tarifa, mas você não pode editá-los.

## Simulando tarifas

***

Use uma simulação para estimar as tarifas de uma tabela para um valor. Uma simulação não registra nada.

1. Abra o menu de ações da linha e clique em **Simular**. A caixa de diálogo **Simular taxas** abre.
2. Informe o valor em **Valor bruto**. O rótulo mostra a moeda da tabela, por exemplo **Valor bruto (BRL)**.
3. Clique em **Rodar simulação**.

O resultado mostra o valor **Bruto**, a **Taxa total** e o valor **Líquido**. Uma tabela lista cada item de tarifa por **Nome**, com a **Base usada** e a **Taxa**.

## Excluindo uma tabela de tarifas

***

1. Abra o menu de ações da linha e clique em **Excluir**. Uma caixa de diálogo de confirmação abre.
2. Clique em **Confirmar**.

> [!NOTE]
>
> O Matcher não exclui uma tabela que uma regra de tarifa ainda usa. A coluna **Usado por** mostra quantos contextos usam a tabela.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.