> ## 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.

# Employee

> The link between a person (CPF) and the organization, in a hierarchy position.

The **Employee** is the **link of an individual** — identified by **CPF** (`gov_id`) — to an
**organization**, in a [hierarchy](/public-api/en/concepts/hierarchy_en) position (branch ×
sector × position). It is the aggregate that **drives the occupational exam lifecycle**: each
relevant action on the employee generates an
[exam pendency](/public-api/en/concepts/exam-pendency_en).

## Identifiers (don't mix them up)

| Field                          | What it is                                                                                |
| ------------------------------ | ----------------------------------------------------------------------------------------- |
| `gov_id`                       | The person's **CPF**. Identifies the individual and **does not change** across companies. |
| `hr_code`                      | **HR registration** — client's internal code; varies per company.                         |
| `employee_registration_number` | **eSocial registration** — formal employment link (when applicable).                      |
| `client_integration_code`      | External identifier from **your** system (mapping/idempotency).                           |

<Note>
  The SOC/eSocial-sensitive fields — `e_social`, `e_social_category` and
  `employee_registration_number` — **preserve internal whitespace** and are not normalized.
  Send them exactly as required by eSocial.
</Note>

## Main fields

| Field                                   | Required | Description                                                                                                                               |
| --------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `name`                                  | yes      | Employee name.                                                                                                                            |
| `gov_id`                                | yes      | CPF (11 digits; validated and normalized).                                                                                                |
| `sex`                                   | yes      | Sex (`MALE`, `FEMALE`, `OTHER`).                                                                                                          |
| `is_disabled`                           | yes      | Whether the employee is a **PCD** (person with a disability).                                                                             |
| `organization_id`                       | yes      | Organization of the link.                                                                                                                 |
| `branch_id`, `sector_id`, `position_id` | yes      | Compose the hierarchy (position).                                                                                                         |
| `admission_date`                        | yes      | Hiring date (ISO 8601).                                                                                                                   |
| `status`                                | yes      | `ACTIVE` or `INACTIVE`.                                                                                                                   |
| `dismissal_date`                        | no       | Dismissal date (when applicable).                                                                                                         |
| Complementary data                      | no       | `social_name`, `phone`, `cell_phone`, `email`, `personal_email`, `gender`, `marital_status`, `educational_stage`, `human_skin_tone`, etc. |
| `create_exam`                           | no       | If `true` (default), automatically generates the hiring exam pendency.                                                                    |

<Info>
  The canonical list of required/optional fields is always the **endpoint schema** (rendered
  from the OpenAPI). Use this page for the **meaning**; use the reference page for the **exact
  contract**.
</Info>

## Lifecycle and events

Each event on the employee generates an exam pendency of the matching type:

| Event          | Endpoint                  | Generated pendency |
| -------------- | ------------------------- | ------------------ |
| Hiring         | create employee           | `HIRING`           |
| Dismissal      | dismiss employee          | `DISMISSAL`        |
| Periodic       | generated by the platform | `PERIODIC`         |
| Return to work | status update             | `RETURN`           |
| Risk change    | hierarchy change          | `RISK_CHANGE`      |

## PCD and disability analysis

When `is_disabled = true`, the employee may be associated with a
[PCD analysis](/public-api/en/concepts/pcd-analysis_en) (field `disability_analysis_id`),
which validates the disability condition.

## Double bond

The same **CPF** can exist in **more than one organization** when "double bond" is enabled for
the client. That is: the Person (CPF) is unique, but may have distinct employees across
distinct organizations.

## Endpoints

<CardGroup cols={2}>
  <Card title="Create employee" icon="user-plus" href="/public-api/en/endpoints/employees/public_create_employee_v0_employee__post_en" />

  <Card title="List employees" icon="list" href="/public-api/en/endpoints/employees/public_list_employees_v0_employee__get_en" />

  <Card title="Update employee" icon="user-pen" href="/public-api/en/endpoints/employees/public_update_employee_v0_employee__employee_id__patch_en" />

  <Card title="Dismiss employee" icon="user-minus" href="/public-api/en/endpoints/employees/public_dismiss_employee_v0_employee__employee_id__dismiss_patch_en" />
</CardGroup>