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

# Regras do contexto

> Crie, reordene e exclua as regras de correspondência Exata, Tolerância, Defasagem de data e Aproximada de um contexto na aba Regras do módulo Matcher.

Use a aba **Regras** de um contexto no módulo Matcher do Lerian Console para gerenciar as regras de correspondência dele. As regras dizem ao motor de correspondência como parear as transações entre os dois lados do contexto.

## Acessando a aba Regras

***

**Step 1**

Na barra lateral do Matcher, vá para **Configurar → Contextos**.

**Step 2**

Clique no nome de um contexto para abrir a página dele.

**Step 3**

Selecione a aba **Regras**.

## Lista de regras

***

A aba lista as regras de correspondência em ordem de prioridade. As regras são avaliadas de cima para baixo, e a primeira correspondência vence. Cada linha mostra o número da posição, o selo da estratégia e um resumo curto da configuração. Uma linha também pode mostrar setas para cima e para baixo, um botão de edição e um botão de exclusão.

O módulo define a prioridade de uma nova regra por você. O formulário não tem campo de prioridade. Para mudar a ordem, use as setas para cima e para baixo.

## Criando uma regra

***

**Step 1**

Na aba **Regras**, clique em **Nova regra**. O painel lateral **Nova regra** abre.

**Step 2**

Selecione uma **Estratégia**:

| Estratégia | Descrição |
| - | - |
| **Exata** | Igualdade campo a campo |
| **Tolerância** | Valor e data dentro de uma faixa |
| **Defasagem de data** | Janela de atraso de liquidação |
| **Aproximada** | Similaridade aproximada de referência |

Os campos da estratégia aparecem abaixo dela. Veja [Tipos de regra](#rule-types).

**Step 3**

Opcionalmente, clique em **Configurações avançadas** para mostrar mais campos.

**Step 4**

Clique em **Salvar**.

> [!WARNING]
>
> Você não pode mudar a estratégia de uma regra depois de criá-la. Para mudá-la, exclua a regra e crie-a de novo.

O Matcher nunca confirma automaticamente uma correspondência de uma regra **Aproximada** ou **Defasagem de data**. Essas regras propõem correspondências para revisão.

## Tipos de regra

***

### Exata

Pareia transações quando os campos selecionados são iguais.

Toggles de primeiro nível:

| Campo | Descrição |
| - | - |
| **Casar valor** | Compara os valores |
| **Casar moeda** | Exige a mesma moeda |
| **Casar data** | Compara as datas |
| **Casar referência** | Compara as referências |

**Configurações avançadas** adiciona:

| Campo | Descrição |
| - | - |
| **Precisão da data** | `DAY` ou `TIMESTAMP` |
| **Comparar referências sem diferenciar maiúsculas** | Ignora maiúsculas e minúsculas quando você compara referências |
| **A referência deve estar presente** | Quando **Casar referência** está ligado, recusa um par se qualquer uma das referências estiver em branco |
| **Modo de sinal** | `same` pareia sinais iguais. `opposite` pareia uma devolução com a cobrança dela. `ignore` compara apenas as magnitudes |
| **Casar valor base** | Também pareia pelo valor base, que é o valor convertido para a moeda base |
| **Casar moeda base** | Também pareia pela moeda base |
| **Alocação (1:N e N:1)** | Configurações de alocação parcial. Veja [Configurações de alocação](#allocation-settings) |
| **Campos da chave composta** | Campos nomeados extras para parear, junto com os toggles acima. Clique em **Adicionar campo da chave** para adicionar um |

### Tolerância

Pareia transações quando os valores e as datas estão dentro de uma faixa.

Campos de primeiro nível:

| Campo | Descrição |
| - | - |
| **Tolerância absoluta** | A maior diferença de valor que ainda permite a correspondência. A faixa de valor usa o maior entre este valor e a tolerância percentual |
| **Tolerância percentual** | Uma fração: `0.005` é 0,5%. A faixa de valor usa o maior entre este valor e a tolerância absoluta |
| **Janela de datas (dias)** | Quantos dias de diferença pode haver entre as datas dos dois lados, de 0 a 3650 |
| **Casar moeda** | Exige a mesma moeda |

> [!NOTE]
>
> As duas tolerâncias começam em `0`. Um valor `0` é válido.

**Configurações avançadas** adiciona:

| Campo | Descrição |
| - | - |
| **Modo de arredondamento** | Como os valores são arredondados antes de o Matcher compará-los: `HALF_UP`, `BANKERS`, `FLOOR`, `CEIL` ou `TRUNCATE` |
| **Escala de arredondamento** | Casas decimais do arredondamento, de 0 a 10 |
| **Base do percentual** | O valor ao qual a tolerância percentual se aplica: `MAX`, `MIN`, `AVERAGE`, `LEFT` ou `RIGHT` |
| **Casar referência** | Compara as referências |
| **Comparar referências sem diferenciar maiúsculas** | Ignora maiúsculas e minúsculas quando você compara referências |
| **A referência deve estar presente** | Quando **Casar referência** está ligado, recusa um par se qualquer uma das referências estiver em branco |
| **Modo de sinal** | `same`, `opposite` ou `ignore`, como em Exata |
| **Casar valor base** | Aplica a faixa de valor aos valores base, que são os valores convertidos para a moeda base |
| **Casar moeda base** | Também exige a mesma moeda base |
| **Faixa de variação cambial** | Tolerância extra entre moedas, como fração: `0.0025` é 25 pontos-base. Uma diferença dentro dela ainda permite a correspondência e abre uma exceção de variação da taxa de câmbio |
| **Faixa de dedução de lockbox** | Quanto um conjunto de pagamentos pode pagar a menos que um conjunto de faturas na correspondência N:M, como fração do valor de face das faturas: `0.05` é 5%. A diferença fica em aberto |
| **Dias úteis e fuso horário** | O **Calendário de feriados** e o **Fuso Horário** para a comparação de datas. O fuso horário começa em UTC |
| **Alocação (1:N e N:1)** | Configurações de alocação parcial. Veja [Configurações de alocação](#allocation-settings) |
| **Campos da chave composta** | Campos nomeados extras para parear, como em Exata |

### Defasagem de data

Pareia transações que ocorrem dentro de um número definido de dias uma da outra.

Campos de primeiro nível:

| Campo | Descrição |
| - | - |
| **Mínimo de dias** | A menor defasagem em dias que permite a correspondência, de 0 a 3650. Começa em `0` |
| **Máximo de dias** | A maior defasagem em dias que permite a correspondência, de 0 a 3650. Começa em `0` |
| **Ordem esperada** | Qual lado você espera que tenha a data mais antiga: `ABS` (qualquer lado), `LEFT_BEFORE_RIGHT` ou `RIGHT_BEFORE_LEFT` |
| **Incluir o mínimo e o máximo de dias** | Inclui os dias-limite na janela de defasagem |

> [!NOTE]
>
> **Máximo de dias** deve ser igual ou maior que **Mínimo de dias**. Se você desligar **Incluir o mínimo e o máximo de dias**, **Mínimo de dias** deve ser maior que `0`.

**Configurações avançadas** adiciona:

| Campo | Descrição |
| - | - |
| **Tolerância de taxa** | A maior diferença de valor que ainda permite a correspondência. Começa em `0` |
| **Casar moeda** | Exige a mesma moeda |
| **Casar referência** | Desligado por padrão. Ligue-o para exigir referências iguais |
| **Comparar referências sem diferenciar maiúsculas** | Ignora maiúsculas e minúsculas quando você compara referências |
| **A referência deve estar presente** | Quando **Casar referência** está ligado, recusa um par se qualquer uma das referências estiver em branco |
| **Dias úteis e fuso horário** | O **Calendário de feriados**, o **Fuso Horário** e **Contar só dias úteis**. **Contar só dias úteis** mede a defasagem em dias úteis e precisa de um calendário |
| **Alocação (1:N e N:1)** | Configurações de alocação parcial. Veja [Configurações de alocação](#allocation-settings) |

### Aproximada

Pareia transações por similaridade aproximada de referência, com verificações opcionais de valor, moeda e data.

Campos de primeiro nível:

| Campo | Descrição |
| - | - |
| **Similaridade mínima** | Uma razão de 0 a 1: `0.80` é 80% de similaridade. Referências abaixo dela nunca geram correspondência. Nesse valor ou acima dele, o Matcher gradua o par em uma pontuação de confiança. Veja [Pontuação de confiança](https://docs.lerian.studio/pt/products/matcher/reference/matcher-confidence-scoring.md). Começa em `0.80` |
| **Casar valor** | Compara os valores |
| **Casar moeda** | Exige a mesma moeda |
| **Casar data** | Compara as datas |

**Configurações avançadas** adiciona:

| Campo | Descrição |
| - | - |
| **Precisão da data** | `DAY` ou `TIMESTAMP` |
| **A referência deve estar presente** | Ligado por padrão. Recusa um par se qualquer uma das referências estiver em branco |
| **Modo de sinal** | `same`, `opposite` ou `ignore` |
| **Alocação (1:N e N:1)** | Configurações de alocação parcial. Veja [Configurações de alocação](#allocation-settings) |

## Configurações de alocação

***

Cada estratégia tem um bloco **Alocação (1:N e N:1)** em **Configurações avançadas**:

| Campo | Descrição |
| - | - |
| **Permitir alocação parcial** | Divide um valor entre várias contrapartes. Um restante fica como item em aberto |
| **Divisão com taxa** | Aloca a parcela bruta de cada perna (líquido mais tarifa) em vez do valor líquido dela |
| **Direção da alocação** | `LEFT_TO_RIGHT` ou `RIGHT_TO_LEFT` |
| **Modo de tolerância da alocação** | `ABS` ou `PERCENT` |
| **Tolerância da alocação** | O restante que uma divisão pode deixar: um valor no modo `ABS` ou uma fração no modo `PERCENT` (`0.01` é 1%) |
| **Alocar sobre o valor base** | Ligue-o para alocar sobre o valor base, que é o valor convertido para a moeda base. Em regras Exata e Tolerância, o Matcher então também pareia pelo valor base e pela moeda base |

## Pré-visualizando uma regra

***

Em um contexto **Ativo**, o painel lateral da regra também mostra um painel **Prévia de casamentos**. Use-o para testar a regra antes de salvá-la.

**Step 1**

Preencha os campos da regra.

**Step 2**

Em **Prévia de casamentos**, clique em **Rodar prévia**.

O painel mostra o número de pares em **Casaria**, as contagens de **Não conciliados à esquerda** e **Não conciliados à direita**, e até 25 pares que corresponderiam. A prévia forma apenas pares 1:1. Ela não aplica normalização de tarifas, faixas de variação cambial nem alocação, então uma execução real pode gerar mais correspondências. A prévia não salva nada. Quando você muda um campo, rode a prévia de novo.

## Editando uma regra

***

Clique no botão de edição de uma regra. O painel lateral **Editar regra** abre. O campo **Estratégia** fica bloqueado. Mude os outros campos e clique em **Salvar**.

## Reordenando regras

***

Use as setas para cima e para baixo de uma linha para mover a regra. As regras são avaliadas de cima para baixo, e a primeira correspondência vence.

## Excluindo uma regra

***

Clique no botão de exclusão de uma regra. Uma caixa de diálogo mostra o tipo da regra e a prioridade dela e pede que você confirme. Clique em **Confirmar**. As outras regras mantêm a ordem delas.


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