Отправить на утверждение

PUT 
/api/v1/clients/:clientId/normativeActs/sendForApproval

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

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

Методы PUT перезаписывают запись целиком: любые непереданные поля считаются null и затирают данные в БД. Поэтому при обновлении нужно указывать все поля. Метод реализует процесс утверждения ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. руководителем перед отправкой на ознакомление сотрудникам. #### Описание процесса: 1. Кадровик создает ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов., в разделе ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. HRlink. 1. В форме создания ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. кадровик может включить опцию «Требуется утверждение руководителем», благодаря которой процесс утверждения ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. будет происходить через HRlink. Это опционально, для того чтобы можно было использовать ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. в старом формате (загружая уже утвержденный документ). 2. Включив опцию утверждения, кадровик выбирает руководителя в системе, который будет утверждать документ ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. (подписывать его УКЭПУКЭП (Усиленная квалифицированная электронная подпись). Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя.'ом). 3. Кадровик заполняет остальные поля и загружает ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. в систему.

2. Загруженный ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов., который создан с опцией утверждения, отображается в реестре ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов.. 1. Выделив его в реестре, кадровик отправляет ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. на утверждение выбранному ранее руководителю.
3. Руководитель получает документ с ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. на подписание и подписывает его УКЭПУКЭП (Усиленная квалифицированная электронная подпись). Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя.'ом
4. После того как ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. был подписан (утвержден) руководителем, кадровик может производить действия с ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов.: отправить на ознакомление сотрудникам, включить автоотправку.
5. Отправив утвержденный ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. сотруднику, сотрудник получит его в качестве документа, запущенного по маршруту («Руководитель первый»), уже подписанным руководителем (такой документ будет автоматически сформирован, на основании подписанного руководителем документа). Это позволит сотруднику подписывать ЛНАЛНА (Локальный нормативный акт). Локальный нормативный акт — внутренний документ организации, с которым сотрудники знакомятся через HRlink. Управляется через отдельный набор API-методов. с помощью ПРР.

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

• Тело запроса задано.
• IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента и пользователя заданы корректно.
• Список нормативных актов задан корректно.
• Для каждого нормативного акта: * IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативного акта задан и по нему существует нормативный акт.
• Если версия нормативного акта задана, то она равна версии нормативного акта в БД.
• У пользователя клиента есть право NORMATIVE_ACTS_SEND_FOR_APPROVAL на уровне клиента или право NORMATIVE_ACTS_SEND_FOR_APPROVAL на уровне сотрудника клиента.
• Пользователь клиента имеет доступ к типам документов каждого нормативного акта.
• Пользователь клиента имеет доступ до всех отделов каждого нормативного акта.
• Нормативный акт не удалён.
• Срок действия нормативного акта не закончился.
• Конвертация файла нормативного акта в PDF/A завершилась.
• Для нормативного акта существует связка с утверждающим документом.
• Для нормативного акта утверждающий документ ещё не был отправлен на подпись.
• Существует активный пакет СМС и лимит СМС в пакете лицензий не исчерпан.
• Лимит на изготовление печатной формыпечатная формаPDF-документ с визуальным оттиском подписей, который система формирует после завершения документооборота. Печатная форма доступна для скачивания и используется для архивного хранения. не будет исчерпан, если операции выполняются в облаке.
• IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
• По заданному IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
• Пользователь, выполняющий операцию, относится к клиенту.
• Список нормативных актов задан.
• В списке нормативных актов нет null-элементов.
• Проверяет, есть ли у пользователя клиента с заданным IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. заданное право и возвращает кэш наличия прав у пользователя клиента.
• Должен быть задан IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. HR-Link'а или IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе. Если заданы оба, то приоритет у IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. HR-Link'а.
• Если задан 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 при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
• Проверяет существование клиента по заданному IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
• Проверяет, что клиент не удален.
• Проверяет, что список нормативных актов задан.
• Задан IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативного акта в системе Hr-link или во внешней системе.
• Если задан IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативного акта в системе Hr-link, то по нему должен существовать нормативный акт, относящийся к заданному клиенту.
• Если задан IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативного акта во внешней системе, то по нему должен существовать нормативный акт.
• Проверяет, что каждый нормативный акт из указанной коллекции относится к заданному клиенту.
• Проверяет существование нормативного акта по заданному IDidВнутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе и возвращает нормативный акт, если он существует.
• Проверяет, что ни один нормативный акт из указанной коллекции не удалён.
• Проверяет, что действие нормативного акта не закончилось для каждого нормативного акта из указанной коллекции.
• Проверяет, что конвертация файла в PDF/A формат завершилась для каждого нормативного акта из указанной коллекции.

Request

Responses

200

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

400

Ошибка при валидации данных запроса.

401

Запрос не аутенифицирован.

403

Для заданного пользователя доступ к ресурсу запрещен.

429

Превышен разрешенный лимит запросов за период.