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.

Modelos prontos para baixar

• Baixar modelo CSV
• Baixar modelo JSON

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

Como importar

1. Abra Cadastros > Pessoas.
2. Clique em Opções > Importar.
3. Baixe o modelo pelo botão da própria tela e preencha com os seus dados.
4. Marque Cliente, Fornecedor ou os dois: quem for importado nasce com essas marcações no cadastro.
5. Anexe o arquivo e clique em Enviar/Importar.
6. Confira o resumo com a quantidade de importados e de falhas.

Nota

A opção Importar só aparece para quem tem a permissão de importação de pessoas. Se ela não estiver no menu Opções, peça ao responsável pela empresa para liberar.

Cabeçalho do CSV

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.

Campo a campo

Campo	Obrigatório	Exemplo	Observações
nome	Sim	MARIA SILVA COMERCIO LTDA	Razão social ou nome completo. Sem ele a importação para com erro.
nome2	Não	MERCADINHO DA MARIA	Nome fantasia ou apelido.
contato	Não	MARIA SILVA	Nome da pessoa de contato, usado nos contatos criados.
endereco	Não	RUA DAS FLORES	Logradouro, sem o número.
numero	Não	120	Número do endereço.
bairro	Não	CENTRO
cidade	Não	SAO PAULO
cidadeCodigo	Não	3550308	Código do município no IBGE. Importante para emitir nota fiscal.
uf	Não	SP	Sigla do estado, com duas letras.
cep	Não	01001000	Pode ser informado com ou sem traço.
telefone1	Não	1133334444	Vira o telefone do primeiro contato.
telefone2	Não	11999990000	Quando preenchido, cria um segundo contato. Use para o celular.
email	Não	[email protected]	E-mail em formato inválido é descartado e o contato entra sem e-mail.
cpfcnpj	Não	12345678000195	Pode ser informado com ou sem pontuação.
ie	Não	123456789	Inscrição estadual. Fica apenas com números.
datacadastro	Não	10/01/2026	Data em que a pessoa foi cadastrada no sistema antigo. Formato DD/MM/AAAA.

Modelo JSON

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 que o sistema ajusta sozinho

• 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.

Erros comuns

Sintoma	Causa provável	Como corrigir
arquivo incompatível com o arquivo csv do modelo de pessoas	Cabeçalho fora do modelo, separador diferente de ; ou arquivo sem linhas	Baixe o modelo de novo e copie os seus dados para dentro dele.
Algumas linhas não entraram	Linha sem o campo nome	Preencha o nome em todas as linhas.
Pessoa importada sem telefone	Telefone só na coluna de celular de outro sistema	Traga o celular em telefone2.
Pessoa importada sem e-mail	E-mail com erro de digitação	Corrija o endereço de e-mail no arquivo e importe novamente.
Pessoa não aparece como cliente	As opções Cliente/Fornecedor não foram marcadas antes de importar	Marque a opção correta e refaça a importação.

Antes de importar

• 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