📥 Importação de Dados

Quando usar a importação

Use a importação para cadastrar vários registros de uma vez a partir de um arquivo, em vez de criar um por um manualmente.

---

Formatos aceitos

Formato	Extensão
CSV	.csv
Excel	.xlsx
JSON	.json

---

Passo a passo

1. Baixe o template

O sistema oferece templates prontos com as colunas corretas:

Tipo	Template
Clientes PF	import_kyc_pf.csv
Clientes PJ	import_kyc_pj.csv
Colaboradores	import_kye.csv
Fornecedores	import_kys.csv

Para baixar: Acesse Importações → Templates.

2. Preencha o arquivo

Abra o template no Excel ou Google Sheets e preencha uma linha por registro.

Dica: Não altere os nomes das colunas no cabeçalho.

3. Faça o upload

1. Acesse Importações no menu lateral
2. Clique em Nova Importação
3. Selecione o tipo (KYC PF, KYC PJ, KYE ou KYS)
4. Escolha o arquivo no computador
5. O sistema exibe uma pré-visualização dos dados

4. Confirme o mapeamento

O sistema tenta mapear automaticamente as colunas do arquivo para os campos do sistema. Verifique se está correto e ajuste se necessário.

5. Processe

Clique em Processar. A importação começará em segundo plano.

---

Resultado da importação

Após o processamento, o sistema exibe:

Indicador	Significado
✅ Sucesso	Registros importados com sucesso
❌ Erros	Linhas com problemas (CPF inválido, campo obrigatório vazio, etc.)
⏭️ Ignorados	Registros duplicados (CPF/CNPJ já existe)

Você pode baixar o relatório de erros para ver exatamente qual linha e campo teve problema.

---

Validações realizadas

Para cada linha, o sistema verifica:

• ✅ CPF ou CNPJ válido
• ✅ Campos obrigatórios preenchidos
• ✅ Formato de datas correto
• ✅ Valores numéricos válidos
• ✅ Não há duplicidade no sistema

---

Reverter uma importação

Se a importação teve problemas e precisa ser desfeita:

1. Acesse Importações
2. Encontre o lote e clique em Detalhes
3. Clique em Reverter Lote
4. Informe a justificativa (obrigatória)
5. Confirme

Todos os registros daquele lote serão excluídos logicamente.

A reversão só é possível se os registros não foram modificados após a importação.