Добавить контакт к предложению crm.quote.contact.add

Выберите инструмент для разработки с AI-агентом:

используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: crm

Кто может выполнять метод: пользователь с правом «изменения» коммерческих предложений

Метод crm.quote.contact.add добавляет контакт к указанному коммерческому предложению.

Параметры метода

Обязательные параметры отмечены *

Название
тип

Описание

id*
integer

Идентификатор коммерческого предложения

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

fields*
object

Объект с информацией о том, какой контакт нужно привязать к предложению (подробное описание)

Параметр fields

Обязательные параметры отмечены *

Название `тип`	Описание
CONTACT_ID* `crm_entity`	Идентификатор контакта, который будет привязан к предложению Идентификатор можно получить с помощью методов crm.contact.list или crm.contact.add
IS_PRIMARY `char`	Является ли привязка первичной. Возможные значения: `Y` — да `N` — нет Если у предложения еще нет первичной привязки, добавляемая станет первичной независимо от переданного значения. Если первичная привязка уже есть и передать `Y`, первичной станет добавляемая, а прежняя получит `N`
SORT `integer`	Индекс сортировки По умолчанию — максимальный `SORT` среди уже привязанных контактов плюс 10. У первой привязки предложения `SORT = 10`

Идентификатор первичного контакта попадает в поле предложения CONTACT_ID и возвращается методом crm.quote.get.

Метод не проверяет, существует ли контакт. Если передать идентификатор несуществующего контакта, привязка будет создана, а сам идентификатор попадет в поле предложения CONTACT_ID

Примеры кода

Как использовать примеры в документации

Пример добавления связи предложение-контакт, где:

идентификатор предложения — 113
идентификатор контакта — 2647

cURL (Webhook)

cURL (OAuth)

JS (TS)

JS (UMD)

PHP

BX24.js

PHP CRest

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":113,"fields":{"CONTACT_ID":2647,"IS_PRIMARY":"Y","SORT":10}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.quote.contact.add

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":113,"fields":{"CONTACT_ID":2647,"IS_PRIMARY":"Y","SORT":10},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.quote.contact.add

// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

try {
  const response = await $b24.actions.v2.call.make<boolean>({
    method: 'crm.quote.contact.add',
    params: {
      id: 113,
      fields: {
        CONTACT_ID: 2647,
        IS_PRIMARY: 'Y',
        SORT: 10,
      },
    },
    requestId: Text.getUuidRfc4122()
  })

  // The payload is available only on a successful response
  if (!response.isSuccess) {
    console.error(response.getErrorMessages().join('; '))
  } else {
    const result = response.getData()!.result
    console.info('Contact linked to quote:', result)
  }
} catch (error) {
  // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
  console.error(error)
}

<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  async function addQuoteContact() {
    try {
      // Initialize the SDK inside a Bitrix24 frame
      const $b24 = await B24Js.initializeB24Frame()

      const response = await $b24.actions.v2.call.make({
        method: 'crm.quote.contact.add',
        params: {
          id: 113,
          fields: {
            CONTACT_ID: 2647,
            IS_PRIMARY: 'Y',
            SORT: 10,
          },
        },
        requestId: B24Js.Text.getUuidRfc4122()
      })

      // The payload is available only on a successful response
      if (!response.isSuccess) {
        console.error(response.getErrorMessages().join('; '))
        return
      }

      const result = response.getData().result
      console.info('Contact linked to quote:', result)
    } catch (error) {
      // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
      console.error(error)
    }
  }

  document.addEventListener('DOMContentLoaded', addQuoteContact)
</script>

try {
    $response = $b24Service
        ->core
        ->call(
            'crm.quote.contact.add',
            [
                'id' => 113,
                'fields' => [
                    'CONTACT_ID' => 2647,
                    'IS_PRIMARY' => 'Y',
                    'SORT' => 10,
                ],
            ]
        );

    $result = $response
        ->getResponseData()
        ->getResult();

    echo 'Linked: ' . ($result ? 'true' : 'false');

} catch (Throwable $e) {
    error_log($e->getMessage());
    echo 'Error adding quote contact: ' . $e->getMessage();
}

BX24.callMethod(
    'crm.quote.contact.add',
    {
        id: 113,
        fields: {
            CONTACT_ID: 2647,
            IS_PRIMARY: 'Y',
            SORT: 10,
        },
    },
    (result) => {
        result.error()
            ? console.error(result.error())
            : console.info(result.data())
        ;
    },
);

require_once('crest.php');

$result = CRest::call(
    'crm.quote.contact.add',
    [
        'id' => 113,
        'fields' => [
            'CONTACT_ID' => 2647,
            'IS_PRIMARY' => 'Y',
            'SORT' => 10,
        ],
    ]
);

echo '<PRE>';
print_r($result);
echo '</PRE>';

// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "crm.quote.contact.add", b24.Params{
	"id": 113,
	"fields": b24.Params{
		"CONTACT_ID": 2647,
		"IS_PRIMARY": "Y",
		"SORT":       10,
	},
})
if err != nil {
	return fmt.Errorf("crm.quote.contact.add: %w", err)
}

var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
	return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)

Обработка ответа

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1787206092,
        "finish": 1787206092.837103,
        "duration": 0.8371028900146484,
        "processing": 0,
        "date_start": "2026-08-20T09:08:12+03:00",
        "date_finish": "2026-08-20T09:08:12+03:00",
        "operating_reset_at": 1787206692,
        "operating": 0
    }
}

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

Название
тип

Описание

result
boolean

Корневой элемент ответа. Содержит:

true — связь добавлена
false — связь не добавлена, контакт уже связан с предложением

time
time

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

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

HTTP-статус: 400

{
    "error": "",
    "error_description": "Not found."
}

Название `тип`	Описание
error `string`	Строковый код ошибки. Может состоять из цифр, латинских букв и знака подчеркивания
error_description `error_description`	Текстовое описание ошибки. Описание не предназначено для показа конечному пользователю в необработанном виде

Возможные коды ошибок

Код	Описание	Значение
Пустое значение	`The parameter 'ownerEntityID' is invalid or not defined.`	Передан `id` меньше 1 или не передан вовсе
Пустое значение	`The parameter 'fields' must be array.`	В `fields` передан не объект
Пустое значение	`The parameter 'fields' is not valid.`	Может возникать из-за нескольких причин: если не передан обязательный параметр `fields.CONTACT_ID` если переданный параметр `fields.CONTACT_ID` меньше или равен 0
Пустое значение	`Not found.`	Предложение с переданным `id` не найдено
Пустое значение	`[Контакт #2647] У Вас нет прав на просмотр этого элемента`	У пользователя нет прав на чтение контакта, который он привязывает
`ACCESS_DENIED`	`Access denied!`	Нет прав на изменение коммерческого предложения. Ответ приходит с HTTP-статусом `403`

Статусы и коды системных ошибок

HTTP-статус: 20x, 40x, 50x

Описанные ниже ошибки могут возникнуть при вызове любого метода

Статус	Код Текст ошибки	Описание
`500`	`INTERNAL_SERVER_ERROR` Internal server error	Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`500`	`ERROR_UNEXPECTED_ANSWER` Server returned an unexpected response	Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`503`	`QUERY_LIMIT_EXCEEDED` Too many requests	Превышен лимит на интенсивность запросов
`429`	`OPERATION_TIME_LIMIT` Method is blocked due to operation time limit	Метод заблокирован из-за превышения лимита на ресурсоемкость запросов. Блокировка снимается автоматически через 10 минут
`405`	`ERROR_BATCH_METHOD_NOT_ALLOWED` Method is not allowed for batch usage	Текущий метод не разрешен для вызова с помощью batch
`400`	`ERROR_BATCH_LENGTH_EXCEEDED` Max batch length exceeded	Превышена максимальная длина параметров, переданных в метод batch
`401`	`NO_AUTH_FOUND` Wrong authorization data	Неверный access-токен или код вебхука
`400`	`INVALID_REQUEST` Https required	Для вызовов методов требуется использовать протокол HTTPS
`503`	`OVERLOAD_LIMIT` REST API is blocked due to overload	REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка, для снятия необходимо обращаться в техническую поддержку Битрикс24
`403`	`ACCESS_DENIED` REST API is available only on commercial plans	REST API доступен только на коммерческих планах
`403`	`INVALID_CREDENTIALS` Invalid request credentials	У пользователя, с чьим access-токеном или вебхуком был вызван метод, не хватает прав
`404`	`ERROR_MANIFEST_IS_NOT_AVAILABLE` Manifest is not available	Манифест недоступен
`403`	`insufficient_scope` The request requires higher privileges than provided by the webhook token	Запрос требует более высоких привилегий, чем предоставляет токен вебхука
`401`	`expired_token` The access token provided has expired	Предоставленный access-токен доступа истек
`403`	`user_access_error` The user does not have access to the application	Пользователь не имеет доступа к приложению. Это означает, что приложение установлено, но администратор портала разрешил доступ к этому приложению только конкретным пользователям
`500`	`PORTAL_DELETED` Portal was deleted	Публичная часть сайта закрыта. Чтобы открыть публичную часть сайта на коробочной установке отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

Продолжите изучение

Была ли статья полезна?

Обзор методов

Удалить контакт

Добавить контакт к предложению crm.quote.contact.add

Параметры методаПараметры метода

Параметр fieldsПараметр fields

Примеры кодаПримеры кода

Обработка ответаОбработка ответа

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

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

Возможные коды ошибокВозможные коды ошибок

Статусы и коды системных ошибокСтатусы и коды системных ошибок

Продолжите изучениеПродолжите изучение