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

# Fontes do contexto

> Adicione, edite e arquive as fontes de dados de um contexto de conciliação na aba Fontes do módulo Matcher e rode ações de ingestão em cada fonte.

Use a aba **Fontes** de um contexto no módulo Matcher do Lerian Console para configurar as fontes de dados de uma conciliação. As fontes alimentam os dois lados do contexto. Cada fonte declara o lado a que pertence e como o Matcher lê os arquivos dela.

## Acessando a aba Fontes

***

**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 **Fontes**.

## Lista de fontes

***

A aba agrupa as fontes em **Lado esquerdo** e **Lado direito**. Cada linha mostra o nome da fonte e um selo de tipo. A linha de uma fonte ativa pode mostrar estes botões:

| Botão | Ação |
| - | - |
| Calendário | [Gerenciar agendamentos de ingestão](#managing-ingestion-schedules) |
| Download | [Rodar uma busca manual](#running-a-manual-fetch) |
| Documento | [Extrair de um documento](#extracting-from-a-document) |
| Lápis | [Editar a fonte](#editing-a-source) |
| Arquivar | [Arquivar a fonte](#archiving-and-restoring-a-source) |

Selecione **Mostrar arquivadas** para incluir as fontes arquivadas. As fontes arquivadas mostram um selo **Arquivado**.

Um contexto precisa de pelo menos uma fonte ativa em cada lado antes que você possa ativá-lo. Fontes arquivadas não contam.

## Criando uma fonte

***

**Step 1**

Na aba **Fontes**, clique em **Adicionar fonte**. O painel lateral **Adicionar fonte** abre.

**Step 2**

Preencha os detalhes da fonte:

| Campo | Descrição |
| - | - |
| **Nome** (obrigatório) | Um nome para a fonte, com até 50 caracteres |
| **Tipo** | O tipo de sistema de onde os dados vêm, por exemplo **Banco** ou **Ledger**. Uma nova fonte começa como **Banco** |
| **Lado** | **Esquerda** ou **Direita**. Uma nova fonte começa como **Esquerda** |

**Step 3**

Defina como o Matcher lê e importa os arquivos da fonte:

| Seção | Descrição |
| - | - |
| **Dialeto do arquivo** | **Codificação**, **Delimitador**, **Estilo decimal** e **Formato de data**. **Automático** usa os padrões: UTF-8, delimitador vírgula, decimais com ponto e datas ISO |
| **Chave de duplicidade** | Os campos mapeados que identificam a mesma linha. Veja [Detecção de duplicatas](#duplicate-detection) |
| **Tratamento de duplicatas** | O que o Matcher faz com uma linha que repete a chave de duplicidade. Veja [Detecção de duplicatas](#duplicate-detection) |
| **Tratamento de referência em branco** | O que o Matcher faz com uma linha sem ID externo. **Rejeitar como erros** (o padrão) registra um erro de importação. **Importar para revisão** importa a linha como uma transação com status pendente de revisão |
| **Opções camt.053** | Para arquivos camt.053: a **Base de data** (data de lançamento ou data de valor) e o campo **Referência da entrada**. **Automático** usa a data de lançamento e `NtryRef` |
| **Configuração avançada (JSON)** | Configurações opcionais do parser como um objeto JSON. Deixe vazio para usar os padrões |

**Step 4**

Clique em **Salvar**.

> [!NOTE]
>
> Você mapeia as colunas da fonte para os campos do Matcher na aba [Mapas de campos](https://docs.lerian.studio/pt/products/matcher/ui/context-field-maps.md) do contexto, não no formulário da fonte. Cada fonte ativa precisa de um mapa de campos antes que você possa ativar o contexto. Uma fonte com uma opção camt.053 diferente de **Automático** não precisa de mapa. O Matcher lê arquivos camt.053 com o mapeamento ISO 20022.

## Detecção de duplicatas

***

O grupo de campos **Chave de duplicidade** define quais campos mapeados tornam duas linhas a mesma linha. Selecione um ou mais entre `external_id`, `amount`, `currency`, `date`, `description`, `fee_amount` e `fee_currency`. A chave padrão é apenas `external_id`.

Você pode selecionar `description`, `fee_amount` e `fee_currency` apenas quando o mapa de campos da fonte os preenche. Uma nova fonte ainda não tem mapa de campos, então esses três ficam indisponíveis até você mapeá-los e editar a fonte.

O formulário pode mostrar **Detecção alterada pela última vez em** com uma data. As linhas que o Matcher importou antes dessa data mantêm a chave que tinham. O Matcher não detecta uma duplicata que atravessa essa data.

O Matcher não importa uma linha que repete a chave de duplicidade de uma linha anterior. **Tratamento de duplicatas** define o que acontece em seguida:

| Opção | Resultado |
| - | - |
| **Sinalizar como exceção (padrão)** | O Matcher mantém a linha original e abre uma exceção de duplicata para revisão. Você a encontra em [Exceções](https://docs.lerian.studio/pt/products/matcher/ui/managing-exceptions.md) |
| **Manter primeiro** | O Matcher mantém a linha original e descarta a repetição. Nenhuma exceção abre |
| **Rejeitar como erros** | O Matcher registra cada repetição como um erro de importação |

## Editando uma fonte

***

Clique no botão de lápis de uma fonte. O painel lateral **Editar fonte** abre com os mesmos campos. Mude os campos e clique em **Salvar**.

## Gerenciando agendamentos de ingestão

***

Um agendamento de ingestão define quando uma fonte busca dados por conta própria. Ele é separado dos [agendamentos de conciliação](https://docs.lerian.studio/pt/products/matcher/ui/context-schedules.md) do contexto, que definem quando a correspondência roda.

**Step 1**

Clique no botão de calendário de uma fonte. O painel lateral **Agendamentos de ingestão** abre. Ele lista os agendamentos da fonte, habilitados e desabilitados.

**Step 2**

Clique em **Adicionar agendamento de ingestão**.

**Step 3**

Preencha o agendamento:

| Campo | Descrição |
| - | - |
| **Trilho** | **Arquivo** busca arquivos por um transporte. **Consulta** lê dados por uma [conexão de discovery](https://docs.lerian.studio/pt/products/matcher/ui/discovery-connections.md). Você não pode mudar o trilho depois |
| **Formato** (obrigatório) | O formato dos dados que o agendamento busca |
| **Agendamento** (obrigatório) | Com que frequência a fonte busca dados, como uma duração positiva, por exemplo `15m`, `1h` ou `24h`. A sintaxe cron é recusada |
| **Habilitado** | Ligado por padrão. Um agendamento desabilitado não roda |
| **Transporte** | Para um trilho **Arquivo**: o **Protocolo**, o **Host**, o **Caminho** e os outros campos do endpoint remoto. **Host** é obrigatório |
| **Conexão** | Para um trilho **Consulta**: a conexão de discovery de onde ler os dados |

**Step 4**

Clique em **Criar agendamento**.

Para mudar um agendamento, clique no botão de lápis dele, mude os campos e clique em **Salvar**. Para excluir um agendamento, clique no botão de lixeira dele. Na caixa de diálogo **Excluir agendamento de ingestão?**, clique em **Excluir**. O agendamento para de rodar, e você não pode desfazer a exclusão.

## Rodando uma busca manual

***

Uma busca manual traz arquivos de um endpoint remoto e os importa agora.

**Step 1**

Clique no botão de download de uma fonte. O painel lateral **Executar busca manual** abre.

**Step 2**

Preencha os campos de **Transporte**. O painel marca os campos obrigatórios.

**Step 3**

Opcionalmente, digite uma **Dica de formato (opcional)**, como `csv`. O Matcher a usa para arquivos que não declaram um formato.

**Step 4**

Clique em **Executar busca**.

Em seguida, o painel lista cada arquivo que processou, com a contagem de transações ou o erro dele. Quando nenhum arquivo corresponde ao caminho, o painel informa isso. Quando a busca manual está desligada, o painel mostra uma mensagem e não busca nada.

## Extraindo de um documento

***

Use a extração de documentos para obter as transações de um extrato em PDF. O Matcher envia um trecho limitado da camada de texto do documento para o provedor de modelo de linguagem que a Lerian configura para o seu ambiente. Quando o PDF não tem camada de texto, o Matcher envia o próprio PDF. O Matcher propõe transações candidatas. O Matcher não importa nada até você aprová-las.

**Step 1**

Clique no botão de documento de uma fonte. A caixa de diálogo **Extrair de um documento** abre.

**Step 2**

Selecione um arquivo PDF em **Documento PDF**. O arquivo pode ter até 100 MB.

**Step 3**

Clique em **Extrair**.

**Step 4**

Quando a caixa de diálogo mostrar o número de candidatas, clique em **Abrir revisão**. Você revisa as candidatas na página [Revisão de extração](https://docs.lerian.studio/pt/products/matcher/ui/extraction-review.md).

Quando a extração de documentos está desligada, a caixa de diálogo mostra uma mensagem e não extrai nada.

## Arquivando e restaurando uma fonte

***

Você não pode excluir uma fonte. Em vez disso, você a arquiva. Uma fonte arquivada sai das fontes ativas, da prontidão da configuração e da correspondência do contexto. O Matcher mantém as transações importadas e o mapa de campos dela.

**Step 1**

Clique no botão de arquivar de uma fonte. A caixa de diálogo **Arquivar fonte?** abre.

**Step 2**

Clique em **Arquivar** seguido do nome da fonte.

**Step 3**

Para trazer a fonte de volta, selecione **Mostrar arquivadas** e clique no botão de restaurar da fonte. Na caixa de diálogo **Restaurar fonte?**, clique em **Restaurar** seguido do nome da fonte.


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