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

Значения EmployeeStatus

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

Типичный путь карточки: приём → работа → отпуск/пауза → увольнение

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

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

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

Дальше

Модель сотрудника

Поля карточки и модель доступа.

Employee-graph

Связи сотрудника и обход через expand.

Вебхуки

Реагируйте на изменения без опроса.