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

> Crie e gerencie contextos de conciliação no módulo Matcher do Lerian Console: defina o tipo, o intervalo, a convenção de sinal, o envelhecimento e a normalização de tarifas e siga a próxima etapa da configuração.

Use a página **Contextos** do módulo Matcher do Lerian Console para criar e gerenciar contextos de conciliação. Um contexto agrupa as fontes, os mapas de campos, as regras e os agendamentos de uma conciliação.

## Acessando a página Contextos

***

No módulo Matcher, selecione **Configurar → Contextos**.

## Lista de contextos

***

A tabela oculta os contextos arquivados até você definir o filtro **Status** como **Arquivado**. Você também pode filtrar por **Tipo**. A lista mostra 50 contextos por página, com os controles **Anterior** e **Próximo**.

| Coluna | Descrição |
| - | - |
| **Nome** | O nome do contexto. Clique nele para abrir a página de detalhe do contexto |
| **Tipo** | Cardinalidade de correspondência: **Um para um**, **Um para muitos** ou **Muitos para muitos** |
| **Intervalo** | O rótulo de cadência do contexto |
| **Status** | Estado atual do contexto |
| **Criado** | Quando o contexto foi criado |

### Status do contexto

| Status | Descrição |
| - | - |
| **Rascunho** | Você configura o contexto antes de ativá-lo |
| **Ativo** | O contexto está operacional e aceita execuções de correspondência |
| **Pausado** | O contexto está suspenso temporariamente |
| **Arquivado** | O contexto foi aposentado. O Matcher mantém o histórico dele |

Você arquiva e restaura contextos. Você não os exclui. Veja [Ações do contexto](#context-actions).

## Criando um novo contexto

***

A página Contextos oferece duas formas de criar um contexto:

* **Novo contexto** abre um painel lateral com o formulário do contexto. Preencha os campos e clique em **Salvar**. Em seguida, o Console abre a página de detalhe do novo contexto.
* **Configurar manualmente** abre a configuração guiada. Ela leva você do formulário do contexto até uma primeira execução de correspondência em seis etapas. Veja [Assistente de configuração do contexto](https://docs.lerian.studio/pt/products/matcher/ui/context-setup-wizard.md).

Os dois caminhos criam o contexto no status **Rascunho**. O formulário tem estes campos:

| Campo | Descrição |
| - | - |
| **Nome** (obrigatório) | Um nome descritivo para o contexto, com até 100 caracteres (por exemplo, "Conciliação bancária T1") |
| **Tipo** (obrigatório) | Cardinalidade de correspondência: **Um para um** (`1:1`), **Um para muitos** (`1:N`) ou **Muitos para muitos** (`N:M`). Você não pode mudá-lo depois de criar o contexto |
| **Intervalo** (obrigatório) | Um rótulo de cadência em texto livre com até 100 caracteres, como `daily` ou `weekly`. Ele não dispara execuções. Para rodar a correspondência em horários definidos, adicione um [agendamento de conciliação](https://docs.lerian.studio/pt/products/matcher/ui/context-schedules.md) |
| **Correspondência automática no upload** | Quando ativada, uma execução de correspondência começa depois que cada upload para um contexto **Ativo** termina |
| **Como um pagamento aparece** | O sinal que um pagamento carrega ao lado da fatura ou cobrança que ele paga. Veja [Convenção de sinal](#sign-convention) |
| **Limite de envelhecimento (dias)** | Em **Envelhecimento de itens em aberto**. O número de dias depois do qual o Matcher marca um resíduo de item em aberto como envelhecido. Deixe vazio para desabilitar o envelhecimento neste contexto |
| **Calendário de envelhecimento** | Em **Envelhecimento de itens em aberto**. Como o Matcher mede a idade: **Dias corridos**, ou dias úteis **Federal dos EUA** ou **Brasil ANBIMA** |
| **Modo** | Em **Normalização de tarifas**. **Nenhum**, **Líquido** ou **Bruto**. **Líquido** compara os valores depois das tarifas. **Bruto** compara os valores antes das tarifas |
| **Tolerância abs.** e **Tolerância pct.** | Em **Normalização de tarifas**. Elas aparecem depois que você seleciona um modo. Elas definem quanto a tarifa real pode diferir da tarifa esperada. O Matcher aplica a maior das duas |

Se você selecionar um modo de normalização de tarifas, adicione uma regra de tarifa na aba [Regras de Taxas](https://docs.lerian.studio/pt/products/matcher/ui/context-fee-rules.md). Você define as próprias tabelas de tarifas em **Configurações → Tabelas de taxas**. Veja [Gerenciando tabelas de tarifas](https://docs.lerian.studio/pt/products/matcher/ui/managing-fee-schedules.md).

### Convenção de sinal

O campo **Como um pagamento aparece** tem duas opções:

* **Mesmo sinal do que ele paga** (padrão): um pagamento carrega o mesmo sinal do item que ele liquida. Um valor negativo é um estorno.
* **Sinal oposto ao do que ele paga**: um pagamento carrega o sinal oposto ao da fatura que ele liquida.

Escolha a convenção antes da primeira execução de correspondência. O Matcher recusa uma mudança depois que o contexto carrega um saldo de itens em aberto. Ele também recusa uma mudança enquanto uma execução de correspondência está em andamento.

## Página de detalhe do contexto

***

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

### Card de próximo passo

Enquanto um contexto não está pronto, um card **Próximo passo** aparece acima das abas. Ele diz o que o Matcher precisa em seguida, por exemplo: "Adicione pelo menos uma fonte do lado direito."

Clique em **Continuar a configuração** para abrir a aba onde você conclui essa etapa. O card desaparece quando o contexto atende a todos os requisitos de ativação.

### Abas

| Aba | Descrição |
| - | - |
| **Informações gerais** | Os ajustes atuais do contexto e quando ele foi criado e atualizado |
| **Fontes** | As fontes de dados do contexto. Veja [Fontes do contexto](https://docs.lerian.studio/pt/products/matcher/ui/context-sources.md) |
| **Mapas de campos** | Como as colunas de cada fonte se mapeiam para os campos que o Matcher compara. Veja [Mapas de campos do contexto](https://docs.lerian.studio/pt/products/matcher/ui/context-field-maps.md) |
| **Regras** | As regras de correspondência do contexto. Veja [Regras do contexto](https://docs.lerian.studio/pt/products/matcher/ui/context-rules.md) |
| **Agendamentos de conciliação** | Quando a correspondência roda automaticamente. Veja [Agendamentos do contexto](https://docs.lerian.studio/pt/products/matcher/ui/context-schedules.md) |
| **Regras de Taxas** | Qual tabela de tarifas se aplica a quais transações. Veja [Regras de tarifa do contexto](https://docs.lerian.studio/pt/products/matcher/ui/context-fee-rules.md) |

### Ações do contexto

As ações ficam no cabeçalho da página, então você pode usá-las em todas as abas:

| Ação | Descrição |
| - | - |
| **Editar contexto** | Abre um painel lateral com o formulário do contexto. Você pode mudar todos os campos, exceto **Tipo**. Clique em **Salvar** para aplicar |
| **Clonar contexto** | Cria um novo contexto a partir desta configuração. Digite um **Nome da cópia**. **Incluir fontes** copia as fontes e os mapas de campos delas. **Incluir regras** copia as regras de correspondência e as regras de tarifa. Clique em **Criar cópia** |
| **Arquivar contexto** | Aposenta o contexto. O Matcher mantém o histórico dele, e você pode restaurar o contexto depois |
| **Restaurar contexto** | Aparece em um contexto arquivado. Ele devolve o contexto para **Rascunho**. Ative-o de novo para retomar a correspondência |

O formulário de edição também tem um campo **Status** com **Ativo**, **Pausado** e **Arquivado**. Um contexto em **Rascunho** também lista **Rascunho**. Para pausar ou retomar um contexto, mude o status dele ali. Para ativar um contexto em **Rascunho**, defina o status dele como **Ativo**. O Matcher recusa a ativação até a configuração estar completa. O card **Próximo passo** nomeia o próximo item a configurar.

> [!NOTE]
>
> Você gerencia fontes, mapas de campos, regras, agendamentos de conciliação e regras de tarifa dentro da página de detalhe do contexto. Eles não têm páginas separadas.


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