Заявления

Заявление создаёт сотрудник, а не кадровик. Заявление идёт по маршруту подписания, в котором участвуют согласующие и кадровики.

Виды подписей, которые применяет HRlink, и их отличия описаны на странице Подписи.

Заявления и документы

В HRlink есть два основных объекта для подписания: заявления (создаёт сотрудник) и документы (создаёт кадровик). Краткое и подробное сравнение собрано на отдельной странице: Заявления и документы: отличия.

Когда использовать

Используйте заявления, если процесс начинает сотрудник: он выбирает тип заявления, заполняет форму или прикладывает файл и запускает маршрут, настроенный кадровиком заранее.

Что нужно заранее

Что нужно	Где получить
clientId	Текущий пользователь
Токен	Аутентификация
Тип заявления	Получить типы заявлений
Получатели заявления	Модель данных
Маршрут заявления	Настройки типа заявления
Тип подписи	Подписи

Типовые сценарии

Создать заявление

1. Получите типы заявлений через Получить типы заявлений.
2. Выберите тип заявления и подготовьте данные формы или файл.
3. Создайте группу заявлений через Создать группу заявлений.
4. Проверьте результат через Получить реестр заявлений кадровика или Получить реестр заявлений сотрудника.

Подробный пример — в гайде Работа с заявлениями.

Подписать или отклонить заявление

1. Определите доступный способ подписи в маршруте.
2. Для ПЭППЭП Простая электронная подпись (SES). Подтверждает факт подписания, но не гарантирует неизменность документа после подписания. вызовите Подписать заявление ПЭП.
3. Для отказа вызовите Отклонить заявление.

Ограничения и ошибки

• У заявления нет статуса ANNULLED: аннулировать заявление нельзя.
• Маршрут заявления привязан к типу заявления, а не выбирается при создании каждого заявления.
• Сейчас ApplicationGroup содержит ровно одно заявление.
• Для отдельного заявления УНЭПУНЭП Усиленная неквалифицированная электронная подпись (CLOUD_NQES). Облачная подпись, обеспечивающая целостность документа. и УКЭПУКЭП Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя. через API не поддерживаются.

Структура заявления

Каждое заявление принадлежит группе заявлений и юридическому лицу.

Поле	Тип	Описание
id	UUID	Идентификатор заявления
applicationGroupId	UUID	Группа заявлений
legalEntityId	UUID	Юридическое лицо
originalFileId	UUID	Файл, загруженный сотрудником
templateFileId	UUID	Файл шаблона (для шаблонных заявлений)
convertedFileId	UUID	PDF/A-версия файла
printFormFileId	UUID	Печатная формапечатная форма PDF-документ с визуальным оттиском подписей, который система формирует после завершения документооборота. Печатная форма доступна для скачивания и используется для архивного хранения.
externalId	string	Идентификатор во внешней системе

Статусы заявления

Статус	Описание
DRAFT	Черновик — заявление создано, но ещё не отправлено по маршруту
AWAITING_MY_SIGNING	Для текущего пользователя сейчас доступно подписание
AWAITING_OTHERS_SIGNING	Для текущего пользователя сейчас очередь других участников
SIGNED	Подписано на всех этапах
REJECTED	Отклонено одним из участников
DELETED	Удалено

Отличия от документов

У заявлений нет статуса ANNULLED: аннулировать заявление нельзя. Остальные различия собраны на странице Заявления и документы: отличия.

Жизненный цикл заявления

1. Создание. Сотрудник заполняет форму заявления — заявление получает статус DRAFT.
2. Отправка. Сотрудник подписывает заявление и запускает маршрут. Дальше статус, который увидит конкретный пользователь, зависит от его места в маршруте: AWAITING_MY_SIGNING или AWAITING_OTHERS_SIGNING.
3. Подписание по этапам. Согласующие и кадровики подписывают заявление в порядке, определённом маршрутом.
4. Завершение. Когда все этапы пройдены — статус SIGNED, фиксируется docflowFinishedDate.
5. Отклонение. Если участник на любом этапе отклоняет заявление — статус REJECTED.

После завершения документооборота HRlink формирует печатную формупечатная форма PDF-документ с визуальным оттиском подписей, который система формирует после завершения документооборота. Печатная форма доступна для скачивания и используется для архивного хранения. и архив.

Группы заявлений (ApplicationGroup)

Когда сотрудник подаёт заявление, HRlink создаёт ApplicationGroup. Эта сущность связывает метаданные подачи и само заявление. В API клиент передаёт группу через массив applications, но в текущей модели HRlink группа содержит ровно одно заявление.

Группа содержит:

• Тип заявления
• Дату и номер
• Данные шаблона (для шаблонных заявлений)
• Заявление
• Вложения

Типы заявлений (ApplicationType)

Тип заявления определяет категорию и настройки подачи.

Поле	Описание
name	Название типа заявления
templatable	Шаблонный ли тип (с формой для заполнения)
templateFileId	Файл шаблона для шаблонных заявлений
templateRouteId	Привязанный шаблон маршрута подписания
mintrudTypeId	Тип по классификации Минтруда
signingByEmployeeSesEnabled	Разрешено ли подписание ПЭППЭП Простая электронная подпись (SES). Подтверждает факт подписания, но не гарантирует неизменность документа после подписания.
attachmentMode	Режим вложений: OPTIONAL, REQUIRED, NOT_ALLOWED
deadlineCalculationRules	Правила расчёта срока подписания

Привязка маршрута к типу

У заявлений маршрут подписания привязан к типу заявления через поле templateRouteId. Для сравнения с документами см. Заявления и документы: отличия.

Правила расчёта сроков

Тип заявления может содержать правила автоматического расчёта дедлайна:

Поле	Описание
daysCount	Количество дней
fromDate	От какой даты считать: SENT_DATE (дата отправки) или EVENT_DATE (дата события)
rule	Направление: BEFORE (до) или AFTER (после)

Подписанты заявления (ApplicationSigner)

Поле	Описание
applicationId	Заявление
employeeId	Сотрудник-получатель
participantId	Участник маршрута
signingOrder	Порядок подписания
signatureType	Тип подписи
signedDate	Дата подписания
rejectedDate	Дата отклонения
rejectionComment	Причина отклонения
signingAvailabilityDate	Когда подписание стало доступно
active	Может ли подписать сейчас
substitutionId	Подписано по замещению (если применимо)

Получатели заявления (ApplicationRecipient)

У заявлений есть получатели — сотрудники, которым адресовано заявление. Для сравнения с наблюдателями документа см. Заявления и документы: отличия.

Ответственный за заявление (ApplicationResponsible)

Если на этапе маршрута установлен флаг responsibleEnabled, HRlink определяет ответственного за обработку заявления на этом этапе.

Отличия от документов

Подробное сравнение заявлений и документов — на странице Заявления и документы: отличия.