метод REST scope: humanresources.hcmlink

humanresources.hcmlink.employee.set

Передать список сотрудников HCM Link

Кто может выполнять: администратор

Описание

Метод humanresources.hcmlink.employee.set передает список сотрудников из системы кадрового учета в интеграцию HCM Link.

Метод работает только в контексте авторизации приложения.

Параметры

company string обязательный

Код компании в системе кадрового учета.

Получить код можно методом humanresources.hcmlink.company.list

data array обязательный

Список сотрудников из системы кадрового учета (подробное описание)

job object необязательный

Данные для обновления задания синхронизации (подробное описание).

Передавайте параметр, если метод выполняется в ответ на событие OnHumanResourcesHcmLinkEmployeeListRequested. Идентификатор задания приходит в событии в поле jobId

Элемент массива data

employee string обязательный

Код сотрудника в системе кадрового учета

person string обязательный

Код физического лица в системе кадрового учета

userId integer необязательный

Идентификатор пользователя Битрикс24.

Получить идентификатор можно методом user.get

data object обязательный

Данные сотрудника (подробное описание). Объект должен содержать хотя бы одно поле с непустым значением

firstName string необязательный

Имя

lastName string необязательный

Фамилия

patronymicName string необязательный

Отчество

Параметр job

id integer обязательный

Идентификатор задания синхронизации.

Приходит в событии OnHumanResourcesHcmLinkEmployeeListRequested в поле jobId

fields object обязательный

Новые данные задания синхронизации (подробное описание)

Параметр job.fields

status string обязательный

Новый статус задания.

Возможные значения:

  • IN_PROGRESS — выполняется
  • DONE — выполнено
  • CANCELED — отменено
total integer необязательный

Общее количество элементов в задании

sent integer необязательный

Количество обработанных элементов

data object необязательный

Дополнительные данные задания

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"company":"hr-company-001","data":[{"employee":"employee-001","person":"person-001","userId":25,"data":{"firstName":"Иван","lastName":"Петров","patronymicName":"Иванович","position":"Менеджер"}}],"job":{"id":101,"fields":{"status":"DONE","total":1,"sent":1}},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/humanresources.hcmlink.employee.set

Ответ

HTTP-статус: 200

{
    "result": {
        "status": "ok",
        "errors": []
    },
    "time": {
        "start": 1739860000.123,
        "finish": 1739860000.456,
        "duration": 0.333,
        "processing": 0.111,
        "date_start": "2026-08-06T19:51:02+03:00",
        "date_finish": "2026-08-06T19:51:02+03:00"
    }
}

Возвращаемые данные

result object

Результат обработки списка сотрудников

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 200

{
    "result": {
        "status": "error",
        "errors": [
            "Parameter 'data' must be a non empty array "
        ]
    }
}
Код Описание Значение
0 Operation failed Не удалось обновить задание синхронизации, переданное в параметре job
Parameter 'data' must be a non empty array Не передан список сотрудников
Item #... should have not empty 'employee', 'person', 'data' В элементе списка нет обязательных полей
ACCESS_DENIED Access denied! Access denied. Пользователь не является администратором
WRONG_AUTH_TYPE Application context required Метод вызван не в контексте приложения

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.