Importação de Pessoas via CSV

A importação de Pessoas permite cadastrar novos colaboradores ou atualizar os dados de pessoas já existentes no Quírons.

O arquivo possui 33 colunas, seguindo a estrutura definida pelo modelo disponibilizado na tela de Importação de Dados.

Para informações sobre como acessar a importação, realizar a pré-validação, confirmar o processamento e consultar erros, consulte o artigo Como importar dados via CSV.

Disponibilidade

A importação de Pessoas está disponível somente para organizações que não possuem configuração de integração cadastrada.

Quando a organização possui uma integração configurada, os dados das pessoas devem ser mantidos por meio da integração e a importação de Pessoas via CSV não fica disponível.

Estrutura do arquivo

Cada linha do arquivo representa uma pessoa.

As seguintes colunas são obrigatórias:

name, individualRegistration, birthday, gender

O cabeçalho deve seguir esta estrutura e ordem:

erpId|name|individualRegistration|birthday|gender|registration|socialName|nickname|generalRegistration|mothersName|email|telephone|isActive|address|numberAddress|neighborhood|city|state|zipCode|civilStatus|educationLevel|costCenter|department|occupation|workShift|admissionDate|dismissalDate|employeeSituation|pisCode|ctps|sefip|rais|eSocialCategory

Colunas

Coluna	Obrigatório	Formato / valores	Descrição
`erpId`	Não	Texto	Código da pessoa. Quando preenchido, identifica o registro nas próximas importações e impede sua edição manual no sistema
`name`	Sim	Texto	Nome completo
`individualRegistration`	Sim	CPF	CPF da pessoa
`birthday`	Sim	`AAAA-MM-DD`	Data de nascimento
`gender`	Sim	`0` ou `1`	`0` = Masculino; `1` = Feminino
`registration`	Não	Texto	Matrícula da pessoa
`socialName`	Não	Texto	Nome social
`nickname`	Não	Texto	Apelido
`generalRegistration`	Não	Texto	RG
`mothersName`	Não	Texto	Nome da mãe
`email`	Não	Texto	E-mail
`telephone`	Não	Texto	Telefone
`isActive`	Não	`true`/`false`	Utilize `false` ou `0` para inativar. Quando vazio, mantém o valor atual
`address`	Não	Texto	Logradouro
`numberAddress`	Não	Texto	Número do endereço
`neighborhood`	Não	Texto	Bairro
`city`	Não	Texto	Cidade
`state`	Não	Sigla	Unidade Federativa, por exemplo `SC`
`zipCode`	Não	Texto	CEP
`civilStatus`	Não	`0`–`4`	Estado civil. Consulte os valores aceitos abaixo
`educationLevel`	Não	Inteiro	Índice correspondente à opção de escolaridade disponível no cadastro
`costCenter`	Não	Composto	Centro de custo no formato `código;descrição`
`department`	Não	Composto	Departamento no formato `código;nome`
`occupation`	Não	Composto	Ocupação no formato `código;nome`
`workShift`	Não	Composto	Turno no formato `código;descrição`
`admissionDate`	Não	`AAAA-MM-DD`	Data de admissão
`dismissalDate`	Não	`AAAA-MM-DD`	Data de demissão
`employeeSituation`	Não	`0`–`5`	Situação da pessoa. Consulte os valores aceitos abaixo
`pisCode`	Não	Texto	PIS
`ctps`	Não	Texto	CTPS
`sefip`	Não	Código	Código SEFIP
`rais`	Não	Código	Código RAIS
`eSocialCategory`	Não	Código	Código da categoria do trabalhador no eSocial

Código da pessoa (`erpId`)

O preenchimento do campo erpId define como o cadastro poderá ser mantido após a importação.

Importante: quando uma pessoa é importada com o campo erpId preenchido, o registro não poderá ser alterado manualmente no sistema. Alterações posteriores deverão ser realizadas por meio de novas importações.

Se a pessoa precisar ser cadastrada pela importação, mas continuar disponível para edição manual no Quírons, deixe o campo erpId em branco.

Nesse caso, o CPF (individualRegistration) será utilizado para identificar a pessoa em futuras importações.

Criação e atualização de pessoas

A importação pode ser utilizada tanto para cadastrar novas pessoas quanto para atualizar registros existentes.

Quando o CPF (individualRegistration) ou o Código (erpId) informado já estiver cadastrado, o registro existente será atualizado em vez de uma nova pessoa ser criada.

Importante: nas atualizações, uma célula vazia preserva o valor atual daquele campo. Dessa forma, é possível atualizar apenas as informações desejadas sem preencher novamente todos os dados da pessoa.

Gênero (`gender`)

Valor	Descrição
`0`	Masculino
`1`	Feminino

Estado Civil (`civilStatus`)

Valor	Descrição
`0`	Solteiro
`1`	Casado
`2`	Divorciado
`3`	Viúvo
`4`	Separado judicialmente

Situação (`employeeSituation`)

Valor	Descrição
`0`	Ativo
`1`	Demitido
`2`	Férias
`3`	Afastado
`4`	Atestado
`5`	Alta

Centro de Custo, Departamento, Ocupação e Turno

Os campos costCenter, department, occupation e workShift utilizam uma estrutura composta, com o código e a descrição separados por ;.

Campo	Estrutura	Exemplo
`costCenter`	`código;descrição`	`001;Administrativo`
`department`	`código;nome`	`010;Recursos Humanos`
`occupation`	`código;nome`	`2524-05;Analista de RH`
`workShift`	`código;descrição`	`T1;Comercial 08h-18h`

Quando o código informado ainda não existir, o respectivo cadastro será criado automaticamente na filial.

Atualização parcial de dados

Para atualizar somente determinadas informações de uma pessoa, mantenha as demais células vazias.

Por exemplo, para alterar apenas o Departamento e a Ocupação de uma pessoa existente, identifique a pessoa pelo erpId ou individualRegistration e informe os novos valores em department e occupation.

As demais informações cadastradas serão preservadas.

Exemplo de arquivo

erpId|name|individualRegistration|birthday|gender|registration|socialName|nickname|generalRegistration|mothersName|email|telephone|isActive|address|numberAddress|neighborhood|city|state|zipCode|civilStatus|educationLevel|costCenter|department|occupation|workShift|admissionDate|dismissalDate|employeeSituation|pisCode|ctps|sefip|rais|eSocialCategory
 | Maria da Silva|123.456.789-09|1990-05-20|1|000123|||1234567|Ana da Silva|[email protected]|(47) 99999-0000||Rua das Flores|100|Centro|Joinville|SC|89200-000|0||001;Administrativo|010;Recursos Humanos|2524-05;Analista de RH|T1;Comercial 08h-18h|2024-02-01||0|||01||101

Nesse exemplo, o campo erpId está vazio. Portanto, o CPF será utilizado para identificar a pessoa e o cadastro continuará disponível para edição manual no sistema.