метод REST scope: crm

crm.requisite.link.register

Зарегистрировать связь реквизитов с объектом

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

Описание

Метод регистрирует связь реквизитов с объектом.

Для успешной регистрации идентификаторы реквизитов должны принадлежать клиенту и продавцу, которые выбраны в связываемом объекте. Если какого-то реквизита нет, то его идентификатор передается как 0. Можно даже указать все идентификаторы реквизитов нулевыми. Тогда считается, что к объекту реквизиты не привязаны.

Параметры

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

Набор полей связи реквизита — объект вида {"поле": "значение"[, ...]}

Параметр fields

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

Идентификатор типа объекта, к которому относится связь.

Могут использоваться следующие типы:
- сделка (значение 2)
- старый счет (значение 5)
- предложение (значение 7)
- новый счет (значение 31)
- другие динамические объекты (для получения возможных значений смотрите метод crm.type.list).

Идентификаторы типов объектов CRM можно получить с помощью метода crm.enum.ownertype

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

Идентификатор объекта, к которому относится связь.

Идентификаторы объектов можно получить с помощью следующих методов: crm.deal.list, crm.quote.list, crm.item.list

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

Идентификатор реквизита клиента, выбранного для объекта.

Идентификаторы реквизитов можно получить с помощью метода crm.requisite.list

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

Идентификатор банковского реквизита клиента, выбранного для объекта.

Идентификаторы банковских реквизитов можно получить с помощью метода crm.requisite.bankdetail.list

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

Идентификатор реквизита моей компании, выбранного для объекта.

Идентификаторы реквизитов можно получить с помощью метода crm.requisite.list

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

Идентификатор банковского реквизита моей компании, выбранного для объекта.

Идентификаторы банковских реквизитов можно получить с помощью метода crm.requisite.bankdetail.list

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"ENTITY_TYPE_ID":31,"ENTITY_ID":315,"REQUISITE_ID":60,"BANK_DETAIL_ID":24,"MC_REQUISITE_ID":2,"MC_BANK_DETAIL_ID":2}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.requisite.link.register

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1718729280.575321,
        "finish": 1718729281.296214,
        "duration": 0.720893144607544,
        "processing": 0.1967611312866211,
        "date_start": "2024-06-18T18:48:00+02:00",
        "date_finish": "2024-06-18T18:48:01+02:00",
        "operating": 0.1967298984527588
    }
}

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

result boolean

Результат регистрации связи:
- true — связь зарегистрирована
- false — связь не зарегистрирована

time time

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

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

{
    "error": "",
    "error_description": "Entity is not found"
}
Код Описание Значение
ENTITY_TYPE_ID is not defined or invalid Идентификатор типа объекта не задан или имеет недопустимое значение
ENTITY_ID is not defined or invalid Идентификатор объекта не задан или имеет недопустимое значение
REQUISITE_ID is not defined or invalid Идентификатор реквизита клиента не задан или имеет недопустимое значение
BANK_DETAIL_ID is not defined or invalid Идентификатор банковского реквизита клиента не задан или имеет недопустимое значение
MC_REQUISITE_ID is not defined or invalid Идентификатор реквизита моей компании не задан или имеет недопустимое значение
MC_BANK_DETAIL_ID is not defined or invalid Идентификатор банковского реквизита моей компнаии не задан или имеет недопустимое значение
The Requisite with ID '60' is not found Реквизит клиента с заданным идентификатором не найден
The Requisite with ID '60' is not assigned to Company with ID '5' Реквизит клиента с заданным идентификатором не принадлежит компании, указанной в объекте
The BankDetail with ID '24' is not found Банковский реквизит клиента с заданным идентификатором не найден
The BankDetail with ID '24' is not assigned to Requisite with ID '60' Банковский реквизит клиента с заданным идентификатором не принадлежит указанному реквизиту
The Requisite of your company with ID '2' is not found Реквизит моей компании с заданным идентификатором не найден
The Requisite with ID '2' is not assigned to your company with ID '3010' Реквизит моей компании с заданным идентификатором не принадлежит моей компании, указанной в объекте
The BankDetail of your company with ID '2' is not found Банковский реквизит моей компании с заданным идентификатором не найден
The BankDetail of your company with ID '2' is not assigned to Requisite of your company with ID '2' Банковский реквизит моей компании с заданным идентификатором не принадлежит указанному реквизиту

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

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