Importar clientes por CSV
Como importar uma planilha de clientes no ERP com mapeamento de colunas e prévia.
O que é
Você envia um arquivo CSV (Alloy, Excel exportado ou outro sistema) e o ERP cria os clientes novos, com endereços, pontos e créditos quando mapeados. Clientes que já existem (mesmo telefone ou CPF) são pulados — a tela mostra a quantidade.
Como usar
- No ERP, abra Clientes e clique em Importar CSV.
- Envie o arquivo (até cerca de 10.000 linhas). Arquivos grandes processam em segundo plano após confirmar.
- Confira o mapeamento: cada coluna do arquivo vira um campo (Nome, Telefone, Rua…). Se o nome da coluna for diferente, escolha no select.
- Veja a prévia: quantos serão criados, quantos pulados e erros (erros aparecem no topo; use Ver erros).
- Confirme. No final você vê o resumo e pode baixar a lista dos pulados.
O que entra
- Nome, telefone, CPF, e-mail, nascimento, observações
- Todos os endereços preenchidos (endereços iguais na mesma linha são unificados)
- Pontuação (pontos de fidelidade)
- Saldo de créditos / cashback, se houver coluna ou se o programa usar carteira de créditos
O nome é gravado exatamente como está no arquivo (Alloy às vezes mistura telefone, emoji ou anotação no nome). Limpe depois no cadastro se quiser.
Atenção ao CSV (snapshot)
O arquivo é um retrato do momento da exportação. Se no Alloy você zerou pontos depois de exportar, o import ainda traz o valor antigo do CSV.
Antes de confirmar, revise na prévia:
- Clientes com mais de 10.000 pontos (alerta ⚠)
- Clientes de teste (endereços tipo “Av. Teste”, “Pedido teste”)
Se precisar, remova a linha do CSV ou ajuste a coluna de pontos para 0 e envie de novo.
Perguntas frequentes
O CSV precisa ter as mesmas colunas do Alloy? Não. Qualquer cabeçalho serve — você mapeia no segundo passo.
Cliente já cadastrado é atualizado? Não. Ele é pulado e contado na prévia e no resultado.
Endereços repetidos no arquivo? Se a mesma rua + número + bairro aparecer mais de uma vez na linha do cliente, só o primeiro é gravado.
Cliente sem endereço é importado? Sim, se tiver telefone ou CPF. O endereço fica vazio até você editar depois.