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

crm.entity.mergeBatch

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

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


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 содержит указанные через запятую идентификаторы объединяемых записей.





© «Битрикс», 2001-2024, «1С-Битрикс», 2024