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
Seção intitulada “Modelos prontos para baixar”São os mesmos arquivos oferecidos na tela de importação, em Baixar modelo CSV e Baixar modelo JSON.
Como importar
Seção intitulada “Como importar”- No menu lateral, clique em Cadastros Gerais.
- Clique em Pessoas.

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

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

- Ver no manual, Baixar modelo CSV e Baixar modelo JSON: abrem esta página e baixam os arquivos de modelo para preencher.
- 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.
- Cliente: quem for importado nasce marcado como cliente no cadastro.
- Fornecedor: quem for importado nasce marcado como fornecedor. Marque os dois se a lista tiver os dois tipos.
- Enviar/Importar: começa a importação. O botão só fica ativo depois de anexar o arquivo.
- 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.
Cabeçalho do CSV
Seção intitulada “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
Seção intitulada “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
Seção intitulada “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", } ] }]O que o sistema ajusta sozinho
Seção intitulada “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.
Importar de novo duplica as pessoas?
Seção intitulada “Importar de novo duplica as pessoas?”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.
Erros comuns
Seção intitulada “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 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 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
Seção intitulada “Antes de importar”- Arquivo salvo em CSV com separador
;(ou em JSON) - Cabeçalho igual ao do modelo
-
nomepreenchido em todas as linhas - CPF/CNPJ conferidos, sem repetição indevida
- Opções Cliente e Fornecedor definidas conforme a lista