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

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

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​

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