Для AI-агентов: markdown этой страницы — /docs-content/entities/catalog-price-types/create.md индекс документации — /llms.txt

Создать тип цены

POST /v1/catalog-price-types

Создаёт тип цены торгового каталога, который используется для отдельных цен товаров на портале. Тело запроса плоское, без обёртки fields.

Поля запроса (body)

Поле Тип Обяз. Описание
Полеname Типstring Обяз.да ОписаниеНазвание типа цены.
Полеsort Типnumber Обяз.нет ОписаниеПорядок сортировки в интерфейсе Битрикс24.
ПолеxmlId Типstring | null Обяз.нет ОписаниеВнешний идентификатор для интеграций импорта и выгрузки.
Полеid Типnumber Обяз.нет ОписаниеRO. Идентификатор типа цены. Список: Список типов цен.
Полеbase Типstring Обяз.нет ОписаниеRO. Признак базового типа цены, заполняется системой.
ПолеcreatedBy Типnumber | null Обяз.нет ОписаниеRO. Идентификатор создавшего пользователя. Список: Список пользователей.
ПолеmodifiedBy Типnumber | null Обяз.нет ОписаниеRO. Идентификатор последнего изменившего пользователя. Список: Список пользователей.
ПолеdateCreate Типstring | null Обяз.нет ОписаниеRO. Дата и время создания в формате ISO 8601.
ПолеtimestampX Типstring | null Обяз.нет ОписаниеRO. Дата и время последнего изменения в формате ISO 8601.

Поля с меткой RO доступны только для чтения. Не передавайте их в теле запроса.

Примеры

curl — личный ключ

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/catalog-price-types" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Wholesale", "sort": 200, "xmlId": "WHOLESALE"}'

curl — OAuth-приложение

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/catalog-price-types" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Wholesale", "sort": 200, "xmlId": "WHOLESALE"}'

JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-price-types', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"name": "Wholesale", "sort": 200, "xmlId": "WHOLESALE"}),
})

const { success, data } = await res.json()
console.log('ID:', data.id)

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-price-types', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"name": "Wholesale", "sort": 200, "xmlId": "WHOLESALE"}),
})

const { success, data } = await res.json()
console.log('ID:', data.id)

Поля ответа

Ответ приходит со статусом 201 и содержит созданный тип цены целиком.

Поле Тип Описание
Полеsuccess Типboolean ОписаниеВсегда true при успехе.
Полеdata Типobject ОписаниеОбъект типа цены.
Полеdata.id Типnumber ОписаниеRO. Идентификатор типа цены. Список: Список типов цен. Это значение передаётся в catalogGroupId при работе с ценами каталога.
Полеdata.name Типstring ОписаниеНазвание типа цены.
Полеdata.base Типstring ОписаниеRO. Y — базовый тип цены портала, N — другой тип.
Полеdata.xmlId Типstring | null ОписаниеВнешний идентификатор для интеграций.
Полеdata.sort Типnumber ОписаниеПорядок сортировки в интерфейсе Битрикс24.
Полеdata.createdBy Типnumber | null ОписаниеRO. Идентификатор создавшего пользователя. Список: Список пользователей.
Полеdata.modifiedBy Типnumber | null ОписаниеRO. Идентификатор последнего изменившего пользователя. Список: Список пользователей.
Полеdata.dateCreate Типstring | null ОписаниеRO. Дата и время создания в формате ISO 8601.
Полеdata.timestampX Типstring | null ОписаниеRO. Дата и время последнего изменения в формате ISO 8601.

Пример ответа

JSON 
{
  "success": true,
  "data": {
    "base": "N",
    "createdBy": 1295,
    "dateCreate": "2026-10-14T17:18:58.000Z",
    "id": 19,
    "modifiedBy": 1295,
    "name": "Wholesale",
    "sort": 200,
    "timestampX": "2026-10-14T17:18:58.000Z",
    "xmlId": "WHOLESALE"
  }
}

Пример ответа при ошибке

400 — не передан name, тип цены не создан:

JSON 
{
  "success": false,
  "error": {
    "code": "MISSING_REQUIRED_FIELDS",
    "message": "Body field \"name\" is required to create catalogPriceType."
  }
}

Ошибки

HTTP Код Описание
HTTP400 КодMISSING_REQUIRED_FIELDS ОписаниеНе передан name, либо его значение равно null или пустой строке.
HTTP400 КодREADONLY_FIELD ОписаниеВ теле передано поле с меткой RO. Уберите его из запроса.
HTTP400 КодINVALID_PARAMS ОписаниеВ строковом или числовом поле передан объект или массив.
HTTP400 КодINVALID_PARAMS ОписаниеБитрикс24 отклонил параметры запроса.
HTTP422 КодBITRIX_ERROR ОписаниеБитрикс24 отклонил запрос. Причина — в error.message.
HTTP403 КодBITRIX_ACCESS_DENIED ОписаниеУ пользователя нет права Битрикс24 «Управление типами цен».
HTTP403 КодWRITE_BLOCKED_READONLY_KEY ОписаниеКлюч работает в режиме только для чтения.
HTTP403 КодSCOPE_DENIED ОписаниеУ ключа нет скоупа catalog.
HTTP401 КодMISSING_API_KEY ОписаниеНе передан заголовок X-Api-Key.
HTTP401 КодTOKEN_MISSING ОписаниеУ ключа нет настроенных токенов Битрикс24. Для ключа OAuth-приложения проверьте пользовательскую сессию.

Полный список общих ошибок API — Ошибки.

Известные особенности

При создании группы просмотра и покупки получают значения [1, 2] — администраторы и все пользователи. Управлять этими группами через метод нельзя.

Смотрите также