crm.entity.mergeBatch

Scope: catalog Permissions to execute: for all

Merging duplicates

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

params - associative array containing the following keys:

Ключ	Описание
entityTypeId	entity type ID. Can receive the values `1` (lead), `2` (deal), `3` (contact) или `4` (company)
entityIds	array with element IDs to be merged

Method returns an associative array:

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

Here:

Parameter	Description
STATUS	can receive the values: `SUCCESS` - merge is successful. `CONFLICT` - merge conflict. `ERROR` - merge error. For example, when current user doesn't have access permissions for editing or deleting records.
ENTITY_IDS	contains element IDs that were merged, expect for the element ID, remaining after merging.

Example:

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

Manual merging during conflicts

To continue merging manually you only need to forward the merging into manual merging section via the following link in the standard Bitrix24 interface:

Contacts: /crm/contact/merge/?id=1,2,3
Companies: /crm/company/merge/?id=1,2,3
Leads: /crm/lead/merge/?id=1,2,3
Deals: /crm/deal/merge/?id=1,2,3

where parameter id contains comma-separated identifiers of entries being manually merged.