Pular para o conteúdo
Acessar sistema

Importação de pessoas

Quando você está começando a usar o sistema, ou recebeu uma lista de clientes de outro sistema, do contador ou de uma planilha, não precisa cadastrar pessoa por pessoa. A importação lê um arquivo e cria os cadastros de uma vez.

São os mesmos arquivos oferecidos na tela de importação, em Baixar modelo CSV e Baixar modelo JSON.

  1. No menu lateral, clique em Cadastros Gerais.
  2. Clique em Pessoas.

Menu lateral com Cadastros Gerais e Pessoas numerados de 1 a 2

  1. Na lista de pessoas, clique em Opções (1) e depois em Importar (2).

Barra de botões da lista de pessoas com o menu Opções aberto, mostrando Importar, numerados de 1 a 2

Na janela Importacao, baixe o modelo, preencha com os seus dados e anexe o arquivo.

Janela de importação de pessoas com os links dos modelos, a área do arquivo, as marcações Cliente e Fornecedor, o botão Enviar/Importar e o resumo numerados de 1 a 6

  1. Ver no manual, Baixar modelo CSV e Baixar modelo JSON: abrem esta página e baixam os arquivos de modelo para preencher.
  2. Selecionar arquivo ou Soltar arquivo aqui: onde você anexa o arquivo preenchido (CSV ou JSON). Depois de anexado, o nome e o tamanho aparecem na faixa abaixo, com o botão Remover para trocar de arquivo.
  3. Cliente: quem for importado nasce marcado como cliente no cadastro.
  4. Fornecedor: quem for importado nasce marcado como fornecedor. Marque os dois se a lista tiver os dois tipos.
  5. Enviar/Importar: começa a importação. O botão só fica ativo depois de anexar o arquivo.
  6. Resumo: ao terminar, mostra quantas pessoas foram importadas e quantas falharam. Em caso de falha, aparece abaixo a lista das pessoas que não entraram, com o nome de cada uma e o motivo (por exemplo, endereço maior que o permitido). Corrija essas linhas no arquivo e importe só elas de novo.

nome;nome2;contato;endereco;numero;bairro;cidade;cidadeCodigo;uf;cep;telefone1;telefone2;email;cpfcnpj;ie;datacadastro

O separador é o ponto e vírgula (;). A ordem das colunas não importa, mas o nome de cada uma precisa ser exatamente o do modelo.

CampoObrigatórioExemploObservações
nomeSimMARIA SILVA COMERCIO LTDARazão social ou nome completo. Sem ele a importação para com erro.
nome2NãoMERCADINHO DA MARIANome fantasia ou apelido.
contatoNãoMARIA SILVANome da pessoa de contato, usado nos contatos criados.
enderecoNãoRUA DAS FLORESLogradouro, sem o número.
numeroNão120Número do endereço.
bairroNãoCENTRO
cidadeNãoSAO PAULO
cidadeCodigoNão3550308Código do município no IBGE. Importante para emitir nota fiscal.
ufNãoSPSigla do estado, com duas letras.
cepNão01001000Pode ser informado com ou sem traço.
telefone1Não1133334444Vira o telefone do primeiro contato.
telefone2Não11999990000Quando preenchido, cria um segundo contato. Use para o celular.
emailNão[email protected]E-mail em formato inválido é descartado e o contato entra sem e-mail.
cpfcnpjNão12345678000195Pode ser informado com ou sem pontuação.
ieNão123456789Inscrição estadual. Fica apenas com números.
datacadastroNão10/01/2026Data em que a pessoa foi cadastrada no sistema antigo. Formato DD/MM/AAAA.

Use o JSON quando estiver trazendo os dados de uma exportação do próprio sistema ou de um arquivo já estruturado. Os nomes dos campos são os do cadastro de pessoa, diferentes dos títulos das colunas do CSV:

[
{
"name": "MARIA SILVA COMERCIO LTDA",
"name2": "MERCADINHO DA MARIA",
"cpf_cnpj": "12345678000195",
"ident": "123456789",
"address": [
{
"address": "RUA DAS FLORES",
"number": "120",
"neighborhood": "CENTRO",
"city": "SAO PAULO",
"city_code": "3550308",
"state": "SP",
"zip_code": "01001000"
}
],
"contacts": [
{
"name": "MARIA SILVA",
"phone": "1133334444",
"email": "[email protected]"
}
]
}
]
  • O nome é gravado em maiúsculas e sem acentos, que é o padrão do cadastro.
  • CPF/CNPJ, CEP e inscrição estadual ficam só com os números.
  • O endereço só é criado quando pelo menos um dos campos de endereço está preenchido.
  • Os contatos só são criados quando há telefone ou e-mail.

Não. Cada linha é comparada com o cadastro pelo CPF/CNPJ ou, na linha sem CPF/CNPJ, pelo nome. Se a pessoa já existe, o sistema não cria outra: só completa o que está em branco no cadastro dela (nome fantasia, inscrição estadual, endereço quando ela não tem nenhum, contatos quando não tem nenhum) e acrescenta as marcações Cliente e Fornecedor escolhidas. O que já está preenchido não muda.

Linhas repetidas no mesmo arquivo, com o mesmo CPF/CNPJ (ou o mesmo nome, sem CPF/CNPJ), viram um cadastro só, com os dados da última linha.

SintomaCausa provávelComo corrigir
arquivo incompatível com o arquivo csv do modelo de pessoasCabeçalho fora do modelo, separador diferente de ; ou arquivo sem linhasBaixe o modelo de novo e copie os seus dados para dentro dele.
Algumas linhas não entraramLinha sem o campo nome ou com campo fora da regra (texto maior que o permitido, CPF/CNPJ inválido, inscrição estadual)Veja na lista do resumo o nome da pessoa e o motivo, corrija a linha e importe de novo.
Pessoa importada sem telefoneTelefone só na coluna de celular de outro sistemaTraga o celular em telefone2.
Pessoa importada sem e-mailE-mail com erro de digitaçãoCorrija o endereço de e-mail no arquivo e importe novamente.
Pessoa não aparece como clienteAs opções Cliente/Fornecedor não foram marcadas antes de importarMarque a opção correta e refaça a importação.
  • Arquivo salvo em CSV com separador ; (ou em JSON)
  • Cabeçalho igual ao do modelo
  • nome preenchido em todas as linhas
  • CPF/CNPJ conferidos, sem repetição indevida
  • Opções Cliente e Fornecedor definidas conforme a lista