Skip to main content

​
Como Importar um Extrato Bancário via CSV

Objetivo: Importar um extrato bancário de arquivo CSV ou Excel para o NovaGestão Tempo estimado: 5-10 minutos Pré-requisitos:
  • Conta bancária já cadastrada no sistema
  • Arquivo CSV ou Excel com transações bancárias
  • Permissão de importação de dados

​
Solução Rápida

  1. Acesse Operações > Importação
  2. Selecione Transações Bancárias
  3. Faça upload do arquivo CSV/Excel ou cole dados
  4. Mapeie as colunas para campos do sistema
  5. Execute Dry Run para validar
  6. Confirme a Importação Final

​
Passo a Passo

​
Passo 1: Acesse a Ferramenta de Importação

Página de importação Navegue até Operações > Importação no menu lateral.

​
Passo 2: Selecione o Tipo de Dados

Seleção de tipo Escolha Transações Bancárias na lista de tipos disponíveis.

​
Passo 3: Faça Upload do Arquivo

Upload de arquivo Você tem três opções: Opção A - Arrastar e Soltar:
  • Arraste o arquivo CSV ou Excel para a área destacada
Opção B - Selecionar Arquivo:
  • Clique em “Selecionar arquivo”
  • Navegue até o arquivo e confirme
Opção C - Colar Dados:
  • Copie dados de Excel ou Google Sheets
  • Clique em “Colar”
  • Cole os dados copiados (Ctrl+V / Cmd+V)
💡 Dica: Para importações rápidas de poucos registros, a opção “Colar” é mais conveniente.

​
Passo 4: Mapeie as Colunas

Mapeamento de colunas Mapeie cada coluna do arquivo para os campos do sistema:
  • Campos obrigatórios: Marcados com asterisco (*)
    • Data da transação
    • Valor (amount)
    • Descrição
    • Conta bancária
  • Campos opcionais: Categoria, contato relacionado, observações
O sistema tenta detectar colunas automaticamente baseado nos nomes dos cabeçalhos.

​
Passo 5: Revise a Pré-Visualização

Pré-visualização Revise os dados antes de importar:
  • 🟢 Linhas válidas: Prontas para importação
  • 🔴 Linhas com erro: Precisam correção
  • 🟡 Avisos: Podem ser importadas mas verifique
Clique em linhas com erro para ver detalhes e corrigir no arquivo original.

​
Passo 6: Execute Dry Run (Simulação)

Opções de importação Antes da importação final:
  1. Selecione Dry Run (Simulação)
  2. Clique em Executar
  3. Aguarde a validação
  4. Corrija erros se houver
  5. Repita até ter 0 erros
💡 Dica: Dry Run NÃO salva dados. Execute quantas vezes precisar para garantir que tudo está correto.

​
Passo 7: Importação Final

Quando tudo estiver validado:
  1. Selecione Importação Final
  2. Clique em Executar
  3. Aguarde o processamento
  4. Verifique mensagem de sucesso
  5. Acesse Financeiro > Transações para ver os dados importados

​
Variações Comuns

Se seu CSV usar ponto-e-vírgula (;) como delimitador:
  • O sistema detecta automaticamente
  • Caso não detecte, ajuste nas configurações de upload
Para importar de múltiplas contas bancárias:
  • Importe um arquivo por vez para cada conta
  • Ou inclua coluna com nome da conta bancária no CSV
Para grandes volumes (>10.000 linhas):
  • Divida em lotes menores (5.000-10.000 por arquivo)
  • Melhora performance e facilita identificação de erros

​
Formatos de Arquivo Aceitos

​
CSV (Comma-Separated Values)

  • Codificação: UTF-8 recomendado
  • Delimitador: vírgula (,) ou ponto-e-vírgula (;)
  • Primeira linha deve conter cabeçalhos

​
Excel (XLSX/XLS)

  • Formatos: .xlsx, .xls
  • Lê apenas a primeira planilha
  • Primeira linha deve conter cabeçalhos

​
Problemas Comuns

“Data inválida”
  • Causa: Formato de data não reconhecido
  • Solução: Use formato YYYY-MM-DD ou DD/MM/YYYY
“Valor numérico inválido”
  • Causa: Texto ou símbolos em campo numérico
  • Solução: Remova caracteres não numéricos (deixe apenas números, ponto e hífen)
“Conta bancária não encontrada”
  • Causa: Nome da conta no CSV não corresponde ao cadastrado
  • Solução: Crie a conta bancária antes da importação ou ajuste o nome no CSV
“Campo obrigatório vazio”
  • Causa: Coluna obrigatória sem valor em alguma linha
  • Solução: Preencha o campo no arquivo ou remova a linha
“Arquivo muito grande”
  • Causa: Arquivo com muitas linhas ou tamanho excessivo
  • Solução: Divida em arquivos menores (5.000-10.000 linhas cada)

​
Veja Também