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
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
try {
const response = await $b24.actions.v2.call.make({
method: 'humanresources.hcmlink.company.update',
params: {
id: 15,
fields: {
company: 'hr-company-001',
crmCompanyId: 12,
title: 'ООО Ромашка',
fields: [
{
field: 'personal_number',
title: 'Табельный номер',
type: 'STRING',
entityType: 'EMPLOYEE',
},
],
},
},
requestId: Text.getUuidRfc4122()
})
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
console.info(response.getData()!.result)
}
} catch (error) {
console.error(error)
}
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function updateHcmLinkCompany() {
try {
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'humanresources.hcmlink.company.update',
params: {
id: 15,
fields: {
company: 'hr-company-001',
crmCompanyId: 12,
title: 'ООО Ромашка',
fields: [
{
field: 'personal_number',
title: 'Табельный номер',
type: 'STRING',
entityType: 'EMPLOYEE'
}
]
}
},
requestId: B24Js.Text.getUuidRfc4122()
})
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
console.info(response.getData().result)
} catch (error) {
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', updateHcmLinkCompany)
</script>
try {
$response = $b24Service
->core
->call(
'humanresources.hcmlink.company.update',
[
'id' => 15,
'fields' => [
'company' => 'hr-company-001',
'crmCompanyId' => 12,
'title' => 'ООО Ромашка',
'fields' => [
[
'field' => 'personal_number',
'title' => 'Табельный номер',
'type' => 'STRING',
'entityType' => 'EMPLOYEE',
],
],
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error updating company: ' . $e->getMessage();
}
BX24.callMethod(
'humanresources.hcmlink.company.update',
{
id: 15,
fields: {
company: 'hr-company-001',
crmCompanyId: 12,
title: 'ООО Ромашка',
fields: [{ field: 'personal_number', title: 'Табельный номер', type: 'STRING', entityType: 'EMPLOYEE' }]
}
},
function(result)
{
if (result.error())
{
console.error(result.error(), result.error_description());
}
else
{
console.dir(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'humanresources.hcmlink.company.update',
[
'id' => 15,
'fields' => [
'company' => 'hr-company-001',
'crmCompanyId' => 12,
'title' => 'ООО Ромашка',
'fields' => [
[
'field' => 'personal_number',
'title' => 'Табельный номер',
'type' => 'STRING',
'entityType' => 'EMPLOYEE',
],
],
],
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "humanresources.hcmlink.company.update", b24.Params{
"id": 15,
"fields": b24.Params{
"company": "hr-company-001",
"crmCompanyId": 12,
"title": "ООО Ромашка",
"fields": []b24.Params{
{
"field": "personal_number",
"title": "Табельный номер",
"type": "STRING",
"entityType": "EMPLOYEE",
},
},
},
}, b24.WithIdempotent())
if err != nil {
return fmt.Errorf("humanresources.hcmlink.company.update: %w", err)
}
var updated bool
if err := json.Unmarshal(res.Result, &updated); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println(updated)
Ответ
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 | Метод вызван не в контексте приложения |

