---
title: Formato do Arquivo
url: https://docs.vehub.com.br/Layouts/%F0%9F%92%B3%20Fly%205/Manual/FormatoDoArquivo/
---
# 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,0315` significa 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.