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

Управление планированием

PUT 
/api/v1/clients/:clientId/vacations/setPlanningState

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

⚠️ Будьте осторожны!

Методы PUT перезаписывают запись целиком: любые непереданные поля считаются null и затирают данные в БД. Поэтому при обновлении нужно указывать все поля. Разрешает или запрещает планирование в тенантеTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. на заданный год. Допустимо указывать настройку на текущий или следующий год. Если год не задан, то по умолчанию, настройка устанавливается на текущий год. Метод доступен только для пользователя или сотрудника пользователя с правом VACATIONS_CHANGE_PLANNING_STATE.

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

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

Request​

Responses​

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