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

Типы цен каталога

Типы цен портала: список, получение, создание, изменение и удаление. Тип цены — это то, что цены каталога передают в поле catalogGroupId. Для записи Битрикс24 требует право «Управление типами цен».

Битрикс24 API: catalog.priceType.* Скоуп: catalog

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

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 Код Описание
400 MISSING_REQUIRED_FIELDS Не передан name, либо его значение равно null или пустой строке.
400 READONLY_FIELD В теле передано поле с меткой RO. Уберите его из запроса.
400 INVALID_PARAMS В строковом или числовом поле передан объект или массив.
400 INVALID_PARAMS Битрикс24 отклонил параметры запроса.
422 BITRIX_ERROR Битрикс24 отклонил запрос. Причина — в error.message.
403 BITRIX_ACCESS_DENIED У пользователя нет права Битрикс24 «Управление типами цен».
403 WRITE_BLOCKED_READONLY_KEY Ключ работает в режиме только для чтения.
403 SCOPE_DENIED У ключа нет скоупа catalog.
401 MISSING_API_KEY Не передан заголовок X-Api-Key.
401 TOKEN_MISSING У ключа нет настроенных токенов Битрикс24. Для ключа OAuth-приложения проверьте пользовательскую сессию.

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

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

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

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