> ## Documentation Index
> Fetch the complete documentation index at: https://platform.doodocs.kz/llms.txt
> Use this file to discover all available pages before exploring further.

# Статусы и жизненный цикл

> Значения EmployeeStatus и переходы карточки сотрудника

Поле `status` карточки отражает этап трудового цикла сотрудника. Значения —
перечисление `EmployeeStatus`. Обрабатывайте его устойчиво к неизвестным
значениям: набор может пополняться аддитивно.

## Значения EmployeeStatus

| Статус                       | Значение                                           |
| ---------------------------- | -------------------------------------------------- |
| `EMPLOYEE_STATUS_HIRED`      | Сотрудник нанят, карточка заведена, приём запущен. |
| `EMPLOYEE_STATUS_ACCEPTED`   | Приём принят сотрудником.                          |
| `EMPLOYEE_STATUS_ONBOARDING` | Идёт адаптация перед выходом в работу.             |
| `EMPLOYEE_STATUS_ACTIVE`     | Активно работает.                                  |
| `EMPLOYEE_STATUS_LEAVE`      | В отпуске или временно отсутствует.                |
| `EMPLOYEE_STATUS_ON_HOLD`    | Работа приостановлена.                             |
| `EMPLOYEE_STATUS_TERMINATED` | Трудовые отношения завершены (уволен).             |

<Warning>
  Внутренние статусы `CREATED` (черновик приёма) и `DELETED` через Developer API не
  отдаются **никогда** — они отфильтрованы из любого чтения. В ответах вы их не
  встретите.
</Warning>

<Frame caption="Типичный путь карточки: приём → работа → отпуск/пауза → увольнение">
  ```mermaid theme={null}
  %%{init: {'theme':'neutral'}}%%
  stateDiagram-v2
      [*] --> HIRED: приём
      HIRED --> ACCEPTED
      ACCEPTED --> ONBOARDING
      ONBOARDING --> ACTIVE
      ACTIVE --> LEAVE: отпуск/отсутствие
      LEAVE --> ACTIVE: возврат
      ACTIVE --> ON_HOLD: приостановка
      ON_HOLD --> ACTIVE: возобновление
      ACTIVE --> TERMINATED: увольнение
      LEAVE --> TERMINATED
      ON_HOLD --> TERMINATED
      TERMINATED --> [*]
  ```
</Frame>

Диаграмма показывает типичное движение, а не жёсткий автомат. Не полагайтесь на
конкретный порядок переходов — ориентируйтесь на текущее значение `status`.

## Фильтрация по статусу

Список фильтруется параметром `status`. Для нескольких значений **повторяйте
параметр** — запятая их не разделяет:

```bash theme={null}
curl -H "X-API-Key: ddp_ВАШ_КЛЮЧ" \
  "https://app.doodocs.kz/api/developer/v1/employees?status=EMPLOYEE_STATUS_ACTIVE&status=EMPLOYEE_STATUS_LEAVE"
```

Неизвестное значение в `status` даёт `DEVELOPER.INVALID_STATUS`.

<Note>
  `status` — это трудовой статус, а не состояние учётной записи в приложении.
  Сотрудник в `EMPLOYEE_STATUS_ACTIVE` может быть приглашён в приложение, но ещё не
  принять приглашение. API этого различия не показывает, и фильтр по `status` таких
  сотрудников не отделит — не читайте `ACTIVE` как «пользуется приложением».
</Note>

## Дальше

<Columns cols={2}>
  <Card title="Модель сотрудника" icon="user" href="/ru/guides/employees/model">
    Поля карточки и модель доступа.
  </Card>

  <Card title="Employee-graph" icon="diagram-project" href="/ru/guides/employees/graph">
    Связи сотрудника и обход через `expand`.
  </Card>

  <Card title="Вебхуки" icon="bell" href="/ru/api-reference/webhooks">
    Реагируйте на изменения без опроса.
  </Card>
</Columns>