Importação Automatizada de Dados Cadastrais de Funcionários (.CSV)

Modificado em Qui, 13 Nov na (o) 11:20 AM


Informações gerais

 

Objetivo: 

 

Foi implementada uma funcionalidade no sistema de cadastro de funcionários que permite a importação automatizada de dados cadastrais a partir de arquivos no formato .CSV


Detalhes:

 

Módulo: Folha de Pagamento (FLP)

Caminhos de Acesso e Funcionalidade

1. Cadastro do Funcionário

Caminho: FLP → Cadastros → Funcionários → Cadastro de Funcionários

Descrição:

Foi adicionada à tela de cadastro de funcionários a nova funcionalidade "Importação Cadastral", permitindo a inserção automatizada de dados via arquivo .CSV. 

   


 Especificações Funcionais


A funcionalidade de importação automatizada de dados cadastrais via arquivos .CSV, conforme layout definido, já está disponível no sistema de cadastro de funcionários, otimizando o processo de registro de colaboradores. 


O sistema de cadastro de funcionários passou a contar com uma funcionalidade implementada para importação automatizada de dados, a partir de arquivos .CSV estruturados, visando maior agilidade e precisão no cadastramento.


Regras de Validação e Comportamento

  • Apenas um arquivo por colaborador será aceito por vez.

  • O sistema valida:

    • Estrutura do arquivo (formato .CSV, separador correto, cabeçalho presente).

    • Conteúdo dos campos (formato de datas, CPF válido, campos obrigatórios).

  • Arquivos com erros são rejeitados e o usuário recebe uma mensagem informativa.

  • A importação está restrita a rotina de Cadastro de Funcionários.


Funcionalidade de Importação

Local de Acesso

  • Nova opção de "Importar Dados (.CSV)" adicionada à tela de Cadastro de Funcionários.

⚠️ Importante

  • O arquivo de importação deve estar salvo com a extensão .csv, utilizando ponto e vírgula (;) como separador de campos.

  • Para garantir que a estrutura e o posicionamento dos dados sejam mantidos corretamente, recomenda-se abrir o arquivo utilizando o editor Notepad++ ou outra ferramenta que preserve o formato original.

  • Ao final desta documentação, está disponível um arquivo modelo (modelo.csv) que pode ser utilizado como referência para a importação dos dados cadastrais do funcionário.



1. Funcionalidades Implementadas

  • Upload de um arquivo por colaborador.

  • Validação automática da estrutura e conteúdo do arquivo.

  • Preenchimento automático dos campos disponíveis no sistema relacionados ao arquivo csv.

  • Exibição de mensagens de erro em caso de:

    • Formatação incorreta do arquivo.

    • Dados inválidos.

    • CPF já cadastrado com status Ativo ou Afastado.

  • Exigência de preenchimento manual dos campos obrigatórios restantes antes da gravação final.

2. Estrutura do Arquivo .CSV

Formato

  • Arquivo no formato .CSV com separador ponto e vírgula (;).

  • Primeira linha deve conter o cabeçalho com os nomes dos campos.


Campos Esperados


3. Campos Obrigatórios para Gravação

Após a importação, os seguintes campos devem ser preenchidos obrigatoriamente antes da gravação do cadastro:


Observação

A validação dos campos obrigatórios é realizada diretamente na tela de cadastro do funcionário. O sistema exibe mensagens orientativas sempre que algum campo essencial não estiver preenchido, guiando o usuário para completar as informações antes de permitir a gravação dos dados.

  • Sexo

  • Função

  • Código do Sindicato

  • Área

  • Departamento

  • Setor

  • Seção

  • Raça

  • Tipo de Regime Trabalhista

  • Tipo de Contrato de Trabalho

  • Categoria do Trabalhador

  • Tipo de Logradouro



Primeiro Passo: Acesso ao Cadastro de Funcionário

  • Acesse o módulo de cadastro de funcionários pelo caminho: FLP → Cadastros → Funcionários → Cadastro de Funcionários

  • Selecione a empresa desejada.

  • Escolha a filial correspondente.

  • Informe o registro do funcionário manualmente ou clique no botão "Próximo" para que o sistema atribua automaticamente o próximo número sequencial disponível.



Selecionar o arquivo para Upload de um arquivo por colaborador.


✅ Confirmação de Importação

Após a conclusão do processo, o sistema exibirá a mensagem: "Dados importados com sucesso."


Em seguida, será permitido o preenchimento sequencial dos demais campos obrigatórios do cadastro de funcionários, conforme exigido para a finalização do registro.




Identificação do Colaborador

  • O CPF é utilizado como chave primária para identificação do colaborador.

  • O sistema realiza as seguintes validações:

    • Se o CPF já estiver cadastrado com status Ativo ou Afastado, a importação é bloqueada e o usuário é notificado.

    • Se o CPF não estiver cadastrado ou o colaborador for Desligado, o sistema permite o cadastro de novo colaborador, desde que os campos obrigatórios estejam preenchidos.



Funcionário Ativo ou Afastado:

Caso seja identificado um registro existente, o sistema exibirá a seguinte mensagem de alerta:

Funcionário: 000001 – Funcionário Teste já cadastrado.

Essa validação impede a duplicidade de cadastros e garante a integridade das informações no sistema.





⚠️ Observações Importantes para o Sucesso da Importação

Para garantir o correto funcionamento da importação de dados cadastrais via arquivo .CSV, é fundamental que os valores informados no arquivo estejam exatamente iguais aos que já estão cadastrados no sistema. Isso inclui acentuação, grafia, espaços e capitalização. Qualquer divergência, mesmo que mínima, impedirá a importação do respectivo campo.


Exemplos de inconsistências que impedem a importação:

  • Estado Civil

    • ✅ Correto no sistema: União Estável

    • ❌ No arquivo: Uniao Estavel (sem acento) → Não será importado

  • Nacionalidade

    • ✅ Correto no sistema: Brasileira

    • ❌ No arquivo: Brasileiro (gênero diferente) → Não será importado

  • Primeiro Emprego ou Reemprego

    • ✅ Correto no sistema: Primeiro emprego

    • ❌ No arquivo: SIM (formato diferente) → Não será importado

  • Cidade

    • ✅ Correto no sistema: São Paulo

    • ❌ No arquivo: Sao Paulo (sem acento) → Não será importado

  • Grau de Instrução

    • ✅ Correto no sistema: Superior

    • ❌ No arquivo: Superior Completo (descrição divergente) → Não será importado


Dica: Sempre utilize os valores exatamente como estão cadastrados no sistema. Recomenda-se consultar previamente os cadastros de referência (como listas de estados civis, nacionalidades, cidades, etc.) para garantir a consistência dos dados no arquivo de importação. 


⚠️ Aviso de Importação Parcial

A importação foi concluída parcialmente. Alguns campos do arquivo apresentam dados inválidos ou divergentes em relação ao cadastro do sistema, e por isso não foram importados.

  • Estado Civil:  Valor no arquivo: Solteira. Valor esperado do sistema: Solteiro

  • RG- Estado de Emissão:  Valor no arquivo: AA. Valor esperado do sistema: SP

  • Grau de Instrução:  Valor no arquivo: mestrada. Valor esperado do sistema:  Mestrado


Para garantir o sucesso da importação, os valores informados no arquivo devem estar idênticos aos cadastrados no sistema, incluindo acentuação, capitalização e grafia.





Mesmo que a importação ocorra de forma parcial devido à ausência ou inconsistência de informações no arquivo .CSV, isso não impede que os campos restantes sejam ajustados manualmente diretamente na tela de cadastro do funcionário. Após a correção, é possível gravar normalmente as informações no sistema.




Se algum auxílio ou esclarecimento forem necessários, conte conosco através de nossos canais de atendimento. 


Telefone: (11) 5018-2525.

Portal do Cliente: https://portaldocliente.praxio.com.br/


#PodeContar
#IA  

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo