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

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.

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.