метод REST scope: crm

crm.entity.mergeBatch

Объединить дубликаты

Кто может выполнять: пользователь с правом на изменение главного элемента и правом на удаление остальных объединяемых элементов

Описание

Метод crm.entity.mergeBatch объединяет несколько элементов в один.

Параметры

params object обязательный

Объект с элементами для объединения (подробное описание)

Параметр params

entityTypeId integer обязательный

Идентификатор типа объекта CRM. Возможные значения:
- 1лид
- 2сделка
- 3контакт
- 4компания
- 7предложение
- 31счет
- 128смарт-процесс. Идентификатор конкретного смарт-процесса можно узнать методами crm.enum.ownertype и crm.type.list

entityIds integer[] обязательный

Массив идентификаторов элементов, которые необходимо объединить. Минимум два элемента

Примеры запроса

curl -X POST \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{"params":{"entityTypeId":3,"entityIds":[100,101,102]}}' \
     https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.entity.mergeBatch

Ответ

HTTP-статус: 200

{
    "result": {
        "STATUS": "SUCCESS",
        "ENTITY_IDS": [101, 102]
    },
    "time": {
        "start": 1750754639.300838,
        "finish": 1750754641.350269,
        "duration": 2.049431085586548,
        "processing": 2.0271031856536865,
        "date_start": "2025-06-24T11:43:59+03:00",
        "date_finish": "2025-06-24T11:44:01+03:00",
        "operating_reset_at": 1750755239,
        "operating": 0
    }
}

Возвращаемые данные

STATUS string

Статус выполнения операции. Возможные значения:
- SUCCESS — объединение прошло успешно
- CONFLICT — возник конфликт данных, автоматическое объединение невозможно
- ERROR — произошла ошибка

ENTITY_IDS integer[]

Массив идентификаторов элементов, которые были удалены при объединении

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": 0,
    "error_description": "The parameter entityIds must contains at least two elements."
}
Код Описание Значение
403 Access denied У пользователя нет прав на изменение или удаление элементов CRM
400 The parameter entityTypeId is required. Не указан обязательный параметр entityTypeId
400 The parameter entityIds does not contains valid elements. Не переданы или не найдены элементы для объединения
400 The parameter entityIds must contains at least two elements. Для объединения требуется минимум два элемента
400 Owner was not found Объект не найден
400 Entity type {entityTypeName} is not supported Указан неподдерживаемый тип объекта
400 CRM_FEATURE_RESTRICTION_ERROR Ограничение тарифа

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.