> ## 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 na Matcher UI: defina cardinalidade, intervalo, tolerância de tarifa, aging e correspondência automática e depois ligue fontes, mapas de campo, regras e agendamentos.

Use a página **Contextos** da Matcher UI para criar e gerenciar contextos de conciliação. Um contexto reúne as fontes, os mapas de campo, as regras e os agendamentos que definem um workflow específico de conciliação.

## Acessando a página de Contextos

***

Para abrir a página **Contextos**, selecione **Contextos** na seção **Configurar** da barra lateral esquerda.

## Lista de contextos

***

<Frame caption="Figura 1. A página de lista de Contextos.">
  <img src="https://mintcdn.com/lerian-49cb71fc/kb1KNsLI0JW1ssLF/en/products/matcher/ui/images/02-contexts-list.jpg?fit=max&auto=format&n=kb1KNsLI0JW1ssLF&q=85&s=3389b6019d424b6ec2da5e794dd77b06" alt="Página de lista de Contextos do Matcher mostrando os contextos de conciliação configurados" width="2000" height="1258" data-path="en/products/matcher/ui/images/02-contexts-list.jpg" />
</Frame>

A tabela mostra todos os contextos de conciliação com as seguintes colunas:

| Coluna        | Descrição                                                |
| ------------- | -------------------------------------------------------- |
| **Nome**      | O nome do contexto                                       |
| **Tipo**      | Cardinalidade de correspondência (`1:1`, `1:N` ou `N:M`) |
| **Intervalo** | Com que frequência a conciliação roda                    |
| **Status**    | Estado atual do contexto                                 |
| **Criado**    | Quando o contexto foi criado                             |

### Status do contexto

| Status        | Descrição                                                     |
| ------------- | ------------------------------------------------------------- |
| **Ativo**     | O contexto está operacional e aceita execuções de conciliação |
| **Pausado**   | O contexto está suspenso temporariamente                      |
| **Rascunho**  | O contexto está sendo configurado e ainda não está ativo      |
| **Arquivado** | O contexto não está mais em uso e foi arquivado               |

Clique no nome de um contexto para abrir a página de detalhe dele. Você arquiva e restaura contextos em vez de excluí-los. Veja [Ações do contexto](#context-actions) abaixo.

## Criando um novo contexto

***

Clique em **Novo contexto** na página Contextos para abrir o assistente guiado de configuração. O assistente é o único caminho para criar um contexto. O primeiro passo coleta a configuração do contexto:

<Steps>
  <Step>
    Preencha os campos gerais:

    | Campo                       | Descrição                                                                                                                                                                                                                             |
    | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Nome** (obrigatório)      | Um nome descritivo para o contexto (por exemplo, "Conciliação bancária T1")                                                                                                                                                           |
    | **Tipo** (obrigatório)      | Cardinalidade de correspondência: `1:1` (um para um), `1:N` (um para muitos) ou `N:M` (muitos para muitos)                                                                                                                            |
    | **Intervalo** (obrigatório) | Com que frequência a conciliação roda. Escolha o preset `Daily`, `Weekly` ou `Monthly`, ou selecione `Custom` e digite qualquer rótulo de cadência (por exemplo, "a cada 4 horas"). O backend guarda o intervalo como um rótulo livre |
  </Step>

  <Step>
    Se quiser, configure a **Normalização de tarifa**, o método de conciliação de tarifas e a variação permitida:

    | Campo                     | Descrição                                                                               |
    | ------------------------- | --------------------------------------------------------------------------------------- |
    | **Modo**                  | Método usado para normalizar os valores de tarifa antes da comparação: `NET` ou `GROSS` |
    | **Tolerância absoluta**   | Diferença absoluta máxima permitida entre valores correspondidos                        |
    | **Tolerância percentual** | Diferença percentual máxima permitida entre valores correspondidos                      |
  </Step>

  <Step>
    Se quiser, configure o **Aging de itens em aberto** para marcar como envelhecido um resíduo de item em aberto carregado assim que ele passa de um número de dias:

    | Campo                      | Descrição                                                                                                                       |
    | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
    | **Limite de aging (dias)** | Número de dias depois do qual um item em aberto é marcado como envelhecido. Deixe vazio para desabilitar o aging neste contexto |
    | **Calendário de aging**    | Como a idade é medida: `Raw calendar days`, `US Federal` ou dias úteis `Brazil ANBIMA`                                          |
  </Step>

  <Step>
    Se quiser, habilite a **Correspondência automática no upload**. Quando você liga essa opção, uma execução de correspondência começa automaticamente depois de cada ingestão de arquivo neste contexto.
  </Step>

  <Step>
    Clique em **Criar contexto** no rodapé do assistente. O assistente então guia você por adicionar fontes, mapas de campo e regras de correspondência.
  </Step>
</Steps>

## Página de detalhe do contexto

***

Clique no nome de um contexto na lista para abrir a página de detalhe dele. A página de detalhe tem seis abas:

<Frame caption="Figura 2. Página de detalhe do contexto com as abas de configuração.">
  <img src="https://mintcdn.com/lerian-49cb71fc/kb1KNsLI0JW1ssLF/en/products/matcher/ui/images/03-context-detail.jpg?fit=max&auto=format&n=kb1KNsLI0JW1ssLF&q=85&s=d3ca3437af32a7bcdcb42fe05ab378a0" alt="Página de detalhe do contexto do Matcher com as seções Fontes, Regras, Regras de tarifa e Agendamentos" width="2000" height="1254" data-path="en/products/matcher/ui/images/03-context-detail.jpg" />
</Frame>

| Aba                    | Descrição                                                                                                                                                     |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Informações gerais** | Os ajustes atuais do contexto: nome, tipo, intervalo, tolerância de tarifa, aging e configuração de correspondência automática                                |
| **Fontes**             | Fontes de dados configuradas para este contexto. Veja [Fontes do contexto](/pt/products/matcher/ui/context-sources)                                           |
| **Mapas de campo**     | Mapeamentos de campo que ligam as colunas de cada fonte aos campos da conciliação                                                                             |
| **Regras**             | Regras de correspondência configuradas para este contexto. Veja [Regras do contexto](/pt/products/matcher/ui/context-rules)                                   |
| **Regras de tarifa**   | Regras de tarifa que ligam tabelas de tarifas às transações deste contexto                                                                                    |
| **Agendamentos**       | Agendamentos de conciliação que definem quando as execuções rodam automaticamente. Veja [Agendamentos do contexto](/pt/products/matcher/ui/context-schedules) |

<h3 id="context-actions">
  Ações do contexto
</h3>

O cabeçalho da página mostra o nome do contexto, o badge de status, o tipo, o intervalo e a data de criação, junto com as seguintes ações:

| Ação                   | Descrição                                                                                                                                                                                                                                                                                                    |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Editar contexto**    | Abre uma caixa de diálogo para atualizar o nome do contexto, o intervalo, o status (`ACTIVE`, `PAUSED` ou `ARCHIVED`), a correspondência automática, a normalização de tarifa e os ajustes de aging. Clique em **Salvar mudanças** para aplicar. Para pausar ou retomar um contexto, mude o status dele aqui |
| **Clonar contexto**    | Cria um novo contexto a partir desta configuração. Você pode escolher se o clone inclui fontes e regras                                                                                                                                                                                                      |
| **Arquivar contexto**  | Aposenta o contexto. O arquivamento substitui a exclusão — o contexto e o histórico dele são preservados                                                                                                                                                                                                     |
| **Restaurar contexto** | Traz de volta um contexto arquivado                                                                                                                                                                                                                                                                          |

<Note>
  Você gerencia fontes, mapas de campo, regras, regras de tarifa e agendamentos dentro da página de detalhe do contexto. Não existem páginas separadas e independentes para essas entidades.
</Note>
