метод REST scope: humanresources.hcmlink

humanresources.hcmlink.company.update

Обновить компанию HCM Link

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

Описание

Метод humanresources.hcmlink.company.update обновляет компанию из системы кадрового учета и список ее полей в интеграции HCM Link.

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

Параметры

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

Идентификатор компании HCM Link.

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

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

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

Параметр fields

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

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

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

Идентификатор компании CRM.

Получить идентификатор можно методом crm.item.list с параметром entityTypeId = 4 и фильтром isMyCompany = Y

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

Название компании

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

Дополнительные данные компании

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

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

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

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

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

Название поля

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

Тип поля. Если не передать значение, метод сохранит поле с внутренним типом UNKNOWN.

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

  • STRING — строка
  • FIRST_NAME — имя
  • LAST_NAME — фамилия
  • PATRONYMIC_NAME — отчество
  • PHONE — телефон
  • EMAIL — адрес электронной почты
  • ADDRESS — адрес
  • BIRTHDAY — дата рождения
  • SNILS — СНИЛС
  • INN — ИНН
  • POSITION — должность
  • DEPARTMENT — подразделение
  • DOCUMENT_REGISTRATION_NUMBER — регистрационный номер документа
  • DOCUMENT_UID — уникальный идентификатор документа
  • DOCUMENT_DATE — дата документа
entityType string необязательный

Тип объекта, к которому относится поле. Если не передать значение, метод сохранит поле с внутренним типом UNKNOWN.

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

  • EMPLOYEE — сотрудник
  • COMPANY — компания
  • DOCUMENT — документ
ttl integer необязательный

Время хранения значения поля в секундах.

По умолчанию 86400

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":15,"fields":{"company":"hr-company-001","crmCompanyId":12,"title":"ООО Ромашка","fields":[{"field":"personal_number","title":"Табельный номер","type":"STRING","entityType":"EMPLOYEE"}]},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/humanresources.hcmlink.company.update

Ответ

HTTP-статус: 200

{
    "result": true,
    "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 boolean

Возвращает true, если компания обновлена

time time

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

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

HTTP-статус: 200

{
    "error": 510,
    "error_description": "Operation failed"
}
Код Описание Значение
510 Operation failed Не переданы обязательные поля, компания CRM не найдена или произошла ошибка сохранения
ACCESS_DENIED Access denied! Access denied. Пользователь не является администратором
WRONG_AUTH_TYPE Application context required Метод вызван не в контексте приложения

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

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