Importar Clientes via CSV ou Excel
Importe dezenas ou centenas de clientes de uma só vez a partir de um arquivo CSV ou Excel.
Como importar (3 etapas)
Etapa 1 — Upload do arquivo
- Acesse Clientes no menu lateral
- Clique em Importar (ícone de upload)
- Opcionalmente, clique em Baixar modelo para obter um arquivo Excel com todas as colunas aceitas e um exemplo preenchido
- Arraste um arquivo para a área indicada ou clique para selecionar
- Formatos aceitos: .csv, .xlsx, .xls — Máximo 500 linhas
Etapa 2 — Mapeamento de colunas
Após o upload, o sistema tenta mapear automaticamente as colunas do seu arquivo para os campos do sistema.
- Revise o mapeamento sugerido — cada coluna do arquivo é associada a um campo
- Ajuste manualmente selecionando o campo correto no dropdown
- Colunas não desejadas podem ser marcadas como Ignorar
- A coluna Nome é obrigatória — o sistema avisa se não estiver mapeada
- Veja a pré-visualização das 5 primeiras linhas para conferir os dados
- Clique em Importar N clientes
Etapa 3 — Resultado
Após a importação, o sistema mostra:
- Importados (verde): Quantidade de clientes cadastrados com sucesso
- Com erro (vermelho): Quantidade de linhas que falharam
- Detalhes dos erros: Lista linha a linha com o motivo do erro (ex: "Nome é obrigatório", "Email inválido")
Colunas aceitas (23 campos)
| Campo | Tipo | Observação |
|---|---|---|
| Nome * | Texto | Obrigatório |
| Texto | Validado automaticamente | |
| Telefone | Texto | — |
| CPF/CNPJ | Texto | — |
| Tipo (PF/PJ) | Texto | "PF" ou "PJ" |
| RG | Texto | Apenas Pessoa Física |
| Razão Social | Texto | Apenas Pessoa Jurídica |
| Texto | — | |
| Texto | — | |
| Data de Nascimento | Data | Formato DD/MM/AAAA (apenas PF) |
| Profissão | Texto | Apenas PF |
| Estado Civil | Texto | Solteiro, Casado, Divorciado, Viúvo, União Estável (apenas PF) |
| Observações | Texto | — |
| Informações Gerais | Texto | — |
| NIF (Estrangeiro) | Sim/Não | Aceita: sim/não, true/false, 1/0 |
| CEP | Texto | — |
| Logradouro | Texto | — |
| Número | Texto | — |
| Complemento | Texto | — |
| Bairro | Texto | — |
| Cidade | Texto | — |
| Estado | Texto | Sigla (ex: SP, RJ) |
| País | Texto | — |
* Campo obrigatório
Reconhecimento inteligente de colunas
O sistema reconhece automaticamente variações dos nomes das colunas. Por exemplo:
- "nome completo", "name", "cliente" → Nome
- "rua", "endereço", "avenida" → Logradouro
- "pf/pj", "pessoa" → Tipo
- "situação conjugal" → Estado Civil
Dicas
- Baixe o modelo antes de montar seu arquivo para garantir que as colunas estão corretas
- O delimitador do CSV é detectado automaticamente (vírgula, ponto-e-vírgula ou tabulação)
- Campos exclusivos de PF (RG, nascimento, profissão, estado civil) são ignorados para clientes PJ e vice-versa
- Se uma importação tiver erros, os clientes válidos são importados normalmente — apenas as linhas com problema são rejeitadas
- Exporte seus contatos do Google, do celular ou de outro sistema em CSV para migrar facilmente
Permissão necessária: Adicionar Clientes