Erros comuns ao importar CSV e Excel: como identificar e corrigir

Migrar uma base de dados para o Pipefy deveria ser o começo de algo mais organizado. Quando a importação falha, a sensação é de travamento logo no primeiro passo. O problema quase sempre tem uma causa clara, mas a mensagem de erro raramente explica qual é.

Ao terminar este artigo, você vai conseguir identificar a causa do erro, corrigir o arquivo e concluir a importação sem precisar acionar o suporte.

📖  O que você vai aprender aqui:

Por que a importação falha?

O Importer App do Pipefy aceita arquivos no formato XLSX. Antes de qualquer outra verificação, confirme que o arquivo está salvo nesse formato, não como .csv, .xls, ou .ods. Esse é o primeiro ponto de falha e também o mais fácil de corrigir.

Além do formato, as causas mais comuns de erro são:

Células mescladas ou filtros aplicados: o Importer App não consegue ler planilhas com células mescladas ou filtros ativos. O arquivo precisa estar com estrutura limpa, sem essas formatações.

Campos obrigatórios sem preenchimento: se um campo está marcado como obrigatório no formulário do pipe, a coluna correspondente na planilha precisa estar preenchida em todas as linhas. Uma célula vazia em campo obrigatório interrompe a importação.

Formato de dado incompatível: cada tipo de campo no Pipefy espera um formato específico. Data precisa estar em DD/MM/AAAA. Moeda precisa ser número puro sem símbolo. Telefone precisa incluir o código do país sem espaços ou símbolos. Quando o formato não bate, o Pipefy rejeita o dado.

Colunas não mapeadas corretamente: durante a importação, você combina as colunas da planilha com os campos do pipe. Se uma coluna obrigatória ficou sem correspondência, a importação não completa.

Como preparar o arquivo para que a importação funcione?

A preparação correta do arquivo resolve a maioria dos erros antes mesmo de tentar importar. Verifique cada um desses pontos:

• Estrutura da planilha

Formato do arquivo: salve como XLSX. Arquivos .csv não são aceitos pelo Importer App.

Células mescladas: desfaça todas as mesclagens. Selecione a área afetada, clique com o botão direito e escolha Formatar Células para reverter.

Filtros: remova todos os filtros ativos antes de salvar o arquivo.

Células em branco: células vazias são importadas como campos em branco no Pipefy. Se o campo for obrigatório, a linha inteira falha. Preencha ou remova as linhas incompletas.

• Formatação por tipo de campo

A tabela abaixo resume os formatos que o Pipefy espera para cada tipo de campo:

O que fazer quando as colunas não mapeiam corretamente?

O mapeamento é a etapa em que você conecta cada coluna da planilha ao campo correspondente no pipe. Erros nessa etapa são comuns quando os nomes das colunas na planilha não correspondem exatamente aos nomes dos campos no Pipefy.

Para reduzir erros de mapeamento:

Use os mesmos nomes na planilha e no pipe. Se o campo no formulário se chama "Nome do solicitante", nomeie a coluna da planilha da mesma forma. O Pipefy tenta fazer o mapeamento automático por nome: quando bate, elimina o trabalho manual.

Campos sem correspondência podem ser pulados. Durante a configuração, você pode clicar em Skip para ignorar colunas que não têm campo equivalente no pipe. Isso não interrompe a importação.

Campos obrigatórios precisam ser mapeados. Se um campo está marcado como obrigatório no formulário do pipe e você pular a coluna correspondente, a importação falha. Para importar sem preencher esse campo, acesse as configurações do pipe, desmarque a obrigatoriedade temporariamente, conclua a importação e reative depois.

A importação rodou mas os dados chegaram incorretos. O que verificar?

Quando a importação conclui sem erro mas os dados aparecem errados no pipe, o problema geralmente está no formato de um campo específico ou no mapeamento de uma coluna.

• Campo de seleção com valor não reconhecido: se a planilha contém um valor que não existe nas opções cadastradas no campo de seleção do pipe, o Pipefy importa a linha mas deixa esse campo em branco. Verifique se os valores na planilha são idênticos às opções do campo, incluindo maiúsculas, minúsculas e acentos.
• Data importada com formato invertido: se as datas aparecem trocadas (dia e mês invertidos), o Excel está interpretando a data em um formato diferente do que o Pipefy espera. Confirme o idioma configurado na sua conta do Pipefy e ajuste o formato da coluna de data na planilha para corresponder.
• Responsável em branco após importação: o campo de responsável precisa conter o nome, o e-mail ou o ID de um usuário que já existe na empresa no Pipefy. Se o usuário não estiver cadastrado na conta, o campo fica em branco mesmo com o dado preenchido na planilha.
• Números formatados como texto: campos numéricos importados como texto no Excel não são reconhecidos pelo Pipefy como números. Selecione a coluna, formate como Número no Excel e salve antes de importar novamente.
• Depois de corrigir o arquivo, acesse o Histórico no Importer App para verificar o status da importação anterior e confirmar quantas linhas foram processadas com sucesso.

Checklist pré-importação

Antes de clicar em Import cards, verifique cada item:

☐  O arquivo está salvo no formato XLSX

☐  Não há células mescladas na planilha

☐  Não há filtros ativos na planilha

☐  Todos os campos obrigatórios do pipe têm uma coluna correspondente preenchida

☐  Campos de data estão no formato DD/MM/AAAA ou MM/DD/AAAA

☐  Campos de moeda são números puros, sem símbolo ou separador de milhar

☐  Campos de telefone incluem o código do país sem espaços ou símbolos

☐  Valores em campos de seleção são idênticos às opções cadastradas no pipe

☐  Responsáveis listados na planilha são usuários cadastrados na conta do Pipefy

☐  Fiz um teste com 5 linhas antes de importar o arquivo completo