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

# Fuentes del contexto

> Agrega y edita fuentes de datos desde la pestaña Sources de la página de configuración de un contexto en la interfaz de Matcher: elige un tipo y un lado, y define el dialecto de archivo y las políticas de ingesta.

Usa la pestaña **Sources** en la página de configuración de un contexto para configurar y gestionar las fuentes de datos para la conciliación. Las fuentes alimentan los dos lados del contexto: cada fuente declara a qué lado pertenece y cómo debe tratar el motor sus datos.

## Cómo acceder a la pestaña Sources

***

<Steps>
  <Step>
    Navega a **Configure → Contexts** en la barra lateral izquierda.
  </Step>

  <Step>
    Selecciona un contexto de la lista para abrir su página de configuración.
  </Step>

  <Step>
    Selecciona la pestaña **Sources**.
  </Step>
</Steps>

<Note>
  El control global **Active context** en la barra lateral permite cambiar el contexto de conciliación activo en cualquier momento.
</Note>

## Lista de fuentes

***

Esta vista muestra hasta 100 fuentes y no tiene controles de paginación. La vista agrupa las fuentes por lado (**LEFT side** / **RIGHT side**). Cada fila de fuente activa muestra su nombre y tipo. Según tus permisos, también puede ofrecer acciones para gestionar las programaciones de ingesta, ejecutar una obtención manual, extraer desde un documento, editar o archivar. Un toggle **Show archived** incluye las fuentes archivadas. Estas llevan una insignia **Archived** y solo ofrecen la restauración.

La preparación de la configuración requiere al menos una fuente `LEFT` activa y una fuente `RIGHT` activa. Las fuentes archivadas no cuentan.

## Cómo crear una fuente

***

<Steps>
  <Step>
    En la pestaña **Sources**, haz clic en el botón **Add source**.
  </Step>

  <Step>
    Se abre un diálogo. Completa los detalles de la fuente:

    | Campo                  | Descripción                                                                                                               |
    | ---------------------- | ------------------------------------------------------------------------------------------------------------------------- |
    | **Name** (obligatorio) | Un nombre descriptivo para la fuente (hasta 50 caracteres)                                                                |
    | **Type** (obligatorio) | El tipo de fuente. Las fuentes nuevas empiezan con `BANK` seleccionado: `LEDGER`, `BANK`, `GATEWAY`, `CUSTOM` o `FETCHER` |
    | **Side** (obligatorio) | Qué lado de la conciliación alimenta la fuente. Las fuentes nuevas empiezan con `LEFT` seleccionado: `LEFT` o `RIGHT`     |
  </Step>

  <Step>
    Configura cómo el motor analiza e ingiere los archivos de la fuente:

    | Sección                      | Descripción                                                                                                                                                                                                                                                                                                                                                                                                   |
    | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **File dialect**             | **Encoding** (`UTF-8`, `UTF-8 with BOM`, `Windows-1252`, `ISO-8859-1`), **Delimiter** (coma, punto y coma, tabulación, barra vertical), **Decimal style** (punto `1234.56` o coma `1.234,56`) y **Date style** (ISO, ISO con offset, día primero, mes primero). Déjalo en **Auto** para usar los valores predeterminados del servidor (UTF-8 / coma / punto / ISO); Auto no detecta el dialecto de un archivo |
    | **Duplicate key**            | Qué campos mapeados definen la misma fila. Déjalo en `external_id` a menos que necesites una identidad compuesta; una fuente vinculada a una conexión de agregador no puede usar una clave personalizada.                                                                                                                                                                                                     |
    | **Duplicate handling**       | Qué hacer cuando un archivo repite esa clave: **Flag as exception (default)** abre una excepción de duplicado en la transacción que se conserva, **Keep first** descarta la repetición en silencio y **Reject as errors** registra un error de importación                                                                                                                                                    |
    | **Blank reference handling** | Qué hacer cuando una fila no tiene un ID externo mapeado: **Reject as errors (default)** registra un error de importación; **Import for review** crea una transacción pendiente de revisión en el Unmatched workbench                                                                                                                                                                                         |
    | **camt.053 options**         | Para las cargas camt.053: **Date basis** (Booking date `BookgDt` o Value date `ValDt`) y qué campo usar como **Entry reference** (`NtryRef`, `EndToEndId` o `TxId`). Deja ambos controles en **Auto** para la fecha contable y `NtryRef`                                                                                                                                                                      |
    | **Advanced config (JSON)**   | Configuración opcional de la fuente como objeto JSON. Déjalo vacío para los valores predeterminados. Para que un trabajo de ingesta falle solo cuando las filas fallidas superen estrictamente un umbral, configura `fail_on_error_rate_percent` con un entero de 1 a 99; omítelo para que nunca falle automáticamente por la tasa de errores de fila                                                         |
  </Step>

  <Step>
    Haz clic en **Create source**.
  </Step>
</Steps>

<Note>
  El mapeo de campos no forma parte del formulario de la fuente. Configura cómo las columnas de la fuente se mapean a los campos de conciliación en la pestaña **Field maps** separada. Para las cargas CSV, JSON y XML, cada fuente activa necesita un mapeo de campos para la preparación de la configuración. Aplica una **excepción camt.053**: seleccionar una opción camt.053 distinta de **Auto** declara la fuente como automapeada para la preparación. En cada carga camt.053, el parser usa su mapeo ISO 20022 incorporado e ignora un mapeo de campos. Si ambos controles camt.053 quedan en **Auto**, no se guarda ninguna declaración `camt053`, así que la preparación todavía espera un mapeo de campos.
</Note>

## Tipos de fuente

***

| Tipo        | Descripción                                         |
| ----------- | --------------------------------------------------- |
| **LEDGER**  | Datos del ledger interno                            |
| **BANK**    | Datos de un feed de extractos bancarios             |
| **GATEWAY** | Datos de un gateway de pagos                        |
| **CUSTOM**  | Datos de un feed a medida                           |
| **FETCHER** | Datos de una extracción del motor de descubrimiento |

## Cómo editar una fuente

***

Haz clic en el botón de edición de una fuente para abrir el diálogo. Actualiza los campos según sea necesario y haz clic en **Save changes**.

## Cómo archivar y restaurar una fuente

***

Las fuentes nunca se eliminan de forma definitiva. Archivar es la única vía de remoción.

<Steps>
  <Step>
    Haz clic en el botón de archivado de una fuente. Aparece un diálogo de confirmación **Archive source?**. Haz clic en **Archive**.
  </Step>

  <Step>
    La fuente sale de la lista activa. Activa **Show archived** para verla con su insignia **Archived**.
  </Step>

  <Step>
    Para recuperarla, haz clic en el botón de restauración de la fuente archivada y confirma en el diálogo **Restore source?**.
  </Step>
</Steps>
