O que é a importação via planilha?
A importação de Pessoas via planilha permite cadastrar ou atualizar múltiplos registros de uma só vez, sem a necessidade de editar cada cadastro individualmente. É a forma indicada para realizar cargas iniciais de cadastros ou para corrigir dados em lote, como razão social ou endereço.
O sistema oferece dois modos de operação:
Persistir — cria novos registros de Pessoas que ainda não existem no sistema.
Sobrescrever — atualiza os dados de Pessoas já existentes, identificadas pelo CNPJ/CPF.
⚠️ Nas importações automáticas de NF-e e CT-e, o nome da Pessoa não é sobrescrito automaticamente — isso é uma proteção intencional do sistema. Para corrigir o nome de uma Pessoa, utilize este processo com o modo Sobrescrever.
1. Acessar a tela de Pessoas
No menu principal, navegue até:
Cadastros Gerais > Cadastros Gerais Pessoas > Cadastro
2. Baixar o modelo da planilha
Na tela de listagem de Pessoas, clique no botão "Modelo". O sistema fará o download de um arquivo .xlsx com as abas e colunas no formato correto esperado para a importação.
💡 Sempre utilize o modelo baixado diretamente do sistema para garantir compatibilidade.
3. Preencher a planilha
A planilha possui três abas:
Aba | Descrição |
|
|
ABA_PESSOA | Onde os dados das Pessoas devem ser preenchidos. |
ABA_EXEMPLO | Exemplo preenchido para referência. Não enviar dados reais aqui. |
ABA_COD_IBGE | Tabela de códigos IBGE de municípios para preenchimento correto da cidade. |
Campos principais da ABA_PESSOA:
Campo | Obrigatório | Descrição |
CNPJ / CPF | Sim | Documento da Pessoa (14 dígitos para CNPJ, 11 para CPF) |
Razão Social | Sim | Nome da Pessoa conforme deve aparecer no sistema |
Nome Fantasia | Não | Nome fantasia |
CEP | Não | CEP do endereço |
Logradouro | Não | Rua / Avenida |
Bairro | Não | Bairro |
Código IBGE | Não | Código IBGE do município (consultar ABA_COD_IBGE) |
UF | Não | Estado (sigla, ex: SP) |
💡 Preencha apenas as linhas com dados reais. Não altere os cabeçalhos das colunas.
4. Importar a planilha
Na tela de listagem de Pessoas, clique no botão "Importar". Uma janela será exibida com as seguintes opções:
Selecionar o arquivo — escolha a planilha preenchida no passo anterior.
Escolher o modo de importação:
Persistir — para criar novas Pessoas.
Sobrescrever — para atualizar Pessoas já existentes.
Clicar em Confirmar para iniciar a importação.
5. Verificar o resultado
Após a importação, o sistema exibirá um resumo indicando quantos registros foram criados ou atualizados com sucesso, e se houve erros em alguma linha com a indicação do motivo. Corrija os erros apontados e reimporte apenas as linhas com problema, se necessário.