Regras do contexto

Use a aba Rules na página de configuração de um contexto 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.

Acessando a aba Rules

Navegue até Configurar → Contextos na barra lateral esquerda.

Selecione um contexto da lista para abrir sua página de configuração.

Selecione a aba Rules.

O Seletor de contexto global na barra lateral permite trocar o contexto de reconciliação ativo a qualquer momento.

Lista de regras

A aba Rules mostra as regras de matching em ordem de prioridade. As regras são avaliadas de cima para baixo; a primeira correspondência vence. Cada linha visível mostra a estratégia e um resumo curto da configuração da regra, com setas Move rule up / Move rule down, um botão Edit rule e um botão Delete rule. Com 100 regras ou menos, a prioridade é atribuída automaticamente ao criar uma regra: a nova regra é adicionada ao final da cadeia. Para mudar a precedência, reordene a lista com as setas para cima/baixo. O formulário não tem campo de prioridade.

A aba Rules carrega somente as primeiras 100 regras por prioridade e não oferece paginação. Você não consegue ver nem gerenciar aqui as regras posteriores. Add rule calcula a nova prioridade a partir dessas 100 regras; quando uma regra com prioridade 101 fica oculta, a próxima tentativa de criação entra em conflito com ela e falha.

Criando uma regra

Na aba Rules, clique no botão Add rule.

Um diálogo é aberto. Selecione uma Strategy:

Estratégia	Descrição
Exact	Igualdade campo a campo
Tolerance	Valor/data dentro de uma faixa
Date lag	Janela de atraso de liquidação
Fuzzy	Similaridade aproximada de referências

Dependendo da estratégia, campos diferentes aparecem (veja abaixo).

Clique em Create rule.

A estratégia fica fixa após a criação. Para mudar a estratégia de uma regra, exclua a regra e recrie-a.

Tipos de regra

EXACT

Pareia transações comparando campos por igualdade exata. Opções de nível superior:

Campo	Descrição
Match amount	Compara os valores das transações
Match currency	Exige igualdade de moeda
Match date	Compara as datas das transações
Match reference	Compara os campos de referência

A seção Advanced adiciona:

Campo	Descrição
Date precision	Precisão da comparação de datas: `DAY` ou `TIMESTAMP`
Case-insensitive reference compare	Ignora maiúsculas/minúsculas ao comparar referências
Reference must be present	Quando Match reference está ativado, exige um valor de referência não vazio
Match base amount	Pareia também o valor base (pré-conversão)
Match base currency	Pareia também a moeda base
Sign mode	Como os sinais dos valores são comparados: `same` pareia sinais iguais, `opposite` pareia um estorno contra sua cobrança, `ignore` compara apenas magnitudes
Match score	Valor de configuração aceito (0–100). Ele é armazenado, mas não determina a confiança atribuída, que usa os componentes de comparação ponderados e fixos do mecanismo
Base-match score	Valor de configuração aceito (0–100). Ele é armazenado, mas não determina a confiança atribuída
Allocation (1:N / N:1)	Configurações de alocação parcial (veja abaixo)
Match fields	Editor de chave composta para parear campos adicionais nomeados, combinado com as opções acima

TOLERANCE

Pareia transações dentro de uma faixa de tolerância numérica ou de data. Campos de nível superior:

Campo	Descrição
Absolute tolerance	Tolerância fixa de valor. A faixa de valor efetiva usa a maior entre esta e a tolerância de valor derivada do percentual
Percent tolerance	Tolerância de valor derivada do percentual (por exemplo, `0.005` = 0,5%). A faixa de valor efetiva usa a maior entre esta e a tolerância absoluta
Date window (days)	Desvio de data permitido entre os lados (0–3650)
Match currency	Exige igualdade de moeda

Tolerâncias em zero são válidas: ambos os valores têm 0 como padrão, o que faz a faixa de valor exigir igualdade após o arredondamento padrão HALF_UP na escala 2.

A seção Advanced adiciona:

Campo	Descrição
Rounding mode	Como os valores são arredondados antes da comparação: `HALF_UP`, `BANKERS`, `FLOOR`, `CEIL` ou `TRUNCATE`
Rounding scale	Casas decimais para o arredondamento (0–10)
Percentage base	Contra qual lado a tolerância percentual é medida: `MAX`, `MIN`, `AVERAGE`, `LEFT` ou `RIGHT`
Match reference	Compara os campos de referência
Case-insensitive reference compare	Ignora maiúsculas/minúsculas ao comparar referências
Reference must be present	Quando Match reference está ativado, exige um valor de referência não vazio
Match base amount / Match base currency	Pareia também o valor/a moeda base
Sign mode	`same`, `opposite` ou `ignore` (como em EXACT)
Match score / Base-match score	Valores de configuração aceitos (0–100). Eles são armazenados, mas não determinam a confiança atribuída, que usa os componentes de comparação ponderados e fixos do mecanismo
FX variance band	Tolerância extra entre moedas acima da faixa de matching, como fração decimal (`0.0001` = 1 ponto-base). Um resíduo dentro dela ainda pareia e registra uma exceção de variância de câmbio; `0` desativa
Lockbox deduction band	Tolerância de pagamento a menor para matching N:M de lockbox, como fração decimal do valor de face da fatura (`0.05` = 5%); `0` desativa
Business-day & timezone	Calendário de feriados e fuso horário para a comparação de datas
Allocation (1:N / N:1)	Configurações de alocação parcial (veja abaixo)
Match fields	Editor de chave composta, como em EXACT

DATE_LAG

Pareia transações que ocorrem dentro de um número configurável de dias entre si. Campos de nível superior:

Campo	Descrição
Min days	Defasagem mínima de dias permitida (0–3650; padrão `0`)
Max days	Defasagem máxima de dias permitida (0–3650; padrão `0`)
Direction	Qual lado deve ser anterior: `ABS` (absoluto), `LEFT_BEFORE_RIGHT` ou `RIGHT_BEFORE_LEFT`
Inclusive bounds	Inclui os limites de dias mín./máx.

Max days deve ser maior ou igual a Min days. Limites exclusivos (Inclusive bounds desativado) com Min days em 0 são rejeitados, porque excluiriam transações do mesmo dia.

A seção Advanced adiciona:

Campo	Descrição
Fee tolerance	Diferença absoluta máxima entre os valores das transações (padrão `0`)
Match currency	Exige igualdade de moeda
Match reference	Desativado por padrão; ative para exigir igualdade de referência
Case-insensitive reference compare	Ignora maiúsculas/minúsculas ao comparar referências
Reference must be present	Quando Match reference está ativado, exige um valor de referência não vazio
Match score	Valor de configuração aceito (0–100). Ele é armazenado, mas não determina a confiança atribuída, que usa os componentes de comparação ponderados e fixos do mecanismo
Business-day & timezone	Holiday calendar (`US Federal` ou `Brazil ANBIMA`), Timezone (zona IANA, UTC por padrão) e Count business days only: mede a defasagem em dias úteis, pulando fins de semana e feriados do calendário. Requer um calendário
Allocation (1:N / N:1)	Configurações de alocação parcial (veja abaixo)

Regras DATE_LAG não têm opções de valor base (Match base amount / Match base currency só estão disponíveis em EXACT e TOLERANCE).

FUZZY

Pareia transações por similaridade aproximada de referências, com verificações financeiras configuráveis de valor, moeda e data. Pareamentos fuzzy sempre são propostos para revisão; nunca são confirmados automaticamente. Campos de nível superior:

Campo	Descrição
Minimum similarity	Limiar de similaridade de referências como razão de 0 a 1 (`0.80` = 80% de similaridade). Referências abaixo dele são rejeitadas; se o atingirem e as verificações financeiras ativadas passarem, o par recebe uma pontuação de confiança graduada. Padrão `0.80`
Match amount	Compara os valores das transações
Match currency	Exige igualdade de moeda
Match date	Compara as datas das transações

A seção Advanced adiciona:

Campo	Descrição
Date precision	`DAY` ou `TIMESTAMP`
Reference must be present	Ativado por padrão: duas referências vazias seriam comparadas como totalmente similares
Sign mode	`same`, `opposite` ou `ignore`
Match score	Valor de configuração aceito (0–100; padrão `70`). Ele é armazenado, mas não determina a confiança atribuída; a confiança fuzzy usa os componentes ponderados e fixos do mecanismo e a similaridade de referência graduada
Allocation (1:N / N:1)	Configurações de alocação parcial (veja abaixo)

Regras FUZZY não têm opção de igualdade de referência nem opções de valor base.

Configurações de alocação

As regras EXACT, TOLERANCE, DATE_LAG e FUZZY incluem um bloco Allocation (1:N / N:1) dentro da seção Advanced:

Campo	Descrição
Allow partial allocation	Pareia um conjunto de itens contra uma contraparte, dividindo o valor entre eles; o restante não alocado segue como item em aberto
Fee-aware split	Consome a parcela bruta de cada perna (líquido + tarifa) da contraparte em vez de apenas seu valor líquido. Desativado usa apenas o líquido
Allocation direction	Ordem em que as pernas são consumidas; padrão da esquerda para a direita
Allocation tolerance mode	Como o resíduo é limitado: `ABS` (valor absoluto) ou `PERCENT` (fração, `0.01` = 1%). Padrão `ABS`
Allocation tolerance value	Resíduo que a divisão pode deixar; padrão `0`
Allocate on base amount	Usa o valor base em vez do convertido para a alocação

Pré-visualizando uma regra

O diálogo da regra inclui um painel Preview matches. Clique em Run preview para testar a regra antes de salvar. A prévia é somente leitura: usa até 5.000 transações não pareadas com extração concluída, forma apenas pares 1:1 e não aplica normalização de tarifas, bandas de variação de FX nem alocação. O painel mostra quantos pares fariam match (Would match), as contagens não pareadas de cada lado e até 25 pares candidatos com maior pontuação. Nada é salvo.

Editando uma regra

Clique no botão Edit rule de uma regra para abrir o diálogo. O seletor Strategy fica desabilitado: a estratégia é fixa após a criação. Atualize os demais campos e clique em Save changes.

Reordenando regras

Use as setas Move rule up / Move rule down na lista para mudar a precedência das regras. As regras são avaliadas de cima para baixo; a primeira correspondência vence.

Excluindo uma regra

Clique no botão Delete rule de uma regra e confirme no diálogo Delete rule?. A regra é removida da cadeia; as demais regras mantêm sua ordem.

Visão geral

Guias

Matcher UI

Servidor MCP

Operações

Regras do contexto

Acessando a aba Rules

Lista de regras

Criando uma regra

Tipos de regra

EXACT

TOLERANCE

DATE_LAG

FUZZY

Configurações de alocação

Pré-visualizando uma regra

Editando uma regra

Reordenando regras

Excluindo uma regra

​Acessando a aba Rules

​Lista de regras

​Criando uma regra

​Tipos de regra

​EXACT

​TOLERANCE

​DATE_LAG

​FUZZY

​Configurações de alocação

​Pré-visualizando uma regra

​Editando uma regra

​Reordenando regras

​Excluindo uma regra

Acessando a aba Rules

Lista de regras

Criando uma regra

Tipos de regra

EXACT

TOLERANCE

DATE_LAG

FUZZY

Configurações de alocação

Pré-visualizando uma regra

Editando uma regra

Reordenando regras

Excluindo uma regra