Документация для разработчиков
Темная тема

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
Надежда Каракулина
Сообщение не промодерировано, возможны ошибки и неточности.
При использовании вебхука, необходимо использовать следующий формат ввода .../crm.lead.update.json?ID=504652&FIELDS[COMPANY_ID]=179&FIELDS[CONTACT_ID]=109200
1
Надежда Каракулина
Сообщение не промодерировано, возможны ошибки и неточности.
При использовании вебхука, необходимо использовать следующий формат ввода .../crm.lead.update.json?ID=504652&FIELDS[COMPANY_ID]=179&FIELDS[CONTACT_ID]=109200
3
Денис Черечукин
Сообщение не промодерировано, возможны ошибки и неточности.
Для очистки пользовательского поля типа "Файл" и удаления загруженного файла нужно передать id файла и remove=Y:
Код
BX24.callMethod(
   "crm.lead.update", 
   { 
      id: id,
      fields:
      { 
         "UF_CRM_1111111111111":
         {
            "id":444444,
            "remove":"Y"
         }
      }   
   }
);
0
Руслан Попадюк
Цитата
Михаил Носов пишет:
При использовании этого метода с множественными полями (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
Сергей Востриков
Перед обновлением дергать методы а-ля crm.*.get и получать ID значений множественных полей. Указываете их в update и происходит именно обновление, а не добавление
6
Михаил Носов
При использовании этого метода с множественными полями (PHONE, EMAIL, WEB), происходит добавление значений, а не изменение. По сути все значения поля WEB должны замениться на новые или даже удалиться, если WEB передан как пустое значение, ну или не меняться, если поле WEB не передано в параметрах fields.
На то оно и UPDATE а не ADD.

Как решается эта проблема? Как перезаписывать или удалять старые значения указанных полей?
© «Битрикс», 2001-2024, «1С-Битрикс», 2024