crm.deal.update

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

Описание

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

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

Параметры

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

Пример

var id = prompt("Введите ID");
BX24.callMethod(
	"crm.deal.update",
	{
		id: id,
		fields:
		{
			"STAGE_ID": "NEGOTIATION",
			"PROBABILITY": 70
		},
		params: { "REGISTER_SONET_EVENT": "Y" }
	},
	function(result) 
	{
		if(result.error())
			console.error(result.error());
		else
		{
			console.info(result.data());
		}
	}
);

Как через веб хук загрузить файл в сделку (PHP)

$batchUpdate = array (
	'update_contact' => 'crm.deal.update?'.http_build_query(
		array(
			'id'=> $dealId,
			'fields'=> array(
				'fileData'=>array(
					$files['files']['name'], base64_encode(file_get_contents($files['files']['tmp_name'])),
				)
			),
		)
	)
)

$resultUpdate = executeHook(array('cmd' => $batchUpdate)); // выполняем хук

Пояснения к методу

Для управления контактами сделки рекомендуется использовать множественное поле CONTACT_IDS:

Пример

BX24.callMethod("crm.deal.update", { id: 1, fields: { "CONTACT_IDS": [ 1, 2, 3 ] } });

В результате сделка будет связана с тремя указанными контактами.

Поле CONTACT_ID является устаревшим и поддерживается для обеспечения обратной совместимости.

Пример

BX24.callMethod("crm.deal.update", { id: 1, fields: { "CONTACT_ID": 4 } });

В результате этого вызова в сделку будет добавлена связь с указанным контактом.

Пожалуйста, обратите внимание, что уже существующие связи связи с контактами при этом удалены не будут. То есть если сделка до этого была связана с контактами 1, 2 и 3, то в результате она будет связана с контактами 1, 2, 3 и 4.