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

# Templates de layout

> Defina layouts de arquivo de largura fixa, como layouts CNAB, como tipos de registro e intervalos de bytes, e depois selecione-os como formato do arquivo quando você enviar dados.

A tela **Modelos de layout** no módulo Matcher do Lerian Console guarda os seus layouts de arquivo de largura fixa. Em um arquivo de largura fixa, como um arquivo CNAB, cada linha é um registro com comprimento fixo. Cada campo é um intervalo de bytes no registro. Um template de layout diz ao Matcher onde cada campo começa e qual é o comprimento dele.

## Acessando a página Modelos de layout

***

Vá para **Configurações → Modelos de layout**.

## Tabela de templates

***

| Coluna | Descrição |
| - | - |
| **Chave de formato** | A chave do template. Ela combina a região, a família e a variante. Clique nela para abrir o template |
| **Chave de variante** | A variante do template |
| **Tipos de registro** | O número de tipos de registro no layout |
| **Criado Em** | A data e a hora da criação do template |

## Criando um template

***

Clique em **Novo modelo**. A página **Novo modelo de layout** abre.

### Campos do template

| Campo | Descrição |
| - | - |
| **Região** | Um código de região de duas letras, como `BR`, ou `XX` para nenhuma região |
| **Família** | A família do formato, como `cnab240` ou `cnab400` |
| **Variante** | Um nome em minúsculas para o layout do banco ou da marca. Use letras, dígitos, `-` e `_` |
| **Byte inicial do discriminador** | A posição, contada a partir de zero, dos bytes que identificam o tipo de registro |
| **Comprimento do discriminador** | O número de bytes que identificam o tipo de registro |
| **Nomes dos campos obrigatórios (opcional)** | Nomes de campos que o layout deve declarar. Separe os nomes com vírgulas |

### Tipos de registro

Cada tipo de registro é um card. Clique em **Adicionar tipo de registro** para adicionar um card. Clique em **Remover** para excluir um card.

| Campo | Descrição |
| - | - |
| **Valor do tipo de registro** | O valor nos bytes do discriminador que identifica este tipo de registro |
| **Largura do registro (bytes)** | O comprimento fixo de um registro deste tipo |

Cada tipo de registro tem um ou mais campos. Clique em **Adicionar um campo** para adicionar uma linha de campo:

| Campo | Descrição |
| - | - |
| **Nome** | O nome do campo |
| **Byte inicial** | A posição, contada a partir de zero, onde o campo começa |
| **Comprimento** | O número de bytes no campo |
| **Tipo** | `string`, `decimal (money)` ou `date`. Um campo chamado `amount` deve usar `decimal (money)` |

O Matcher mapeia os campos chamados `external_id`, `amount`, `currency`, `date` e `description` para os campos da transação com os mesmos nomes. Ele mantém todos os outros campos como metadados da transação. Se um layout não tiver um campo `currency`, o Matcher usa `BRL`.

O formulário mostra **Problemas de layout de bytes** quando dois campos de um tipo de registro se sobrepõem. Ele também os mostra quando um campo termina depois da largura do registro. O Matcher não salva um layout com esses problemas.

Clique em **Enviar modelo** para salvar. A página do template abre.

## Usando um template

***

Para usar um template, envie um arquivo em **Operar → Nova conciliação**. No seletor **Formato**, escolha a chave de formato do template. O seletor lista os seus templates no grupo **Modelos de layout**. Para os passos do envio, veja [Subindo dados de conciliação](/pt/products/matcher/ui/uploading-reconciliation-data).

## Detalhes do template

***

Clique em uma chave de formato na tabela para abrir o template. A página mostra dois cards:

* **Identidade do modelo**: a **Chave de formato**, a **Região**, a **Família** e a **Variante**.
* **Registro**: a **Chave de variante**, o número de **Tipos de registro**, o intervalo de bytes do **Discriminador** e a data de criação.

A seção **Layout de bytes** tem um card para cada tipo de registro. Cada card mostra a largura do registro e uma tabela de campos com **Nome**, **Intervalo de bytes**, **Comprimento** e **Tipo**.

## Editando um template

***

Clique em **Editar** na página do template. A página **Editar modelo de layout** abre com os valores atuais. Clique em **Salvar alterações** para substituir o layout armazenado. Essa alteração não cria uma cópia. O Matcher valida de novo o layout completo antes de salvar a alteração.

## Duplicando um template

***

Clique em **Duplicar / editar como novo** na página do template. A página **Novo modelo de layout** abre com os valores do template. Altere os valores e clique em **Enviar modelo** para salvar um template separado.

## Excluindo um template

***

Clique em **Excluir** na página do template. Na caixa de diálogo **Excluir modelo de layout?**, clique em **Excluir**. O Matcher remove o template e libera a chave de formato dele para um novo template. Você não pode desfazer esta ação.


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