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

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	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`