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

Отправить группу на подписание

POST 
/api/v1/clients/:clientId/normativeActs/sendBulkToSigning

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

Отправляет группу нормативных актов на подписание сотрудникам.

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

  • Тело запроса задано.
  • Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
  • В теле запроса указаны корректные IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативных актов.
  • Существуют нормативные акты по IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., указанным в теле запроса.
  • Все нормативные акты по указанным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. относятся к одним и тем же юрлицам.
  • Список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлиц задан корректно.
  • Каждый нормативный акт из тела запроса относится к заданному клиенту.
  • Пользователь клиента имеет доступ к типам документов нормативных актов.
  • Для каждого нормативного акта по IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. из тела запроса пользователь клиента имеет доступ хотя бы к одному из отделов клиента, на которых распространяется данный нормативный акт.
  • Ни один нормативный акт из тела запроса не удалён.
  • Не закончилось действие каждого нормативного акта из тела запроса.
  • Конвертация файла в PDF/A формат завершилась для каждого нормативного акта из тела запроса.
  • Все нормативные акты из тела запроса, требующие утверждения, должны быть утверждены.
  • Если данные фильтрации содержат непустую строку с номером документа, не состоящую из одних пробельных символов, у пользователя клиента есть право PERSONAL_DATA на уровне пользователя клиента или право PERSONAL_DATA на уровне сотрудника клиента в юрлице, на которое распространяются нормативные акты.
  • Данные фильтрации указаны корректно.
  • Лимит на выполнение операций создания печатной формыпечатная форма PDF-документ с визуальным оттиском подписей, который система формирует после завершения документооборота. Печатная форма доступна для скачивания и используется для архивного хранения. файла для заданного тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. не превышен.
  • Существует активный пакет СМС и лимит СМС для заданного тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. не превышен.
  • Каждое юр лицо относится к юрлицам заданных нормативных актов.
  • У пользователя клиента есть право NORMATIVE_ACTS_SEND_TO_SIGNING на уровне клиента или право NORMATIVE_ACTS_SEND_TO_SIGNING на уровне сотрудника клиента во всех заданных юр лицах.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
  • По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
  • Пользователь, выполняющий операцию, относится к клиенту.
  • Если список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативных актов не равен null и не пуст, то он не содержит null-элементов.
  • Если список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативных актов не равен null и не пуст, то по указанным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существуют нормативные акты.
  • Если список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативных актов равен null или пуст, то список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативных актов во внешней системе не равен null и не пуст.
  • Если список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативных актов равен null или пуст, то список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативных актов во внешней системе не содержит null-элементов.
  • Если список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативных актов равен null или пуст, то по указанным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе существуют нормативные акты.
  • Проверяет, что все нормативные акты из указанной коллекции относятся к одним и тем же юрлицам.
  • Проверяет, есть ли у пользователя клиента с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. заданное право и возвращает кэш наличия прав у пользователя клиента.
  • Проверяет, что каждый нормативный акт из указанной коллекции относится к заданному клиенту.
  • Проверяет, что пользователь клиента имеет доступ к типам документов каждого нормативного акта.
  • Проверяет, что пользователь клиента имеет доступ хотя бы к одному отделу клиента, на которые распространяется заданный нормативный акт.
  • В метод должен быть передан список разрешённых отделов, который включает в себя все дочерние и родительские отделы разрешённых отделов.
  • Это нужно из-за бизнес-правила: нормативный акт, который распространяется на выбранный отдел, должен быть доступен и сотруднику, который имеет доступ только к дочерним отделам выбранного отдела.
  • Нормативный акт не удалён.
  • Срок действия нормативного акта не закончился.
  • Конвертация файла нормативного акта в PDF/A завершилась.
  • Проверяет, что все указанные нормативные акты были утверждены, если они требуют утверждения.
  • Нормативный акт требует утверждения, если у него существует утверждающий документ.
  • Пользователь клиента имеет право PERSONAL_DATA.
  • Пользователь клиента имеет право PERSONAL_DATA на уровне одного из юрлиц.
  • Один из замещаемых пользователей клиента имеет право PERSONAL_DATA.
  • Пользователь клиента имеет права для получения данных должностей сотрудников.
  • Если IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. должностей сотрудников заданы, то они корректны.
  • Если IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. отделов клиента заданы, то они корректны.
  • У пользователя клиента есть доступ к отделам клиента с заданными IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
  • Если IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудников в данных фильтрации заданы, то они корректны.
  • Проверяет, что если операции в облаке включены, то лимит на выполнение операций создания печатной формыпечатная форма PDF-документ с визуальным оттиском подписей, который система формирует после завершения документооборота. Печатная форма доступна для скачивания и используется для архивного хранения. файла для заданного тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. не превышен.
  • Проверяет, есть ли у пользователя клиента с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. для заданного юрлица заданное право с учётом замещенийSubstitution Замещение — временная передача прав одного пользователя другому (например, на время отпуска). Настраивается для конкретных контекстов: документы, заявления, сотрудники, ЛНА..
  • В случае замещенияSubstitution Замещение — временная передача прав одного пользователя другому (например, на время отпуска). Настраивается для конкретных контекстов: документы, заявления, сотрудники, ЛНА. в режиме кадровика дополнительно проверяются его активные замещенияSubstitution Замещение — временная передача прав одного пользователя другому (например, на время отпуска). Настраивается для конкретных контекстов: документы, заявления, сотрудники, ЛНА..
  • Проверяет, что текущий пользователь относится к заданному клиенту и возвращает пользователя клиента, если он существует.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
  • Проверяет существование клиента по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
  • Проверяет, что клиент не удален.
  • Проверяет, что ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативного акта из списка не равен null.
  • Проверяет, что список нормативных актов задан.
  • Проверяет, что список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативных актов во внешней системе не равен null и не пуст.
  • Проверяет, что ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативного акта во внешней системе из списка не равен null.
  • Проверяет существование всех нормативных актов по заданному списку IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе.
  • Проверяет, что ни один нормативный акт из указанной коллекции не удалён.
  • Проверяет, что действие нормативного акта не закончилось для каждого нормативного акта из указанной коллекции.
  • Проверяет, что конвертация файла в PDF/A формат завершилась для каждого нормативного акта из указанной коллекции.
  • Проверяет, есть ли у пользователя клиента с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. заданное право, учитывая замещенияSubstitution Замещение — временная передача прав одного пользователя другому (например, на время отпуска). Настраивается для конкретных контекстов: документы, заявления, сотрудники, ЛНА..
  • Список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. должностей сотрудников равен null.
  • Список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. должностей сотрудников пуст.
  • Список содержит только IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существующих должностей сотрудников.
  • Список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. отделов клиента равен null.
  • Список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. отделов клиента пуст.
  • Список содержит только IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существующих отделов клиента.
  • Среди IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудников нет null-элементов.
  • По заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. существуют сотрудники.
  • Все сотрудники относятся к одному клиенту.
  • Все сотрудники находятся в юрлицах, на которые распространяется нормативный акт.
  • Ни один из сотрудников не уволен.
  • Все сотрудники подтверждены.
  • Отделы сотрудников входят в список разрешенных отделов пользователя клиента, выполняющего операцию.
  • Пользователь клиента имеет право EMPLOYEE_POSITIONSPosition Название должности из плоского справочника на уровне пространства клиента. Справочник общий для всех юрлиц. Position — именно название должности, а не позиция штатного расписания..
  • Пользователь клиента имеет право EMPLOYEE_POSITIONSPosition Название должности из плоского справочника на уровне пространства клиента. Справочник общий для всех юрлиц. Position — именно название должности, а не позиция штатного расписания. на уровне одного из юрлиц.
  • Заполняет данные для фильтрации сотрудников отделами, которые являются потомками для заданных в фильтрах отделов, или очищает список отделов, если фильтрация по отделам не требуется.
  • Фильтрация по отделам не требуется, если текущий пользователь клиента имеет доступ ко всем отделам клиента и в данных фильтрации не заданы IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. отделов.
  • Проверяет, что лимит на выполнение операций создания печатной формыпечатная форма PDF-документ с визуальным оттиском подписей, который система формирует после завершения документооборота. Печатная форма доступна для скачивания и используется для архивного хранения. файла для заданного тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. не превышен.
  • Проверяет, что ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. должности сотрудника не равен null.
  • Проверяет, что все UUID, заданные в списке, соответствуют существующим должностям сотрудников и возвращает список должностей сотрудников.
  • Проверяет, что ни один IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. отдела клиента не равен null.
  • Проверяет, что все UUID, заданные в списке, соответствуют существующим отделам клиента и возвращает список отделов клиента.
  • Проверяет, что сотрудники относятся к юрлицам, на которые распространяется нормативный акт.
  • Проверяет, что сотрудники не уволены.
  • Проверяет, что все сотрудники, заданные в данных фильтрации, подтверждены.
  • Проверяет, что среди списка IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. сотрудников ни один не равен null.
  • Проверяет, что сотрудники существуют по всем заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях., и возвращает список сотрудников.
  • Проверяет, что все сотрудники принадлежат клиенту с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
  • Проверяет, что отделы сотрудников входят в список разрешенных отделов пользователя клиента с учетом замещенийSubstitution Замещение — временная передача прав одного пользователя другому (например, на время отпуска). Настраивается для конкретных контекстов: документы, заявления, сотрудники, ЛНА..
  • Проверяет, что заданный сотрудник относится к заданному клиенту.
  • Проверяет, что отделы сотрудников доступны пользователю клиента с учётом контекста текущей операции.

Request​

Responses​

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