Documentation

crm.entity.mergeBatch

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)
entityIdsarray 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_IDScontains 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 merged entries.





© «Bitrix24», 2001-2022
Up