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

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

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​

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