метод REST scope: crm

crm.orderentity.add

Добавить привязку заказа к объекту CRM

Кто может выполнять: администратор интернет-магазина

Описание

Метод добавляет привязку заказа к объекту CRM.

Параметры

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

Значения полей для создания привязки

Параметр fields

orderId sale_order.id обязательный

Идентификатор заказа

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

Идентификатор типа объекта CRM.

Привязка возможна только к сделке или счету

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

Идентификатор объекта CRM.

Для сделок может быть получен методом crm.deal.list.

Для счетов может быть получен методом crm.invoice.list

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"orderId":5125,"ownerId":6933,"ownerTypeId":2}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.orderentity.add

Ответ

HTTP-статус: 200

{
    "result": {
        "dealOrder": {
            "orderId": 5125,
            "ownerId": 6933,
            "ownerTypeId": 2
        }
    },
    "time": {
        "start": 1719325851.568441,
        "finish": 1719325852.546479,
        "duration": 0.9780380725860596,
        "processing": 0.32780981063842773,
        "date_start": "2024-06-25T16:30:51+02:00",
        "date_finish": "2024-06-25T16:30:52+02:00",
        "operating": 0
    }
}

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

result object

Корневой элемент ответа

dealOrder crm_orderentity

Объект с информацией о созданной привязке

time time

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

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

HTTP-статус: 400

{
    "error": "201650000001",
    "error_description": "Duplicate entry for key [ownerId, ownerTypeId, orderId]"
}

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

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