📋 Documentação - Importação de Clientes

Guia completo para importação e exportação de dados de clientes

🎯 Objetivo

O sistema permite fazer backup completo dos clientes cadastrados e importar novos clientes ou atualizar dados existentes através de arquivos CSV ou Excel.

📤 Exportação (Backup)

Você pode exportar todos os clientes cadastrados em dois formatos:

✅ Vantagem: Os arquivos exportados já vêm no formato correto para reimportação!

📥 Importação

Formato Obrigatório do CSV

O arquivo CSV deve seguir exatamente este formato:

nome;email;telefone;endereco;cidade;estado;cep;cnpj_cpf João da Silva;joao@email.com;(11) 99999-9999;Rua das Flores, 123;São Paulo;SP;01234-567;123.456.789-00 Maria Santos;maria@email.com;(21) 88888-8888;Av. Principal, 456;Rio de Janeiro;RJ;20000-000;987.654.321-00

Especificações Técnicas

Aspecto Especificação
Separador Ponto e vírgula (;)
Codificação UTF-8
Primeira linha Cabeçalho obrigatório
Tamanho máximo 5 MB

Colunas do Arquivo

Coluna Obrigatória Descrição Exemplo
nome ✅ Sim Nome completo do cliente João da Silva
email ❌ Não E-mail do cliente joao@email.com
telefone ✅ Sim Telefone de contato (11) 99999-9999
endereco ❌ Não Endereço completo Rua das Flores, 123
cidade ❌ Não Cidade São Paulo
estado ❌ Não Estado (UF) SP
cep ❌ Não CEP 01234-567
cnpj_cpf ❌ Não CPF ou CNPJ 123.456.789-00

🔄 Como Funciona a Importação

  1. Validação: O sistema verifica se o formato está correto
  2. Verificação: Para cada linha, verifica se o cliente já existe
  3. Ação:
    • Se o cliente não existe: cria um novo registro
    • Se o cliente já existe: atualiza os dados existentes
  4. Relatório: Mostra quantos foram importados, atualizados e erros
⚠️ Critério de Cliente Existente:
Um cliente é considerado existente se:

❌ Mensagens de Erro Comuns

Erro Causa Solução
"Apenas arquivos CSV são aceitos" Arquivo não é .csv Salve o arquivo como CSV
"Formato de arquivo inválido" Cabeçalho incorreto Use o formato exato do cabeçalho
"Nome e telefone são obrigatórios" Campos obrigatórios vazios Preencha nome e telefone
"Arquivo muito grande" Arquivo > 5MB Divida em arquivos menores

📁 Arquivos de Exemplo

Para facilitar, você pode:

📥 Baixar Exemplo CSV 🔙 Voltar ao Sistema

💡 Dicas Importantes