Перейти к основному содержимому

Реестр отпусков

POST 
/api/v1/clients/:clientId/vacations/getRegistry

Описание метода​

Возвращает полную информацию по отпускам пользователей для реестра отпусков в зависимости от типа пользователя: HR, EMPLOYER, EMPLOYEE.

  • Для Руководителя будут возвращены данные по сотрудникам, которые подчиняются ему по структуре отделов и по управленческой структуре.
  • Для Сотрудника будут возвращены данные по сотрудникам, которые являются коллегами по структуре отделов и по управленческой структуре.

Валидации запроса​

  • На тенантеTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. включен функционал «График отпусков».
  • Тело запроса задано.
  • Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
  • Тип реестра задан корректно.
  • Пользователь имеет право доступа к указанному типу реестра.
  • Данные фильтрации реестра отпусков сотрудников заданы корректно.
  • Проверяет, что на данном тенантеTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. включен функционал графика отпусков.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
  • По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
  • Пользователь, выполняющий операцию, относится к клиенту.
  • Тип реестра задан.
  • Тип реестра соответствует одному из допустимых значений (HR, EMPLOYEE, EMPLOYER).
  • Выполняет проверку наличия прав пользователя клиента к указанному типу реестра.
  • Для реестра сотрудника (EMPLOYEE) сервер не проверяет права.
  • Для реестра руководителя (EMPLOYER) необходимо, чтобы любой не уволенный сотрудник пользователя клиента был руководителем хотя бы одного отдела или управленческим руководителем хотя бы одного неуволенного сотрудника.
  • Для реестра кадровика (HR) необходимо наличие переданных прав.
  • Год, за который возвращается информация об отпусках, задан.
  • Если месяц задан, он принимает возможные значения от 1 до 12.
  • Если задан флаг необходимости получения сотрудников без отпусков, то месяц не должен быть задан.
  • Список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. отделов задан корректно.
  • Список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудников задан корректно.
  • Параметры пагинации заданы корректно.
  • Проверяет, что текущий пользователь относится к заданному клиенту и возвращает пользователя клиента, если он существует.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
  • Проверяет существование клиента по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
  • Проверяет, что клиент не удален.
  • Проверяет, что если задан флаг необходимости получения сотрудников без отпусков, то месяц не должен быть задан.
  • По заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существуют отделы клиента.
  • Список отделов задан корректно для заданного типа реестра.
  • Среди IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудников нет пустых элементов.
  • По заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существуют сотрудники.
  • Все сотрудники относятся к одному клиенту.
  • Сотрудники находятся в доступных текущему пользователю отделах клиента или находятся с пользователем клиента в одной управленческой структуре.
  • Сотрудники находятся в доступных текущему пользователю юрлицах или находятся с пользователем клиента в одной управленческой структуре.
  • Один из активных сотрудников пользователя клиента относится к отделу.
  • Один из коллег пользователя клиента по управленческой структуре относится к отделу.
  • Один из активных сотрудников пользователя клиента является руководителем отдела.
  • Один из подчинённых пользователя клиента по управленческой структуре относится к отделу.
  • У пользователя клиента есть доступ к отделам клиента с заданными IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
  • Проверяет, что все UUID, заданные в списке, соответствуют существующим отделам клиента и возвращает список отделов клиента.
  • Проверяет, что сотрудники существуют по всем заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., и возвращает список сотрудников.
  • Проверяет, что все сотрудники принадлежат клиенту с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
  • Проверяет, что текущий пользователь клиента имеет доступ к юрлицам переданных сотрудников.
  • В случае, если пользователь клиента не имеет доступа к юрлицам некоторых сотрудников, проверяет наличие прав руководителя у пользователей клиентов этих сотрудников через связку хотя бы в одном из юрлиц, указанных в фильтре, или хотя бы в одном из доступных юрлиц, если фильтр по юрлицам не задан.
  • Проверяет, что заданный сотрудник относится к заданному клиенту.

Request​

Responses​

Успешная операция.