Importação CSV — Lançamentos

Importe lançamentos em lote via arquivo CSV.

Onde fica

Não existe "Importação" no menu, nem uma tela de importação. E, ao contrário do que se poderia esperar, a tela de Lançamentos não importa — a importação vive dentro da conta:

Contas financeiras → abra a conta → pílula Importar.

observação

Não há seletor de conta de destino. A conta é aquela em que você já está: todos os lançamentos do arquivo entram nela. Para importar em duas contas, são duas importações.

É preciso ter uma empresa específica selecionada no cabeçalho, e a conta precisa estar vinculada a uma empresa. Nos dois casos o painel avisa: "Selecione uma empresa específica para importar lançamentos."

O botão Baixar modelo entrega um CSV de exemplo com o cabeçalho correto — é o ponto de partida mais seguro, porque já vem no encoding certo.

Colunas do CSV

Coluna	Obrigatório	Descrição
data	✅	Data do lançamento
descricao	✅	Descrição do lançamento
valor	✅	Valor em reais, sempre positivo
tipo	✅	entrada (crédito) ou saida (débito)
categoria	—	Nome da categoria (deve já existir — não é criada; nome sem correspondência fica em branco)
pessoa	—	Nome da pessoa (cria se não existir). Alias: cliente_fornecedor
centro_custo	—	Nome do centro de classificação (deve já existir — não é criado). Alias: centro_de_custo
documento	—	Identificador do documento
observacao	—	Observações

aviso

O cabeçalho deste arquivo é em português, e só em português. Diferente do CSV de contas a pagar e a receber — que aceita tanto description quanto descricao —, aqui os nomes canônicos já são os portugueses e não há equivalente em inglês. Um arquivo com description, amount e date é recusado inteiro, por coluna obrigatória ausente.

Colunas que o sistema não conhece são ignoradas em silêncio.

Formato

• Cabeçalho — maiúsculas, acentos e espaços não importam: Descrição, DESCRICAO e descricao são a mesma coluna.
• Separador — , ou ;, detectado pela linha de cabeçalho. Em caso de empate, ;.
• Datas — 31/12/2026, 31-12-2026 ou 2026-12-31.
• Valores — 1234.56, 1.234,56, 1234,56, com ou sem R$. O valor precisa ser maior que zero: quem decide se é entrada ou saída é a coluna tipo, nunca o sinal do valor.

aviso

A codificação precisa ser UTF-8, e é aqui que a maioria dos arquivos tropeça. O Excel em português salva CSV em Windows-1252 por padrão, e o sistema recusa: "Arquivo não está em UTF-8. Salve novamente em UTF-8 e tente novamente." No Excel, use Salvar como → CSV UTF-8; ou parta do modelo baixado.

Outras recusas do arquivo inteiro: extensão diferente de .csv, tamanho acima de 5 MB, arquivo vazio, e coluna obrigatória ausente — "Colunas obrigatórias ausentes: tipo". Nesses casos não há preview: o problema é do arquivo, não de uma linha.

Importar

1. Envie o arquivo. O sistema lê e mostra o preview.
2. As linhas válidas já vêm marcadas. Clique numa linha para desmarcá-la.
3. Clique em Importar N linhas.

Linhas com erro

Linhas inválidas aparecem no preview com um marcador vermelho, e não podem ser selecionadas nem editadas ali. Não há correção dentro do sistema. A própria tela diz o caminho: "Desmarque as linhas com erro ou corrija-as no arquivo e envie novamente."

O número em Linha N é o número da linha no arquivo, contando o cabeçalho — a primeira linha de dados é a 2.

A gravação roda em segundo plano

Ao confirmar, você recebe "Importação iniciada em segundo plano" e um diálogo de progresso. Pode fechar o diálogo — a importação continua, e o progresso fica visível no canto inferior direito.

Vínculos

A pessoa é criada automaticamente quando o nome não existe. Categoria e centro de classificação não são criados: nome sem correspondência deixa o campo em branco, sem erro e sem aviso.

As regras automáticas são aplicadas aos registros importados.

Histórico

Abaixo do painel, a seção Histórico lista as importações com data, arquivo, status (Na fila, Processando, Concluído, Falha, Cancelado), quantas linhas entraram do total e quem pediu.