--- title: Retorno 400 url: https://docs.vehub.com.br/Layouts/%F0%9F%8F%A6BV/Manual/Retorno%20400/ --- # Retorno 400 Layout CNAB 400 de retorno do BV (banco 655). > **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 Tamanho da linha: **400** posições. | **Posição** | **Nome do Campo** | **Tam.** | **A/N** | **Formato** | **Conteúdo / Regra** | |---|---|---:|:---:|---|---| | 001 a 001 | Identificação Registro Header | 001 | N | Número | Identificação do Registro Header ("0") _(padrão: `0`)_ | | 002 a 002 | Tipo Operação | 001 | N | Número | Tipo de Operação ("2" = Retorno) _(padrão: `2`)_ | | 003 a 009 | Extenso Tipo Operação | 007 | A | Texto | Identificação por Extenso do Tipo de Operação ("RETORNO") _(padrão: `RETORNO`)_ | | 010 a 011 | Identificação Tipo Serviço | 002 | A | Texto | Identificação do Tipo de Serviço ("01" = Cobrança) _(padrão: `01`)_ | | 012 a 026 | Extenso Tipo Serviço | 015 | A | Texto | Identificação por Extenso do Tipo de Serviço ("COBRANCA") _(padrão: `COBRANCA`)_ | | 027 a 036 | Número Convênio | 010 | A | Texto | Número do Convênio de Cobrança (Nota 24 - preenchido pelo BV se parametrizado) | | 037 a 046 | Número Conta Corrente | 010 | A | Texto | Número da Conta Corrente (Nota 24 - preenchido pelo BV se parametrizado) | | 047 a 076 | Nome Empresa | 030 | A | Texto | Nome por Extenso da Empresa (cedente) | | 077 a 079 | Identificação Banco | 003 | N | Número | Identificação do Banco ("655" = Banco Votorantim) _(padrão: `655`)_ | | 080 a 099 | Nome Banco | 020 | A | Texto | Nome por Extenso do Banco ("BANCO VOTORANTIM S/A") _(padrão: `BANCO VOTORANTIM S/A`)_ | | 100 a 105 | Data Gravacao | 006 | A | Texto | Data da Gravação do Arquivo (formato DDMMAA) | | 106 a 389 | Complemento | 284 | A | Texto | Complemento (brancos) | | 390 a 394 | Identificação Layout | 005 | A | Texto | Identificação do Layout ("CL002") _(padrão: `CL002`)_ | | 395 a 400 | Número Sequencial Registro | 006 | N | Número | Número Sequencial do Registro no Arquivo ("000001") _(padrão: `1`)_ | ## Detalhe Tamanho da linha: **400** posições. | **Posição** | **Nome do Campo** | **Tam.** | **A/N** | **Formato** | **Conteúdo / Regra** | |---|---|---:|:---:|---|---| | 001 a 001 | Identificação Registro Detalhe | 001 | N | Número | Identificador do Registro Detalhe ("1") | | 002 a 003 | Tipo Inscrição Empresa | 002 | N | Número | Identificador do Tipo de Inscrição da Empresa (01=CPF, 02=CNPJ) | | 004 a 017 | Número Inscrição Empresa | 014 | A | Texto | Número de Inscrição da Empresa (CPF ou CNPJ do cedente) | | 018 a 027 | Código Convênio | 010 | A | Texto | Código do Convênio (fornecido pelo Banco Votorantim) | | 028 a 037 | Brancos | 010 | A | Texto | Brancos | | 038 a 062 | Número Atribuido Empresa | 025 | A | Texto | Número Atribuído pela Empresa (campo "Seu Número" / uso empresa - retornado em qualquer movimento) | | 063 a 072 | Nosso Número BV | 010 | A | Texto | Nosso Número no Banco Votorantim (atribuído pelo BV) | | 073 a 097 | Nosso Número Banco Correspondente | 025 | A | Texto | Nosso Número no Banco Correspondente (opcional, Nota 21) | | 098 a 100 | Número Da Carteira | 003 | N | Número | Número da Carteira (Nota 14: 001=Escritural/Desconto; 200=Garantia; 300=Simples; etc.) | | 101 a 102 | Identificação Ocorrência | 002 | N | Número | Identificação da Ocorrência (Nota 10: 2=Entrada Confirmada, 3=Entrada Rejeitada, 6=Liquidação Normal, 7=Liquidação Parcial, 8=Liquidação em Cartório, 9=Baixa Simples, 12=Abatimento Concedido, 14=Vencimento Alterado, 70=Liquidação PIX...) | | 103 a 110 | Zeros | 008 | N | Texto | Zeros | | 111 a 116 | Data Ocorrência | 006 | A | Texto | Data de Ocorrência (formato DDMMAA) | | 117 a 126 | Seu Número | 010 | A | Texto | Seu Número (número atribuído pela empresa, retornado pelo BV) | | 127 a 146 | Brancos | 020 | A | Texto | Brancos | | 147 a 152 | Data Vencimento | 006 | N | Data `DDMMAA` | Data de Vencimento do Título (formato DDMMAA) | | 153 a 165 | Valor Nominal | 013 | N | Decimal 0 casas | Valor Nominal do Título (11 inteiros + 2 decimais) | | 174 a 175 | Espécie Título | 002 | N | Número | Identificação da Espécie do Título (Nota 5: 01=Duplicata Mercantil, 08=Serviço, 31=Cartão Crédito) | | 176 a 188 | Tarifa Cobrança | 013 | N | Decimal 0 casas | Tarifa de Cobrança (11 inteiros + 2 decimais) | | 189 a 201 | Outras Despesas | 013 | N | Decimal 0 casas | Outras Despesas (11 inteiros + 2 decimais) | | 202 a 214 | Zeros | 013 | N | Texto | Zeros (11 inteiros + 2 decimais) | | 215 a 227 | Valor IOF | 013 | N | Decimal 0 casas | Valor do IOF (11 inteiros + 2 decimais) | | 228 a 240 | Valor Abatimento Concedido | 013 | N | Decimal 0 casas | Valor do Abatimento Concedido (11 inteiros + 2 decimais) | | 241 a 253 | Valor Desconto Concedido | 013 | N | Decimal 0 casas | Valor do Desconto Concedido (11 inteiros + 2 decimais) | | 254 a 266 | Valor Principal | 013 | N | Decimal 0 casas | Valor Principal recebido (11 inteiros + 2 decimais) | | 267 a 279 | Valor Mora Multa | 013 | N | Decimal 0 casas | Valor de Mora e Multas Pagas pelo Sacado (11 inteiros + 2 decimais) | | 280 a 292 | Valor Outros Creditos | 013 | N | Decimal 0 casas | Valor de Outros Créditos (11 inteiros + 2 decimais) | | 293 a 295 | Brancos | 003 | A | Texto | Brancos | | 296 a 301 | Data Crédito | 006 | A | Texto | Data do Crédito (formato DDMMAA) | | 302 a 303 | Código Instrução Cancelada | 002 | N | Número | Código da Instrução Cancelada (Nota 11) | | 304 a 312 | Zeros | 009 | N | Texto | Zeros | | 313 a 313 | Pagador Aderente DDA | 001 | N | Número | Pagador Aderente ao DDA (1=Aderente, 2=Não Aderente - Nota 25) | | 314 a 353 | Nome Sacado | 040 | A | Texto | Nome do Sacado (pagador) | | 354 a 366 | Zeros | 013 | N | Texto | Zeros (11 inteiros + 2 decimais) | | 367 a 374 | Códigos Erro | 008 | A | Texto | Erros - Registros Rejeitados ou Alegação do Sacado (até 4 códigos de 2 dígitos - Nota 11) | | 375 a 376 | Zeros | 002 | N | Texto | Zeros | | 377 a 378 | Código Liquidação | 002 | N | Número | Código de Liquidação (Nota 12: 01=Outros bancos/guichê, 02=TAA, 03=Home Banking, 08=BV débito...) | | 379 a 394 | Zeros | 016 | N | Texto | Zeros | | 395 a 400 | Número Sequencial Registro | 006 | N | Número | Número Sequencial do Registro no Arquivo | - **Posições não mapeadas pelo sistema:** 166–173. Na leitura ficam ignoradas; na geração saem em branco. ## Trailler Tamanho da linha: **400** posições. | **Posição** | **Nome do Campo** | **Tam.** | **A/N** | **Formato** | **Conteúdo / Regra** | |---|---|---:|:---:|---|---| | 001 a 001 | Identificação Registro | 001 | N | Número | Identificação do Registro Trailer ("9") _(padrão: `9`)_ | | 002 a 002 | Identificação Arquivo Retorno | 001 | N | Número | Identificação do Arquivo Retorno ("2") _(padrão: `2`)_ | | 003 a 004 | Zeros | 002 | N | Texto | Zeros | | 005 a 007 | Número Banco Comp | 003 | N | Número | Número do Banco na COMP ("655" = Banco Votorantim) _(padrão: `655`)_ | | 008 a 017 | Brancos | 010 | A | Texto | Brancos | | 018 a 025 | Quantidade Títulos | 008 | N | Número | Quantidade de Títulos | | 026 a 039 | Valor Total Títulos | 014 | N | Decimal 0 casas | Valor Total dos Títulos (12 inteiros + 2 decimais) | | 040 a 394 | Brancos | 355 | A | Texto | Brancos | | 395 a 400 | Número Sequencial Registro | 006 | N | Número | Número Sequencial do Registro no Arquivo | ## 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 #### Leitura do arquivo (arquivo → sistema) A espécie é guardada como texto, sem conversão. ### Ocorrência #### Leitura do arquivo (arquivo → sistema) Cada código de ocorrência do retorno gera uma movimentação de conta corrente. Liquidações e baixas entram na conciliação; as ocorrências informativas geram movimentação de valor zero. | **Código no arquivo** | **Descrição no manual** | **Tipo de movimentação** | |---|---|---| | `02` | Entrada confirmada | Entrada de Título Confirmada | | `03` | Entrada rejeitada | Entrada de Título Rejeitada | | `06` | Liquidacao normal | Liquidação Boleto | | `07` | Liquidacao parcial | Liquidação Boleto | | `08` | Liquidacao em cartorio | Liquidação em Cartório | | `09` | Baixa simples | Baixa de Título (Informativa) | | `12` | Abatimento concedido | Abatimento Concedido | | `14` | Vencimento alterado | Vencimento do Título Alterado | | `16` | Instrucoes rejeitadas | Instrução Rejeitada | | `18` | Confirmacao da instrucao de alteracao de dias para baixa automatica | Instrução Confirmada | | `19` | Confirmacao da instrucao de protesto | Situação de Protesto/Negativação do Título | | `20` | Confirmacao da instrucao de sustacao de protesto | Situação de Protesto/Negativação do Título | | `21` | Confirmacao da instrucao de nao protestar | Situação de Protesto/Negativação do Título | | `22` | Confirmacao da instrucao de nao baixar automaticamente | Instrução Confirmada | | `23` | Protesto enviado a cartorio | Situação de Protesto/Negativação do Título | | `24` | Confirmacao de alteracao de dias para baixa automatica | Alteração de Dados Confirmada | | `25` | Confirmacao de cancelamento de baixa automatica | Alteração de Dados Confirmada | | `26` | Confirmacao de alteracao do valor nominal | Alteração de Dados Confirmada | | `27` | Confirmacao de alteracao de valor/percentual minimo | Alteração de Dados Confirmada | | `28` | Confirmacao de alteracao de valor/percentual maximo | Alteração de Dados Confirmada | | `29` | Confirmacao de alteracao de valor/percentual minimo e maximo | Alteração de Dados Confirmada | | `32` | Baixa por ter sido protestado | Baixa de Título (Informativa) | | `33` | Confirmacao de protesto | Situação de Protesto/Negativação do Título | | `34` | Confirmacao de sustacao | Situação de Protesto/Negativação do Título | | `35` | Protesto sustado judicialmente | Situação de Protesto/Negativação do Título | | `47` | Transferencia de carteira | Alteração de Dados Confirmada | | `48` | Alteracao de percentual minimo/maximo | Alteração de Dados Confirmada | | `49` | Alteracao de percentual minimo | Alteração de Dados Confirmada | | `50` | Alteracao de percentual maximo | Alteração de Dados Confirmada | | `51` | Alteracao da quantidade de parcelas | Alteração de Dados Confirmada | | `70` | Liquidacao Pix | Liquidação Boleto | Código fora da tabela é registrado como movimentação **Outro**, com o código original. ### Motivos de ocorrência Algumas ocorrências vêm acompanhadas de **códigos de motivo**, que detalham a rejeição, a baixa ou a alteração. Um motivo listado em **Qualquer ocorrência** vale para todas. ??? note "Ocorrência 03 — 38 motivos" | **Motivo** | **Descrição no manual** | |---|---| | 01 | Valor do abatimento invalido | | 02 | Agencia encarregada da cobranca em branco ou invalido | | 03 | Bairro do sacado em branco ou invalido | | 04 | Carteira invalida | | 05 | Cep nao numerico ou invalido | | 06 | Cidade do sacado em branco ou invalido | | 07 | Cnpj do cedente inapto | | 08 | Cnpj/cpf do sacado nao numerico ou igual a zeros | | 09 | Mensagem de cobranca em branco ou invalida para registro do tipo 7 | | 10 | Data de emissao de titulo em branco ou invalido | | 11 | Data de mora em branco ou invalido | | 12 | Data de multa invalida ou inferior ao vencimento do titulo | | 13 | Data de vencimento invalida ou fora de prazo de operacao | | 14 | Data limite para concessao de desconto invalido | | 15 | Sigla do estado invalida | | 16 | Cep incompativel com a sigla do estado | | 17 | Identifica a especie do titulo em branco ou invalido | | 18 | Identificacao do tipo inscricao do sacado em branco ou invalido | | 19 | Instrucao de cobranca invalida | | 20 | Juros de mora maior que o permitido | | 21 | Logradouro nao informado ou deslocado | | 22 | Nome do sacado nao informado ou deslocado | | 23 | Nosso numero ja registrado ou invalido | | 24 | Documento de inscricao do sacado em branco ou invalido | | 25 | Documento de inscricao da empresa em branco ou invalido | | 26 | Ocorrencia invalida | | 27 | Prazo para protesto em branco ou invalido | | 28 | Sacador/avalista nao informado ou deslocado (bancos correspondentes) | | 29 | Seu numero em branco | | 30 | Valor de multa invalido ou maior que o permitido | | 31 | Valor de mora por dia de atraso em branco ou invalido | | 32 | Valor do abatimento a ser concedido invalido | | 33 | Valor de desconto a ser concedido invalido | | 34 | Valor do abatimento a ser concedido invalido | | 35 | Valor nominal do titulo em branco ou invalido | | 50 | Convenio sem codigo do boleto personalizado cadastrado ou codigo diferente do cadastrado | | 53 | Arquivo excedeu a quantidade de linhas permitidas | | 54 | Convenio nao permite mensagem personalizada | ??? note "Ocorrência 16 — 16 motivos" | **Motivo** | **Descrição no manual** | |---|---| | 36 | Valor de abatimento invalido | | 37 | Valor nominal invalido | | 38 | Data de prorrogacao invalida | | 39 | Data de vencimento menor que a data atual ou invalida | | 40 | Valor minimo invalido | | 41 | Valor maximo invalido | | 42 | Valor minimo e/ou maximo invalido | | 43 | Titulo ja baixado, liquidado, com instrucao de protesto ou recusada pelo banco | | 44 | Numero de dias para baixa automatica invalido | | 45 | Titulo sem instrucao de protesto ou baixado/liquidado | | 46 | Sustacao de protesto nao permitida para o titulo | | 47 | Titulo sem instrucao e baixa automatica ou ja baixado/liquidado | | 48 | Recusado cartorio sem custas | | 49 | Recusado cartorio com custas | | 51 | Protesto recusado pelo cartorio | | 52 | Quantidade de parcelas invalida |