Layout Retorno WBA
Estrutura do Arquivo
Planilha XLS (Excel) de retorno gerada pelo VeHub após o processamento do lote. O arquivo tem uma única aba, organizada em três blocos:
- Nome do arquivo:
retorno-wba.xls - Datas:
DD/MM/AAAA - Valores monetários: formato pt-BR — ponto (
.) como separador de milhar e vírgula (,) como decimal, gravados em células do tipo monetário - Campos sem valor: gravados como célula em branco
Cabeçalho da Operação
| Célula | Conteúdo | Origem |
A1:B2 | Nome do cessionário | Cessionário da operação |
C1 | Rótulo ADITIVO AO CONTRATO | Fixo |
H1:L1 | Rótulo CONTA PARA CREDITO | Fixo |
C2 | Rótulo Contrato de Fomento Merc. nr.: | Fixo |
E2 | Número do contrato de fomento | Identificador do contrato do lote; na ausência, o número do convênio do originador |
F2 | Rótulo Assinado em: | Fixo |
G2 | Data de assinatura | Data de registro do lote |
H2 | Rótulo Banco: | Fixo |
I2:J2 | Nome do banco | Conta corrente de crédito do cedente na operação |
K2 | Rótulo N° | Fixo |
L2 | Número do banco | Conta corrente de crédito do cedente na operação |
A3 | Rótulo CÓDIGO CEDENTE: | Fixo |
B3 | Código do cedente; na ausência, o identificador interno | Cedente do lote |
C3 | Rótulo Contratante: | Fixo |
D3:G3 | Razão social do cedente | Cedente do lote |
H3 | Rótulo Agência: | Fixo |
I3 | Agência da conta para crédito | Conta corrente de crédito do cedente |
J3 | Rótulo C/C: | Fixo |
K3:L3 | Número da conta corrente | Conta corrente de crédito do cedente |
A4 | Rótulo DATA OPERAÇÃO: | Fixo |
B4 | Data de geração do arquivo | Data corrente |
C4 | Rótulo CNPJ (MF): | Fixo |
D4:G4 | CNPJ do cedente, com máscara | Cedente do lote |
H4 | Rótulo Nome: | Fixo |
I4:L4 | Razão social do cedente | Cedente do lote |
A5 | Rótulo TOTAL VLR FACE: | Fixo |
B5 | Valor nominal total do lote | Lote |
C5 | Rótulo Proposta: | Fixo |
D5:E5 | Sempre em branco | — |
F5 | Rótulo Operação: | Fixo |
G5 | Nome da operação; na ausência, o identificador interno | Operação do lote |
A6 | Rótulo QTDE DIGITADA: | Fixo |
B6 | Quantidade de títulos do lote | Lote |
C6:G7 | Rótulo Contratada: CNPJ: Reg. Anfac: (texto fixo, sem valores) | Fixo |
H6 | Rótulo CNPJ: | Fixo |
I6:L6 | CNPJ do cessionário, com máscara | Cessionário da operação |
A7:L7 | Linha em branco | — |
Faixa de Grupos (linha 8)
| Célula | Grupo | Colunas abrangidas |
A8 | DEMONSTRATIVO DE CALCULO DA OPERAÇÃO | A a L |
M8:U8 | ENDEREÇO | M a U |
V8:Y8 | DADOS DO CHEQUE | V a Y |
AB8 | NOTA FISCAL | AB |
AC8:AD8 | NOTA FISCAL DE SERVICO | AC e AD |
AE8 | CONFIRMAÇÃO | AE |
AF8 | TÍTULO | AF |
AG8:AS8 | Endossador Por | AG a AS |
AT8:BC8 | Personalizado | AT a BC |
Colunas dos Títulos
Cabeçalho na linha 9; a partir da linha 10, uma linha por título do lote.
| Coluna | Cabeçalho | Tipo | Conteúdo | Exemplo |
| A | CNPJ/CPF SACADO | Texto | CNPJ/CPF do sacado, com máscara | 12.345.678/0001-90 |
| B | RAZÃO SOCIAL/NOME | Texto | Nome ou razão social do sacado (cabeçalho mesclado em B9:C9) | Comercio Silva e Souza Ltda |
| C | — | Texto | Sempre em branco | |
| D | No TÍTULO | Texto | Número do documento do título; se ausente, o identificador do título no lote | 0114800/01 |
| E | D-DUPLICATA C-CHEQUE S-DUP. SERVIÇO N-NOTA PROMIS. P-PARC | Texto | Espécie do título no formato WBA | D |
| F | VENCTO | Data | Data de vencimento do título | 25/06/2026 |
| G | VLR.FACE | Monetário | Valor nominal (de face) do título | 360.066,55 |
| H | QTDE | Inteiro | Quantidade — sempre 1 | 1 |
| I | DDD | Texto | Sempre em branco | |
| J | TELEFONE | Texto | Sempre em branco | |
| K | BANCO | Texto | Sempre em branco | |
| L | DIG | Texto | Sempre em branco | |
| M | LOGRADOURO | Texto | Sempre em branco | |
| N | ENDEREÇO | Texto | Endereço do sacado | DAS FLORES |
| O | NUMERO | Texto | Número do endereço do sacado | 100 |
| P | COMPLEMENTO | Texto | Complemento do endereço do sacado | SALA 2 |
| Q | BAIRRO | Texto | Bairro do sacado | CENTRO |
| R | CIDADE | Texto | Cidade do sacado | Curitiba |
| S | ESTADO | Texto | UF do sacado (sigla de 2 letras) | PR |
| T | CEP | Texto | CEP do sacado, como cadastrado | 01001000 |
| U | E-MAIL | Texto | E-mail do sacado | contato@exemplo.com.br |
| V | CMC7 | Texto | Sempre em branco | |
| W | C1 | Texto | Sempre em branco | |
| X | C2 | Texto | Sempre em branco | |
| Y | C3 | Texto | Sempre em branco | |
| Z | VLR.DESCONTO | Monetário | Valor de desconto do título; na ausência, o valor total do lastro | 1.500,50 |
| AA | LIMITE DESCONTO | Monetário | Valor nominal do lastro | 360.066,55 |
| AB | CHAVE DA NOTA FISCAL | Texto | Chave de acesso da NF-e do lastro | 41260245723174... |
| AC | CHAVE DE VERIFICACAO NFSE | Texto | Código de verificação da NFS-e do lastro | ABCD1234 |
| AD | VALOR NOTA FISCAL / NOTA FISCAL DE SERVICO | Monetário | Valor da nota fiscal do lastro; na ausência, o valor total do lastro | 360.066,55 |
| AE | DATA LIMITE CONFIRMAÇÃO | Texto | Sempre em branco | |
| AF | NÚMERO BANCÁRIO | Texto | Nosso número do título | 00012345678 |
| AG | CNPJ/CPF ENDOSSO | Texto | Sempre em branco | |
| AH | RAZÃO SOCIAL/NOME | Texto | Sempre em branco | |
| AI | DDD | Texto | Sempre em branco | |
| AJ | TELEFONE | Texto | Sempre em branco | |
| AK | LOGRADOURO | Texto | Sempre em branco | |
| AL | ENDERECO | Texto | Sempre em branco | |
| AM | NUMERO | Texto | Sempre em branco | |
| AN | COMPLEMENTO | Texto | Sempre em branco | |
| AO | BAIRRO | Texto | Sempre em branco | |
| AP | CIDADE | Texto | Sempre em branco | |
| AQ | ESTADO | Texto | Sempre em branco | |
| AR | CEP | Texto | Sempre em branco | |
| AS | EMAIL | Texto | Sempre em branco | |
| AT–BC | Personalizado0 … Personalizado9 | Texto | Colunas reservadas — sempre em branco | |
Espécies do Título
Códigos emitidos na coluna E:
| Código | Descrição |
D | Duplicata Mercantil |
UR | Unidade de Recebível |
NFS | Nota Fiscal de Serviço |
ND | Nota de Débito |
CCB | CCB Pré Digital |
NP | Nota Promissória |
Espécies fora dessa lista deixam a célula em branco. O texto do cabeçalho (D-DUPLICATA C-CHEQUE S-DUP. SERVIÇO N-NOTA PROMIS. P-PARC) é a legenda original do layout WBA e não corresponde integralmente aos códigos acima.
Regras
- Geração: o arquivo é produzido quando a operação está configurada com o layout de integração de saída
XLS WBA - Retorno, ou pelo modo Refletir Entradas. - Refletir Entradas: nesse modo, apenas os títulos importados pelo layout de entrada
Xlsx WBA entram na planilha. Se nenhum título do lote veio desse layout, o arquivo não é gerado. - Endossador e colunas personalizadas: os blocos
Endossador Por (AG–AS) e Personalizado (AT–BC) existem para compatibilidade com o layout original e são sempre entregues em branco. - Conta para crédito: os dados de banco, agência e conta vêm do vínculo do cedente com a operação. Sem vínculo cadastrado, as células ficam em branco.
- Documentos: CNPJ/CPF do cedente, do cessionário e do sacado são gravados com máscara. Documento inválido é gravado como veio do cadastro.