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

# Plantillas de layout

> Define layouts de archivo de ancho fijo, como los layouts CNAB, como tipos de registro y rangos de bytes, y luego selecciónalos como formato de archivo cuando subes datos.

La pantalla **Layout Templates** del módulo Matcher de Lerian Console guarda tus layouts de archivo de ancho fijo. En un archivo de ancho fijo, como un archivo CNAB, cada línea es un registro de longitud fija. Cada campo es un rango de bytes en el registro. Una plantilla de layout le indica a Matcher dónde empieza cada campo y cuál es su longitud.

## Cómo acceder a la página Layout Templates

***

Navega a **Settings → Layout Templates**.

## Tabla de plantillas

***

| Columna | Descripción |
| - | - |
| **Format key** | La clave de la plantilla. Combina la región, la familia y la variante. Haz clic en ella para abrir la plantilla |
| **Variant key** | La variante de la plantilla |
| **Record types** | La cantidad de tipos de registro del layout |
| **Created At** | La fecha y la hora de creación de la plantilla |

## Cómo crear una plantilla

***

Haz clic en **New template**. Se abre la página **New layout template**.

### Campos de la plantilla

| Campo | Descripción |
| - | - |
| **Region** | Un código de región de dos letras, como `BR`, o `XX` para ninguna región |
| **Family** | La familia del formato, como `cnab240` o `cnab400` |
| **Variant** | Un nombre en minúsculas para el layout del banco o de la marca. Usa letras, dígitos, `-` y `_` |
| **Discriminator start byte** | La posición, contada desde cero, de los bytes que identifican el tipo de registro |
| **Discriminator length** | La cantidad de bytes que identifican el tipo de registro |
| **Required field names (optional)** | Nombres de campo que el layout debe declarar. Separa los nombres con comas |

### Tipos de registro

Cada tipo de registro es una tarjeta. Haz clic en **Add record type** para agregar una tarjeta. Haz clic en **Remove** para eliminar una tarjeta.

| Campo | Descripción |
| - | - |
| **Record-type value** | El valor en los bytes discriminadores que identifica este tipo de registro |
| **Record width (bytes)** | La longitud fija de un registro de este tipo |

Cada tipo de registro tiene uno o más campos. Haz clic en **Add a field** para agregar una fila de campo:

| Campo | Descripción |
| - | - |
| **Name** | El nombre del campo |
| **Start byte** | La posición, contada desde cero, donde empieza el campo |
| **Length** | La cantidad de bytes del campo |
| **Kind** | `string`, `decimal (money)` o `date`. Un campo llamado `amount` debe usar `decimal (money)` |

Matcher mapea los campos llamados `external_id`, `amount`, `currency`, `date` y `description` a los campos de transacción con los mismos nombres. Conserva todos los demás campos como metadatos de la transacción. Si un layout no tiene un campo `currency`, Matcher usa `BRL`.

El formulario muestra **Byte-layout problems** cuando dos campos de un tipo de registro se superponen. También los muestra cuando un campo termina después del ancho del registro. Matcher no guarda un layout con estos problemas.

Haz clic en **Submit template** para guardar. Se abre la página de la plantilla.

## Cómo usar una plantilla

***

Para usar una plantilla, sube un archivo en **Operate → New Reconciliation**. En el selector **Format**, elige la clave de formato de la plantilla. El selector enumera tus plantillas en el grupo **Layout Templates**. Para los pasos de la subida, consulta [Subir datos de conciliación](/es/products/matcher/ui/uploading-reconciliation-data).

## Detalles de la plantilla

***

Haz clic en una clave de formato de la tabla para abrir la plantilla. La página muestra dos tarjetas:

* **Template identity**: **Format key**, **Region**, **Family** y **Variant**.
* **Registration**: **Variant key**, la cantidad de **Record types**, el rango de bytes del **Discriminator** y la fecha de creación.

La sección **Byte layout** tiene una tarjeta para cada tipo de registro. Cada tarjeta muestra el ancho del registro y una tabla de campos con **Name**, **Byte range**, **Length** y **Kind**.

## Cómo editar una plantilla

***

Haz clic en **Edit** en la página de la plantilla. Se abre la página **Edit layout template** con los valores actuales. Haz clic en **Save changes** para reemplazar el layout guardado. Este cambio no crea una copia. Matcher valida de nuevo el layout completo antes de guardar el cambio.

## Cómo duplicar una plantilla

***

Haz clic en **Duplicate as new** en la página de la plantilla. Se abre la página **New layout template** con los valores de la plantilla. Cambia los valores y luego haz clic en **Submit template** para guardar una plantilla separada.

## Cómo eliminar una plantilla

***

Haz clic en **Delete** en la página de la plantilla. En el diálogo **Delete layout template?**, haz clic en **Delete**. Matcher elimina la plantilla y libera su clave de formato para una plantilla nueva. No puedes deshacer esta acción.


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