O guia rápido “Importação de pessoas por planilha” está subdividido nas seções:

• O que é a importação de pessoas por planilha?
• Por que utilizar essa funcionalidade?
• Permissões de usuários
• Como funciona a importação de pessoas por planilha?
• Como importar uma planilha pela tela de Pessoas?
• Como importar uma planilha pela tela Importação de pessoas?
• Visão geral da tela “Importação de pessoas”
• Como processar um arquivo de importação de pessoas?
• O que acontece após o processamento do arquivo?
• Como funciona a exclusão de arquivos importados?
• Como preparar a planilha de importação de pessoas?
• Validações realizadas antes do processamento do arquivo
• Validações de campos obrigatórios
• Validações de CPF e CNPJ
• Validações de cadastros complementares
• Validações de campos com opções padrão
• Validações de município, UF e país
• Validações de formato e tamanho dos campos
• Validações das categorias da pessoa
• Comportamentos especiais durante a importação
• Como consultar municípios disponíveis?
• Configuração para permitir criar pessoa sem categoria
• Boas práticas para importar pessoas por planilha
   

O que é a importação de pessoas por planilha?

A importação de pessoas por planilha é uma rotina que permite criar cadastros de pessoas no sistema a partir de um arquivo preenchido pelo usuário.

Na prática, o usuário baixa ou utiliza o modelo padrão da planilha, preenche os dados das pessoas que deseja cadastrar e anexa esse arquivo no Nomus. Depois disso, o sistema valida as informações, aponta possíveis inconsistências e, quando os dados estiverem corretos, cria automaticamente os cadastros de pessoas.

Essa rotina pode ser utilizada para importar diferentes tipos de pessoas, como clientes, fornecedores, transportadoras, representantes, vendedores, funcionários, sócios, parceiros, fabricantes, motoristas, compradores, entre outros.

Veja uma imagem da opção de importação na tela de "Pessoas":

Por que utilizar essa funcionalidade?

A importação de pessoas por planilha é indicada para empresas que precisam cadastrar muitas pessoas no sistema de uma só vez.

Sem essa funcionalidade, o processo depende de preenchimento manual ou de apoio técnico para tratar os dados e executar scripts de importação. Com a nova rotina, o próprio usuário pode conduzir o processo diretamente no sistema, com validações automáticas e acompanhamento do histórico de arquivos.

Essa funcionalidade ajuda a empresa a:

• Agilizar a criação de cadastros de pessoas;

• Reduzir retrabalho no processo de implantação;

• Evitar digitação manual de grandes volumes de dados;

• Identificar erros de preenchimento antes da criação dos cadastros;

• Garantir que os dados importados respeitem as regras do sistema;

• Acompanhar quais arquivos foram importados e processados;

• Manter rastreabilidade entre o arquivo de origem e as pessoas criadas.

Permissões de usuários

A funcionalidade de importação de pessoas possui permissões específicas.

O sistema apresenta a seção de permissões chamada “Importação de pessoas”, na aba "Permissões" na tela de edição / criação do grupo de usuários.

As permissões são:

• Acessar tela de importação de pessoas: controla o acesso à tela “Importação de pessoas”. Quando o usuário não possui essa permissão, o sistema não exibe a opção de importar planilha de pessoas na tela “Pessoas”.

• Abrir arquivo: controla a exibição da opção para abrir ou baixar o arquivo de origem.

• Excluir arquivo de importação de pessoas: controla a exibição da opção “Excluir”.

• Processar arquivo importado: controla a exibição da opção “Processar arquivo”.

Importante: se uma opção não estiver aparecendo no submenu do arquivo importado, verifique se o usuário possui a permissão correspondente.

Veja uma imagem da seção "importação de pessoas":

Como funciona a importação de pessoas por planilha?

A importação de pessoas funciona em duas etapas principais.

Na primeira etapa, o usuário anexa a planilha no sistema. Ao salvar o arquivo, o Nomus cria um registro na tela “Importação de pessoas” com o status “Pendente de processamento”.

Na segunda etapa, o usuário acessa o arquivo importado e executa a opção “Processar arquivo”. Nesse momento, o sistema valida os dados da planilha e, se não encontrar inconsistências, cria os cadastros de pessoas automaticamente.

Durante o processamento, o sistema também preenche automaticamente o código da pessoa, seguindo a mesma lógica utilizada no cadastro manual de pessoas. Dessa forma, a planilha não precisa ter uma coluna para informar esse código.

Além disso, o sistema mantém o vínculo entre o arquivo importado e as pessoas criadas por ele. Esse vínculo é importante para rastreabilidade e também para permitir que o sistema tente remover as pessoas importadas caso o arquivo processado seja excluído futuramente.

Veja abaixo uma imagem da tela de importar dados de pessoas:

Como importar uma planilha pela tela de Pessoas?

A importação pode ser iniciada diretamente pela tela “Pessoas”.

Para fazer isso, acesse a tela “Pessoas” e localize o ícone utilizado para acessar a planilha padrão de importação de pessoas.

Nesse botão, selecione a opção “Importar planilha de pessoas para o sistema”.

Veja uma imagem da opção “Importar planilha de pessoas para o sistema” em destaque:

Ao selecionar essa opção, o sistema abre a tela “Importar dados de pessoas”.

Nesse modal, informe os dados necessários para anexar a planilha.

Os principais campos e botões são:

• Arquivo: campo utilizado para selecionar a planilha de pessoas que deve ser importada.

• Usuário: o sistema exibe o usuário que está fazendo a importação.

• Data: o sistema exibe a data e a hora da importação. 

• Observações: campo utilizado para registrar informações complementares sobre o arquivo importado. Esse preenchimento ajuda na identificação do arquivo no histórico de importações.

• Salvar: ao clicar nesse botão, o sistema anexa a planilha e cria um registro na tela “Importação de pessoas” com o status “Pendente de processamento”.

• Voltar: ao clicar nesse botão, o sistema retorna para a tela “Pessoas” sem executar nenhuma ação e sem importar o arquivo.

Veja abaixo uma imagem da tela de importar dados de pessoas:

Como importar uma planilha pela tela Importação de pessoas?

Além da tela “Pessoas”, a importação também pode ser iniciada pela nova tela “Importação de pessoas”.

Nessa tela, clique no botão “Importar novo arquivo”.

Ao clicar nesse botão, o sistema abre a tela “Importar dados de pessoas”, onde você pode anexar a planilha e salvar o arquivo.

Depois de salvar, o arquivo é exibido no histórico da tela “Importação de pessoas” com o status “Pendente de processamento”.

Veja uma imagem do botão “Importar novo arquivo”:

Visão geral da tela “Importação de pessoas”

A tela “Importação de pessoas” apresenta o histórico dos arquivos anexados e processados no sistema.

Essa tela permite acompanhar quais arquivos ainda estão pendentes, quais já foram processados, quem realizou a importação, em qual data o arquivo foi anexado e quais observações foram registradas.

Essa tela é importante porque centraliza o controle das importações e permite executar ações como editar, baixar, processar ou excluir arquivos importados.

Na tela “Importação de pessoas”, os arquivos são apresentados em uma tabela com as seguintes colunas:

• Código: identifica o registro da importação no sistema.

• Nome do arquivo: apresenta o nome da planilha anexada pelo usuário.

• Data: apresenta a data em que o arquivo foi importado.

• Usuário: apresenta o usuário responsável pela importação do arquivo.

• Observações: apresenta as observações informadas no momento da importação.

• Status: apresenta a situação atual do arquivo importado.

   

A coluna “Status” pode assumir dois valores, que são:

• Pendente de processamento: indica que o arquivo foi anexado ao sistema, mas ainda não foi processado. Nesse status, as pessoas da planilha ainda não foram criadas.

• Processado: indica que o arquivo foi processado com sucesso e que as pessoas da planilha foram criadas no sistema.

Ao clicar em um arquivo com status “Pendente de processamento”, o sistema apresenta as seguintes opções no submenu:

• Editar: permite alterar as informações do registro de importação, como observações e arquivo anexado, conforme o comportamento definido para a tela.

• Download do arquivo origem: permite baixar a planilha que foi anexada na importação.

• Processar arquivo: executa a validação e o processamento da planilha. Se os dados estiverem corretos, o sistema cria os cadastros de pessoas.

• Excluir: remove o arquivo importado que ainda não foi processado.

Veja uma imagem das opções disponíveis para um arquivo pendente de processamento:

Ao clicar em um arquivo com status “Processado”, o sistema apresenta as seguintes opções no submenu:

• Download do arquivo origem: permite baixar a planilha utilizada na importação.

• Excluir: permite excluir o arquivo processado. Ao executar essa ação, o sistema tenta remover também as pessoas importadas por aquele arquivo, desde que elas não estejam vinculadas a nenhum documento ou entidade do sistema.

Veja uma imagem das opções disponíveis para um arquivo processado:

Como processar um arquivo de importação de pessoas?

Para processar um arquivo, acesse a tela “Importação de pessoas”, clique em um registro com status “Pendente de processamento” e selecione a opção “Processar arquivo”.

Ao executar essa ação, o sistema analisa a planilha e realiza as validações necessárias antes de criar os cadastros.

Se a planilha estiver correta, o sistema cria as pessoas e altera o status do arquivo para “Processado”.

Se a planilha tiver inconsistências, o sistema não cria os cadastros e apresenta mensagens orientando o usuário sobre os ajustes necessários.

O que acontece após o processamento do arquivo?

Após o processamento bem sucedido, o sistema cria os cadastros das pessoas listadas na planilha.

O código da pessoa é preenchido automaticamente pelo Nomus, seguindo a lógica já utilizada no cadastro manual de pessoas.

O sistema também registra internamente qual arquivo originou cada pessoa importada. Isso permite rastrear quais pessoas foram criadas por uma determinada planilha.

Depois do processamento, o status do arquivo passa a ser “Processado”.

Veja uma imagem da planilha padrão de importação:

Como funciona a exclusão de arquivos importados?

A exclusão de arquivos importados depende do status do registro.

Quando o arquivo está com status “Pendente de processamento”, a exclusão remove apenas o registro do arquivo importado, pois nenhuma pessoa foi criada ainda.

Quando o arquivo está com status “Processado”, a exclusão exige mais cuidado, pois o sistema tenta remover as pessoas criadas por aquela importação.

Ao tentar excluir um arquivo já processado, o sistema apresenta a seguinte mensagem “Ao excluir um arquivo já processado, o sistema tentará remover todos os cadastros de pessoas importadas por ele, desde que não estejam vinculadas a nenhum documento. Deseja continuar com essa ação?”.

Os botões disponíveis são:

• Ok: o sistema tenta excluir as pessoas importadas por aquela planilha que não possuem vínculo com outras entidades do sistema.

• Cancelar: o sistema fecha a mensagem e não realiza nenhuma ação.

Importante: o sistema realiza as mesmas validações aplicadas quando uma pessoa é excluída pela tela “Pessoas”. Portanto, se alguma pessoa importada já estiver vinculada a documentos ou outras entidades, o sistema impede sua exclusão e apresentar a mensagem de validação correspondente.

Veja uma imagem da mensagem ao tentar excluir um arquivo já processado:

Como preparar a planilha de importação de pessoas?

Para importar pessoas corretamente, utilize a planilha no padrão esperado pelo sistema.

Os rótulos das colunas estão na primeira linha do arquivo. Esses rótulos são utilizados pelo sistema para identificar quais informações devem ser importadas para cada campo do cadastro da pessoa.

Antes de processar o arquivo, revise principalmente:

• Se os nomes das colunas estão no padrão esperado;

• Se não existem colunas duplicadas;

• Se o campo “Nome” está preenchido;

• Se CPF e CNPJ foram preenchidos de acordo com o tipo de pessoa;

• Se os campos obrigatórios por configuração geral foram preenchidos;

• Se os valores de campos com opções padrão foram digitados corretamente;

• Se os campos respeitam o tamanho máximo permitido.

Veja uma imagem da aba "cadastro de pessoas" da planilha de importação de pessoas padrão:

Validações realizadas antes do processamento do arquivo

Antes de processar o arquivo, o sistema valida a estrutura da planilha.

Colunas com rótulo fora do padrão

Se o sistema não localizar colunas obrigatórias para importação, é apresentada uma mensagem como “O sistema não conseguiu localizar no arquivo as colunas obrigatórias para importação com os nomes: XXXXX, YYYYY, ZZZZZZ”.

Nesse caso, revise os nomes das colunas da planilha e ajuste os rótulos para o padrão esperado.

Colunas duplicadas

Se o sistema localizar mais de uma coluna com o mesmo rótulo, é apresentada uma mensagem como “O sistema localizou mais de 1 coluna com os rótulos: "AAA", "BBB".

Nesse caso, remova ou renomeie as colunas duplicadas antes de processar novamente o arquivo.

Validações de campos obrigatórios

Durante o processamento, o sistema valida os campos obrigatórios do cadastro da pessoa.

Nome da pessoa

O campo “Nome” é obrigatório por padrão no cadastro de pessoas.

Se o campo não estiver preenchido na planilha, o sistema apresenta uma mensagem como “O sistema não conseguiu interpretar os dados na coluna "Nome" nas linhas: 228, 122. O preenchimento do Nome é obrigatório”.

CPF ou CNPJ obrigatório

Quando a configuração geral “Tornar o preenchimento dos campos "CNPJ" ou "CPF" obrigatórios no cadastro de pessoas” estiver ativa, o sistema passa a validar o preenchimento de CPF ou CNPJ conforme o tipo de pessoa.

Se a coluna “Tipo pessoa” estiver preenchida com “Pessoa Física”, o sistema valida o preenchimento da coluna “CPF”.

Mensagem apresentada “O sistema não conseguiu interpretar os dados na coluna "CPF" nas linhas: 228, 122. O preenchimento do CPF é obrigatório de acordo com a configuração geral "Tornar o preenchimento dos campos "CNPJ" ou "CPF" obrigatórios no cadastro de pessoas"”

Se a coluna “Tipo pessoa” estiver preenchida com “Pessoa Jurídica”, o sistema valida o preenchimento da coluna “CNPJ”.

Mensagem apresentada “O sistema não conseguiu interpretar os dados na coluna "CNPJ" nas linhas: 228, 122. O preenchimento do CNPJ é obrigatório de acordo com a configuração geral "Tornar o preenchimento dos campos "CNPJ" ou "CPF" obrigatórios no cadastro de pessoas"”.

Tipo de contribuinte obrigatório

Quando a configuração geral “Tornar preenchimento do campo "Tipo de contribuinte do ICMS" obrigatório no cadastro de pessoas” estiver ativa, o sistema valida o preenchimento da coluna “Tipo Contribuinte”.

Mensagem apresentada “O sistema não conseguiu interpretar os dados na coluna "Tipo Contribuinte" nas linhas: 228, 122. O preenchimento do Tipo de Contribuinte é obrigatório de acordo com a configuração geral "Tornar preenchimento do campo "Tipo de contribuinte do ICMS" obrigatório no cadastro de pessoas"”.

Razão social obrigatória

Quando a configuração geral “Tornar o preenchimento do campo "Razão social/Nome" obrigatório no cadastro de pessoas” estiver ativa, o sistema valida o preenchimento da coluna “Razão social”.

Mensagem apresentada “O sistema não conseguiu interpretar os dados na coluna "Razão social" nas linhas: 228, 122. O preenchimento da Razão social é obrigatório de acordo com a configuração geral "Tornar o preenchimento do campo "Razão social/Nome" obrigatório no cadastro de pessoas"”.

Classificação da pessoa obrigatória

Quando a configuração geral “Tornar preenchimento do campo "Classificação" obrigatório” estiver ativa, o sistema valida o preenchimento da coluna “Classificação da pessoa”.

Mensagem apresentada “O sistema não conseguiu interpretar os dados na coluna "Classificação da pessoa" nas linhas: 228, 122. O preenchimento da Classificação da pessoa é obrigatório de acordo com a configuração geral "Tornar preenchimento do campo "Classificação" obrigatório"”.

Grupo de pessoa obrigatório

Quando a configuração geral “Tornar preenchimento do campo "Grupo de pessoa" obrigatório” estiver ativa, o sistema valida o preenchimento da coluna “Grupo de pessoa”.

Mensagem apresentada “O sistema não conseguiu interpretar os dados na coluna "Grupo de pessoa" nas linhas: 228, 122. O preenchimento do Grupo de pessoa é obrigatório de acordo com a configuração geral "Tornar preenchimento do campo "Grupo de pessoa" obrigatório"”.

CRT obrigatório para clientes

Quando a configuração geral “Tornar o preenchimento do campo "CRT" obrigatório no cadastro de pessoas jurídicas e classificação "Cliente"” estiver ativa, o sistema valida o preenchimento da coluna “CRT” sempre que a coluna “Cliente” estiver preenchida com o valor 1.

Mensagem apresentada “O sistema não conseguiu interpretar os dados na coluna "CRT" nas linhas: 228, 122. O preenchimento do CRT de pessoas da categoria cliente é obrigatório de acordo com a configuração geral "Tornar o preenchimento do campo "CRT" obrigatório no cadastro de pessoas jurídicas e classificação "Cliente""”.

CRT obrigatório para fornecedores

Quando a configuração geral “Tornar o preenchimento do campo "CRT" obrigatório no cadastro de pessoas jurídicas e classificação "Fornecedor"” estiver ativa, o sistema valida o preenchimento da coluna “CRT” sempre que a coluna “Fornecedor” estiver preenchida com o valor 1.

Mensagem apresentada “O sistema não conseguiu interpretar os dados na coluna "CRT" nas linhas: 228, 122. O preenchimento do CRT de pessoas da categoria fornecedor é obrigatório de acordo com a configuração geral "Tornar o preenchimento do campo "CRT" obrigatório no cadastro de pessoas jurídicas e classificação "Fornecedor""”.

CRT obrigatório para transportadoras

Quando a configuração geral “Tornar o preenchimento do campo "CRT" obrigatório no cadastro de pessoas jurídicas e classificação "Transportadora"” estiver ativa, o sistema valida o preenchimento da coluna “CRT” sempre que a coluna “Transportadora” estiver preenchida com o valor 1.

Mensagem apresentada “O sistema não conseguiu interpretar os dados na coluna "CRT" nas linhas: 228, 122. O preenchimento do CRT de pessoas da categoria transportadora é obrigatório de acordo com a configuração geral "Tornar o preenchimento do campo "CRT" obrigatório no cadastro de pessoas jurídicas e classificação "Transportadora""”

E-mail obrigatório para representantes

Quando a configuração geral “Tornar preenchimento do campo E-mail obrigatório no cadastro de representantes” estiver ativa, o sistema valida o preenchimento da coluna “E-mail” sempre que a coluna “Representante” estiver preenchida com o valor 1.

Mensagem apresentada “O sistema não conseguiu interpretar os dados na coluna "E-mail" nas linhas: 228, 122. O preenchimento do e-mail de pessoas da categoria representante é obrigatório de acordo com a configuração geral "Tornar preenchimento do campo E-mail obrigatório no cadastro de representantes"”.

E-mail obrigatório para vendedores

Quando a configuração geral “Tornar preenchimento do campo E-mail obrigatório no cadastro de vendedores” estiver ativa, o sistema valida o preenchimento da coluna “E-mail” sempre que a coluna “Vendedor” estiver preenchida com o valor 1.

Mensagem apresentada "O sistema não conseguiu interpretar os dados na coluna "E-mail" nas linhas: 228, 122. O preenchimento do e-mail de pessoas da categoria vendedor é obrigatório de acordo com a configuração geral "Tornar preenchimento do campo E-mail obrigatório no cadastro de vendedores"”.

Validações de CPF e CNPJ

O sistema valida CPF e CNPJ considerando apenas os números informados.

Isso significa que valores preenchidos com ou sem máscara são tratados da mesma forma. Por exemplo, os preenchimentos “00.000.000/0001-10” e “00000000000110” são interpretados como o mesmo CNPJ.

Depois de extrair os números, o sistema aplica a formatação padrão do campo e realiza as validações de duplicidade de acordo com as configurações gerais.

Duplicidade de CPF

Por padrão, o sistema não permite cadastrar pessoas físicas diferentes com o mesmo CPF.

Quando a configuração “Permitir o cadastro de pessoas diferentes com o mesmo CPF?” estiver desativada, o sistema bloqueia a importação se encontrar duplicidade de CPF na própria planilha.

Mensagem apresentada “Foram encontrados múltiplos registros de pessoa física com o mesmo CPF nas linhas 123 e 321. Por favor, revise o preenchimento da planilha e corrija as duplicidades”.

Se já existir uma pessoa cadastrada no sistema com o mesmo CPF informado na planilha, o sistema apresenta a mensagem “Já existe uma pessoa cadastrada no sistema com o CPF XXXXXX informado no registro da linha 123. Por favor, revise o preenchimento da planilha para evitar duplicidade”.

Quando a configuração estiver ativa, o sistema permite importar pessoas físicas com o mesmo CPF.

Duplicidade de CNPJ

A validação de CNPJ depende da configuração “Permitir o cadastro de pessoas diferentes com o mesmo CNPJ?”.

Essa configuração possui três opções.

Opção 1: Sim, porém as pessoas precisam ter inscrições estaduais diferentes

Nesse cenário, o sistema permite cadastrar mais de uma pessoa jurídica com o mesmo CNPJ, desde que a inscrição estadual seja diferente.

Se forem encontrados registros na planilha com o mesmo CNPJ e a mesma inscrição estadual, o sistema apresenta a mensagem “Foram encontrados múltiplos registros de pessoa jurídica com o mesmo CNPJ e a mesma inscrição estadual nas linhas 123 e 321. Por favor, revise o preenchimento da planilha e corrija as duplicidades.”

Se já existir no sistema uma pessoa cadastrada com o mesmo CNPJ e inscrição estadual, o sistema apresenta a mensagem “Já existe uma pessoa cadastrada no sistema com o mesmo CNPJ e inscrição estadual informados no registro da linha 123. Por favor, revise o preenchimento da planilha para evitar duplicidade.”.

Opção 2: Sim, mesmo que as pessoas tenham a mesma inscrição estadual

Nesse cenário, o sistema permite cadastrar múltiplas pessoas jurídicas com o mesmo CNPJ, independentemente da inscrição estadual informada.

Opção 3: Não

Nesse cenário, o sistema não permite cadastrar pessoas jurídicas com CNPJ já existente.

Se forem encontrados múltiplos registros com o mesmo CNPJ na planilha, o sistema apresenta a mensagem “Foram encontrados múltiplos registros de pessoa jurídica com o mesmo CNPJ nas linhas 123 e 321. Por favor, revise o preenchimento da planilha e corrija as duplicidades”.

Se já existir uma pessoa cadastrada no sistema com o CNPJ informado na planilha, o sistema apresenta a mensagem “Já existe uma pessoa cadastrada no sistema com o CNPJ XXXXXXX informado no registro da linha 123. Por favor, revise o preenchimento da planilha para evitar duplicidade”.

Validações de cadastros complementares

Algumas informações preenchidas na planilha dependem de cadastros já existentes no sistema.

Esse é o caso dos campos “Grupo de pessoa” e “Classificação da pessoa”.

Esses campos não são obrigatórios por padrão. Portanto, se estiverem vazios e não houver configuração geral obrigando o preenchimento, o sistema não bloqueia a importação.

Porém, se esses campos forem preenchidos, o sistema tenta localizar os respectivos cadastros.

Grupo de pessoa

Se o sistema não localizar um grupo de pessoa correspondente ao valor preenchido na planilha, é apresentada a mensagem “Não foi possível processar o arquivo importado. Por favor, siga as orientações abaixo para conseguir fazer essa operação no sistema. O sistema não conseguiu interpretar os dados na coluna "Grupo de pessoa" nas linhas: 2”.

Classificação da pessoa

Se o sistema não localizar uma classificação da pessoa correspondente ao valor preenchido na planilha, será apresentada a mensagem “Não foi possível processar o arquivo importado. Por favor, siga as orientações abaixo para conseguir fazer essa operação no sistema. O sistema não conseguiu interpretar os dados na coluna "Classificação da pessoa" nas linhas: 2”.

Validações de campos com opções padrão

Algumas colunas da planilha aceitam apenas valores específicos. Se o usuário digitar um valor diferente do esperado, o sistema bloqueia o processamento e apresenta uma mensagem de orientação. Esses campos são:

Tipo de pessoa

Valores permitidos:

• Pessoa Física

• Pessoa Jurídica

Mensagem apresentada nos casos onde a coluna estiver diferente desses valores “O sistema não conseguiu interpretar os dados na coluna "Tipo de pessoa" nas linhas: 2. Os valores permitidos para os campos são "Pessoa Física" e "Pessoa Jurídica"”.

Tipo de contribuinte

Valores permitidos:

• Contribuinte

• Isento

• Não Contribuinte

Mensagem apresentada nos casos onde a coluna estiver diferente desses valores “O sistema não conseguiu interpretar os dados na coluna "Tipo Contribuinte" nas linhas: 2. Os valores permitidos para os campos são "Contribuinte", "Isento" e "Não Contribuinte"”.

Importante: quando o tipo de contribuinte estiver preenchido como “Isento”, o sistema não grava a inscrição estadual no cadastro da pessoa, mesmo que essa informação esteja preenchida na planilha.

CRT

Valores permitidos:

• Simples Nacional

• Simples Nacional - excesso de sublimite de receita bruta

• Regime Normal

Mensagem apresentada nos casos onde a coluna estiver diferente desses valores “O sistema não conseguiu interpretar os dados na coluna "CRT" nas linhas: 2. Os valores permitidos para os campos são "Simples Nacional", "Simples Nacional - excesso de sublimite de receita bruta" e "Regime Normal"”.

Validações de município, UF e país

Município e UF

O sistema valida município e UF de forma combinada.

Isso significa que o Nomus compara a concatenação entre o município e a UF informados na planilha para localizar uma opção existente na tabela de municípios do sistema.

Se o sistema não localizar a combinação informada, é apresentada a mensagem “O sistema não conseguiu interpretar os dados na coluna "Município" nas linhas: 2. Sugerimos consultar a tela 'Municípios'”

País

O sistema também valida o valor preenchido na coluna “País”.

Se o valor informado não for localizado na tabela de países do sistema, é apresentada a mensagem “O sistema não conseguiu interpretar os dados na coluna "País" nas linhas: 2”.

Validações de formato e tamanho dos campos

O sistema valida o formato e o tamanho máximo dos campos antes de processar a planilha.

Se algum valor estiver em formato inválido ou ultrapassar o tamanho permitido, o sistema bloqueia o processamento e orienta o usuário a revisar as linhas com problema.

Veja os principais campos validados:

• Nome da pessoa: tamanho máximo de 100 caracteres.

• CNPJ: tamanho máximo de 18 caracteres.

• CPF: tamanho máximo de 14 caracteres.

• Razão social: tamanho máximo de 150 caracteres.

• CEP: tamanho máximo de 10 caracteres.

• Endereço: tamanho máximo de 150 caracteres.

• Número: tamanho máximo de 45 caracteres.

• Complemento: tamanho máximo de 100 caracteres.

• Bairro: tamanho máximo de 255 caracteres.

• Cidade: tamanho máximo de 30 caracteres.

• UF: tamanho máximo de 2 caracteres.

• DDD: tamanho máximo de 5 caracteres.

• Nº telefone: formato numérico e tamanho máximo de 255 caracteres.

• Nº Inscr. Estadual: tamanho máximo de 30 caracteres.

• Nº Inscr. Municipal: tamanho máximo de 45 caracteres.

• E-mail: tamanho máximo de 70 caracteres.

• Data do início do relacionamento com a pessoa: deve estar em formato de data, no padrão DD/MM/AAAA.

Para esses campos, o sistema apresenta mensagens como “O sistema não conseguiu interpretar os dados na coluna 'Nome da pessoa', o tamanho máximo dessa coluna é de 100 caracteres. Por favor revise o preenchimento dessa coluna nas linhas XX, YY”.

No caso de data, a mensagem apresentada é “O sistema não conseguiu interpretar os dados na coluna 'Data do início do relacionamento com a pessoa'. Este campo espera um valor de data (formato padrão esperado: 'DD/MM/AAAA'. Por favor revise o formato nas linhas XX, YY”.

Validações das categorias da pessoa

As colunas de categoria indicam a qual categoria a pessoa pertence.

Essas colunas aceitam apenas o valor 1 ou 0.

Preencha com "1" quando a pessoa pertencer à categoria correspondente. Preencha com o valor "0" ou vazio quando ela não pertencer à categoria.

As colunas de categoria são:

• Cliente

• Fornecedor

• Transportadora

• Lead

• Representante

• Vendedor

• Funcionário

• Sócio

• Parceiro

• Concorrente

• Fabricante

• Responsável contábil

• Motorista

• Comprador

• Intermediador

Se algum desses campos for preenchido com valor diferente de 1, 0 ou vazio, o sistema apresenta uma mensagem como “O sistema não conseguiu interpretar os dados na coluna "Cliente. Este campo aceita somente valor 1, 0 ou vazio. Preencha com 1 para indicar que a pessoa pertence a essa categoria, caso contrário preencha com 0 ou deixe vazio. Por favor revise o preenchimento dessa coluna nas linhas 3”.

Importante: o sistema não permite salvar uma pessoa sem categoria, exceto quando a configuração geral “Permitir criar pessoa sem categoria” estiver habilitada.

Comportamentos especiais durante a importação

Durante o processamento, o sistema também aplica alguns comportamentos especiais para manter a coerência do cadastro.

Se o valor da coluna “Tipo pessoa” for “Pessoa Física” e a coluna “CNPJ” estiver preenchida, o sistema ignora o CNPJ.

Se o valor da coluna “Tipo pessoa” for “Pessoa Jurídica” e a coluna “CPF” estiver preenchida, o sistema ignora o CPF.

Se o valor da coluna “Tipo de contribuinte” for “Isento” e a inscrição estadual estiver preenchida, o sistema não grava a inscrição estadual no cadastro da pessoa.

Como consultar municípios disponíveis?

Para ajudar no preenchimento da planilha, o sistema passa a contar com uma tela de consulta para municípios.

A tela “Municípios” permite consultar os municípios disponíveis no sistema.

Essa tela fica nas configurações do módulo Faturamento.

A tabela apresenta os seguintes campos:

• Nome: apresenta o nome do município.

• UF: apresenta a unidade federativa do município.

• Código IBGE: apresenta o código IBGE do município.

A tela também permite pesquisar pelos campos Nome, UF e Código IBGE.

Veja uma imagem da tela “Municípios”:

Configuração para permitir criar pessoa sem categoria

Por padrão, o sistema não permite criar ou editar uma pessoa sem selecionar pelo menos uma categoria.

Caso o usuário tente salvar uma pessoa sem categoria, o sistema apresenta a mensagem “Não foi possivel salvar a pessoa. Por favor, siga as orientações abaixo para conseguir fazer essa operação no sistema. A Categoria é requerida. Por favor selecione uma categoria. Esse comportamento pode ser alterado na configuração geral "Permitir criar pessoa sem categoria"”.

Para flexibilizar esse comportamento, existe a configuração geral “Permitir criar pessoa sem categoria”.

Essa configuração possui as opções:

• Sim: permite salvar pessoas sem categoria.

• Não: não permite salvar pessoas sem categoria.

A opção padrão é “Não”.

Boas práticas para importar pessoas por planilha

Antes de importar uma planilha, revise se os rótulos das colunas estão exatamente no padrão esperado pelo sistema.

Evite alterar os nomes das colunas do modelo padrão, pois o sistema utiliza esses nomes para interpretar os dados.

Preencha CPF e CNPJ com atenção. O sistema considera apenas os números para validação, mas duplicidades podem bloquear o processamento conforme as configurações gerais.

Consulte previamente a tela “Municípios”  para garantir que os dados preenchidos na planilha existem no sistema.

Cadastre previamente os grupos de pessoa e classificações de pessoa que serão utilizados na importação.

Utilize o campo “Observações” para registrar informações que ajudem a identificar o arquivo posteriormente, como origem dos dados, responsável pelo preenchimento ou finalidade da importação.

Processe primeiro planilhas menores para validar o padrão de preenchimento antes de importar uma grande base de pessoas.

Após o processamento, mantenha o arquivo registrado na tela “Importação de pessoas” para preservar a rastreabilidade da operação.

#VamosEmFrente