---
title: Layout Retorno WBA
url: https://docs.vehub.com.br/Layouts/%F0%9F%92%BC%20WBA/Manual/LayoutRetorno/
---
# 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:

| Linhas | Bloco |
|---|---|
| 1 a 7 | [Cabeçalho da operação](#cabecalho-da-operacao) — aditivo ao contrato, dados do cedente, do cessionário e da conta para crédito |
| 8 | [Faixa de grupos](#faixa-de-grupos-linha-8) — títulos mesclados que agrupam as colunas |
| 9 | [Cabeçalho das colunas](#colunas-dos-titulos) — 55 colunas, de `A` até `BC` |
| 10 em diante | Um título do lote por linha |

- **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](#especies-do-titulo) | 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.