метод REST scope: humanresources.hcmlink

humanresources.hcmlink.field.value.set

Передать значения полей HCM Link

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

Описание

Метод humanresources.hcmlink.field.value.set передает значения полей системы кадрового учета для сотрудников.

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

Параметры

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

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

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

Идентификатор компании CRM можно получить методом crm.item.list с параметром entityTypeId = 4 и фильтром isMyCompany = Y. Если передан job, компания может быть определена по заданию

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

Список значений полей (подробное описание)

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

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

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

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

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

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

Получить код можно из fields[].field в ответе метода humanresources.hcmlink.company.list

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

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

Получить код можно из employees[].employee в ответе метода humanresources.hcmlink.employee.list

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

Значение поля

Параметр job

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

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

Приходит в событиях OnHumanResourcesHcmLinkFieldValueRequested, OnHumanResourcesHcmLinkPinRequested или OnHumanResourcesHcmLinkSalaryVacationRequested в поле 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":[{"field":"personal_number","employee":"employee-001","value":"TN-1001"}],"job":{"id":101,"fields":{"status":"DONE","total":1,"sent":1}},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/humanresources.hcmlink.field.value.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 #... field '...' not found for company '...' Поле не найдено в компании
Item #... employee '...' not found for company '...' Сотрудник не найден в компании
Item #... does not match PIN request job '...' Значение не соответствует заданию запроса ПИН-кода
Item #... does not match salary/vacation request job '...' Значение не соответствует заданию запроса расчетных листков или остатков отпусков
Job '...' result is incomplete Для задания передан статус DONE, но в ответе нет всех запрошенных значений
ACCESS_DENIED Access denied! Access denied. Пользователь не является администратором
WRONG_AUTH_TYPE Application context required Метод вызван не в контексте приложения

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

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