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

Поля типа цены

GET /v1/catalog-price-types/fields

Возвращает справочник полей типа цены с типами. Все поля доступны только для чтения.

Примеры

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/catalog-price-types/fields" \
  -H "X-Api-Key: YOUR_API_KEY"

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

Terminal 
curl "https://vibecode.bitrix24.tech/v1/catalog-price-types/fields" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-price-types/fields', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log('Полей:', Object.keys(data.fields).length)

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-price-types/fields', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()

Поля ответа

data.fields — объект, ключ которого совпадает с именем поля, а значение содержит type (тип поля), readonly (true — поле нельзя передать при создании и обновлении), label (отображаемое название) и description (краткое описание). Значения label/description приходят на русском языке. Заголовками запроса язык не переключается. У полей, которые могут прийти без значения, стоит nullable: true. Список data.batch пуст: операций записи в пакетном режиме у типов цен нет.

Поле Тип RO Описание
id number да Идентификатор типа цены. Это значение передаётся в catalogGroupId при работе с ценами каталога
name string да Название типа цены, как оно задано на портале
base string да Y у базового типа цены портала, N у остальных
xmlId string да Внешний код интеграций импорта и выгрузки. Может быть null
sort number да Порядок сортировки в интерфейсе Битрикс24
createdBy number да ID пользователя, создавшего тип цены. Может быть null
modifiedBy number да ID пользователя, последним изменившего тип цены. Может быть null
dateCreate datetime да Дата и время создания типа цены. Может быть null
timestampX datetime да Дата и время последнего изменения типа цены. Может быть null

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

JSON 
{
  "success": true,
  "data": {
    "fields": {
      "id": { "type": "number", "readonly": true, "label": "ID", "description": "Идентификатор типа цены. Именно это значение /v1/catalog-prices ждёт в catalogGroupId." },
      "name": { "type": "string", "readonly": true, "label": "Название", "description": "Название типа цены, заданное на портале." },
      "base": { "type": "string", "readonly": true, "label": "Базовый тип цены", "description": "Y у базового типа цены портала, N у остальных. Значение Y несёт ровно один тип, и его id зависит от портала — он не обязан быть равен 1." },
      "xmlId": { "type": "string", "readonly": true, "nullable": true, "label": "Внешний код", "description": "Внешний идентификатор, используемый интеграциями импорта и экспорта." },
      "sort": { "type": "number", "readonly": true, "label": "Сортировка", "description": "Порядок сортировки типа цены в интерфейсе Bitrix24." },
      "createdBy": { "type": "number", "readonly": true, "nullable": true, "label": "Кем создан", "description": "ID пользователя, создавшего тип цены." },
      "modifiedBy": { "type": "number", "readonly": true, "nullable": true, "label": "Кем изменён", "description": "ID пользователя, последним изменившего тип цены." },
      "dateCreate": { "type": "datetime", "readonly": true, "nullable": true, "label": "Дата создания", "description": "Дата и время создания типа цены." },
      "timestampX": { "type": "datetime", "readonly": true, "nullable": true, "label": "Дата изменения", "description": "Дата и время последнего изменения типа цены." }
    },
    "batch": []
  }
}

Все поля помечены readonly: true — завести или изменить тип цены через API нельзя, это делается в интерфейсе Битрикс24.

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

403 — нет скоупа:

JSON 
{
  "success": false,
  "error": {
    "code": "SCOPE_DENIED",
    "message": "This endpoint requires 'catalog' scope"
  }
}

Ошибки

HTTP Код Описание
403 SCOPE_DENIED API-ключ не имеет скоупа catalog
401 MISSING_API_KEY Не передан заголовок X-Api-Key
429 RATE_LIMITED Превышен лимит запросов: 300 в минуту на портал, все API-ключи портала делят один лимит. Точное значение — в заголовке x-ratelimit-limit (потолок делится на реплики). Повторите после срока из заголовка Retry-After

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

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