Skip to main content

​
Importação de Dados

Acesse via Operações > Importação.
O sistema de importação permite carregar grandes volumes de dados de forma rápida e segura. Página de importação

​
Tipos de Dados Suportados

  • Transações Bancárias: Entradas e saídas de contas bancárias
  • Contas a Pagar: Compromissos com fornecedores (faturas reais)
  • Contas a Receber: Valores a receber de clientes (faturas reais)
  • Orçamento - Receitas: Previsões de receitas futuras (planejamento)
  • Orçamento - Despesas: Previsões de despesas futuras (planejamento)
  • Categorias: Plano de contas/categorias contábeis
  • Contatos: Clientes, fornecedores e outros terceiros

​
Formatos Aceitos

​
CSV (Comma-Separated Values)

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

​
Excel (XLSX)

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

​
Colar (Clipboard)

Colar dados
  • Cole dados copiados de Excel, Google Sheets, ou CSV
  • Detecta automaticamente delimitadores
  • Útil para importações rápidas

​
Workflow de Importação

​
Passo 1: Selecione o Tipo de Dados

Seleção de tipo Escolha o tipo de dados que deseja importar.

​
Passo 2: Faça Upload ou Cole Dados

Upload de arquivo
  • Arraste e solte o arquivo, ou
  • Clique para selecionar arquivo, ou
  • Cole dados copiados

​
Passo 3: Mapeie as Colunas

Mapeamento de colunas Mapeie cada coluna do arquivo para os campos do sistema:
  • Campos obrigatórios: Marcados com asterisco (*)
  • Campos opcionais: Podem ser deixados em branco
  • Mapeamento automático: Sistema tenta detectar colunas automaticamente

​
Passo 4: Pré-Visualização e Validação

Pré-visualização Revise os dados antes de importar:
  • Linhas válidas: Marcadas em verde
  • Linhas com erro: Marcadas em vermelho
  • Avisos: Marcados em amarelo
Clique em erros para ver detalhes e corrigir.

​
Passo 5: Importação

Opções de importação Escolha o modo de importação:
  • Dry Run (Simulação): Valida sem salvar (recomendado)
  • Importação Final: Salva os dados no banco
Execute sempre um Dry Run primeiro para identificar erros antes da importação final.

​
Validações e Erros Comuns

ErroCausaSolução
Campo obrigatório vazioColuna obrigatória sem valorPreencha o campo no arquivo
Data inválidaFormato de data não reconhecidoUse formato YYYY-MM-DD ou DD/MM/YYYY
Valor numérico inválidoTexto em campo numéricoRemova caracteres não numéricos
Categoria não encontradaCategoria não existe no sistemaCrie a categoria antes ou ajuste o nome
Conta bancária não encontradaConta não existeCrie a conta antes ou ajuste o nome

​
Perguntas Frequentes

Posso desfazer uma importação?
Funcionalidade de desfazer importação está em desenvolvimento. Atualmente, registros importados devem ser removidos manualmente.
Como importar arquivo com milhares de linhas? O sistema suporta arquivos grandes. Para melhor performance, divida arquivos >10.000 linhas em lotes menores. Posso importar dados parciais? Sim. Linhas com erro são ignoradas. Linhas válidas são importadas normalmente.

​
Formatos Específicos por Tipo

​
Orçamentos de Receitas

Colunas esperadas para importação de orçamentos de receitas: 
customer_name,description,budgeted_date,budgeted_amount,category
Cliente ABC,Venda prevista - Projeto X,2025-11-15,10000.00,Receita de Serviços
Cliente XYZ,Consultoria mensal,2025-11-30,5000.00,Receita de Consultoria
Campos:
  • customer_name (opcional): Nome do cliente relacionado
  • description (obrigatório): Descrição da receita prevista
  • budgeted_date (obrigatório): Data prevista de recebimento (formato YYYY-MM-DD ou DD/MM/YYYY)
  • budgeted_amount (obrigatório): Valor orçado (número positivo)
  • category (opcional): Nome da categoria contábil

​
Orçamentos de Despesas

Colunas esperadas para importação de orçamentos de despesas: 
vendor_name,description,budgeted_date,budgeted_amount,category
Fornecedor ABC,Compra de equipamento,2025-11-20,-15000.00,Despesas com Equipamentos
Fornecedor XYZ,Aluguel mensal,2025-11-05,-3000.00,Despesas Operacionais
Campos:
  • vendor_name (opcional): Nome do fornecedor relacionado
  • description (obrigatório): Descrição da despesa prevista
  • budgeted_date (obrigatório): Data prevista de pagamento (formato YYYY-MM-DD ou DD/MM/YYYY)
  • budgeted_amount (obrigatório): Valor orçado (número negativo para despesas)
  • category (opcional): Nome da categoria contábil
  • Use “Orçamento - Receitas/Despesas” para planejamento e previsões financeiras
  • Use “Contas a Pagar/Receber” para faturas reais com clientes/fornecedores
Veja mais em: Documentação de Orçamentos

​
Veja Também