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

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

POST 
/api/v1/clients/:clientId/normativeActs/:normativeActId/sendToSigning

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

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

  • Тело запроса задано.
  • Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативного акта задан корректно.
  • Нормативный акт существует по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях..
  • Нормативный акт относится к заданному клиенту.
  • Список IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. юрлиц задан корректно.
  • Пользователь клиента, выполняющий операцию, имеет право PERSONAL_DATA на уровне пользователя клиента или PERSONAL_DATA на уровне сотрудника хотя бы одного из юрлиц при использовании фильтрации по номеру документа сотрудника.
  • Пользователь клиента имеет доступ к типу документа нормативного акта.
  • Пользователь клиента имеет доступ хотя бы к одному отделу клиента, на который распространяется нормативный акт.
  • Нормативный акт не удалён.
  • Конвертация файла нормативного акта в PDF/A формат завершилась.
  • Нормативный акт был утвержден, если он требует утверждения.
  • Данные фильтрации заданы корректно для выполнения операции отправки нормативного акта сотрудникам.
  • Лимит на выполнение операций создания печатной формыпечатная форма PDF-документ с визуальным оттиском подписей, который система формирует после завершения документооборота. Печатная форма доступна для скачивания и используется для архивного хранения. файла для заданного тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. не превышен.
  • Существует активный пакет СМС и лимит СМС для заданного тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. не превышен.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. нормативного акта задан корректно и возвращает нормативный акт, если он существует.
  • Каждое юр лицо связано с заданным нормативным актом.
  • У пользователя клиента есть право во всех заданных юр лицах, которым принадлежит нормативный акт.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
  • По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
  • Пользователь, выполняющий операцию, относится к клиенту.
  • Проверяет, есть ли у пользователя клиента с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. заданное право и возвращает кэш наличия прав у пользователя клиента.
  • Пользователь клиента имеет право PERSONAL_DATA.
  • Пользователь клиента имеет право PERSONAL_DATA на уровне одного из юрлиц.
  • Один из замещаемых пользователей клиента имеет право PERSONAL_DATA.
  • Проверяет, что пользователь клиента имеет доступ к типам документов каждого нормативного акта.
  • Проверяет, что пользователь клиента имеет доступ хотя бы к одному отделу клиента, на которые распространяется заданный нормативный акт.
  • В метод должен быть передан список разрешённых отделов, который включает в себя все дочерние и родительские отделы разрешённых отделов.
  • Это нужно из-за бизнес-правила: нормативный акт, который распространяется на выбранный отдел, должен быть доступен и сотруднику, который имеет доступ только к дочерним отделам выбранного отдела.
  • Проверяет, что ни один нормативный акт из указанной коллекции не удалён.
  • Проверяет, что конвертация файла в PDF/A формат завершилась для каждого нормативного акта из указанной коллекции.
  • Проверяет, что нормативный акт был утвержден, если он требует утверждения.
  • Нормативный акт требует утверждения, если у него существует утверждающий документ.
  • Пользователь клиента имеет права для получения данных должностей сотрудников.
  • Если 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 при создании. Неизменяемый, используется во всех внутренних операциях. заданное право, учитывая замещения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​

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