> ## 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
> Defina regras de matching que controlam como o motor pareia transações entre fontes de dados para resultados precisos.
Use a seção **Regras** na Matcher UI para definir e gerenciar as regras de matching que controlam como as transações são pareadas durante a reconciliação. As regras especificam os critérios que o motor de matching usa para identificar transações correspondentes entre fontes de dados. As regras são gerenciadas a partir da página de detalhes do contexto.
## Acessando a seção de Regras
***
Navegue até **Reconciliação > Contextos** na barra lateral esquerda.
Selecione um contexto da lista para abrir sua página de detalhes.
Role até a seção **Regras de matching**.
O **Seletor de contexto** global na barra lateral permite trocar o contexto de reconciliação ativo a qualquer momento.
## Lista de regras
***
A tabela lista todas as regras de matching configuradas para o contexto selecionado, incluindo sua prioridade, tipo e configuração.
## Criando uma regra
***
Na seção **Regras de matching** da página de detalhes do contexto, clique no botão **Nova regra**.
Um painel lateral será aberto. Preencha os detalhes da regra:
| Campo | Descrição |
| ------------------------------- | --------------------------------------------------------------------------- |
| **Prioridade** (obrigatório) | Ordem de execução (1–1000). Números menores executam primeiro. |
| **Tipo de regra** (obrigatório) | A estratégia de matching a ser aplicada: `EXACT`, `TOLERANCE` ou `DATE_LAG` |
Dependendo do tipo de regra, campos adicionais aparecem (veja abaixo).
Clique em **Salvar regra** para criar a regra.
## Tipos de regra
***
### EXACT
Pareia transações comparando um ou mais campos para igualdade exata.
A seção **Configurações avançadas** expõe os seguintes campos e opções:
| Campo | Descrição |
| ----------------------------- | -------------------------------------------------------------------- |
| **Amount** | Ative para parear por valor da transação |
| **Match currency** | Ative para exigir correspondência de moeda |
| **Date** | Ative para parear por data da transação |
| **Match reference** | Ative para parear por campo de referência |
| **Date Precision** | Nível de precisão para o matching de datas: `DAY` ou `TIMESTAMP` |
| **Case insensitive matching** | Ative para ignorar maiúsculas/minúsculas ao comparar campos de texto |
| **Reference must be set** | Ative para exigir um valor de referência para o match |
### TOLERANCE
Pareia transações dentro de um intervalo de tolerância numérica ou de data.
| Campo | Descrição |
| ---------------------------------- | ---------------------------------------------------------- |
| **Tolerância de valor (absoluta)** | Diferença absoluta máxima permitida no valor |
| **Tolerância de valor (%)** | Diferença percentual máxima permitida (ex: `0.05` para 5%) |
| **Janela de data (dias)** | Número de dias de tolerância para o matching de datas |
Pelo menos um valor de tolerância deve ser fornecido e deve ser maior que zero.
A seção **Configurações avançadas** para regras TOLERANCE também inclui:
| Campo | Descrição |
| ----------------------------- | --------------------------------------------------------------------------------------------------------- |
| **Rounding Mode** | Como os valores são arredondados antes da comparação: `HALF_UP`, `BANKERS`, `FLOOR`, `CEIL` ou `TRUNCATE` |
| **Rounding Scale** | Número de casas decimais para arredondamento (0–10) |
| **Percentage Base** | Valor base para cálculos percentuais: `MAX`, `MIN`, `AVERAGE`, `LEFT` ou `RIGHT` |
| **Match currency** | Ative para exigir correspondência de moeda |
| **Match reference** | Ative para parear por campo de referência |
| **Case insensitive matching** | Ative para ignorar maiúsculas/minúsculas ao comparar campos de texto |
| **Reference must be set** | Ative para exigir um valor de referência |
### DATE\_LAG
Pareia transações que ocorrem dentro de um número configurável de dias uma da outra.
| Campo | Descrição |
| -------------------------- | --------------------------------------------------------------------- |
| **Min Days** (obrigatório) | Dias mínimos de deslocamento permitidos entre as datas das transações |
| **Max Days** (obrigatório) | Dias máximos de deslocamento permitidos entre as datas das transações |
A seção **Configurações avançadas** para regras DATE\_LAG também inclui:
| Campo | Descrição |
| ------------------- | ---------------------------------------------------------------------------------- |
| **Inclusive range** | Ative para incluir os dias limites no intervalo |
| **Direction** | Restrição de direção: `ABS` (absoluto), `LEFT_BEFORE_RIGHT` ou `RIGHT_BEFORE_LEFT` |
| **Fee Tolerance** | Valor de tolerância de tarifa para o matching de date lag |
| **Match currency** | Ative para exigir correspondência de moeda |
## Configurações avançadas (todos os tipos de regra)
***
Todos os tipos de regra compartilham estas opções avançadas:
| Campo | Descrição |
| ----------------------- | ----------------------------------------------------------------- |
| **Match base amount** | Ative para também parear pelo valor base (antes da conversão) |
| **Match base currency** | Ative para também parear pela moeda base |
| **Match Score** | Pontuação de confiança atribuída a um match primário (0–100) |
| **Base Match Score** | Pontuação de confiança atribuída a um match de valor base (0–100) |
## Configurações de alocação
***
Todos os tipos de regra incluem uma seção **Configurações de alocação** para configurar o comportamento de alocação parcial:
| Campo | Descrição |
| ---------------------------------- | -------------------------------------------------------------------------- |
| **Allow partial allocation** | Ative para permitir parear uma transação com múltiplas contrapartes |
| **Use base amount for allocation** | Ative para usar o valor base em vez do valor convertido para a alocação |
| **Allocation Direction** | Direção da alocação: `LEFT_TO_RIGHT` ou `RIGHT_TO_LEFT` |
| **Tolerance Mode** | Como a tolerância de alocação é medida: `ABS` (absoluto) ou `PERCENT` |
| **Tolerance Value** | Limite de tolerância de alocação (absoluto ou percentual com base no modo) |
## Editando uma regra
***
Clique no ícone de edição ao lado de uma regra para abrir o painel de edição. Atualize os campos conforme necessário e clique em **Atualizar regra**.
## Excluindo uma regra
***
Clique no ícone de exclusão ao lado de uma regra e confirme a exclusão.