#Каталог и склад

Управляйте каталогом товаров, ценами и складскими остатками через Entity API. Разделы каталога, ценовые предложения, склады — всё через стандартные CRUD-операции.

#Обзор

Catalog API расширяет базовые entity-обёртки для торгового каталога Битрикс24:

• Разделы каталога (/v1/catalog-sections/*) — категории и подкатегории товаров
• Цены (/v1/catalog-prices/*) — ценовые предложения (прайс-листы)
• Склады (/v1/warehouses/*) — управление складами и остатками

Требуемые скоупы: catalog, crm

Базовый URL: https://vibecode.bitrix24.tech/v1

Авторизация: заголовок X-Api-Key с вашим API-ключом.

#Быстрый старт

#Создайте раздел каталога

curl -X POST https://vibecode.bitrix24.tech/v1/catalog-sections \
  -H "X-Api-Key: $VIBE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "iblockId": 14,
      "name": "Электроника",
      "iblockSectionId": null
    }
  }'

Ответ:

{
  "success": true,
  "data": {
    "section": {
      "id": 42
    }
  }
}

#Разделы каталога

Entity: catalog-sections — разделы (категории) торгового каталога.

#POST /v1/catalog-sections

Создаёт новый раздел каталога.

Параметры тела запроса (в fields):

JavaScript:

const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-sections', {
  method: 'POST',
  headers: {
    'X-Api-Key': VIBE_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    fields: {
      iblockId: 14,
      name: 'Смартфоны',
      iblockSectionId: 42,  // дочерний раздел "Электроники"
      sort: 100
    }
  })
})

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