метод REST scope: crm Устаревший

crm.quote.add

Добавить коммерческое предложение

Устаревший метод. Развитие метода остановлено. Используйте crm.item.add.

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

Описание

Метод crm.quote.add создает коммерческое предложение.

Если в предложении нужно явно указать реквизиты покупателя и продавца, используйте метод crm.requisite.link.register.

Параметры

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

Объект с полями коммерческого предложения формата:

{
    "field_1": "value_1",
    "field_2": "value_2",
    "...": "..."
}

где:
- field_n — название поля
- value_n — значение поля

Список обязательных и основных полей — ниже.

Полный список доступных полей и их типов можно получить методом crm.quote.fields

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

Объект дополнительных параметров (подробное описание)

Параметр fields

TITLE string обязательный

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

Ограничение длины — до 255 символов.

Если передать значение длиннее 255, система обрежет его до 255 символов

STATUS_ID crm_status необязательный

Стадия предложения

Передавайте значение явно в каждом запросе.

Список доступных стадий можно получить методом crm.status.list с фильтром ENTITY_ID = QUOTE_STATUS

CURRENCY_ID crm_currency необязательный

Валюта суммы предложения

OPPORTUNITY double необязательный

Сумма предложения

Передавайте числовое значение в паре с CURRENCY_ID

ASSIGNED_BY_ID user необязательный

Идентификатор ответственного

COMPANY_ID crm_company необязательный

Идентификатор компании-клиента

CONTACT_IDS crm_contact[] необязательный

Массив идентификаторов контактов клиента

MYCOMPANY_ID crm_company необязательный

Идентификатор «вашей компании» для реквизитов продавца

OPENED char необязательный

Доступно ли предложение для всех. Возможные значения:
- Y — да
- N — нет

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

Идентификатор типа плательщика

BEGINDATE date необязательный

Дата выставления

CLOSEDATE date необязательный

Срок действия предложения

CLIENT_TITLE string необязательный

Название клиента, до 255 символов

CLIENT_ADDR string необязательный

Адрес клиента, до 255 символов

CLIENT_EMAIL string необязательный

Email клиента, до 255 символов

CLIENT_PHONE string необязательный

Телефон клиента, до 255 символов

COMMENTS string необязательный

Комментарий

Параметр params

IMPORT boolean необязательный

Режим импорта. Возможные значения:
- Y — да
- N — нет

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"TITLE":"КП на поставку мебели","STATUS_ID":"DRAFT","OPENED":"Y","ASSIGNED_BY_ID":1,"CURRENCY_ID":"RUB","OPPORTUNITY":150000,"COMPANY_ID":1,"MYCOMPANY_ID":3,"COMMENTS":"Подготовлено по запросу клиента","BEGINDATE":"2026-03-13T10:00:00+03:00","CLOSEDATE":"2026-03-20T18:00:00+03:00"},"params":{"IMPORT":"N"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.quote.add

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"TITLE":"КП на поставку мебели","STATUS_ID":"DRAFT","OPENED":"Y","ASSIGNED_BY_ID":1,"CURRENCY_ID":"RUB","OPPORTUNITY":150000,"COMPANY_ID":1,"MYCOMPANY_ID":3,"COMMENTS":"Подготовлено по запросу клиента","BEGINDATE":"2026-03-13T10:00:00+03:00","CLOSEDATE":"2026-03-20T18:00:00+03:00"},"params":{"IMPORT":"N"},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.quote.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<number>({
    method: 'crm.quote.add',
    params: {
      fields: {
        TITLE: 'Furniture supply quote',
        STATUS_ID: 'DRAFT',
        OPENED: 'Y',
        ASSIGNED_BY_ID: 1,
        CURRENCY_ID: 'RUB',
        OPPORTUNITY: 150000,
        COMPANY_ID: 1,
        MYCOMPANY_ID: 3,
        COMMENTS: 'Prepared at client request',
        BEGINDATE: '2026-03-13T10:00:00+03:00',
        CLOSEDATE: '2026-03-20T18:00:00+03:00',
      },
      params: {
        IMPORT: 'N',
      },
    },
    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('Created quote ID:', 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 createQuote() {
    try {
      // Initialize the SDK inside a Bitrix24 frame
      const $b24 = await B24Js.initializeB24Frame()

      const response = await $b24.actions.v2.call.make({
        method: 'crm.quote.add',
        params: {
          fields: {
            TITLE: 'Furniture supply quote',
            STATUS_ID: 'DRAFT',
            OPENED: 'Y',
            ASSIGNED_BY_ID: 1,
            CURRENCY_ID: 'RUB',
            OPPORTUNITY: 150000,
            COMPANY_ID: 1,
            MYCOMPANY_ID: 3,
            COMMENTS: 'Prepared at client request',
            BEGINDATE: '2026-03-13T10:00:00+03:00',
            CLOSEDATE: '2026-03-20T18:00:00+03:00',
          },
          params: {
            IMPORT: 'N',
          },
        },
        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('Created quote ID:', result)
    } catch (error) {
      // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
      console.error(error)
    }
  }

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

try {
    $response = $b24Service
        ->core
        ->call(
            'crm.quote.add',
            [
                'fields' => [
                    'TITLE' => 'КП на поставку мебели',
                    'STATUS_ID' => 'DRAFT',
                    'OPENED' => 'Y',
                    'ASSIGNED_BY_ID' => 1,
                    'CURRENCY_ID' => 'RUB',
                    'OPPORTUNITY' => 150000,
                    'COMPANY_ID' => 1,
                    'MYCOMPANY_ID' => 3,
                    'COMMENTS' => 'Подготовлено по запросу клиента',
                    'BEGINDATE' => '2026-03-13T10:00:00+03:00',
                    'CLOSEDATE' => '2026-03-20T18:00:00+03:00',
                ],
                'params' => [
                    'IMPORT' => 'N',
                ],
            ]
        );

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

    echo 'Created quote ID: ' . $result;

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

BX24.callMethod(
    'crm.quote.add',
    {
        fields: {
            TITLE: 'КП на поставку мебели',
            STATUS_ID: 'DRAFT',
            OPENED: 'Y',
            ASSIGNED_BY_ID: 1,
            CURRENCY_ID: 'RUB',
            OPPORTUNITY: 150000,
            COMPANY_ID: 1,
            MYCOMPANY_ID: 3,
            COMMENTS: 'Подготовлено по запросу клиента',
            BEGINDATE: '2026-03-13T10:00:00+03:00',
            CLOSEDATE: '2026-03-20T18:00:00+03:00',
        },
        params: {
            IMPORT: 'N',
        },
    },
    (result) => {
        result.error()
            ? console.error(result.error())
            : console.info(result.data())
        ;
    },
);

require_once('crest.php');

$result = CRest::call(
    'crm.quote.add',
    [
        'fields' => [
            'TITLE' => 'КП на поставку мебели',
            'STATUS_ID' => 'DRAFT',
            'OPENED' => 'Y',
            'ASSIGNED_BY_ID' => 1,
            'CURRENCY_ID' => 'RUB',
            'OPPORTUNITY' => 150000,
            'COMPANY_ID' => 1,
            'MYCOMPANY_ID' => 3,
            'COMMENTS' => 'Подготовлено по запросу клиента',
            'BEGINDATE' => '2026-03-13T10:00:00+03:00',
            'CLOSEDATE' => '2026-03-20T18:00:00+03:00',
        ],
        'params' => [
            'IMPORT' => 'N',
        ],
    ]
);

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

// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "crm.quote.add", b24.Params{
	"fields": b24.Params{
		"TITLE":          "КП на поставку мебели",
		"STATUS_ID":      "DRAFT",
		"OPENED":         "Y",
		"ASSIGNED_BY_ID": 1,
		"CURRENCY_ID":    "RUB",
		"OPPORTUNITY":    150000,
		"COMPANY_ID":     1,
		"MYCOMPANY_ID":   3,
		"COMMENTS":       "Подготовлено по запросу клиента",
		"BEGINDATE":      "2026-03-13T10:00:00+03:00",
		"CLOSEDATE":      "2026-03-20T18:00:00+03:00",
	},
	"params": b24.Params{
		"IMPORT": "N",
	},
})
if err != nil {
	return fmt.Errorf("crm.quote.add: %w", err)
}

var newID b24.ID
if err := json.Unmarshal(res.Result, &newID); err != nil {
	return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("идентификатор:", newID)

Ответ

HTTP-статус: 200

{
    "result": 43,
    "time": {
        "start": 1773396937,
        "finish": 1773396937.557957,
        "duration": 0.5579569339752197,
        "processing": 0,
        "date_start": "2026-03-13T13:15:37+03:00",
        "date_finish": "2026-03-13T13:15:37+03:00",
        "operating_reset_at": 1773397537,
        "operating": 0.5224320888519287
    }
}

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

result integer

Корневой элемент ответа. Содержит идентификатор созданного коммерческого предложения

time time

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

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

HTTP-статус: 400

{
    "error": "",
    "error_description": "Parameter 'fields' must be array."
}

Код	Описание	Значение
—	`Parameter 'fields' must be array.`	В `fields` передан не объект
—	`Parameter 'params' must be array.`	В `params` передан не объект
—	`Access denied.`	У пользователя нет прав на добавление коммерческих предложений

Описание

Параметры

Параметр fields

Параметр params

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

Ответ

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

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

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