> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salu.com.vc/llms.txt
> Use this file to discover all available pages before exploring further.

# Colaborador (Employee)

> O vínculo de uma pessoa (CPF) com a organização, em uma posição da hierarquia.

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](/public-api/br/conceitos/hierarquia) (unidade × setor × cargo). É o agregado que
**dispara o ciclo de exames ocupacionais**: cada ação relevante no colaborador gera uma
[Pendência](/public-api/br/conceitos/pendencia-exame).

## Identificadores (não confundir)

| Campo                          | O que é                                                                      |
| ------------------------------ | ---------------------------------------------------------------------------- |
| `gov_id`                       | **CPF** da pessoa. Identifica a pessoa física e **não muda** entre empresas. |
| `hr_code`                      | **Matrícula do RH** — código interno do cliente; varia por empresa.          |
| `employee_registration_number` | **Matrícula eSocial** — vínculo formal de emprego (quando aplicável).        |
| `client_integration_code`      | Identificador externo do **seu** sistema (mapeamento/idempotência).          |

<Note>
  Os campos sensíveis ao SOC/eSocial — `e_social`, `e_social_category` e
  `employee_registration_number` — **preservam espaços internos** e não são normalizados.
  Envie-os exatamente como exigido pelo eSocial.
</Note>

## Campos principais

| Campo                                   | Obrigatório | Descrição                                                                                                                                 |
| --------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `name`                                  | sim         | Nome do colaborador.                                                                                                                      |
| `gov_id`                                | sim         | CPF (11 dígitos; validado e normalizado).                                                                                                 |
| `sex`                                   | sim         | Sexo (`MALE`, `FEMALE`, `OTHER`).                                                                                                         |
| `is_disabled`                           | sim         | Indica se é **PCD** (pessoa com deficiência).                                                                                             |
| `organization_id`                       | sim         | Organização do vínculo.                                                                                                                   |
| `branch_id`, `sector_id`, `position_id` | sim         | Compõem a hierarquia (posição).                                                                                                           |
| `admission_date`                        | sim         | Data de admissão (ISO 8601).                                                                                                              |
| `status`                                | sim         | `ACTIVE` ou `INACTIVE`.                                                                                                                   |
| `dismissal_date`                        | não         | Data de demissão (quando aplicável).                                                                                                      |
| Dados complementares                    | não         | `social_name`, `phone`, `cell_phone`, `email`, `personal_email`, `gender`, `marital_status`, `educational_stage`, `human_skin_tone`, etc. |
| `create_exam`                           | não         | Se `true` (padrão), gera automaticamente a pendência de exame admissional.                                                                |

<Info>
  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**.
</Info>

## Ciclo de vida e eventos

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

| Evento              | Endpoint               | Pendência gerada                 |
| ------------------- | ---------------------- | -------------------------------- |
| Admissão            | criar colaborador      | `HIRING` (Admissional)           |
| Demissão            | dispensar colaborador  | `DISMISSAL` (Demissional)        |
| Periódico           | gerado pela plataforma | `PERIODIC` (Periódico)           |
| Retorno ao trabalho | atualização de status  | `RETURN` (Retorno)               |
| Mudança de risco    | mudança de hierarquia  | `RISK_CHANGE` (Mudança de Risco) |

## PCD e dupla análise

Quando `is_disabled = true`, o colaborador pode estar associado a uma
[Análise PCD](/public-api/br/conceitos/analise-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

<CardGroup cols={2}>
  <Card title="Criar colaborador" icon="user-plus" href="/public-api/br/endpoints/employees/public_create_employee_v0_employee__post" />

  <Card title="Listar colaboradores" icon="list" href="/public-api/br/endpoints/employees/public_list_employees_v0_employee__get" />

  <Card title="Atualizar colaborador" icon="user-pen" href="/public-api/br/endpoints/employees/public_update_employee_v0_employee__employee_id__patch" />

  <Card title="Dispensar colaborador" icon="user-minus" href="/public-api/br/endpoints/employees/public_dismiss_employee_v0_employee__employee_id__dismiss_patch" />
</CardGroup>