метод REST scope: humanresources.hcmlink

humanresources.hcmlink.company.add

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

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

Описание

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

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

Параметры

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 '{"fields":{"company":"hr-company-001","crmCompanyId":12,"title":"ООО Ромашка","data":{"inn":"1234567890"},"fields":[{"field":"personal_number","title":"Табельный номер","type":"STRING","entityType":"EMPLOYEE","ttl":86400}]},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/humanresources.hcmlink.company.add

Ответ

HTTP-статус: 200

{
    "result": 15,
    "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 integer

Идентификатор добавленной компании HCM Link

time time

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

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

HTTP-статус: 200

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

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

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