Corrigir erros de importação

Guia completo de solução de problemas para corrigir erros de importação de CSV.

Visão geral

A importação não está funcionando? Este guia ajuda você a identificar e corrigir, passo a passo, erros comuns de importação.

Como funciona a validação da importação

Depois de carregar o seu arquivo e mapear as colunas, o Vecta Desk valida os seus dados:

1. A validação é executada — o Vecta Desk verifica cada linha quanto a erros
2. Os erros são destacados — as linhas problemáticas aparecem em amarelo
3. Você pode corrigir no local — edite as células diretamente na interface de importação
4. Ou remova linhas — ignore completamente os registros problemáticos

Corrija os erros na interface. Não precisa voltar à sua planilha. Edite as células diretamente durante a importação para poupar tempo.

Resolução de problemas passo a passo

Passo 1: Identifique o tipo de erro

Clique numa linha destacada para ver a mensagem de erro específica. Tipos de erro comuns:

Passo 2: Corrija o erro

Siga as instruções específicas abaixo para cada tipo de erro.

Erro: Valor duplicado

O que você verá

As linhas com valores duplicados são destacadas em amarelo na interface de importação antes de a importação começar.

O que significa

Um campo único (e-mail, domínio) pode:

• Já existir no Vecta Desk
• Aparecer duas vezes no seu arquivo

Como corrigir

Opção 1: edite o valor duplicado

1. Clique na célula com o erro
2. Altere para um valor único
3. Continue com a importação

Opção 2: remova a linha duplicada

1. Clique no X ao lado da linha
2. A linha será ignorada durante a importação

Opção 3: deixe o Vecta Desk atualizar o registro existente

1. Garanta que o seu arquivo inclui um identificador único (email, domain ou id)
2. Mapeie o campo do identificador único
3. O Vecta Desk atualizará o registro existente em vez de criar um duplicado

Você também pode atualizar campos únicos:

• Se mantiver o id mas alterar o email, o e-mail será atualizado
• Se mantiver o email mas alterar o id, o id será atualizado

Desde que um identificador único corresponda, o Vecta Desk atualiza o registro.

Como prevenir este erro

Antes de importar:

1. Ordene a sua planilha pelo campo único
2. Remova linhas duplicadas
3. Verifique se os registros já existem no Vecta Desk

Registros excluídos logicamente contam para a unicidade. Verifique o Menu de Comandos → Ver registros excluídos. Os registros lá continuam a impor a unicidade. Exclua-os permanentemente ou restaure e atualize.

Para mais detalhes: Restrições de unicidade.

Erro: Formato inválido

O que você verá

O valor da célula está destacado em amarelo. Passe o cursor sobre ele para ver a mensagem de erro:

{nome do campo} não é um {tipo de campo} válido

O que significa

Os dados não correspondem ao formato esperado para esse tipo de campo.

Como corrigir — por tipo de campo

E-mail

Problema: formato de e-mail inválido. Solução: use o formato nome@dominio.com.

❌ joao.silva@
❌ joao silva@acme.com
✓ joao.silva@acme.com

Domínio

Problema: formato inconsistente pode causar duplicados. Solução: use o formato https://dominio.com (recomendado).

⚠️ acme.com         (válido, mas não recomendado)
⚠️ www.acme.com     (válido, mas não recomendado)
✅ https://acme.com  (recomendado)

Todos os formatos são válidos, mas https://dominio.com é recomendado porque corresponde ao formato usado pela sincronização de e-mail/calendário. Usar outros formatos pode criar empresas duplicadas.

Data

Problema: formato de data não reconhecido. Solução: use o formato YYYY-MM-DD de forma consistente em todo o arquivo.

✓ 2024-03-15        (YYYY-MM-DD)
❌ 03/15/2024        (MM/DD/YYYY)
❌ 15/03/2024        (DD/MM/YYYY)

Telefone

Problema: colunas obrigatórias em falta. Solução: inclua todas as colunas de telefone.

Booleano

Problema: valor booleano incorreto. Solução: use TRUE ou FALSE em maiúsculas.

❌ true
❌ yes
❌ 1
✓ TRUE
✓ FALSE

Seleção / Seleção múltipla

Problema: o valor não corresponde às opções existentes. Solução: use nomes da API, não rótulos de exibição.

Como encontrar nomes da API:

1. Vá a Configurações → Modelo de dados
2. Selecione o objeto e o campo
3. Ative o Modo avançado (alternador no canto inferior direito)
4. Use o nome da API (por exemplo, OPTION_1, não “Option 1”)

❌ High Priority
✓ HIGH_PRIORITY

Moeda

Problema: valor ou código de moeda em falta. Solução: preencha ambas as colunas.

Número

Problema: caracteres não numéricos. Solução: apenas números; ponto para decimais.

❌ R$ 1.234,56
❌ 1,234.56
✓ 1234.56

Para referência completa de formatos: Mapeamento de campos.

Erro: Campo obrigatório em falta

O que você verá

A linha está destacada em amarelo com a célula do campo obrigatório assinalada.

O que significa

Um campo obrigatório está vazio nesta linha.

Como corrigir

Opção 1: insira um valor

1. Clique na célula vazia
2. Insira um valor
3. Continue com a importação

Opção 2: remova a linha

1. Se não tiver os dados, clique em X para ignorar a linha

Como prevenir este erro

Antes de importar, identifique os campos obrigatórios:

1. Vá a Configurações → Modelo de dados
2. Selecione o seu objeto
3. Verifique quais os campos marcados como obrigatórios

Erro: Relação não encontrada

O que você verá

Este erro aparece após o início da importação — a importação falha com uma mensagem como:

Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f

Isto significa que não existe nenhuma Empresa no Vecta Desk com esse identificador específico.

Ao contrário de outros erros, este não é detectado durante a etapa de revisão dos dados. A importação começará e depois falhará quando encontrar a relação em falta.

O que significa

Você está a tentar ligar a um registro que não existe no Vecta Desk.

Como corrigir

Opção 1: importe primeiro os registros pai

1. Cancele a importação atual
2. Importe os registros pai (por exemplo, Empresas)
3. Depois, importe os registros filho (por exemplo, Pessoas)

Opção 2: corrija o valor de referência

1. Verifique o valor de referência no seu arquivo
2. Garanta que corresponde exatamente a um registro existente
3. Verifique o formato: os domínios devem ser https://dominio.com

Opção 3: remova a relação

1. Limpe a célula para importar sem a relação
2. Adicione a relação manualmente mais tarde

Como prevenir este erro

1. Importe na ordem correta:
   • Empresas primeiro
   • Pessoas em segundo (com referências à empresa)
   • Oportunidades em terceiro
2. Verifique os valores de referência:
   • Exporte os registros pai para obter identificadores exatos
   • Use o formato de domínio https://dominio.com
   • Verifique erros de digitação e sensibilidade a maiúsculas/minúsculas

A importação falhará se for feita referência a um registro inexistente. Importe sempre os objetos pai antes dos objetos filho.

Para mais detalhes: Importar relações.

Erro: Arquivo demasiado grande

O que você verá

Este erro aparece ao carregar o seu arquivo — o carregamento é totalmente bloqueado:

Demasiados registros. Até 10000 permitidos

Não poderá avançar para a etapa de revisão dos dados até reduzir o tamanho do arquivo.

O que significa

O seu arquivo tem mais de 10.000 registros.

Como corrigir

Opção 1: divida em vários arquivos

1. Divida os seus dados em arquivos de 10.000 registros ou menos
2. Importe cada arquivo separadamente
3. Mantenha a ordem de importação (Empresas antes de Pessoas)

Opção 2: use a importação via API

Para conjuntos de dados muito grandes, use a API, que não tem limite de registros. Consulte Como importar dados via API.

Erro: Campo não reconhecido

O que significa

Uma coluna no seu arquivo não pode ser mapeada porque o campo não existe no Vecta Desk.

Como corrigir

1. Vá a Configurações → Modelo de dados
2. Selecione o objeto que está a importar
3. Clique em + Adicionar campo
4. Crie o campo personalizado com o tipo apropriado
5. Carregue novamente o seu arquivo

A importação de CSV cria registros, não campos. Todos os campos devem existir antes de importar.

Erro: Relação de usuário vazia

O que significa

Você está a tentar atribuir um registro a um usuário (Proprietário, Responsável), mas a relação não está a ser mapeada.

Causas comuns

1. O usuário não aceitou o convite — o usuário ainda não existe no Vecta Desk
2. O uso do ID de usuário do sistema antigo — o Vecta Desk não consegue corresponder IDs de outro sistema
3. Formato de e-mail incorreto — o e-mail não corresponde à conta do usuário no Vecta Desk

Como corrigir

1. Garanta que todos os usuários aceitaram o convite para o seu espaço de trabalho no Vecta Desk
2. Use o endereço de e-mail do usuário (não o nome nem o ID do sistema antigo)
3. Use o mesmo e-mail que utilizaram para aderir ao Vecta Desk

Os usuários devem aceitar os convites antes de importar. Se um usuário não tiver aceitado o convite, os registros que o referenciem terão relações de usuário vazias.

Lista de verificação antes da importação

Evite erros verificando isto antes de importar:

Requisitos do arquivo

• O arquivo está no formato CSV, XLSX ou XLS
• O arquivo tem menos de 10.000 registros
• O arquivo usa codificação UTF-8

Qualidade dos dados

• Sem e-mails duplicados (para Pessoas)
• Sem domínios duplicados (para Empresas)
• Todas as datas usam um formato consistente
• Todos os domínios usam o formato https://dominio.com

Formatos de campos

• Campos booleanos usam TRUE ou FALSE (maiúsculas)
• Campos de seleção usam nomes da API, não rótulos de exibição
• Campos de telefone têm todas as colunas necessárias
• Campos de moeda têm tanto o Valor como o Código da Moeda

Relações

• Registros pai importados antes dos registros filho
• Colunas de relação referenciam registros existentes
• O formato de domínio corresponde exatamente ao formato do Vecta Desk

Modelo de dados

• Todos os campos personalizados existem em Configurações → Modelo de dados
• As opções de seleção existem antes de importar

Ainda com problemas?

Se já tentou as soluções acima:

1. Baixe o arquivo de exemplo — veja o formato exato que o Vecta Desk espera
2. Exporte os registros existentes — compare o seu arquivo com dados funcionais
3. Teste com um pequeno lote — experimente primeiro 5 a 10 linhas
4. Consulte os artigos de referência:
   • Mapeamento de campos
   • Restrições de unicidade
   • Importar relações
   • Tratamento de erros