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

> Añade y edita fuentes de datos desde la pestaña Sources de la página de configuración de un contexto en la Matcher UI: elige tipo y 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 de la reconciliación. Las fuentes alimentan los dos lados del contexto: cada fuente declara a qué lado pertenece y cómo debe tratar sus datos el motor.

## Acceder a la pestaña Sources

***

<Steps>
  <Step>
    Navega a **Configurar → Contextos** 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 **Contexto activo** de la barra lateral te permite cambiar el contexto de reconciliación activo en cualquier momento.
</Note>

## Lista de fuentes

***

Esta vista muestra hasta 100 fuentes y no ofrece controles de paginación. Las fuentes se agrupan 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 programaciones de ingesta, ejecutar una extracción manual, extraer desde un documento, editar o archivar. Un interruptor **Show archived** incluye las fuentes archivadas; llevan una insignia **Archived** y solo ofrecen restauración.

Para que la configuración esté lista, se necesita al menos una fuente `LEFT` activa y una `RIGHT` activa; las fuentes archivadas no cuentan.

## 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 comienzan con `BANK` seleccionado: `LEDGER`, `BANK`, `GATEWAY`, `CUSTOM` o `FETCHER` |
    | **Side** (obligatorio) | Qué lado de la reconciliación alimenta la fuente. Las fuentes nuevas comienzan 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, tabulador, barra vertical), **Decimal style** (punto `1234.56` o coma `1.234,56`) y **Date style** (ISO, ISO con offset, día primero, mes primero). Deja **Auto** para usar los valores por defecto del servidor (UTF-8 / coma / punto / ISO); Auto no detecta el dialecto del archivo |
    | **Duplicate handling**       | Qué hacer cuando un archivo repite un ID externo ya presente en esta fuente: **Keep first (default)** conserva en silencio el original y descarta la repetición, **Reject as errors** registra un error de importación y **Flag as exception** abre una excepción por duplicado en la transacción conservada                                                                                      |
    | **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 espacio de trabajo Unmatched                                                                                                                                                                    |
    | **camt.053 options**         | Para cargas camt.053: **Date basis** (fecha contable `BookgDt` o fecha valor `ValDt`) y qué campo usar como **Entry reference** (`NtryRef`, `EndToEndId` o `TxId`). Deja ambos controles en **Auto** para usar la fecha contable y `NtryRef`                                                                                                                                                      |
    | **Advanced config (JSON)**   | Configuración opcional de la fuente como objeto JSON. Déjalo vacío para usar los valores por defecto. Para que un trabajo de ingesta falle solo si las filas con error superan estrictamente un umbral, define `fail_on_error_rate_percent` como un entero de 1 a 99; omítelo para no fallar automáticamente por la tasa de errores de filas                                                      |
  </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 reconciliación en la pestaña separada **Field maps**. Para cargas CSV, JSON y XML, cada fuente activa necesita un mapa de campos para que la configuración esté lista. **Excepción para camt.053:** al seleccionar una opción camt.053 distinta de **Auto**, la fuente se considera ya mapeada para la preparación. En todas las cargas camt.053, el parser usa su mapeo ISO 20022 incorporado e ignora un mapa de campos; si ambos controles camt.053 permanecen en **Auto**, no se guarda una declaración `camt053`, por lo que la preparación sigue esperando un mapa de campos.
</Note>

## Tipos de fuente

***

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

## Editar una fuente

***

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

## Archivar y restaurar una fuente

***

Las fuentes nunca se eliminan de forma definitiva: archivar es la única vía de eliminación.

<Steps>
  <Step>
    Haz clic en el botón de archivar 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 restaurar de la fuente archivada y confirma en el diálogo **Restore source?**.
  </Step>
</Steps>