---
title: Retorno 240
url: https://docs.vehub.com.br/Layouts/%F0%9F%8F%A6%20BTG%20Pactual/Manual/Retorno%20240/
---
# Retorno 240

Layout CNAB 240 de retorno do BTG Pactual (banco 208).

> **Como ler as tabelas**
>
> As posições, tamanhos e tipos abaixo refletem o que o sistema realmente lê e grava.
>
> - **Posição** — posição inicial e final na linha, com 1 na primeira coluna.
> - **A/N** — classificação do campo: `N` numérico, `A` alfanumérico.
> - **Formato** — como o campo é lido/gravado. Um campo de domínio numérico pode aparecer
>   como `Texto` quando o sistema preserva os zeros à esquerda. `Decimal N casas` indica
>   vírgula implícita de N casas. Datas e horas seguem a máscara indicada (`DD` dia, `MM` mês,
>   `AA`/`AAAA` ano, `HHMMSS` hora).

## Header de Arquivo

Tamanho da linha: **240** posições.

| **Posição** | **Nome do Campo** | **Tam.** | **A/N** | **Formato** | **Conteúdo / Regra** |
|---|---|---:|:---:|---|---|
| 001 a 003 | Código Banco | 003 | A | Texto | — |
| 004 a 007 | Lote Serviço | 004 | A | Texto | Fixo `0000` |
| 008 a 008 | Tipo Registro | 001 | A | Texto | Fixo `0` |
| 009 a 017 | Brancos | 009 | A | Texto | Branco |
| 018 a 018 | Tipo Inscrição Empresa | 001 | N | Número | — |
| 019 a 032 | Número Inscrição Empresa | 014 | A | Texto | — |
| 033 a 052 | Código Convênio | 020 | A | Texto | — |
| 053 a 057 | Agência | 005 | A | Texto | — |
| 058 a 058 | Dígito Agência | 001 | A | Texto | — |
| 059 a 070 | Conta | 012 | A | Texto | — |
| 071 a 071 | Dígito Conta | 001 | A | Texto | — |
| 072 a 072 | Dígito Agência Conta | 001 | A | Texto | — |
| 073 a 102 | Nome Empresa | 030 | A | Texto | — |
| 103 a 132 | Nome Banco | 030 | A | Texto | — |
| 133 a 142 | Brancos | 010 | A | Texto | Branco |
| 143 a 143 | Código Remessa Retorno | 001 | N | Número | Codigo Remessa/Retorno – "2" (Retorno) _(padrão: `2`)_ |
| 144 a 151 | Data Geração | 008 | N | Data `DDMMAAAA` | Data de geração do arquivo (DDMMAAAA) (pos. 144-151) |
| 152 a 157 | Hora Geração | 006 | A | Texto | — |
| 158 a 163 | Número Sequencial Registro | 006 | N | Número | — |
| 164 a 166 | Versão Layout Arquivo | 003 | A | Texto | — |
| 167 a 171 | Densidade Gravacao | 005 | A | Texto | — |
| 172 a 191 | Reservado Banco | 020 | A | Texto | Branco |
| 192 a 211 | Reservado Empresa | 020 | A | Texto | Branco |
| 212 a 240 | Filler Final | 029 | A | Texto | Branco |

## Header de Lote

Tamanho da linha: **240** posições.

| **Posição** | **Nome do Campo** | **Tam.** | **A/N** | **Formato** | **Conteúdo / Regra** |
|---|---|---:|:---:|---|---|
| 001 a 003 | Código Banco | 003 | A | Texto | — |
| 004 a 007 | Lote Serviço | 004 | A | Texto | — |
| 008 a 008 | Tipo Registro | 001 | N | Número | Fixo `1` |
| 009 a 009 | Tipo Operação | 001 | A | Texto | Tipo operação – "T" (Retorno) _(padrão: `T`)_ |
| 010 a 011 | Tipo Serviço | 002 | A | Texto | Fixo `01` |
| 012 a 013 | Brancos | 002 | A | Texto | Branco |
| 014 a 016 | Layout Lote | 003 | A | Texto | Layout do lote – BTG usa "060" no retorno (Febraban default é "040") _(padrão: `060`)_ |
| 017 a 017 | Brancos | 001 | A | Texto | Branco |
| 018 a 018 | Tipo Inscrição Empresa | 001 | A | Texto | — |
| 019 a 033 | Número Inscrição Empresa | 015 | A | Texto | — |
| 034 a 053 | Código Convênio | 020 | A | Texto | — |
| 054 a 058 | Agência | 005 | A | Texto | — |
| 059 a 059 | Dígito Agência | 001 | A | Texto | — |
| 060 a 071 | Conta | 012 | A | Texto | — |
| 072 a 072 | Dígito Conta | 001 | A | Texto | — |
| 073 a 073 | Dígito Agência Conta | 001 | A | Texto | — |
| 074 a 103 | Nome Empresa | 030 | A | Texto | — |
| 104 a 143 | Mensagem 1 | 040 | A | Texto | — |
| 144 a 183 | Mensagem 2 | 040 | A | Texto | — |
| 184 a 191 | Número Sequencial Registro | 008 | N | Número | BTG omite o sequencial no header lote (8 espaços, não zeros). Usa sobrecarga de 4 args para garantir que o source generator interprete o último bool como preencherComZeros |
| 192 a 199 | Data Geração | 008 | N | Data `DDMMAAAA` | Data de geração do arquivo (DDMMAAAA) (pos. 192-199) |
| 200 a 207 | Data Crédito | 008 | N | Data `DDMMAAAA` | Data de crédito (DDMMAAAA) (pos. 200-207) |
| 208 a 240 | Filler Final | 033 | A | Texto | Branco |

## Segmento T (Detalhe — obrigatório)

Tamanho da linha: **240** posições.

| **Posição** | **Nome do Campo** | **Tam.** | **A/N** | **Formato** | **Conteúdo / Regra** |
|---|---|---:|:---:|---|---|
| 001 a 003 | Código Banco | 003 | A | Texto | — |
| 004 a 007 | Lote Serviço | 004 | A | Texto | Fixo `0001` |
| 008 a 008 | Tipo Registro | 001 | N | Número | Fixo `3` |
| 009 a 013 | Número Sequencial Registro | 005 | N | Número | — |
| 014 a 014 | Código Segmento | 001 | A | Texto | Fixo `T` |
| 015 a 015 | Filler CNAB | 001 | A | Texto | Branco |
| 016 a 017 | Código Movimento Retorno | 002 | A | Texto | Código de Movimento Retorno (pos. 16-17) |
| 018 a 022 | Agência | 005 | A | Texto | — |
| 023 a 023 | Dígito Agência | 001 | A | Texto | — |
| 024 a 035 | Conta | 012 | A | Texto | — |
| 036 a 036 | Dígito Conta | 001 | A | Texto | — |
| 037 a 037 | Dígito Agência Conta | 001 | A | Texto | — |
| 038 a 057 | Nosso Número | 020 | A | Texto | Identificação do Título no Banco (Nosso Número) (pos. 38-57) |
| 058 a 058 | Código Carteira | 001 | A | Texto | Código da Carteira – BTG usa "1" (Febraban default é "6") _(padrão: `1`)_ |
| 059 a 073 | Número Documento | 015 | A | Texto | Número do Documento de Cobrança (Seu Número) (pos. 59-73) |
| 074 a 081 | Data Vencimento | 008 | N | Data `DDMMAAAA` | Data do Vencimento (DDMMAAAA) (pos. 74-81) |
| 082 a 096 | Valor Título | 015 | N | Decimal 2 casas (zeros à esq.) | Valor Nominal do Título (2 decimais implícitos) (pos. 82-96) |
| 097 a 099 | Número Banco Cobrador Recebedor | 003 | A | Texto | — |
| 100 a 104 | Agência Cobradora Recebedora | 005 | A | Texto | — |
| 105 a 105 | Dígito Agência Cobradora Recebedora | 001 | A | Texto | — |
| 106 a 130 | Identificação Título Empresa | 025 | A | Texto | Identificação do Título na Empresa (pos. 106-130) |
| 131 a 132 | Código Moeda | 002 | A | Texto | — |
| 133 a 133 | Tipo Inscrição Pagador | 001 | N | Número | — |
| 134 a 148 | Número Inscrição Pagador | 015 | A | Texto | — |
| 149 a 188 | Nome Pagador | 040 | A | Texto | — |
| 189 a 198 | Número Contrato Operação Crédito | 010 | A | Texto | Nº do Contrato da Operação de Crédito (pos. 189-198) |
| 199 a 213 | Valor Tarifa Custas | 015 | N | Decimal 2 casas (zeros à esq.) | Valor da Tarifa/Custas (2 decimais implícitos) (pos. 199-213) |
| 214 a 223 | Motivo Ocorrência | 010 | A | Texto | Motivo da Ocorrência (pos. 214-223) |
| 224 a 240 | Filler Final | 017 | A | Texto | Branco |

## Segmento U (Detalhe — obrigatório)

Tamanho da linha: **240** posições.

| **Posição** | **Nome do Campo** | **Tam.** | **A/N** | **Formato** | **Conteúdo / Regra** |
|---|---|---:|:---:|---|---|
| 001 a 003 | Código Banco | 003 | A | Texto | — |
| 004 a 007 | Lote Serviço | 004 | A | Texto | Fixo `0001` |
| 008 a 008 | Tipo Registro | 001 | N | Número | Fixo `3` |
| 009 a 013 | Número Sequencial Registro | 005 | N | Número | — |
| 014 a 014 | Código Segmento | 001 | A | Texto | Fixo `U` |
| 015 a 015 | Filler CNAB | 001 | A | Texto | Branco |
| 016 a 017 | Código Movimento Retorno | 002 | A | Texto | — |
| 018 a 032 | Valor Juros Multa Encargos | 015 | N | Decimal 2 casas (zeros à esq.) | Juros/Multa/Encargos (pos. 18-32) |
| 033 a 047 | Valor Desconto | 015 | N | Decimal 2 casas (zeros à esq.) | Desconto Concedido (pos. 33-47) |
| 048 a 062 | Valor Abatimento | 015 | N | Decimal 2 casas (zeros à esq.) | Abatimento Concedido/Cancelado (pos. 48-62) |
| 063 a 077 | Valor IOF | 015 | N | Decimal 2 casas (zeros à esq.) | IOF Recolhido (pos. 63-77) |
| 078 a 092 | Valor Pago | 015 | N | Decimal 2 casas (zeros à esq.) | Valor Pago pelo Pagador (pos. 78-92) |
| 093 a 107 | Valor Liquido | 015 | N | Decimal 2 casas (zeros à esq.) | Valor Líquido a ser Creditado (pos. 93-107) |
| 108 a 122 | Valor Outras Despesas | 015 | N | Decimal 2 casas (zeros à esq.) | Outras Despesas (pos. 108-122) |
| 123 a 137 | Valor Outros Creditos | 015 | N | Decimal 2 casas (zeros à esq.) | Outros Créditos (pos. 123-137) |
| 138 a 145 | Data Ocorrência | 008 | N | Data `DDMMAAAA` | Data da Ocorrência (DDMMAAAA) (pos. 138-145). BTG zero-pad quando null |
| 146 a 153 | Data Crédito | 008 | N | Data `DDMMAAAA` | Data do Crédito (DDMMAAAA) (pos. 146-153). BTG zero-pad quando null |
| 154 a 157 | Código Ocorrência Pagador | 004 | A | Texto | Código da Ocorrência do Pagador (pos. 154-157) |
| 158 a 165 | Data Ocorrência Pagador | 008 | N | Data `DDMMAAAA` | Data da Ocorrência do Pagador (DDMMAAAA) (pos. 158-165). BTG zero-pad quando null |
| 166 a 180 | Valor Ocorrência Pagador | 015 | N | Decimal 2 casas (zeros à esq.) | Valor da Ocorrência do Pagador (pos. 166-180) |
| 181 a 210 | Complemento Ocorrência | 030 | A | Texto | Complemento da Ocorrência (pos. 181-210) |
| 211 a 213 | Código Banco Correspondente | 003 | A | Texto | Código Banco Correspondente (pos. 211-213) |
| 214 a 233 | Nosso Número Banco Correspondente | 020 | A | Texto | Nosso Número no Banco Correspondente (pos. 214-233) |
| 234 a 240 | Filler Final | 007 | A | Texto | Branco |

## Trailler de Lote

Tamanho da linha: **240** posições.

| **Posição** | **Nome do Campo** | **Tam.** | **A/N** | **Formato** | **Conteúdo / Regra** |
|---|---|---:|:---:|---|---|
| 001 a 003 | Código Banco | 003 | A | Texto | Código do banco (208) |
| 004 a 007 | Lote Serviço | 004 | A | Texto | Código do lote |
| 008 a 008 | Tipo Registro | 001 | N | Número | Tipo de registro (5 = trailer de lote) _(padrão: `5`)_ |
| 009 a 017 | Brancos | 009 | A | Texto | CNAB - Uso Exclusivo FEBRABAN/CNAB (pos. 9-17) |
| 018 a 023 | Quantidade Registros Lote | 006 | N | Número | Quantidade de registros do lote (pos. 18-23) |
| 024 a 029 | Quantidade Títulos Carteiras | 006 | N | Número | Quantidade de títulos em carteira (pos. 24-29) |
| 030 a 044 | Valor Total Títulos Carteiras | 015 | N | Decimal 2 casas (zeros à esq.) | Valor total dos títulos em carteira – BTG usa 15 chars com 2 decimais (pos. 30-44) |
| 045 a 046 | Brancos | 002 | A | Texto | Filler entre o valor total de carteira e a próxima quantidade (pos. 45-46) |
| 047 a 052 | Quantidade Títulos Cobrança Descontada | 006 | N | Número | Quantidade de títulos em cobrança descontada (pos. 47-52) |
| 053 a 067 | Valor Total Títulos Cobrança Descontada | 015 | N | Decimal 2 casas (zeros à esq.) | Valor total dos títulos em cobrança descontada – BTG usa 15 chars com 2 decimais (pos. 53-67) |
| 068 a 069 | Brancos | 002 | A | Texto | Filler entre o valor total descontada e a próxima quantidade (pos. 68-69) |
| 070 a 075 | Quantidade Títulos Cobrança Condicionada | 006 | N | Número | Quantidade de títulos em cobrança condicionada (pos. 70-75) |
| 076 a 092 | Valor Total Títulos Cobrança Condicionada | 017 | N | Decimal 2 casas (zeros à esq.) | Valor total dos títulos em cobrança condicionada – 17 chars com 2 decimais (pos. 76-92) |
| 093 a 098 | Quantidade Títulos Cobrança Custodia | 006 | N | Número | Quantidade de títulos em cobrança custódia (pos. 93-98) |
| 099 a 113 | Valor Total Títulos Cobrança Custodia | 015 | N | Decimal 2 casas (zeros à esq.) | Valor total dos títulos em cobrança custódia – BTG usa 15 chars com 2 decimais (pos. 99-113) |
| 114 a 115 | Brancos | 002 | A | Texto | Filler entre o valor total custódia e o número de aviso (pos. 114-115) |
| 116 a 123 | Número Aviso Lançamento | 008 | A | Texto | Número do aviso de lançamento (pos. 116-123) |
| 124 a 240 | Filler Final | 117 | A | Texto | Filler até o final da linha (pos. 124-240) |

## Trailler de Arquivo

Tamanho da linha: **240** posições.

| **Posição** | **Nome do Campo** | **Tam.** | **A/N** | **Formato** | **Conteúdo / Regra** |
|---|---|---:|:---:|---|---|
| 001 a 003 | Código Banco | 003 | A | Texto | — |
| 004 a 007 | Lote Serviço | 004 | A | Texto | Fixo `9999` |
| 008 a 008 | Tipo Registro | 001 | N | Número | Fixo `9` |
| 009 a 017 | Brancos | 009 | A | Texto | Branco |
| 018 a 023 | Quantidade Lotes | 006 | N | Número | — |
| 024 a 029 | Quantidade Registros | 006 | N | Número | — |
| 030 a 035 | Quantidade Contas Conciliacao | 006 | N | Número | — |
| 036 a 240 | Filler Final | 205 | A | Texto | Branco |

<!-- INICIO-DEPARA -->

## De-para

Como o VeHub traduz a espécie do título e a ocorrência neste layout. Na **leitura** do arquivo vale a tabela arquivo → sistema; na **geração**, a tabela sistema → arquivo. O catálogo de espécies do VeHub está em [De-Para](../../%F0%9F%94%81%20De-Para/Especies%20de%20titulo.md).

### Espécie do título

#### Geração do arquivo (sistema → arquivo)

O arquivo gerado não grava a espécie.

### Ocorrência

#### Geração do arquivo (sistema → arquivo)

| **Ocorrência no VeHub** | **Valor no arquivo** | **Condição** |
|---|---|---|
| Cessão | `09` | Título não rejeitado |
| Cessão | `03` | Título rejeitado |
| Liquidação Cedente | `06` | — |
| Liquidação Sacado | `06` | — |
| Recompra com adiantamento | `85` | Título não rejeitado |
| Recompra com adiantamento | `93` | Título rejeitado |
| Recompra com substituição | `74` | Título não rejeitado |
| Recompra com substituição | `93` | Título rejeitado |

Demais ocorrências não têm código: o arquivo não é gerado.

<!-- FIM-DEPARA -->