> ## 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 expressão para que o motor de conciliação verifique e sinalize divergências de tarifa nas correspondências automaticamente.
A página **Tabelas de tarifas** da Matcher UI permite definir as tarifas esperadas: fixas, percentuais, por faixas ou por expressão. O motor de conciliação usa essas definições para verificar e sinalizar divergências de tarifa entre transações correspondidas automaticamente. A página também hospeda as **Regras de tarifa** com escopo de contexto, que ligam as tabelas às transações.
## Acessando a página de Tabelas de tarifas
***
Vá em **Matcher > Configurações > Tabelas de tarifas** na barra lateral esquerda.
## Listagem de tabelas de tarifas
***
Cada linha da tabela de dados mostra as seguintes colunas:
| Coluna | Descrição |
| ---------------------- | ----------------------------------------------------------------------------------------- |
| **Nome** | O nome da tabela de tarifas |
| **Moeda** | O código da moeda (por exemplo, BRL) |
| **Ordem de aplicação** | Como os itens de tarifa são aplicados, mostrado como badge: **PARALLEL** ou **CASCADING** |
| **Arredondamento** | O modo e a escala de arredondamento — por exemplo, "HALF\_UP @ 2" |
| **Itens** | A quantidade de itens de tarifa na tabela |
| **Usada por** | Quantos contextos referenciam a tabela por regras de tarifa, ou "Sem uso" |
| **Criada** | Data em que a tabela foi criada |
| **Ações** | Os botões **Ver**, **Simular**, **Editar** e **Excluir** na própria linha |
### Ordem de aplicação
| Modo | Descrição |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| **Paralelo** | Todos os itens de tarifa são calculados de forma independente sobre o valor bruto original |
| **Cascata** | Os itens de tarifa são aplicados em sequência — cada item usa o valor líquido depois de descontada a tarifa do item anterior |
### Modos de arredondamento
| Modo | Descrição |
| ------------------ | ------------------------------------------------------------------------------------------------ |
| **Meio para cima** | Arredonda para o vizinho mais próximo; arredonda para cima no limite de 0,5 |
| **Bancário** | Arredonda para o vizinho mais próximo; arredonda para o dígito par mais próximo no limite de 0,5 |
| **Piso** | Arredonda sempre em direção ao infinito negativo |
| **Teto** | Arredonda sempre em direção ao infinito positivo |
| **Truncar** | Descarta as casas decimais excedentes sem arredondar |
### Tipos de estrutura
| Tipo | Descrição |
| -------------- | --------------------------------------------------------------------------------------------------------------- |
| **Fixa** | Um valor monetário fixo (por exemplo, 5.00) |
| **Percentual** | Uma taxa decimal aplicada ao valor base (por exemplo, 0.015 = 1,5%) |
| **Por faixas** | Faixas marginais por valor base — cada faixa cobra a taxa dela sobre a fatia até o teto correspondente |
| **Expressão** | Uma fórmula sobre o valor bruto mais as chaves de metadados da transação, interpretada e validada pelo servidor |
## Criando uma tabela de tarifas
***
Clique no botão **Nova tabela** no topo da página. Um painel lateral abre com as seguintes seções.
### Campos da tabela
| Campo | Descrição |
| ---------------------------- | --------------------------------------------------------------------------------------------- |
| **Nome** | Um nome descritivo para a tabela (por exemplo, "Tarifas bancárias BRL") |
| **Moeda** | O código de moeda de três letras (por exemplo, BRL). Não pode ser alterado depois da criação |
| **Ordem de aplicação** | Selecione Paralelo ou Cascata. O padrão é Paralelo |
| **Modo de arredondamento** | Selecione um destes: Meio para cima, Bancário, Piso, Teto, Truncar. O padrão é Meio para cima |
| **Escala de arredondamento** | Número de casas decimais para o arredondamento (0–12). O padrão é 2 |
### Itens de tarifa
Depois de preencher os campos da tabela, adicione pelo menos um item de tarifa. Clique em **Adicionar item**:
| Campo | Descrição |
| -------------- | --------------------------------------------------------------------------------- |
| **Nome** | Um nome descritivo para o item de tarifa (por exemplo, "Tarifa de transferência") |
| **Prioridade** | Define a ordem em que os itens são aplicados (número inteiro, 0 ou mais) |
| **Estrutura** | Selecione Fixa, Percentual, Por faixas ou Expressão |
Conforme a estrutura selecionada, aparecem campos adicionais:
| Estrutura | Campos adicionais | Descrição |
| -------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fixa** | **Valor** | O valor fixo na moeda da tabela (por exemplo, "5.00") |
| **Percentual** | **Taxa** | Uma taxa decimal entre 0 e 1 (por exemplo, "0.015" para 1,5%) |
| **Por faixas** | **Faixas** | Um editor estruturado de faixas: cada linha tem uma **Taxa** e um teto **Até**. Adicione ou remova linhas com **Adicionar faixa** e o controle de remoção; os tetos devem crescer estritamente, e você pode deixar o teto da última faixa vazio para uma faixa aberta |
| **Expressão** | **Expressão** | Uma fórmula sobre o valor `gross` injetado mais as chaves de metadados da transação — operadores `+ - * /` e parênteses, mais as funções `days_late(a, b)`, `days_between(a, b)`, `max(…)`, `min(…)`, `abs(x)` e `clamp(x, lo, hi)`. Validada ao salvar |
Você pode adicionar vários itens antes de enviar. Clique em **Criar tabela** para salvar a tabela de tarifas.
Os itens de tarifa são imutáveis depois da criação. Para mudar a estrutura de um item, crie uma nova tabela.
## Editando uma tabela de tarifas
***
Clique em **Editar** na linha de uma tabela de tarifas. O painel lateral abre com os valores atuais já preenchidos.
Você pode alterar o nome da tabela, a ordem de aplicação, o modo de arredondamento e a escala de arredondamento. O campo de moeda fica travado depois da criação, e os itens de tarifa aparecem somente leitura. Clique em **Salvar mudanças** para aplicar.
## Simulando uma tabela de tarifas
***
Clique em **Simular** na linha de uma tabela de tarifas para estimar as tarifas de um dado valor sem registrar nada.
A caixa de diálogo **Simular tarifas** pede:
| Campo | Descrição |
| --------------- | ----------------------------------------------------- |
| **Valor bruto** | O valor sobre o qual simular (por exemplo, "1000.00") |
| **Moeda** | Já preenchida com a moeda da tabela |
Clique em **Rodar simulação**. Os resultados mostram:
* **Bruto**: o valor informado
* **Tarifa total**: o total de tarifas descontadas
* **Líquido**: o valor que sobra depois das tarifas
Se a tabela tem vários itens de tarifa, uma tabela de detalhamento lista cada **Item** com a **Base usada** no cálculo dele e a **Tarifa** cobrada.
## Excluindo uma tabela de tarifas
***
Clique em **Excluir** na linha de uma tabela de tarifas. A caixa de diálogo de confirmação avisa que a exclusão remove a tabela de forma permanente e pode quebrar as regras de tarifa que a referenciam. Clique em **Excluir tabela** para seguir.
Se ainda existem regras de tarifa referenciando a tabela, a exclusão é bloqueada. O erro identifica os contextos que a referenciam (até 20) e informa o total. Remova antes essas regras de tarifa.
## Regras de tarifa
***
Abaixo do catálogo de tabelas, a página hospeda uma seção **Regras de tarifa**, regras com escopo de contexto que ligam tabelas a predicados de correspondência. Selecione um contexto e então:
* Clique em **Nova regra de tarifa** para ligar uma tabela de tarifas a um lado de correspondência e a um conjunto de predicados de campo. Os predicados comparam campos da transação com operadores como igual a, diferente de, é um de, está presente, maior que, pelo menos, menor que, no máximo e no intervalo inclusivo.
* Use os botões **Editar** e **Excluir** na própria linha de uma regra para alterá-la ou removê-la.