O que é

A tela que traz a base de clientes de um sistema anterior (ou de uma planilha) para o AtmusOS, em um arquivo CSV com uma linha por cliente. Cada linha pode trazer também um aparelho.

Para que serve

Começar a usar o sistema com a carteira de clientes já dentro, em vez de cadastrar um a um no balcão.

Quando usar

Na migração inicial, e sempre que chegar uma lista nova (compra de carteira, planilha de outro sistema).

Quem pode usar

Atendente, Gestor, Administrador e Proprietário.

Onde encontrar

Menu Mais → Importar, o botão Importar na lista de Clientes, ou /import. Também pela busca rápida (Ctrl+K).

Como usar

  1. Clique em Baixar modelo para obter um CSV com os cabeçalhos reconhecidos — opcional, mas evita retrabalho.
  2. Clique em Escolher arquivo e selecione o CSV.
  3. O sistema lê o arquivo e mostra o bloco Confira o que entendemos, com:
    • o mapeamento que ele reconheceu (qual coluna é o quê);
    • as 10 primeiras linhas já validadas, com ok ou o erro daquela linha.
  4. Corrija o mapeamento onde estiver errado — cada campo tem um seletor com as colunas do arquivo.
  5. Clique em Importar N linhas.
  6. Acompanhe a barra de progresso.

Campos do mapeamento

Campo Obrigatório
Nome do cliente Sim
CPF ou CNPJ Não
Telefone Não
E-mail Não
Tipo do aparelho Não
Marca Não
Modelo Não
Número de série Não

O sistema reconhece automaticamente os cabeçalhos que as planilhas de sistema antigo costumam usar (Cliente, CPF/CNPJ, Celular, Fone, IMEI, entre outros). O reconhecimento automático é palpite — por isso a tela deixa corrigir antes de gravar.

O que acontece depois

Terminada a importação, o resumo mostra três números:

Número Significado
importados Cadastros criados
já existiam Linhas ignoradas por serem duplicadas
com erro Linhas que não puderam ser importadas

Os erros vêm listados com o número da linha, a mensagem e o valor problemático (até 50 exemplos).

O bloco Importações anteriores guarda o histórico, com arquivo, data, autor e quantidade importada.

Desfazer

Por 24 horas depois da importação, o botão Desfazer importação remove o que foi trazido.

O aviso na tela: “Deu para desfazer nas primeiras 24 horas. Quem já tem OS aberta continua no cadastro.” — desfazer a planilha não pode levar junto o atendimento que começou depois dela.

Regras importantes

  • Reimportar o mesmo arquivo não duplica ninguém. A chave é documento ou telefone — a mesma que o balcão usa para achar cliente. O que já existe conta como “já existia”, não como erro.
  • Linha inválida não aborta o lote. Ela vira erro daquela linha; o resto entra. Uma planilha de cinco mil linhas sempre tem uma com telefone errado.
  • A importação roda em segundo plano, em lotes, com progresso na tela. Dá para sair da tela e voltar.
  • Só CSV. Planilhas em .xlsx precisam ser salvas como CSV antes.
  • Não há importação de OS, peças ou serviços — apenas clientes e, junto deles, um aparelho por linha.

Quem pode fazer isso está detalhado em Papéis e permissões.

Problemas comuns

“O arquivo não tem nenhuma linha além do cabeçalho” O CSV só tem a linha de títulos.

“Escolha qual coluna tem o nome do cliente” O mapeamento do nome não foi reconhecido nem escolhido. Ele é obrigatório.

“Esta importação já foi desfeita” O botão já foi usado uma vez.

“Só é possível desfazer uma importação nas primeiras 24 horas” Passou o prazo. A remoção terá de ser feita cliente a cliente.

Os acentos vieram errados Salve o CSV em UTF-8 no programa de planilha antes de importar.

Importei e os clientes não apareceram Confira o resumo: eles podem ter contado como “já existiam” (duplicados por documento ou telefone).

Desfiz a importação e alguns clientes continuaram Esperado: quem já tem OS aberta permanece no cadastro.

Funcionalidades relacionadas