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
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.
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.
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.
| Condição | Para que serve | Exemplo |
|---|---|---|
| Tamanho do registro | Casar pelo comprimento da linha de detalhe | tamanho = 400 (ou faixa 398–402) |
| Literal no header | Procurar um texto em posição fixa do cabeçalho | header[3–9] = "REMESSA" |
| Ocorrência em lista | Campo deve estar entre certos valores | posição[105–106] ∈ [06, 09] |
| Campo > 0 | Soma de um campo é positiva | soma[83–95] > 0 (valor pago) |
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.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.
Transformações disponíveis
A transformação diz como interpretar os caracteres extraídos:| Transformação | O que faz | Exemplo |
|---|---|---|
| TEXTO | Texto como está (mantém espaços) | "SICREDI " → "SICREDI " |
| TEXTO_STRIP | Texto sem espaços nas pontas | "SICREDI " → "SICREDI" |
| NUMERO | Número (inteiro ou com casas decimais) | "00012345" (2 casas) → 123.45 |
| MOEDA | Centavos inteiros → valor | "00000001234" (2 casas) → 12.34 |
| ID | Remove zeros à esquerda | "00000123456" → "123456" |
| DATA6 | Data no formato DDMMAA | "301225" → 2025‑12‑30 |
| DATA8 | Data no formato DDMMAAAA | "30122025" → 2025‑12‑30 |
| CONST | Valor constante (ignora a posição) | sempre "MANUAL" |
| RAW | A linha inteira, sem recorte | linha completa |
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:Erros (bloqueiam o salvamento)
Erros (bloqueiam o salvamento)
- 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).
Avisos (informativos)
Avisos (informativos)
- 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.