crm.entity.mergeBatch

Объединение дубликатов

crm.entity.mergeBatch({params: {entityTypeId: number, entityIds: number[]}})

params - ассоциативный массив, содержащий ключи:

Ключ	Описание
entityTypeId	идентификатор типа сущности. Может принимать значения 1 (лид), 2 (сделка), 3 (контакт) или 4 (компания)
entityIds	массив идентификаторов элементов, которые необходимо объединить

Метод вернет ассоциативный массив вида:

{
	"STATUS": "SUCCESS",
	"ENTITY_IDS": [
		"1" 
	]
}

Здесь:

Параметр	Описание
STATUS	может принимать значения: SUCCESS - объединение прошло успешно. CONFLICT - при объединении возник конфликт. ERROR - при объединении произошла ошибка. Например, если у текущего пользователя нет прав на изменение или удаление записей.
ENTITY_IDS	содержит идентификаторы элементов, которые были объединены, кроме идентификатора элемента, оставшегося после объединения.

Пример вызова:

BX24.callMethod(
	'crm.entity.mergeBatch',
	{
		params: {
			entityTypeId: 3,
			entityIds: [1, 2, 3],
		}
	},
	(result) => {
		console.log(result);
	}
);

Ручное объединение для случаев, когда возник конфликт

Для продолжения объединения вручную, в привычном пользователю интерфейсе Битиркс24, достаточно перенаправить его в раздел ручного объединения по соответствующей ссылке:

• Контакты: /crm/contact/merge/?id=1,2,3
• Компании: /crm/company/merge/?id=1,2,3
• Лиды: /crm/lead/merge/?id=1,2,3
• Сделки: /crm/deal/merge/?id=1,2,3

где параметр id содержит указанные через запятую идентификаторы объединяемых записей.