#Обновить товар

PATCH /v1/catalog-products/:id

Изменяет существующий товар. Поля передаются плоско в корне JSON. Передавайте только изменяемые поля — остальные сохраняют текущие значения. В ответ приходит полный объект обновлённого товара.

#Параметры

#Поля запроса (body)

Пользовательские свойства товара передаются как propertyNNN; on-premise-поля (recurSchemeType, recurSchemeLength, trialPriceId) тоже принимаются. Полный список полей — в `GET /v1/catalog-products/fields`.

Тело должно содержать хотя бы одно записываемое поле. Пустой PATCH ({}) отклоняется с 400 EMPTY_UPDATE_BODY, а PATCH, в котором нет ни одного распознанного записываемого поля (например только опечатки), — с 400 NO_RECOGNIZED_UPDATE_FIELDS. Раньше такой запрос возвращал 200 с неизменённым объектом, вводя клиента в заблуждение. Поля-объекты iblockSection/previewPicture/detailPicture пишутся, но по ним нельзя фильтровать и сортировать (запрос отклоняется явной ошибкой UNKNOWN_FILTER_FIELD/UNKNOWN_SORT_FIELD); для надёжной фильтрации используйте индексируемые поля (code, xmlId, sort, vatId, размеры).

id передаётся в пути, в теле его передавать нельзя — он только для чтения. Поля available и bundle вычисляются Битрикс24 и при записи отвечают READONLY_FIELD. iblockId задаётся только при создании: смена каталога через PATCH отклоняется с READONLY_FIELD — Битрикс24 не переносит товар между каталогами (раньше такой запрос возвращал 200, но товар оставался на месте). Поля аудита createdBy и modifiedBy заполняются системой и при записи тоже отвечают READONLY_FIELD.

#Примеры

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

curl -X PATCH "https://vibecode.bitrix24.tech/v1/catalog-products/541" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Кабель USB-C, 2 м"
  }'

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

curl -X PATCH "https://vibecode.bitrix24.tech/v1/catalog-products/541" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Кабель USB-C, 2 м"
  }'

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

const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-products/541', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Кабель USB-C, 2 м',
  }),
})

const { success, data } = await res.json()
console.log('Новое название:', data.name)

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

const res = await fetch('https://vibecode.bitrix24.tech/v1/catalog-products/541', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'Кабель USB-C, 2 м',
  }),
})

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

#Поля ответа

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

Показаны основные поля.

{
  "success": true,
  "data": {
    "id": 541,
    "iblockId": 25,
    "iblockSectionId": null,
    "name": "Кабель USB-C, 2 м",
    "active": true,
    "measure": 9,
    "available": true,
    "bundle": false,
    "canBuyZero": true,
    "quantityTrace": false,
    "subscribe": true,
    "vatIncluded": false,
    "purchasingPrice": 110,
    "purchasingCurrency": "RUB",
    "quantity": null,
    "dateCreate": "2021-08-06T12:59:15.000Z",
    "timestampX": "2026-06-15T13:11:33.000Z",
    "xmlId": "541"
  }
}

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

422 — товара с указанным id не существует:

{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "product does not exist."
  }
}

#Ошибки

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

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

• Создать товар
• Список товаров
• Получить товар
• Удалить товар
• Цены каталога
• Batch
• Лимиты и оптимизация