> ## 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 e edite fontes de dados na aba Fontes da página de configuração de um contexto, na interface do Matcher: escolha um tipo e um lado, defina o dialeto do arquivo e as políticas de ingestão.
Use a aba **Fontes** na página de configuração de um contexto para configurar e gerenciar as fontes de dados da conciliação. As fontes alimentam os dois lados do contexto: cada fonte declara a qual lado pertence e como o motor deve tratar os dados dela.
## Como acessar a aba Fontes
***
Vá para **Configurar → Contextos** na barra lateral esquerda.
Selecione um contexto na lista para abrir a página de configuração dele.
Selecione a aba **Fontes**.
O controle **Contexto ativo** global na barra lateral permite trocar o contexto de conciliação ativo a qualquer momento.
## Lista de fontes
***
Esta visão mostra até 100 fontes e não tem controles de paginação. A visão agrupa as fontes por lado (**lado LEFT** / **lado RIGHT**). Cada linha de fonte ativa mostra o nome e o tipo dela. Conforme as suas permissões, ela também pode oferecer ações para gerenciar agendamentos de ingestão, rodar uma busca manual, extrair de um documento, editar ou arquivar. Um toggle **Mostrar arquivadas** inclui as fontes arquivadas. Elas trazem um selo **Arquivado** e oferecem apenas a restauração.
A prontidão da configuração exige pelo menos uma fonte `LEFT` viva e uma fonte `RIGHT` viva. Fontes arquivadas não contam.
## Criar uma fonte
***
Na aba **Fontes**, clique no botão **Adicionar fonte**.
Uma caixa de diálogo abre. Preencha os detalhes da fonte:
| Campo | Descrição |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **Nome** (obrigatório) | Um nome descritivo para a fonte (até 50 caracteres) |
| **Tipo** (obrigatório) | O tipo da fonte. Fontes novas começam com `BANK` selecionado: `LEDGER`, `BANK`, `GATEWAY`, `CUSTOM` ou `FETCHER` |
| **Lado** (obrigatório) | Qual lado da conciliação a fonte alimenta. Fontes novas começam com `LEFT` selecionado: `LEFT` ou `RIGHT` |
Configure como o motor interpreta e ingere os arquivos da fonte:
| Seção | Descrição |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Dialeto do arquivo** | **Codificação** (`UTF-8`, `UTF-8 with BOM`, `Windows-1252`, `ISO-8859-1`), **Delimitador** (vírgula, ponto e vírgula, tabulação, barra vertical), **Estilo decimal** (ponto `1234.56` ou vírgula `1.234,56`) e **Formato de data** (ISO, ISO com offset, dia primeiro, mês primeiro). Deixe em **Auto** para usar os padrões do servidor (UTF-8 / vírgula / ponto / ISO); o Auto não detecta o dialeto de um arquivo |
| **Chave de duplicidade** | Quais campos mapeados definem a mesma linha. Deixe em `external_id` a menos que você precise de uma identidade composta; uma fonte ligada a uma conexão de agregador não pode usar uma chave personalizada. |
| **Tratamento de duplicatas** | O que fazer quando um arquivo repete essa chave: **Sinalizar como exceção (padrão)** abre uma exceção de duplicata na transação sobrevivente, **Manter primeiro** descarta a repetição em silêncio e **Rejeitar como erros** registra um erro de importação |
| **Tratamento de referência em branco** | O que fazer quando uma linha não tem ID externo mapeado: **Rejeitar como erros (padrão)** registra um erro de importação; **Importar para revisão** cria uma transação pendente de revisão na bancada de não conciliados |
| **Opções camt.053** | Para uploads camt.053: **Base de data** (data de lançamento `BookgDt` ou data de valor `ValDt`) e qual campo usar como **Referência da entrada** (`NtryRef`, `EndToEndId` ou `TxId`). Deixe os dois controles em **Auto** para a data de lançamento e `NtryRef` |
| **Configuração avançada (JSON)** | Configuração opcional da fonte como um objeto JSON. Deixe vazio para os padrões. Para falhar um job de ingestão apenas quando as linhas com falha passarem estritamente de um limiar, defina `fail_on_error_rate_percent` com um inteiro de 1 a 99; omita-o para nunca falhar automaticamente por causa da taxa de erro de linha |
Clique em **Criar fonte**.
O mapeamento de campos não faz parte do formulário da fonte. Configure como as colunas da fonte mapeiam para os campos da conciliação na aba **Mapas de campos** separada. Para uploads de CSV, JSON e XML, cada fonte viva precisa de um mapa de campos para a prontidão da configuração. Vale uma **exceção do camt.053**: escolher uma opção camt.053 diferente de **Auto** declara a fonte como automapeada para a prontidão. Em todo upload camt.053, o parser usa o mapeamento ISO 20022 embutido nele e ignora um mapa de campos. Se os dois controles camt.053 ficarem em **Auto**, nenhuma declaração `camt053` é salva, então a prontidão continua esperando um mapa de campos.
## Tipos de fonte
***
| Tipo | Descrição |
| ----------- | -------------------------------------------------- |
| **LEDGER** | Dados do ledger interno |
| **BANK** | Dados de um feed de extrato bancário |
| **GATEWAY** | Dados de um gateway de pagamento |
| **CUSTOM** | Dados de um feed sob medida |
| **FETCHER** | Dados de uma coleta feita pelo motor de descoberta |
## Editar uma fonte
***
Clique no botão de edição de uma fonte para abrir a caixa de diálogo. Atualize os campos conforme precisar e clique em **Salvar alterações**.
## Arquivar e restaurar uma fonte
***
As fontes nunca são excluídas em definitivo. Arquivar é o único caminho de remoção.
Clique no botão de arquivamento de uma fonte. Uma caixa de diálogo de confirmação **Arquivar fonte?** aparece. Clique em **Arquivar**.
A fonte sai da lista de ativas. Ligue **Mostrar arquivadas** para vê-la com o selo **Arquivado**.
Para trazê-la de volta, clique no botão de restauração da fonte arquivada e confirme na caixa de diálogo **Restaurar fonte?**.