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

Массово подписать и отправить

PUT 
/api/v1/clients/:clientId/documents/sendAndSign

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

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

Методы PUT перезаписывают запись целиком: любые непереданные поля считаются null и затирают данные в БД. Поэтому при обновлении нужно указывать все поля. Выполняет массовое подписание документов с одновременной отправкой на подписание, если это необходимо.

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

  • Клиент существует, не удалён, и к нему относится пользователь, выполняющий операцию.
  • Тело запроса должно быть задано.
  • В теле запроса должен быть задан список данных для подписей, ни один из элементов не должен быть пустым.
  • Каждый документ существует.
  • Для каждого документа у пользователя есть право массового подписания.
  • Каждый документ относится к заданному клиенту.
  • Каждая подпись документа имеет корректный формат.
  • Для каждого документа указан облачный УКЭПУКЭП Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя..
  • Каждый документ не удалён.
  • Каждый документ-черновик должен иметь тип.
  • Каждый документ-черновик должен иметь номер.
  • Каждый документ-черновик должен иметь дату.
  • Каждый документ-черновик должен иметь порядок подписания.
  • Для каждого документа-черновика завершилась конвертация файла документа в PDF/A формат.
  • Для каждого документа-черновика набор подписантов документа указан корректно относительно порядка подписания.
  • Если текущий пользователь клиента является первыми подписантами документа после его отправки на подписание, то все первые подписанты документа после его отправки на подписание должны быть руководителями.
  • Если текущий пользователь клиента не является первыми подписантами документа после его отправки на подписание, то все первые подписанты документа после его отправки на подписание должны быть руководителями-подписантами и у пользователя клиента должно быть право подписывать за руководителя.
  • Для каждого документ не черновика есть подписант документ, который еще не принял решение о подписание и он является руководителем.
  • Для каждого документа не черновика, если пользователь клиента не является текущим подписантом, то у него должно быть право подписывать документы за руководителя.
  • У каждого документа не черновика должен быть подписант, который еще не принял решение о подписание.
  • Для каждого документа не черновика текущий пользователь являться одним из заданных подписантов или имеет право подписывать документ за руководителя.
  • Подписант всех документов не черновиков должен быть руководителем.
  • Для каждого документа не черновика текущий подписант не выполнил отказ от подписания документа.
  • Для каждого документа не черновика ни один подписант документа не выполнил отказ от подписания документа.
  • Для каждого документа не черновика текущий подписант еще не подписал документ.
  • Для каждого документа не черновика необходимо, чтобы все подписанты, стоящие перед текущим подписантом, подписали документ.
  • Существует активный пакет СМС и лимит СМС в пакете лицензий не должен быть исчерпан.
  • Лимит на выполнение операций создания печатной формыпечатная форма PDF-документ с визуальным оттиском подписей, который система формирует после завершения документооборота. Печатная форма доступна для скачивания и используется для архивного хранения. файла для заданного тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. не будет превышен.
  • Файл подписи соответствует файлу для каждого документа.
  • IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента соответствует формату UUID.
  • По заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента существует клиент.
  • Пользователь, выполняющий операцию, относится к клиенту.
  • Проверяет, что список данных подписей документов не пуст и не содержит null-элементов.
  • Проверяет, что все заданные документы существуют по заданным данным подписей документов, и возвращает список документов.
  • Проверяет, что документ относится к заданному клиенту.
  • Документ отправлен на подпись и текущий пользователь является его следующим подписантом.
  • Документ является черновиком, текущий пользователь является его первым подписантом и имеет право DOCUMENTS_MULTIPLE_SEND_AND_SIGN на уровне пользователя клиента или DOCUMENTS_MULTIPLE_SEND_AND_SIGN в юрлице документа.
  • Текущий пользователь не является следующим подписантом и проходит проверку прав на выполнение операций с документами.
  • Во всех данных для подписания, если IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. МЧДМЧД Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица. задан, то по нему существует МЧДМЧД Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица..
  • Подпись каждого документа имеет корректный формат Base64.
  • Бинарные данные внешнего УКЭПУКЭП Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя. указаны для каждого документа.
  • Для каждого документа тип подписи задан корректно, исходя из настроек тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов..
  • Проверяет для документов, что подписи УКЭПУКЭП Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя. корректны для соответствующих файлов документов.
  • Если в настройке тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. выключен флаг проверки подписи УКЭПУКЭП Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя. и файла, тогда пропускаем данную валидацию.
  • Проверяет, что текущий пользователь относится к заданному клиенту и возвращает пользователя клиента, если он существует.
  • Проверяет, что IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента, заданный в виде строки, соответствует формату, и возвращает типизированный IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. клиента.
  • Проверяет существование клиента по заданному IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. и возвращает клиента, если он существует.
  • Проверяет, что клиент не удален.
  • Проверяет наличие у пользователя клиента права для массового подписания документов с одновременной отправкой на подпись в списке юрлиц.
  • Проверяет, что у пользователя клиента есть указанное право для каждого из заданных документов.
  • У остальных сотрудников проверяется право на уровне юрлица документа, на уровне типа документа и на уровне отдела сотрудника-подписанта.
  • Проверяет, есть ли у пользователя клиента с заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. заданное право и возвращает кэш наличия прав у пользователя клиента.
  • Проверяет, что по заданным IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. в системе HR-Link или IDid Внутренний идентификатор сущности в формате UUID, генерируемый HRlink при создании. Неизменяемый, используется во всех внутренних операциях. во внешней системе существует МЧДМЧД Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица..
  • Проверяет, что подпись документа имеет корректный формат.
  • Проверяет, что облачный УНЭПУНЭП Усиленная неквалифицированная электронная подпись (CLOUD_NQES). Облачная подпись, обеспечивающая целостность документа. указан для документа.
  • Проверяет, что аккредитация УЦ выпустившего сертификат не была отозвана.
  • Проверка выполняется только при включенной глобальной настройке блокировки подписания УКЭПУКЭП Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя. выпущенных УЦ без аккредитации, при условии что на уровне тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. выключена настройка игнорирования этого запрета.
  • Выполняет проверку типа подписи CAdES, исходя из настроек тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов..
  • Если в настройках тенантаTenant Экземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. включено требование использовать тип подписи CAdES-X Long Type 1, то тип подписи должен соответствовать настройке.
  • Проверяет, что документ-черновик находится в корректном состоянии для отправки на подписание и одновременного подписания заданным пользователем клиента.
  • Проверяет, что подписи УКЭПУКЭП Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя. и соответствующие файлы корректны.
  • Возвращаются только результаты проверки, которые завершились неуспешно.
  • Если все подписи УКЭПУКЭП Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя. и файлы прошли проверку, тогда возвращается пустой список.
  • В случае успешной проверки всех подписей УКЭПУКЭП Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя. и соответствующих файлов возвращается пустой список.
  • Проверяет, есть ли у пользователя клиента заданное право на уровне пользователя клиента по заданным данным аутентификации.
  • Проверяет, что подпись корректна и возвращает её данные.

Request​

Responses​

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