Обновить существующую компанию crm.company.update

Scope: crm

Кто может выполнять метод: пользователь с правом «Изменение» компаний

DEPRECATED

Развитие метода остановлено. Используйте crm.item.update.

Метод crm.company.update обновляет существующую компанию.

Параметры метода

Обязательные параметры отмечены *

Название `тип`	Описание
id* `integer`	Идентификатор компании
fields* `object`	Объект формата: `{ field_1: value_1, field_2: value_2, ..., field_n: value_n, }` где: `field_n` — название поля `value_n` — новое значение поля Список доступных полей описан в методе crm.company.fields. Некорректное поле в `fields` будет проигнорировано
params `object`	Объект, содержащий набор дополнительных параметров: `REGISTER_SONET_EVENT` — отправить уведомление ответственному `REGISTER_HISTORY_EVENT` — регистрировать событие в истории. Возможные значения: `Y` — да `N` — нет

Параметр fields

Название `тип`	Описание
TITLE `string`	Название компании
COMPANY_TYPE `crm_status`	Тип компании. Значения можно получить методом crm.status.list с фильтром по `ENTITY_ID=COMPANY_TYPE`
LOGO `file`	Логотип
INDUSTRY `crm_status`	Сфера деятельности. Значения можно получить методом crm.status.list с фильтром по `ENTITY_ID=INDUSTRY`
EMPLOYEES `crm_status`	Количество сотрудников. Значения можно получить методом crm.status.list с фильтром по `ENTITY_ID=EMPLOYEES`
CURRENCY_ID `crm_currency`	Валюта
REVENUE `double`	Годовой оборот
OPENED `char`	Доступна ли компания для всех. Возможные значения: `Y` — да `N` — нет
COMMENTS `string`	Комментарий
ASSIGNED_BY_ID `user`	Ответственный
CONTACT_ID `crm_contact`	Контакт. Множественное
ORIGINATOR_ID `string`	Идентификатор источника данных. Используется только для привязки к внешнему источнику
ORIGIN_ID `string`	Идентификатор элемента в источнике данных. Используется только для привязки к внешнему источнику
ORIGIN_VERSION `string`	Оригинальная версия. Используется для защиты данных от случайного перетирания внешней системой
UTM_SOURCE `string`	Рекламная система. Yandex-Direct, Google-Adwords и другие
UTM_MEDIUM `string`	Тип трафика. Возможные значения: `CPC` — объявления `CPM` — баннеры
UTM_CAMPAIGN `string`	Обозначение рекламной кампании
UTM_CONTENT `string`	Содержание кампании. Например, для контекстных объявлений
UTM_TERM `string`	Условие поиска кампании. Например, ключевые слова контекстной рекламы
PARENT_ID_...	Поля связей. Если на портале есть смарт-процессы, связанные с компаниями, для каждого такого смарт-процесса существует поле, хранящее связь между этим смарт-процессом и компанией. Само поле хранит идентификатор элемента такого смарт-процесса
PHONE `crm_multifield[]`	Телефон. Множественное
EMAIL `crm_multifield[]`	E-mail. Множественное
WEB `crm_multifield[]`	Сайт. Множественное
IM `crm_multifield[]`	Мессенджер. Множественное
LINK `crm_multifield[]`	LINK. Множественное
UF_...	Пользовательские поля. Например, `UF_CRM_25534736`. В зависимости от настроек портала у компаний может быть набор пользовательских полей определенных типов. Добавить пользовательское поле в компанию можно с помощью метода crm.company.userfield.add

Чтобы изменить адрес и банковские реквизиты компании, используйте методы реквизитов

Примеры

Как использовать примеры в документации

cURL (Webhook)

cURL (OAuth)

PHP

BX24.js

PHP CRest

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"ID":43,"FIELDS":{"CURRENCY_ID":"RUB","REVENUE":500000,"EMPLOYEES":"EMPLOYEES_3"},"PARAMS":{"REGISTER_SONET_EVENT":"Y","REGISTER_HISTORY_EVENT":"Y"}}' \
        https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.company.update

curl -X POST \
        -H "Content-Type: application/json" \
        -H "Accept: application/json" \
        -d '{"ID":43,"FIELDS":{"CURRENCY_ID":"RUB","REVENUE":500000,"EMPLOYEES":"EMPLOYEES_3"},"PARAMS":{"REGISTER_SONET_EVENT":"Y","REGISTER_HISTORY_EVENT":"Y"},"auth":"**put_access_token_here**"}' \
        https://**put_your_bitrix24_address**/rest/crm.company.update

try
        {
        	const id = prompt("Введите ID");
        	const response = await $b24.callMethod(
        		"crm.company.update",
        		{
        			id: id,
        			fields:
        			{
        				"CURRENCY_ID": "RUB",
        				"REVENUE" : 500000,
        				"EMPLOYEES": "EMPLOYEES_3"
        			},
        			params: { "REGISTER_SONET_EVENT": "Y" }
        		}
        	);
        	
        	const result = response.getData().result;
        	if(result.error())
        	{
        		console.error(result.error());
        	}
        	else
        	{
        		console.info(result);
        	}
        }
        catch(error)
        {
        	console.error('Error:', error);
        }

$id = readline("Введите ID");
        
        try {
            $response = $b24Service
                ->core
                ->call(
                    'crm.company.update',
                    [
                        'id' => $id,
                        'fields' => [
                            'CURRENCY_ID' => 'RUB',
                            'REVENUE' => 500000,
                            'EMPLOYEES' => 'EMPLOYEES_3',
                        ],
                        'params' => ['REGISTER_SONET_EVENT' => 'Y'],
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            if ($result->error()) {
                error_log($result->error());
            } else {
                echo 'Success: ' . print_r($result->data(), true);
            }
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error updating company: ' . $e->getMessage();
        }

var id = prompt("Введите ID");
        BX24.callMethod(
            "crm.company.update",
            {
                id: id,
                fields:
                {
                    "CURRENCY_ID": "RUB",
                    "REVENUE" : 500000,
                    "EMPLOYEES": "EMPLOYEES_3"
                },
                params: { "REGISTER_SONET_EVENT": "Y" }
            },
            function(result)
            {
                if(result.error())
                    console.error(result.error());
                else
                {
                    console.info(result.data());
                }
            }
        );

require_once('crest.php');
        
        $result = CRest::call(
            'crm.company.update',
            [
                'id' => 43,
                'fields' => [
                    'CURRENCY_ID' => 'RUB',
                    'REVENUE' => 500000,
                    'EMPLOYEES' => 'EMPLOYEES_3',
                ],
                'params' => [
                    'REGISTER_SONET_EVENT' => 'Y',
                    'REGISTER_HISTORY_EVENT' => 'Y',
                ],
            ]
        );
        
        echo '<PRE>';
        print_r($result);
        echo '</PRE>';

Обработка ответа

HTTP-статус: 200

{
            "result": true,
            "time": {
                "start": 1769499930,
                "finish": 1769499931.074515,
                "duration": 1.0745151042938232,
                "processing": 1,
                "date_start": "2026-01-27T10:45:30+03:00",
                "date_finish": "2026-01-27T10:45:31+03:00",
                "operating_reset_at": 1769500530,
                "operating": 0.2604348659515381
            }
        }

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

Название `тип`	Описание
result `boolean`	Корневой элемент ответа, возвращает `true` в случае успеха
time `time`	Информация о времени выполнения запроса

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

HTTP-статус: 400

{
            "error": "",
            "error_description": "Company is not found"
        }

Название `тип`	Описание
error `string`	Строковый код ошибки. Может состоять из цифр, латинских букв и знака подчеркивания
error_description `error_description`	Текстовое описание ошибки. Описание не предназначено для показа конечному пользователю в необработанном виде

Возможные коды ошибок

Код	Описание	Значение
`-`	Parameter 'fields' must be array	В параметр `fields` передан не объект
`-`	Parameter 'params' must be array	В параметр `params` передан не объект
`-`	Access denied	У пользователя нет права «Изменение» компаний
`-`	Исчерпан выделенный дисковый ресурс
`ERROR_CORE`	Поле `E-mail` содержит некорректный адрес	Поле `E-mail` содержит некорректный адрес

Статусы и коды системных ошибок

HTTP-статус: 20x, 40x, 50x

Описанные ниже ошибки могут возникнуть при вызове любого метода

Статус	Код Текст ошибки	Описание
`500`	`INTERNAL_SERVER_ERROR` Internal server error	Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`500`	`ERROR_UNEXPECTED_ANSWER` Server returned an unexpected response	Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`503`	`QUERY_LIMIT_EXCEEDED` Too many requests	Превышен лимит на интенсивность запросов
`405`	`ERROR_BATCH_METHOD_NOT_ALLOWED` Method is not allowed for batch usage	Текущий метод не разрешен для вызова с помощью batch
`400`	`ERROR_BATCH_LENGTH_EXCEEDED` Max batch length exceeded	Превышена максимальная длина параметров, переданных в метод batch
`401`	`NO_AUTH_FOUND` Wrong authorization data	Неверный access-токен или код вебхука
`400`	`INVALID_REQUEST` Https required	Для вызовов методов требуется использовать протокол HTTPS
`503`	`OVERLOAD_LIMIT` REST API is blocked due to overload	REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка, для снятия необходимо обращаться в техническую поддержку Битрикс24
`403`	`ACCESS_DENIED` REST API is available only on commercial plans	REST API доступен только на коммерческих планах
`403`	`INVALID_CREDENTIALS` Invalid request credentials	У пользователя, с чьим access-токеном или вебхуком был вызван метод, не хватает прав
`404`	`ERROR_MANIFEST_IS_NOT_AVAILABLE` Manifest is not available	Манифест недоступен
`403`	`insufficient_scope` The request requires higher privileges than provided by the webhook token	Запрос требует более высоких привилегий, чем предоставляет токен вебхука
`401`	`expired_token` The access token provided has expired	Предоставленный access-токен доступа истек
`403`	`user_access_error` The user does not have access to the application	Пользователь не имеет доступа к приложению. Это означает, что приложение установлено, но администратор портала разрешил доступ к этому приложению только конкретным пользователям
`500`	`PORTAL_DELETED` Portal was deleted	Публичная часть сайта закрыта. Чтобы открыть публичную часть сайта на коробочной установке отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

Продолжите изучение

Создать новую компанию

Получить информацию о компании

Обновить существующую компанию crm.company.update

Параметры методаПараметры метода

Параметр fieldsПараметр fields

ПримерыПримеры

Обработка ответаОбработка ответа

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

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

Возможные коды ошибокВозможные коды ошибок

Статусы и коды системных ошибокСтатусы и коды системных ошибок

Продолжите изучениеПродолжите изучение