Importando pessoas em lote (CSV)

Menu: RH → Pessoas → Importar (só aparece para administradores).

Use a importação quando precisar cadastrar várias pessoas de uma vez — por
exemplo, ao iniciar o sistema ou ao trazer uma planilha já existente.

Passo a passo

1. Baixe o modelo — botão "Baixar modelo CSV" na tela de importação.

O arquivo já vem com os cabeçalhos corretos e duas linhas de exemplo.

1. Preencha em Excel, LibreOffice ou Google Sheets — uma linha por pessoa.
2. Salve como CSV (UTF-8) com separador ;. No Excel: Salvar como → CSV

UTF-8 (delimitado por vírgula). No LibreOffice: Arquivo → Salvar como → Texto CSV → UTF-8, campo delimitado por ;.

1. Envie o arquivo. O sistema mostra uma pré-visualização com três

grupos: válidas, já existentes e com erro.

1. Confirme para criar as pessoas. A operação é transacional — se algo

falhar, nada é criado.

Colunas aceitas

Obrigatórias: nome, cpf, tipo, vinculo.

Opcionais: email, telefone, rg, data_nascimento, data_admissao,
departamento, cargo, salario_base, endereco, cidade, estado,
cep, numero_cota, data_ingresso_coop, valor_cota.

Os cabeçalhos devem ser exatamente esses (minúsculos, sem acento).

Formato dos campos

| Campo | Formato |
|---|---|
| cpf | Com ou sem máscara (o sistema normaliza) |
| tipo | colaborador, associado ou ambos |
| vinculo | clt, cooperado, autonomo, pj, horista, estagiario, aprendiz, rpa, outro |
| Datas | AAAA-MM-DD (ex: 2026-01-15) |
| salario_base, valor_cota | 3500,00 ou 3500.00 |
| departamento, cargo | Nome exato (não cria automaticamente) |

Regras de validação

• CPF inválido → linha vai para Com erro.
• CPF duplicado dentro do arquivo → linha vai para Com erro.
• CPF já cadastrado no sistema → linha vai para Já existentes e é

ignorada (não gera erro, só aviso).

• Departamento ou cargo não cadastrado → linha vai para Com erro.

Cadastre antes em RH → Estrutura.

• Tipo associado ou ambos sem numero_cota → erro.

Depois da importação

As pessoas criadas aparecem normalmente em RH → Pessoas. Você pode abrir
a ficha de cada uma para completar dados que não estavam no CSV (foto,
documentos, etc.) e, se for o caso, habilitar o portal do colaborador.

A ação é registrada na auditoria como evento crítico (pessoa.importar).