Skip to main content

​
Como Validar Dados Antes de Importar

Objetivo: Validar dados de importação sem salvar no banco usando Dry Run Tempo estimado: 3-5 minutos Pré-requisitos:
  • Arquivo CSV/Excel preparado para importação
  • Acesso à funcionalidade de importação

​
Solução Rápida

  1. Siga o fluxo de importação até a etapa de pré-visualização
  2. Selecione Dry Run (Simulação)
  3. Execute a validação
  4. Revise erros e avisos
  5. Corrija o arquivo se necessário
  6. Repita até 0 erros
  7. Execute Importação Final quando validado

​
Passo a Passo

​
Passo 1: Chegue até a Pré-Visualização

Pré-visualização Complete os passos iniciais de importação:
  • Selecione tipo de dados
  • Faça upload do arquivo
  • Mapeie as colunas

​
Passo 2: Entenda os Indicadores de Validação

A pré-visualização mostra três tipos de status: 🟢 Linhas Válidas (Verde)
  • Todos os campos obrigatórios preenchidos
  • Formatos corretos
  • Referências válidas (categorias, contas, contatos)
  • Prontas para importação
🔴 Linhas com Erro (Vermelho)
  • Campo obrigatório vazio
  • Formato inválido (data, número)
  • Referência não encontrada
  • NÃO serão importadas
🟡 Linhas com Aviso (Amarelo)
  • Dados válidos mas com alertas
  • Valores incomuns ou duplicados
  • Serão importadas, mas revise

​
Passo 3: Selecione Dry Run

Opções de importação Na seção de opções de importação:
  1. Marque Dry Run (Simulação)
  2. Clique em Executar
  3. Aguarde o processamento
💡 Dica: Dry Run executa todas as validações como se fosse importar, mas não salva nada.

​
Passo 4: Analise os Resultados

Após a execução, o sistema mostra: Resumo da Validação:
  • ✅ X linhas válidas
  • ❌ Y linhas com erro
  • ⚠️ Z linhas com avisos
Detalhamento de Erros:
  • Clique em linhas com erro para ver detalhes
  • Erro específico para cada linha
  • Campo problemático destacado

​
Passo 5: Corrija os Erros

Para cada tipo de erro comum: “Campo obrigatório vazio”
  • Identifique qual campo está vazio
  • Preencha no arquivo original
  • Recarregue o arquivo
“Data inválida”
  • Use formato YYYY-MM-DD ou DD/MM/YYYY
  • Verifique se data existe (ex: 30/02 é inválida)
“Categoria não encontrada”
  • Crie a categoria no sistema antes, ou
  • Ajuste o nome no CSV para corresponder exatamente
“Valor numérico inválido”
  • Remova símbolos (R,, , etc)
  • Use ponto como separador decimal
  • Use hífen para negativos

​
Passo 6: Execute Novo Dry Run

Após corrigir os erros:
  1. Recarregue o arquivo corrigido
  2. Execute novo Dry Run
  3. Verifique se erros foram resolvidos
  4. Repita até ter 0 erros

​
Passo 7: Confirme Importação Final

Quando a validação estiver 100% limpa:
  1. Desmarque Dry Run
  2. Selecione Importação Final
  3. Clique em Executar
  4. Aguarde confirmação de sucesso

​
Variações Comuns

Se você tiver muitos erros (mais de 50):
  • Faça uma amostra pequena primeiro (10-20 linhas)
  • Valide e corrija padrões de erro
  • Aplique correções no arquivo completo
  • Valide arquivo completo depois
Para importações recorrentes:
  • Documente erros comuns encontrados
  • Crie um guia de formatação do arquivo
  • Configure validações no Excel antes de exportar CSV
Para dados parcialmente corretos:
  • Sistema importa apenas linhas válidas
  • Linhas com erro são ignoradas
  • Você pode reimportar apenas as correções depois

​
Problemas Comuns

“Dry Run mostra sucesso mas importação falha”
  • Causa: Raro, pode ocorrer em condições de concorrência
  • Solução: Execute novo Dry Run e tente novamente
“Muitos avisos amarelos, devo ignorar?”
  • Causa: Sistema detecta padrões incomuns
  • Solução: Revise manualmente alguns exemplos, se correto pode importar
“Mesmo erro aparece em todas as linhas”
  • Causa: Problema no mapeamento de colunas
  • Solução: Volte ao passo de mapeamento, verifique campos obrigatórios
“Validação muito lenta”
  • Causa: Arquivo muito grande
  • Solução: Divida em lotes menores para validação mais rápida

​
Quando NÃO usar Dry Run

Situações onde você pode pular diretamente para importação final:
  • Arquivo pequeno (menos de 50 linhas) e você já revisou manualmente
  • Reimportação de arquivo que já foi validado anteriormente
  • Ambiente de teste/desenvolvimento (não produção)
⚠️ Aviso: Sempre use Dry Run em produção com arquivos não testados!

​
Veja Também