# Разделы товаров

Управление разделами каталога товаров CRM: создание, получение, обновление, удаление и поиск. Раздел группирует товары внутри каталога и может быть вложенным.

Битрикс24 API: `crm.productsection.*`
Скоуп: `crm`

**Методы `/v1/product-sections` устарели.** Для новых интеграций используйте [Разделы каталога](/docs/entities/catalog-sections).

## Операции

- [Создать раздел](./product-sections/create.md) — `POST /v1/product-sections`
- [Список разделов](./product-sections/list.md) — `GET /v1/product-sections`
- [Получить раздел](./product-sections/get.md) — `GET /v1/product-sections/:id`
- [Обновить раздел](./product-sections/update.md) — `PATCH /v1/product-sections/:id`
- [Удалить раздел](./product-sections/delete.md) — `DELETE /v1/product-sections/:id`
- [Поиск разделов](./product-sections/search.md) — `POST /v1/product-sections/search`
- [Поля раздела](./product-sections/fields.md) — `GET /v1/product-sections/fields`

## Ключевые поля

| Поле | Описание |
|------|---------|
| `name` | Название раздела |
| `catalogId` | ID каталога. Список: `GET /v1/catalogs` |
| `sectionId` | ID родительского раздела для вложенности. У корневого раздела — `null` |
| `code` | Символьный код раздела |
| `xmlId` | Внешний идентификатор |

Полный список полей — [`GET /v1/product-sections/fields`](./product-sections/fields.md).

## Что нужно знать перед работой

1. **Это те же разделы, что и в каталоге.** Раздел с тем же `id` доступен через [`GET /v1/catalog-sections`](/docs/entities/catalog-sections). `catalogId` здесь соответствует `iblockId` там.
2. **Тело запроса плоское.** Поля передаются в корне JSON, без обёртки `fields`.
3. **Для создания нужно только `name`.** `catalogId` по умолчанию равен каталогу CRM портала, `code` формируется из названия.
4. **Вложенность задаётся через `sectionId`.** Это ID родительского раздела. У разделов верхнего уровня `sectionId` равен `null`.
5. **Поля ответа в camelCase.** Соответствие исходным именам Битрикс24 — в [Полях раздела](./product-sections/fields.md).

## Типичный сценарий

1. Посмотреть разделы каталога: [`GET /v1/product-sections?filter[catalogId]=25`](./product-sections/list.md).
2. Создать новый раздел: [`POST /v1/product-sections`](./product-sections/create.md).
3. Привязать товары к разделу: [`PATCH /v1/products/:id`](/docs/entities/products) с полем `sectionId`.

## Лимиты

| Лимит | Значение |
|-------|----------|
| Максимум записей на запрос | 5000 (`limit ≤ 5000`) |
| Авто-пагинация | включается при `limit > 50` |
| `offset` на больших выборках | рекомендуется `limit ≤ 500` при `offset ≥ 2500` |
| Batch-запросы | до 50 операций в [`POST /v1/batch`](/docs/batch) |
| Rate limit | общий для API Вайбкод — см. [Лимиты и оптимизация](/docs/optimization) |

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

- [Entity API](/docs/entity-api)
- [Синтаксис фильтрации](/docs/filtering)
- [Batch](/docs/batch)
- [Справочник API](/docs/api-reference)
- [Товары CRM](/docs/entities/products)
- [Разделы каталога](/docs/entities/catalog-sections)