Skip to main content
O Colaborador (Employee) é o vínculo de uma pessoa física — identificada pelo CPF (gov_id) — com uma organização, em uma posição da hierarquia (unidade × setor × cargo). É o agregado que dispara o ciclo de exames ocupacionais: cada ação relevante no colaborador gera uma Pendência.

Identificadores (não confundir)

Os campos sensíveis ao SOC/eSocial — e_social, e_social_category e employee_registration_numberpreservam espaços internos e não são normalizados. Envie-os exatamente como exigido pelo eSocial.

Campos principais

A lista canônica de campos obrigatórios/opcionais é sempre a do schema do endpoint (renderizada a partir do OpenAPI). Use esta página para entender o significado; use a página de referência para o contrato exato.

Ciclo de vida e eventos

Cada evento no colaborador gera uma pendência de exame do tipo correspondente:

PCD e dupla análise

Quando is_disabled = true, o colaborador pode estar associado a uma Análise PCD (campo disability_analysis_id), que valida a condição de pessoa com deficiência.

Duplo vínculo (double bond)

O mesmo CPF pode existir em mais de uma organização quando o “duplo vínculo” está habilitado para o cliente. Ou seja: a Pessoa (CPF) é única, mas pode ter colaboradores distintos em organizações distintas.

Endpoints

Criar colaborador

Listar colaboradores

Atualizar colaborador

Dispensar colaborador