Importar clientes via planilha CSV

Se você está migrando de um sistema antigo ou tem planilha de clientes herdada, dá pra importar tudo de uma vez. O fluxo é parecido com o importador de produtos, com diferenças no modelo e na validação.

Migrando de outro sistema? Quase todos os ERPs e CRMs exportam clientes em CSV (Tiny, Bling, Conta Azul, Olist). Geralmente você precisa só renomear umas colunas pra bater com o modelo do NF-e Desktop.

Baixe o modelo

Vá em Menu lateralCadastrosContatos e clique em Importar CSV no topo. Clique em Baixar modelo.

Vem um arquivo modelo-contatos.csv com cabeçalho e exemplo.

Estrutura da planilha

As colunas suportadas (com o cabeçalho exato):

Coluna	Obrigatório	Exemplo	Notas
`tipo`	sim	`PF` ou `PJ`	Define os campos exigidos
`nome`	sim	`João Silva` ou `ACME Comércio Ltda`	Nome/Razão social
`nome_fantasia`	não	`ACME`	Só faz sentido pra PJ
`cpf_cnpj`	sim	`12345678900` ou `12345678000190`	Só números, sem máscara
`inscricao_estadual`	condicional	`123456789` ou `ISENTO`	Obrigatório pra PJ contribuinte
`indicador_ie`	sim (PJ)	`1`, `2` ou `9`	Ver tabela abaixo
`email`	não	`joao@email.com`	Pra envio do DANFE
`telefone`	não	`11999999999`	Só números
`cep`	sim	`01310100`	8 dígitos
`logradouro`	sim	`Avenida Paulista`
`numero`	sim	`1000` ou `SN`
`complemento`	não	`Sala 502`
`bairro`	sim	`Bela Vista`
`municipio`	sim	`São Paulo`
`uf`	sim	`SP`	2 letras

Tabela do indicador_ie:

Código	Significado
`1`	Contribuinte ICMS (tem IE ativa)
`2`	Contribuinte isento (MEI, empresa isenta)
`9`	Não contribuinte (ONG, condomínio, PF)

Para PF (Pessoa Física): sempre use indicador 9. Pessoa Física não é contribuinte de ICMS.

Cuidados ao exportar do sistema antigo

Quando você exporta CSV de outro sistema, geralmente vem com:

Máscaras em CPF/CNPJ: 123.456.789-00 → o programa aceita, mas é bom remover pra ficar 12345678900 (mais rápido na validação)
Telefone com formatação: (11) 99999-9999 → remove tudo, deixa só números
CEP com traço: 01310-100 → remove, deixa 01310100
Acentos quebrados: use UTF-8 ao salvar
Linhas em branco no fim: apague antes de importar

No Excel pra limpar máscaras rápido: use Localizar e Substituir (Ctrl+H) — busca por ., -, (, ) e substitui por nada.

Faça o upload e revise

Volte ao assistente, arraste o arquivo. O programa mostra preview das 5 primeiras linhas — confira se as colunas estão alinhadas.

Preview da importação de contatos antes de validar

Clique em Validar. O programa verifica linha por linha:

CPF/CNPJ matemático (dígito verificador)
CEP existente (ViaCEP)
Indicador IE compatível com IE preenchida
Município/UF coerentes com CEP
Campos obrigatórios não vazios

Resolva os erros e importe

Linhas com erro mostram o motivo. Os mais comuns:

"CPF inválido" — dígito verificador errado, dado digitado errado
"CNPJ inválido" — mesmo problema, mais 14 dígitos
"CEP não encontrado" — CEP errado ou inexistente
"IE obrigatória para Indicador 1" — escolheu contribuinte mas deixou IE vazia
"UF não combina com CEP" — CEP é de outro estado

Você pode:

Voltar à planilha, corrigir os erros e re-importar
Importar só as válidas e cadastrar as erradas manualmente depois

Clique em Importar X contatos. Pra 500 contatos, demora ~10 segundos.

Conflito com contatos existentes

Se um CPF/CNPJ no CSV já está cadastrado, o programa pergunta:

Atualizar — sobrescreve com dados do CSV
Manter atual — preserva o que já tem
Aplicar pra todos — usa a mesma decisão pras próximas duplicatas

Pra atualizar contatos em massa (mudou endereço, e-mail), exporte a lista atual, edite e re-importe com "Atualizar".

Próximo passo

Cadastros prontos: produtos ✓ e contatos ✓. Agora você está preparado pra emitir notas reais. Vá pra categoria Emissão ou comece pela NF-e modo simples.