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

Работа с доверенностями (МЧД)

Машиночитаемая доверенность (МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица.) — электронный документ с полномочиями представителя организации. HRlink хранит МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица., отправляет её на подписание УКЭПУКЭП (Усиленная квалифицированная электронная подпись). Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя. и отдаёт по API в виде XML или архива с подписью.

Что получится в конце​

После выполнения сценария HRlink сохранит МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица., переведёт её в подписание, примет УКЭПУКЭП (Усиленная квалифицированная электронная подпись). Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя. и позволит получить доверенность по externalId.

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

Что нужноГде получить
tenantHostАдрес тенантаTenantЭкземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов. HRlink
clientIdТекущий пользователь
ТокенАутентификация
XML-файл МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица.В системе, которая формирует доверенность
Файл отсоединённой подписи .sigВ системе подписания, если XML уже подписан
externalId МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица.Идентификатор доверенности во внешней системе
Средство УКЭПУКЭП (Усиленная квалифицированная электронная подпись). Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя.На стороне клиента: КриптоПро CSP, Rutoken или другой криптопровайдер

Какие методы используются​

ШагМетод
Загрузить XML и подписьЗагрузить файл
Импортировать МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица.Импорт МЧД
Отправить на подписаниеОтправить МЧД на подписание
Подписать УКЭПУКЭП (Усиленная квалифицированная электронная подпись). Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя.Подписать МЧД УКЭП
Найти МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица.Получить МЧД по externalId

Сценарий импорта МЧД​

Шаг 1. Загрузить XML-файл доверенности​

Загрузите XML доверенности через Загрузить файл. Если XML был подписан отсоединённой подписью — загрузите файл подписи .sig отдельным запросом. Сохраните fileId каждого файла для шага 2.

curl -X POST "https://{tenantHost}/api/v1/files" \
  -H "Accept: application/json" \
  -H "User-Api-Token: {token}" \
  -F "file=@/path/to/attorney.xml"

Шаг 2. Импортировать МЧД​

Передайте fileId XML и fileId подписи в Импорт МЧД. В ответе сохраните attorney.externalId: по нему следующие методы получают, подписывают и скачивают МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица..

curl -X POST "https://{tenantHost}/api/v1/clients/{clientId}/attorneys/import" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "User-Api-Token: {token}" \
  -d '{
    "xmlFileId": "{fileId XML}",
    "signatureFileId": "{fileId подписи}"
  }'

Шаг 3. Отправить на подписание​

Переведите МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица. в статус подписания через Отправить МЧД на подписание. Метод принимает массив МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица.. В теле передайте externalId и текущую version доверенности — сервер увеличит её на 1 при успешном переходе статуса.

curl -X PUT "https://{tenantHost}/api/v1/clients/{clientId}/attorneys/sendToSigning" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "User-Api-Token: {token}" \
  -d '{"attorneys":[{"externalId":"ATT-001","version":1}]}'

Шаг 4. Подписать УКЭП​

Получите подпись на стороне клиента (КриптоПро CSP, Rutoken, плагин в браузере) и передайте её в Base64 через Подписать МЧД УКЭП. Поле version — актуальная версия МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица. после шага 3.

curl -X PUT "https://{tenantHost}/api/v1/clients/{clientId}/attorneysByExternalId/ATT-001/sign" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "User-Api-Token: {token}" \
  -d '{
    "signature": "{base64-подпись}",
    "version": 2
  }'

Создание доверенности через API​

Если нужно создать запись МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица. через API без импорта XML — используйте Создать МЧД. В теле передайте externalId, юрлицо, представителя, срок действия и полномочия.

curl -X POST "https://{tenantHost}/api/v1/clients/{clientId}/attorneys" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "User-Api-Token: {token}" \
  -d '{
    "legalEntityId": "{UUID юрлица}",
    "externalId": "ATT-002",
    "delegateClientUserId": "{UUID пользователя-представителя}",
    "startDate": "2026-04-15",
    "endDate": "2027-04-15",
    "permissions": {
      "textContent": "Подписание кадровых документов"
    }
  }'

Получение доверенности по externalId​

Чтобы найти МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица. по идентификатору из вашей системы, вызовите Получить МЧД по externalId. Это удобно, когда attorneyId не сохранён на стороне интегратора.

curl -X GET "https://{tenantHost}/api/v1/clients/{clientId}/attorneysByExternalId/ATT-001" \
  -H "Accept: application/json" \
  -H "User-Api-Token: {token}"

Скачивание архива и XML​

Архив содержит XML-файл МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица. и файл подписи в одном ZIP — используйте его для передачи МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица. в другие системы. Отдельный XML нужен, когда сторонняя сторона запрашивает только тело доверенности без подписи.

# Скачать архив
curl -X GET "https://{tenantHost}/api/v1/clients/{clientId}/attorneysByExternalId/ATT-001/archive" \
  -H "User-Api-Token: {token}" -o attorney.zip

# Скачать XML
curl -X GET "https://{tenantHost}/api/v1/clients/{clientId}/attorneysByExternalId/ATT-001/xml" \
  -H "User-Api-Token: {token}" -o attorney.xml

Реестр доверенностей​

Список МЧДМЧД (Машиночитаемая доверенность). Машиночитаемая доверенность (Attorney) — электронный документ, подтверждающий полномочия представителя юридического лица. клиента с фильтрами и пагинацией отдаёт Получить реестр МЧД. Пагинация — через limit (количество элементов в ответе) и offset (смещение от начала списка).

curl -X POST "https://{tenantHost}/api/v1/clients/{clientId}/attorneys/getHrRegistry" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "User-Api-Token: {token}" \
  -d '{"limit": 50, "offset": 0}'
УКЭП и HRlink

HRlink не хранит закрытый ключ УКЭПУКЭП (Усиленная квалифицированная электронная подпись). Усиленная квалифицированная электронная подпись (QES). Имеет полную юридическую силу. HRlink не хранит закрытый ключ — он находится на ПК пользователя.. Ключ остаётся на стороне подписанта — на рабочей станции, токене или смарт-карте. API принимает только готовую Base64-подпись через поле signature.