Skip to main content
Cada originador/banco entrega o CNAB num layout próprio — os campos ficam em posições diferentes. Os Templates ensinam o sistema a ler cada layout: quando um arquivo é enviado, o parser testa os templates e usa o que casa com o arquivo.
Onde fica: Operação → Templates. Você só precisa criar um template quando aparece um layout novo que o sistema ainda não reconhece.

​
Anatomia de um template

Um template tem quatro partes:

1. Identificação

Nome, tipo de CNAB (400/444/500/600) e status (Ativo/Inativo).

2. Operação

Se o arquivo é sempre Cessão/Liquidação (fixa) ou se o tipo é derivado de uma regra do conteúdo.

3. Seletor

As condições que dizem se este template casa com um arquivo (detecção automática).

4. Mapa de campos

O de‑para: cada coluna de saída e a posição que ela ocupa na linha do arquivo.

​
Passo a passo

1

Crie o template

Em Templates, clique em Novo template. Informe:
  • Nome — ex.: “BTG Cessão 400”.
  • Tipo CNAB — 400, 444, 500 ou 600.
  • Operação — Cessão, Liquidação, ou deixe em branco para derivada.
Clique em Criar e editar. O template nasce Inativo (não participa da detecção automática até ser ativado).
2

Defina a operação

Na seção Operação, escolha:
  • Fixa — todas as linhas viram a mesma operação (Cessão ou Liquidação).
  • Derivada — o tipo depende de uma regra do conteúdo. Ex.: ocorrência 06/09 (444) → se o código for 06 ou 09 é Liquidação, senão Cessão; ou valor pago > 0 → se há valor pago é Liquidação.
3

Configure o seletor (identificação automática)

Em Seletor, adicione condições (todas precisam ser verdadeiras). Tipos disponíveis:O resumo em texto ajuda a conferir a leitura das condições.
4

Monte o mapa de campos (de-para)

Esta é a parte central. Cada linha do mapa extrai uma coluna de uma posição fixa do arquivo.Para cada campo informe: Coluna destino (ex.: VALOR_TITULO), Pos. inicial, Pos. final e a transformação. O tamanho é calculado automaticamente.
Use Colar da planilha para colar várias linhas de uma vez no formato COLUNA POS_INI POS_FIM TRANSFORMAÇÃO NOTA (separadas por tabulação).
5

Teste antes de ativar

Na ferramenta Testar template, selecione o template e suba um arquivo (ou cole uma linha). Você também pode usar Detectar (auto) para ver qual template casa com o arquivo. O resultado mostra a operação detectada, avisos e uma amostra das colunas extraídas — confira se os valores caíram nas colunas certas.
6

Ative

Volte ao editor, mude o Status para Ativo e Salve. A partir daí o template entra na detecção automática dos próximos uploads.

​
Transformações disponíveis

A transformação diz como interpretar os caracteres extraídos:
Existem variações para datas lidas do header (HEADER_DATE6/8) e posições alternativas de fallback. Use a nota de cada campo para registrar a origem (ex.: “código do banco”).

​
Erros e avisos no mapa de campos

Ao salvar, o editor sinaliza:
  • Campo sem coluna de destino.
  • Pos. final menor que a inicial.
  • Pos. final maior que o tamanho do registro.
  • Coluna duplicada (duas linhas com o mesmo destino).
  • Sobreposição de posições entre dois campos — pode ser intencional, mas vale conferir.

​
Dicas de manutenção

Duplicar para variar

Um layout parecido com outro? Duplique um template existente (a cópia nasce Inativa) e ajuste só o que muda.

Prioridade

Quando mais de um template poderia casar, a prioridade funciona como desempate na detecção automática.