История изменений

На этой странице отражены изменения публичной документации: новые методы, изменения контрактов, устаревшие методы, удалённые возможности и исправления, которые влияют на интеграции.

Важно

Все изменения сохраняют работу существующих интеграций. Если вы уже используете API, ваши текущие запросы и обработка ответов продолжают работать без доработок. Менять интеграцию нужно только в том случае, если вы хотите использовать новую функциональность: новый метод, параметр или поле в ответе.

Версионирование

Версия записи состоит из трёх частей: major.minor.patch. Часть minor показывает номер релиза приложения HRlink, которому соответствует документация. Например, записи 2.102.* описывают изменения документации для релиза HRlink 102.

Как читать записи

• Добавлено — новые методы, параметры, схемы или разделы документации.
• Изменено — правки существующего поведения, параметров, схем или описаний.
• Устарело — методы или поля, которые HRlink больше не рекомендует использовать.
• Удалено — методы, поля или сценарии, которые больше недоступны.
• Исправлено — уточнения и исправления ошибок в документации без изменения API-контракта.

2.105.1 от 07.09.2026 г.

Добавлено

• Руководство Пользовательские справочники и признаки сотрудника: использование в интерфейсе, создание и обновление справочников через API, назначение и снятие признаков, права доступа и ограничения массовой синхронизации.

2.105.0 от 18.08.2026 г.

Добавлено

• Руководство Планирование отпусков описывает загрузку доступных дней и региональных календарей, открытие и закрытие планирования, работу сотрудников и руководителей, выгрузку графика и обратную синхронизацию исправленных периодов.
• Методы Подписать через Госключ, Подтвердить подписание (УНЭП), Подписать через ПРР async (v2), Подписать (ПЭП), Подписать (УКЭП) (v2) и Подписать (УКЭП) по внешнему ID (v2) принимают новый необязательный query-параметр decision. Он нужен при подписании документа-уведомления о начале отпуска: значение TRANSFER_VACATION означает, что сотрудник запрашивает перенос отпуска. По умолчанию — CONFIRM_VACATION, подтверждение отпуска без переноса. На подписание остальных типов документов параметр не влияет.
• Метод Получить типы заявлений принимает новый необязательный query-параметр dataSet. Он задаёт набор возвращаемых типов заявлений: ALL, ACTIVE, ACTIVE_EXCLUDE_SERVICE или VACATION_TRANSFER. Если не передать, поведение не изменилось.
• Методы Отправить на подписание (частично) и Создать группу и отправить на подписание принимают у документа необязательное поле vacationNotification.vacations[]. Оно привязывает документ к периодам отпуска сотрудника-подписанта как документ-уведомление: HRlink ищет у сотрудника отпуска со статусом «Утверждён кадровиком», совпадающие по датам и типу, и после отправки документа на подписание привязывает его к каждому найденному отпуску. У метода Отправить на подписание (все) это же поле присутствует в теле запроса, но не обрабатывается.
• Методы Получить разрешённые типы заявлений сотрудника, Обновить разрешённые типы заявлений сотрудника и их варианты по внешнему IDexternalIdВнешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. сотрудника. Ограничивают, заявления каких типов сотрудник может обрабатывать как кадровик (реестр заявлений кадровика, согласование/подписание по маршруту на стороне HR). Не влияют на то, какие типы заявлений сотрудник может подать сам как заявитель — за это отвечает поле permittedByClientDepartments на самом типе заявления.

Исправлено

• Документация метода Изменить состояние планирования теперь указывает фактическое значение planningYear по умолчанию: следующий год, а не текущий.
• На странице Создать задачу синхронизации актуализированы возможные значения type. Удалены технические дискриминаторы и добавлены новые значения CLIENT_DEPARTMENTS_V2, EMPLOYEE_FUNCTIONAL_MANAGERS_V2 и CLIENT_USERS_V7, включая соответствующую им структуру полей data и parameters.
• Страница Создать задачу синхронизации теперь использует фактические конечные состояния задачи FINISHED и FAILED и описывает состояние элемента SKIPPED.
• Методы Обновить пользователя клиента и Обновить пользователя клиента по внешнему ID теперь описывают поведение при смене email/phone: для неподтверждённого пользователя значение заменяется сразу, а для уже подтверждённого — создаётся новый неподтверждённый канал оповещения с приглашением, которое подтверждает сам пользователь. После подтверждения прежний логин того же типа освобождается (перестаёт быть закреплён за пользователем), а не помечается неактивным.
• Метод Создать задачу экспорта описывал неверные значения поля params.registryType для типов APPLICATIONS_DOCFLOW_ARCHIVES и DOCUMENTS_DOCFLOW_ARCHIVES (HR_DOCUMENTS/EMPLOYEE_DOCUMENTS вместо реальных HR/EMPLOYEE/EMPLOYER).

2.104.1 от 03.08.2026 г.

Добавлено

• Раздел Корпоративный SSO описывает подключение входа через OAuth 2.0 и OpenID Connect, требования к провайдеру удостоверений, сопоставление пользователей, режимы входа, данные для настройки и текущие ограничения.
• Раздел Интеграция с Active Directory описывает подключение входа через Kerberos, подготовку Active Directory, данные для настройки и текущие ограничения.

Изменено

• Руководство Мастер-токен разделено на четыре последовательных шага: регистрация интегратора, подготовка JWT, получение мастер-токена и запросы от имени пользователя.

Исправлено

• OpenAPI больше не помечает внешние идентификаторыexternalIdВнешний идентификатор сущности — произвольная строка, задаваемая интегратором при создании. Связывает сущность HRlink с записью во внешней системе (1С, SAP и др.) без хранения маппинга UUID. как UUID. В схемах это строки без format: uuid, поэтому валидация по OpenAPI не отклоняет идентификаторы, которые не соответствуют формату UUID.
• В спецификации ESAESA (External System Authentication). Сервис аутентификации внешних систем (esa.hr-link.ru). Через ESA интеграторы получают мастер-токены и реализуют сквозную аутентификацию. адрес сервера по умолчанию исправлен с https://portal.hr-link.ru на https://esa.hr-link.ru. Try it и сгенерированные клиенты отправляют запросы метода Создать мастер-токен и других методов ESAESA (External System Authentication). Сервис аутентификации внешних систем (esa.hr-link.ru). Через ESA интеграторы получают мастер-токены и реализуют сквозную аутентификацию. на единый адрес, который не зависит от тенантаTenantЭкземпляр системы HRlink на отдельном домене (например, company.hr-link.ru). Внутри одного тенанта может быть несколько пространств клиентов..

2.104.0 от 27.07.2026 г.

Добавлено

• Метод Получить пересечения отпусков возвращает периоды пересечения отпусков и список сотрудников для каждого периода.

Изменено

• Метод Получить сертификат принимает необязательный query-параметр alg. Параметр задаёт семейство алгоритма подписи: ES, RS или PS. Значение по умолчанию — RS.
• Метод Получить шаблоны маршрутов возвращает необязательные поля escalationSettings и xmlParticipantType в данных участника маршрута.
• В данных подписанта заявления появилось необязательное поле escalatedDate — дата и время срабатывания эскалации.
• Метод Получить реестр отпусков возвращает табельный номер сотрудника в необязательном поле number.
• Метод Создать задачу экспорта принимает новое значение VACATION_REGISTRY в поле type для экспорта графика отпусков.

Исправлено

• В документации по заявлениям явно указан обязательный шаг перед первым подписанием сотрудником: после создания или изменения черновика вызовите Конвертировать файл для подписания и дождитесь convertedFileProcess.state: FINISHED. Если начать подписание раньше, сервер вернёт 400 Bad Request с кодом 13.862.

2.103.1 от 16.07.2026 г.

Добавлено

• Webhook для событий документов и задач групповой отправки. Подписку настраивает команда HRlink по заявке в Службу заботы. Для on-premise поставок webhook доступен после установки приложения HRlink релиза 103.
• Подраздел Webhook с руководством по подключению и справочником событий.

2.103.0 от 19.06.2026 г.

Добавлено

• Метод Создать сотрудника.
• Метод Создать неподтверждённого пользователя.
• Метод Добавить сотруднику элементы пользовательского справочника.
• Метод Получить данные о всех юрлицах клиента версии 2. В отличие от версии 1 метод не ограничивает доступ и список возвращаемых юрлиц, но возвращает более урезанный ответ.

Устарело

• Метод Получить юрлица. Используйте версию 2.

Исправлено

• Методы групп заявлений теперь документируют поля currentUserSigningInfo, deadlineDate и deadlineViolated. HRlink уже возвращал эти поля в ответе, документация не отражала это. Поля добавлены в ответ методов: Создать черновик, Получить группу заявлений, Реестр заявлений сотрудника, Реестр заявлений кадровика, Добавить вложения, Скачать вложение заявлений.

2.102.0 от 26.05.2026 г.

Добавлено

• Добавлен раздел истории изменений публичной документации.
• Метод Получить пользователей теперь принимает необязательный query-параметр employeeStatus. Он дополнительно фильтрует пользователей клиента по наличию связанных сотрудников. Значение NO_EMPLOYEES вернёт только пользователей без связанных сотрудников. Значение WITH_EMPLOYEES вернёт только пользователей, у которых есть хотя бы один связанный сотрудник. Права доступа и остальные фильтры применяются всегда. Если не передать employeeStatus, HRlink вернёт пользователей, доступных текущему пользователю с учётом уже существующих параметров запроса: ids, search, userRoleIds, confirmationStatus, disabledStatus, offset и limit.
• Методы групп заявлений теперь возвращают необязательное поле deleteInDays. Поле показывает, через сколько дней HRlink удалит черновик заявления. Если поле отсутствует или содержит null, HRlink не планирует автоматическое удаление этого черновика: например, автоудаление черновиков отключено, заявление уже не черновик. Поле добавлено в ответ методов: Создать черновик, Получить группу заявлений, Реестр заявлений сотрудника, Реестр заявлений кадровика, Добавить вложения, Удалить вложение.

Исправлено

• Зафиксирована стартовая версия истории. Изменения до 2.102.0 не отражены на этой странице.