Formato do Arquivo¶
Características Gerais¶
- Tipo de Arquivo: XLSX (planilha Excel)
- Planilha lida: apenas a primeira da pasta de trabalho
- Identificação das colunas: por nome do cabeçalho — insensível a caixa, sensível a acento
- Linha do cabeçalho: localizada nas 10 primeiras linhas pela coluna
CNPJ Sacado - Encoding: UTF-8
Estrutura¶
Planilha Excel com uma linha de cabeçalho, uma linha por título e um totalizador no rodapé. As colunas são localizadas pelo nome do cabeçalho, então a ordem física não é obrigatória e colunas extras são ignoradas.
A leitura para na linha que contém o texto TOTAL em qualquer coluna mapeada, ou na primeira linha sem CNPJ Sacado, sem NF e sem Vencimento.
Regras¶
Campos de Texto¶
- Texto simples na célula
- Apenas os espaços das pontas são removidos
Documentos e CEP¶
- CPF, CNPJ e CEP são reduzidos a somente dígitos — pontos, barras, hífens e vírgulas são removidos
- CEP é completado com zeros à esquerda até 8 posições
Campos Numéricos¶
- Aceita célula numérica ou texto
- Formato invariant (
1234.56) e pt-BR: ponto (.) como separador de milhar e vírgula (,) como separador decimal - Valores monetários são arredondados para 2 casas decimais
Taxa a.m.é uma fração, não um percentual:0,0315significa 3,15% a.m.
Datas¶
- Aceita serial do Excel, célula de data e texto no formato
DD/MM/AAAA
Gravação¶
O arquivo é processado em transação única: uma linha inválida ou qualquer validação reprovada rejeita o arquivo inteiro, sem importação parcial. As mensagens de erro informam o número da linha.