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
- No menu ⋮ do topo da listagem, clique em Importar. Abre o assistente Importar Pessoas, em três etapas: Upload, Validação e Resultados.
- Em Template de Importação, escolha o formato (CSV ou XLSX) e, se quiser, marque Incluir dados de exemplo.
- Clique em Baixar Template e preencha a planilha seguindo as colunas do modelo.
- Arraste o arquivo preenchido para Enviar Arquivo (ou clique para selecionar). Aceita um arquivo por vez, em CSV ou XLSX.
- 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.
- 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.").
- 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 exibido | Quando 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
- Aplique a busca e os filtros que quiser na listagem.
- No menu ⋮ do topo, clique em Exportar.
- 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.
- Na pessoa que vai ficar (a principal), abra o menu ⋮ e clique em Mesclar com outra.
- 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.
- 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.
- Leia o alerta: "A pessoa origem será inativada e todos os seus vínculos serão transferidos para principal."
- Clique em Mesclar Pessoas e confirme.
O que acontece na mesclagem
| Item | Resultado |
|---|---|
| Dados escolhidos na comparação | Ficam na pessoa principal |
| Campos vazios na principal | São completados com os dados da origem |
| Classificações | Somadas: a principal recebe as da origem |
| E-mails e telefones | Passam 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 Cliente | Fica liberado se qualquer uma das duas tinha acesso |
| Negócios, lançamentos, contratos e demais registros ligados à origem | Passam a apontar para a principal |
| Pessoa origem | É inativada |
| Histórico | A mesclagem fica registrada no Histórico da principal |
A mesclagem não pode ser desfeita. A pessoa origem é inativada e todos os vínculos dela passam para a principal.
Regras importantes
| Regra | Detalhe |
|---|---|
| Validação não grava | Só o botão Importar cria pessoas |
| Importação não atualiza | Pessoas existentes (mesmo documento ou mesmo nome) são ignoradas |
| Um arquivo por vez | CSV ou XLSX, no formato do modelo baixado |
| Exportação filtrada | O arquivo leva o que a busca e os filtros mostram |
| Mesclagem só entre ativas | Pessoa inativa não pode ser principal nem origem |
| Protegidas não mesclam | A 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ível | Não há desfazer nem reativação da origem |
Permissões
| Para | É preciso |
|---|---|
| Importar | Criar em Pessoa (ou na tela de Cliente, Fornecedor ou Colaborador) |
| Exportar | Ação especial Gerenciar Exportação |
| Mesclar | Açã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
A nossa equipe ajuda você a configurar e usar esse recurso.