crm.lead.update

Scope: crm Права на выполнение: для всех

crm.lead.update(id, fields, params)

Обновляет существующий лид.

Важно! Настоятельно рекомендуется при обновлении адреса передавать полный набор полей адреса в метод обновления. Особенности обновления полей адреса описаны здесь.

Параметры

Параметр	Описание
id	Идентификатор лида.
fields	Набор полей - массив вида array("обновляемое поле"=>"значение"[, ...]), где "обновляемое поле" может принимать значения из возвращаемых методом crm.lead.fields. Примечание: чтобы узнать требуемый формат полей, выполните метод crm.lead.fields и посмотрите формат пришедших значений этих полей.
params	Набор параметров. REGISTER_SONET_EVENT - произвести регистрацию события изменения лида в живой ленте. Дополнительно будет отправлено уведомление ответственному за лид.

Пример

var id = prompt("Введите ID");
BX24.callMethod(
	"crm.lead.update", 
	{ 
		id: id,
		fields:
		{ 
			"STATUS_ID": "IN_PROCESS",
			"CURRENCY_ID": "USD", 
			"OPPORTUNITY": 15500
		},
		params: { "REGISTER_SONET_EVENT": "Y" }
	}, 
	function(result) 
	{
		if(result.error())
			console.error(result.error());
		else
		{
			console.info(result.data());
		}
	}
);

Дополнительно

Как обновить поле с типом "бронирование ресурсов"

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

1 Надежда Каракулина 04.03.2024 19:17:41 Сообщение не промодерировано, возможны ошибки и неточности.
При использовании вебхука, необходимо использовать следующий формат ввода .../crm.lead.update.json?ID=504652&FIELDS[COMPANY_ID]=179&FIELDS[CONTACT_ID]=109200

1 Надежда Каракулина 04.03.2024 19:17:18 Сообщение не промодерировано, возможны ошибки и неточности.
При использовании вебхука, необходимо использовать следующий формат ввода .../crm.lead.update.json?ID=504652&FIELDS[COMPANY_ID]=179&FIELDS[CONTACT_ID]=109200 Безымянный1.bmp (890.09 КБ)

Денис Черечукин 28.11.2022 16:09:24

Сообщение не промодерировано, возможны ошибки и неточности.

Для очистки пользовательского поля типа "Файл" и удаления загруженного файла нужно передать id файла и remove=Y:

Код
BX24.callMethod( "crm.lead.update", { id: id, fields: { "UF_CRM_1111111111111": { "id":444444, "remove":"Y" } } } );

Руслан Попадюк 31.07.2021 16:45:50

Цитата

Михаил Носов пишет:
При использовании этого метода с множественными полями (PHONE, EMAIL, WEB), происходит добавление значений, а не изменение. По сути все значения поля WEB должны замениться на новые или даже удалиться, если WEB передан как пустое значение, ну или не меняться, если поле WEB не передано в параметрах fields.
На то оно и UPDATE а не ADD.

Как решается эта проблема? Как перезаписывать или удалять старые значения указанных полей?

Здесь https://dev.1c-bitrix.ru/rest_help/crm/cases/edit/how_to_change_email_or_phone.php детально описано как решить даную проблему

4 Сергей Востриков 22.10.2018 17:58:33
Перед обновлением дергать методы а-ля crm.*.get и получать ID значений множественных полей. Указываете их в update и происходит именно обновление, а не добавление

6 Михаил Носов 08.01.2016 11:05:12
При использовании этого метода с множественными полями (PHONE, EMAIL, WEB), происходит добавление значений, а не изменение. По сути все значения поля WEB должны замениться на новые или даже удалиться, если WEB передан как пустое значение, ну или не меняться, если поле WEB не передано в параметрах fields. На то оно и UPDATE а не ADD. Как решается эта проблема? Как перезаписывать или удалять старые значения указанных полей?