Pular para o conteúdo principal

Importar, exportar e mesclar pessoas

Para que serve​

Esta página reúne as três operações em massa do cadastro de pessoas: importar de uma planilha, exportar a listagem e mesclar dois cadastros duplicados num só.

Onde fica​

As três ficam em Cadastros › Pessoa e também nas telas Cliente (CRM & Vendas, Serviços ou Medições), Fornecedor (Compras ou Medições) e Colaborador (RH). Se a sua empresa não tem um módulo que hospede essas telas, elas aparecem em Cadastros. Se o módulo não aparecer na barra lateral, procure em Módulos › Ver todos.

  • Importar e Exportar: menu ⋮ no topo da listagem.
  • Mesclar com outra: menu ⋮ da linha ou da página da pessoa que vai ficar.

Antes de começar​

  • Para importar, você precisa de permissão de criar em Pessoa (ou na tela de Cliente, Fornecedor ou Colaborador em que está).
  • Para exportar, o seu perfil precisa da ação especial Gerenciar Exportação; sem ela, o item Exportar não aparece.
  • Para mesclar, o seu perfil precisa da ação especial Mesclar Pessoas, e as duas pessoas precisam estar ativas.

Importar pessoas de uma planilha​

  1. No menu ⋮ do topo da listagem, clique em Importar. Abre o assistente Importar Pessoas, em três etapas: Upload, Validação e Resultados.
  2. Em Template de Importação, escolha o formato (CSV ou XLSX) e, se quiser, marque Incluir dados de exemplo.
  3. Clique em Baixar Template e preencha a planilha seguindo as colunas do modelo.
  4. Arraste o arquivo preenchido para Enviar Arquivo (ou clique para selecionar). Aceita um arquivo por vez, em CSV ou XLSX.
  5. Clique em Validar. O Tesselys confere o arquivo sem gravar nada e mostra Total, Válidos e Inválidos, com a lista de registros (Linha, Nome, Documento, Status e Motivo), que você pode filtrar.
  6. Se houver erros, use Baixar relatório de erros, corrija a planilha e clique em Enviar novo arquivo. Para seguir assim mesmo, clique em Importar: entram só os válidos ("Serão importados X de Y registros. Os inválidos serão ignorados.").
  7. Na etapa Resultados, confira quantas pessoas foram Importadas e quantos Erros houve.

Se nenhum registro for válido, aparece "Nenhum registro válido — Verifique se o arquivo segue o modelo." e a importação não avança.

Linhas que a validação marca como inválidas​

Além dos erros de preenchimento apontados pelo modelo, a validação recusa a linha quando a pessoa já existe ou se repete no arquivo:

Motivo exibidoQuando acontece
"Já existe uma pessoa cadastrada com este documento. A linha será ignorada."Há uma pessoa ativa na empresa com o mesmo CPF/CNPJ
"Documento repetido no arquivo (linha N). A linha será ignorada."O mesmo documento já apareceu numa linha anterior da planilha
"Já existe uma pessoa cadastrada com este nome. A linha será ignorada."Há uma pessoa ativa com o mesmo nome social/fantasia
"Nome repetido no arquivo (linha N). A linha será ignorada."O mesmo nome já apareceu numa linha anterior

A importação nunca altera cadastros existentes. Quem já estava cadastrado é ignorado e contado no aviso "N registros já cadastrados foram ignorados".

O que é criado​

Cada linha válida vira uma pessoa ativa, com os e-mails e telefones preenchidos na planilha. Contatos com o campo vazio são descartados.

Exportar a listagem​

  1. Aplique a busca e os filtros que quiser na listagem.
  2. No menu ⋮ do topo, clique em Exportar.
  3. Escolha o formato: XLSX, CSV ou PDF.

A exportação respeita a busca e os filtros: se você filtrou só clientes de uma cidade, só eles vão para o arquivo.

Mesclar pessoas duplicadas​

Quando a mesma pessoa foi cadastrada duas vezes, a mesclagem junta os dois cadastros num só sem perder o histórico.

  1. Na pessoa que vai ficar (a principal), abra o menu ⋮ e clique em Mesclar com outra.
  2. Em Buscar pessoa para mesclar, procure por nome, razão social ou documento e escolha a pessoa que vai sair (a origem). Nas telas de Cliente, Fornecedor e Colaborador, a busca mostra só pessoas com a classificação da tela.
  3. Na Comparação de Dados, escolha, campo a campo, qual valor fica: o da Pessoa Principal ou o da Pessoa Origem. Os campos comparados são nome, nome social/fantasia, tipo de pessoa, gênero, documento, país, estrangeiro, data de nascimento, inscrições municipal e estadual, código externo, endereço e tags. A linha Classificações aparece só para conferência, sem escolha: elas são sempre somadas.
  4. Leia o alerta: "A pessoa origem será inativada e todos os seus vínculos serão transferidos para principal."
  5. Clique em Mesclar Pessoas e confirme.

O que acontece na mesclagem​

ItemResultado
Dados escolhidos na comparaçãoFicam na pessoa principal
Campos vazios na principalSão completados com os dados da origem
ClassificaçõesSomadas: a principal recebe as da origem
E-mails e telefonesPassam para a principal. Um e-mail que a principal já tem não é duplicado, e o principal dela continua sendo o principal
Acesso ao Portal do ClienteFica liberado se qualquer uma das duas tinha acesso
Negócios, lançamentos, contratos e demais registros ligados à origemPassam a apontar para a principal
Pessoa origemÉ inativada
HistóricoA mesclagem fica registrada no Histórico da principal
Ação irreversível

A mesclagem não pode ser desfeita. A pessoa origem é inativada e todos os vínculos dela passam para a principal.

Regras importantes​

RegraDetalhe
Validação não gravaSó o botão Importar cria pessoas
Importação não atualizaPessoas existentes (mesmo documento ou mesmo nome) são ignoradas
Um arquivo por vezCSV ou XLSX, no formato do modelo baixado
Exportação filtradaO arquivo leva o que a busca e os filtros mostram
Mesclagem só entre ativasPessoa inativa não pode ser principal nem origem
Protegidas não mesclamA pessoa da sua própria empresa, pessoas com a classificação Usuário e registros da plataforma não têm a opção
Não com ela mesma"Não é possível mesclar uma pessoa com ela mesma."
IrreversívelNão há desfazer nem reativação da origem

Permissões​

ParaÉ preciso
ImportarCriar em Pessoa (ou na tela de Cliente, Fornecedor ou Colaborador)
ExportarAção especial Gerenciar Exportação
MesclarAção especial Mesclar Pessoas

Veja Permissões e papéis.

Perguntas frequentes​

A importação atualiza pessoas que já existem?​

Não. Pessoas já cadastradas (mesmo documento ou mesmo nome) são ignoradas e contadas no resultado. Para alterar cadastros existentes, edite cada um ou use a mesclagem para duplicados.

Por que uma linha sem documento foi recusada?​

Sem documento, a comparação é feita pelo nome. Se já existe uma pessoa ativa com o mesmo nome social/fantasia, ou o nome se repete na planilha, a linha é ignorada.

Posso importar só parte da planilha?​

Sim. Depois da validação, ao clicar em Importar, só os registros válidos entram. Baixe o relatório de erros para corrigir o restante e importar depois.

Qual pessoa devo escolher como principal na mesclagem?​

A que tem mais histórico ou o cadastro mais completo. Você abre a mesclagem a partir dela e ainda pode escolher, campo a campo, os dados da outra.

Por que não aparece "Mesclar com outra" numa pessoa?​

Ela é a sua própria empresa, tem a classificação Usuário, é um registro da plataforma, está inativa, ou o seu perfil não tem a ação Mesclar Pessoas.

Depois de mesclar, consigo recuperar a pessoa origem?​

Não. A mesclagem é irreversível e a pessoa origem fica inativa.

Próximos passos​

Ainda com dúvida?

A nossa equipe ajuda você a configurar e usar esse recurso.