## Создать услугу `POST /v1/catalog-services` Создаёт услугу в товарном каталоге. Поля передаются плоско в корне JSON. ## Поля запроса (body) | Поле | Тип | Обяз. | Описание | |------|-----|:-----:|---------| | `name` | string | да | Название услуги | | `iblockId` | number | да | ID товарного каталога — каталога, у которого не заполнен `productIblockId`. Список: [`GET /v1/catalogs`](/docs/entities/catalogs/list) | | `iblockSectionId` | number | нет | ID раздела каталога. Список: [`GET /v1/catalog-sections`](/docs/entities/catalog-sections/list) | | `iblockSection` | array | нет | Массив ID разделов каталога, если услуга относится к нескольким разделам. Основным разделом `iblockSectionId` становится первый ID массива. Список: [`GET /v1/catalog-sections`](/docs/entities/catalog-sections/list) | | `active` | boolean | нет | Активна ли услуга. По умолчанию `true` | | `available` | boolean | нет | Доступна ли услуга к покупке. По умолчанию `false` | | `measure` | number | нет | ID единицы измерения. Список: [`GET /v1/catalog-measures`](/docs/entities/catalog-measures/list) | | `vatIncluded` | boolean | нет | НДС включён в цену | | `vatId` | number | нет | ID ставки НДС. Список: [`GET /v1/catalog-vat-rates`](/docs/entities/catalog-vat-rates/list) | | `code` | string | нет | Символьный код | | `xmlId` | string | нет | Внешний код. Без него в ответе приходит `id` услуги строкой | | `sort` | number | нет | Порядок сортировки. По умолчанию `500` | | `previewText` | string | нет | Текст анонса | | `previewTextType` | string | нет | Формат текста анонса: `text` или `html`. По умолчанию `text` | | `detailText` | string | нет | Подробное описание | | `detailTextType` | string | нет | Формат подробного описания: `text` или `html`. По умолчанию `text` | | `previewPicture` | object | нет | Картинка анонса | | `detailPicture` | object | нет | Детальная картинка | | `propertyNNN` | string | нет | Значение свойства каталога, где `NNN` — `id` свойства из [`GET /v1/catalog-product-properties`](/docs/entities/catalog-product-properties/list). Строковое свойство принимает строку: `"property301": "A-100"` | Поля с `readonly: true` в [Полях услуги](./fields.md) заполняет система — например, `type` и `createdBy`. Такое поле в теле отклоняется с `400 READONLY_FIELD`. Цена продажи задаётся отдельно — в [`POST /v1/catalog-prices`](/docs/entities/catalog-prices/create) с `id` услуги в `productId`. ## Примеры ### curl — личный ключ ```bash curl -X POST "https://vibecode.bitrix24.tech/v1/catalog-services" \ -H "X-Api-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Монтаж кондиционера", "iblockId": 25, "iblockSectionId": 281, "measure": 9, "vatIncluded": true }' ``` ### curl — OAuth-приложение ```bash curl -X POST "https://vibecode.bitrix24.tech/v1/catalog-services" \ -H "X-Api-Key: YOUR_APP_KEY" \ -H "Authorization: Bearer USER_SESSION_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "Монтаж кондиционера", "iblockId": 25, "iblockSectionId": 281, "measure": 9, "vatIncluded": true }' ``` ### JavaScript — личный ключ ```javascript const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-services', { method: 'POST', headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ name: 'Монтаж кондиционера', iblockId: 25, iblockSectionId: 281, measure: 9, vatIncluded: true, }), }) const { success, data } = await res.json() console.log('ID услуги:', data.id) ``` ### JavaScript — OAuth-приложение ```javascript const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-services', { method: 'POST', headers: { 'X-Api-Key': 'YOUR_APP_KEY', 'Authorization': 'Bearer USER_SESSION_TOKEN', 'Content-Type': 'application/json', }, body: JSON.stringify({ name: 'Монтаж кондиционера', iblockId: 25, iblockSectionId: 281, measure: 9, vatIncluded: true, }), }) const { success, data } = await res.json() ``` ## Поля ответа | Поле | Тип | Описание | |------|-----|---------| | `success` | boolean | Всегда `true` при успехе | | `data` | object | Полный объект созданной услуги. Набор полей — как у [`GET /v1/catalog-services/:id`](./get.md) | ## Пример ответа Показаны основные поля. ```json { "success": true, "data": { "id": 7231, "iblockId": 25, "iblockSectionId": 281, "iblockSection": [281], "name": "Монтаж кондиционера", "type": 7, "active": true, "available": false, "code": null, "xmlId": "7231", "sort": 500, "measure": 9, "vatId": null, "vatIncluded": true, "previewText": null, "previewTextType": "text", "createdBy": 1295, "modifiedBy": 1295, "dateCreate": "2026-10-08T20:50:59.000Z", "timestampX": "2026-10-08T20:50:59.000Z" } } ``` ## Пример ответа при ошибке 422 — не передано название: ```json { "success": false, "error": { "code": "BITRIX_ERROR", "message": "Required fields: name", "b24Code": "0" } } ``` ## Ошибки | HTTP | Код | Описание | |------|-----|----------| | 422 | `BITRIX_ERROR` | Не передано `name` (`Required fields: name`) | | 422 | `BITRIX_ERROR` | Не передан `iblockId` или каталога с таким `iblockId` нет (`iblock is not catalog`) | | 422 | `BITRIX_ERROR` | В `iblockId` передан ID каталога вариаций, а не товарного каталога (`productType is not allowed for this catalog`) | | 400 | `EMPTY_CREATE_BODY` | Тело запроса пустое | | 400 | `NESTED_FIELDS_ENVELOPE` | Вместо корневых полей передан объект `fields`; услуга не создаётся | | 400 | `READONLY_FIELD` | В теле передано поле, которое заполняет система, например `type` или `createdBy` | | 403 | `SCOPE_DENIED` | Ключу не хватает скоупа `catalog` | | 401 | `MISSING_API_KEY` | Не передан заголовок `X-Api-Key` | Полный список общих ошибок API — [Ошибки](/docs/errors). ## Известные особенности **Новая услуга недоступна к покупке.** Если `available` не передано, услуга создаётся с `available: false`. Чтобы услугу можно было продавать сразу, передайте `"available": true` при создании или позже в [`PATCH /v1/catalog-services/:id`](./update.md). **Неизвестные скалярные поля не отклоняются.** Имя, которого нет среди полей услуги, в теле создания пропускается: услуга создаётся без него, ответ — `201`. Объект `fields` отклоняется с `400 NESTED_FIELDS_ENVELOPE` до создания — отправляйте поля в корне JSON. Сверяйте имена с [Полями услуги](./fields.md). ## Смотрите также - [Список услуг](/docs/entities/catalog-services/list) - [Получить услугу](/docs/entities/catalog-services/get) - [Изменить услугу](/docs/entities/catalog-services/update) - [Удалить услугу](/docs/entities/catalog-services/delete) - [Цены каталога](/docs/entities/catalog-prices) - [Разделы каталога](/docs/entities/catalog-sections) - [Batch](/docs/batch) - [Лимиты и оптимизация](/docs/optimization)