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:
Nnumérico,Aalfanumérico.- Formato — como o campo é lido/gravado. Um campo de domínio numérico pode aparecer como
Textoquando o sistema preserva os zeros à esquerda.Decimal N casasindica vírgula implícita de N casas. Datas e horas seguem a máscara indicada (DDdia,MMmês,AA/AAAAano,HHMMSShora).
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.
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.
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 |
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 |