---
title: Layout XLSX AG2
url: https://docs.vehub.com.br/Layouts/%F0%9F%92%B3%20AG2/Manual/LayoutXlsx/
---
# Layout XLSX AG2

## Estrutura do Arquivo

Planilha **XLSX (Excel)** para operações AG2. A **primeira linha** contém os cabeçalhos e cada linha seguinte representa um título.

As colunas são identificadas pelo **nome do cabeçalho** (não pela posição), com leitura tolerante a variações de **acento e caixa** — por exemplo, `Data Emissão`, `DATA EMISSAO` e `data emissao` são equivalentes.

A planilha reaproveita as colunas **A–P** do arquivo base e acrescenta **Q (NR Documento)**, **R (NR Parcela)** e **S (Data Emissão)**.

## Espécies de Título

A coluna **Espécie Título** aceita tanto a **sigla** quanto a **descrição** da espécie (a comparação ignora acento e caixa).

| Sigla | Descrição |
|---|---|
| `DM` | Duplicata |
| `UR` | UR |
| `NFSE` | Nota Fiscal Serviço |
| `ND` | Nota de Débito |
| `CCB` | CCB Pré Digital |
| `NP` | Nota Promissória |
| `NC` | Nota Comercial |
| `CT` | Contrato |
| `NF` | Nota Fiscal |
| `CPR` | Cédula de Produto Rural |
| `CTE` | CT-e |
| `CD` | Confissão de Dívida |
| `AD` | Assunção de Dívida |

## Colunas

| Coluna | **Cabeçalho** | **Tipo** | **Descrição** | **Exemplo** |
|---|---|---|---|---|
| A | Item | Inteiro | Numeração sequencial da linha. Informativo — **não importado** | `1` |
| B | Nome do Pagador | Texto | Nome ou razão social do sacado | `Comercio Silva e Souza Ltda` |
| C | CPF/CNPJ do Pagador | Texto | CPF ou CNPJ do sacado (pontuação removida na importação). Define o tipo de pessoa: documento com 12 dígitos ou mais → Pessoa Jurídica; senão → Pessoa Física | `12.345.678/0001-90` |
| D | LOGRADOURO | Texto | Tipo de logradouro (ex.: Rua, Avenida). Concatenado com `ENDEREÇO` para compor o endereço | `RUA` |
| E | ENDEREÇO | Texto | Nome do logradouro / endereço do sacado | `DAS FLORES` |
| F | NUMERO | Texto | Número do endereço do sacado | `100` |
| G | COMPLEMENTO | Texto | Complemento do endereço do sacado | `SALA 2` |
| H | BAIRRO | Texto | Bairro do sacado | `CENTRO` |
| I | CIDADE | Texto | Cidade do sacado | `Curitiba` |
| J | ESTADO | Texto | UF do sacado (sigla de 2 letras) | `PR` |
| K | CEP | Texto | CEP do sacado (pontuação removida na importação) | `01001-000` |
| L | Vencimento | Data | Data de vencimento no formato `DD/MM/AAAA` | `25/06/2026` |
| M | Nosso Número | Texto | Nosso número atribuído pelo banco cobrador (opcional) | `00012345678` |
| N | Seu Número | Texto | Seu número / número de controle do participante (opcional) | `ABC-123` |
| O | Situação | Texto | Situação do título (ex.: `Normal`). Informativo — **não mapeado** para o domínio | `Normal` |
| P | Valor | Decimal | Valor nominal do título. Milhar: ponto. Decimal: vírgula | `360.066,55` |
| Q | NR Documento | Texto | Número base do documento. Combinado com `NR Parcela` gera o número do documento final | `NC-01` |
| R | NR Parcela | Texto | Número da parcela. Combinado com `NR Documento` gera o número do documento final | `1` |
| S | Data Emissão | Data | Data de emissão no formato `DD/MM/AAAA` (última coluna, opcional) | `20/03/2026` |
| — | [Espécie Título](#especies-de-titulo) | Texto | Espécie do título — sigla ou descrição (opcional) | `DM` |

## Regras

- **Identificação por cabeçalho**: as colunas são localizadas pelo nome do cabeçalho, tolerando variações de acento e caixa. A ordem física das colunas não é obrigatória.
- **Número do documento**: quando `NR Documento` e `NR Parcela` estão preenchidos, o número do documento final é gerado como `{NR Documento}/{NR Parcela}` (ex.: `NC-01/1`). Sem a parcela, usa-se apenas o `NR Documento`.
- **Tipo de pessoa**: deduzido automaticamente pelo tamanho do documento do pagador — 12 dígitos ou mais → Pessoa Jurídica; caso contrário → Pessoa Física.
- **Documento e CEP**: a pontuação é removida na importação.
- **Situação**: coluna informativa, não importada para o domínio.
- **Data Emissão**: coluna opcional; se ausente ou vazia, o título é importado mesmo assim.
- **Linhas inválidas**: uma linha com formato inválido é rejeitada individualmente e as demais continuam sendo processadas (importação parcial).

## Exemplo

Cabeçalho e uma linha de dados (representação em pares **coluna → valor**):

| Cabeçalho | Valor |
|---|---|
| Item | `1` |
| Nome do Pagador | `Comercio Silva e Souza Ltda` |
| CPF/CNPJ do Pagador | `12.345.678/0001-90` |
| LOGRADOURO | `RUA` |
| ENDEREÇO | `DAS FLORES` |
| NUMERO | `100` |
| COMPLEMENTO | `SALA 2` |
| BAIRRO | `CENTRO` |
| CIDADE | `Curitiba` |
| ESTADO | `PR` |
| CEP | `01001-000` |
| Vencimento | `25/06/2026` |
| Nosso Número | `00012345678` |
| Seu Número | `ABC-123` |
| Situação | `Normal` |
| Valor | `360.066,55` |
| NR Documento | `NC-01` |
| NR Parcela | `1` |
| Data Emissão | `20/03/2026` |
| Espécie Título | `DM` |