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

# Mapeos de campos del contexto

> Mapea las columnas de cada fuente a los campos que Matcher compara, desde la pestaña Field Maps de un contexto en el módulo Matcher de Lerian Console.

Usa la pestaña **Field Maps** de un contexto para indicarle a Matcher cómo leer cada fuente. Un mapeo de campos traduce las columnas de una fuente a los campos canónicos que compara el motor de coincidencia.

## Cómo acceder a la pestaña Field Maps

***

<Steps>
  <Step>
    En el módulo Matcher, selecciona **Configure → Contexts**.
  </Step>

  <Step>
    Haz clic en un contexto para abrir su página de detalle.
  </Step>

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

El paso **Map fields** del [Asistente de configuración de contextos](/es/products/matcher/ui/context-setup-wizard) muestra la misma pestaña.

## Lista de mapeos de campos

***

La pestaña muestra una fila por cada fuente del contexto. Las fuentes archivadas no aparecen. Cada fila muestra el nombre de la fuente, su tipo, su lado y un resumen de su mapeo:

* **No field map yet**: la fuente no tiene mapeo. Haz clic en **Add map** para crear uno.
* Una cantidad de campos mapeados, seguida de los primeros campos canónicos. Usa el botón de lápiz para editar el mapeo y el botón de papelera para eliminarlo.

Si el contexto no tiene fuentes, la pestaña te pide que las agregues primero. Haz clic en **Go to sources** para abrir la pestaña **Sources**.

<Note>
  Matcher activa un contexto solo cuando cada fuente de esta pestaña tiene un mapeo de campos. Una fuente con un valor de **camt.053 options** distinto de **Auto** no necesita mapeo de campos. El analizador de camt.053 usa el mapeo de ISO 20022. Consulta [Fuentes del contexto](/es/products/matcher/ui/context-sources).
</Note>

## Cómo crear o editar un mapeo de campos

***

<Steps>
  <Step>
    Haz clic en **Add map** en la fila de una fuente, o en el botón de lápiz de una fuente mapeada. Se abre el panel lateral **Create field map** o **Edit field map**.
  </Step>

  <Step>
    Agrega una fila de mapeo por cada campo canónico. En cada fila, escribe el campo canónico a la izquierda y la columna de la fuente a la derecha. Haz clic en **Add field** para agregar una fila. Haz clic en el botón de papelera de una fila para quitarla.
  </Step>

  <Step>
    De forma opcional, completa los campos **Debit and credit column**. Consulta [Columna de débito y crédito](#debit-and-credit-column).
  </Step>

  <Step>
    Haz clic en **Create map** para un mapeo nuevo, o en **Save map** para uno existente.
  </Step>
</Steps>

Matcher rechaza un mapeo al que le falta un campo obligatorio o que usa un campo fuera de esta lista:

| Campo canónico | Obligatorio | Descripción |
| - | - | - |
| `external_id` | Sí | La referencia de la transacción en la fuente |
| `amount` | Sí | El monto de la transacción |
| `currency` | Sí | La moneda de la transacción |
| `date` | Sí | La fecha de la transacción |
| `description` | No | Una descripción de la transacción |
| `fee_amount` | No | La comisión cobrada sobre la transacción. La verificación de comisiones lee este campo |
| `fee_currency` | No | La moneda de la comisión |

Matcher conserva como metadatos de la transacción las columnas de la fuente que el mapeo no usa. Las [reglas de comisión](/es/products/matcher/ui/context-fee-rules) pueden evaluar esos campos de metadatos.

<h3 id="debit-and-credit-column">
  Columna de débito y crédito
</h3>

Algunos archivos no ponen un signo menos en los montos de débito. Marcan cada fila como débito o crédito en una columna aparte. Para estos archivos, completa los tres campos:

| Campo | Descripción |
| - | - |
| **Column** | La columna de la fuente que contiene el marcador de débito o crédito |
| **Value for a debit** | El marcador de una fila de débito, por ejemplo `D` |
| **Value for a credit** | El marcador de una fila de crédito, por ejemplo `C` |

Si completas uno de los campos, completa los tres. Los valores de débito y crédito deben ser diferentes. Matcher los compara sin distinguir mayúsculas de minúsculas.

Matcher importa las filas de débito como montos negativos y las filas de crédito como montos positivos. Entonces, la columna de montos debe contener montos sin signo. Falla la importación de una fila con un monto con signo, o con un marcador que no coincide con ninguno de los dos valores.

## Cómo sugerir mapeos con IA

***

El editor tiene un panel **Suggest mappings with AI**. Lee una muestra del archivo de la fuente y propone columnas de la fuente para los campos canónicos. Matcher envía un fragmento limitado de la muestra al proveedor de modelos de lenguaje que Lerian configura para tu entorno.

<Steps>
  <Step>
    Pega una muestra del archivo de la fuente en **Source sample**. Una fila de encabezado y algunas líneas son suficientes.
  </Step>

  <Step>
    Haz clic en **Suggest mappings**. El panel lista cada mapeo propuesto con un medidor de confianza.
  </Step>

  <Step>
    Haz clic en **Accept** en una propuesta para copiarla en las filas de mapeo.
  </Step>

  <Step>
    Revisa las filas y luego guarda el mapeo.
  </Step>
</Steps>

Una propuesta no cambia nada en Matcher. Solo el mapeo que guardas tiene efecto.

Si el panel muestra **AI assist unavailable**, el asesor de mapeo no está disponible. Mapea los campos manualmente.

## Cómo eliminar un mapeo de campos

***

Haz clic en el botón de papelera de una fuente mapeada. Se abre un diálogo **Delete field map?**. Haz clic en **Delete** para quitar el mapeo. Matcher conserva la fuente.


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