Skip to main content
Cadastrar um colaborador faz duas coisas ao mesmo tempo: posiciona a pessoa na hierarquia (unidade × setor × cargo) e, por padrão, gera a pendência de exame admissional.
Pré-requisito: a estrutura da empresa (Unidade, Setor e Cargo) já deve existir, pois você informa branch_id, sector_id e position_id.

Sequência

Passo a passo

1

Montar o payload do colaborador

Informe os obrigatórios: name, gov_id (CPF), sex, is_disabled, organization_id, branch_id, sector_id, position_id, admission_date e status. Adicione os complementares que tiver (contato, hr_code, dados de eSocial, etc.).
2

Criar o colaborador

POST /v0/employee. A hierarquia é resolvida a partir dos três IDs; se a combinação ainda não existir na organização, ela é criada.
3

Exame admissional automático

Com create_exam = true (padrão), uma pendência do tipo HIRING é gerada. Use send_email/send_date para controlar a comunicação ao colaborador.
4

Acompanhar a pendência

Liste as pendências do colaborador em Listar pendências e acompanhe o status até a conclusão (ASO).
Se o colaborador é PCD (is_disabled = true), pode ser necessário associar uma Análise PCD (disability_analysis_id).

Eventos seguintes

Demissão, retorno e mudança de risco geram novas pendências automaticamente — veja Ciclo da pendência.