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

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

PATCH /v1/products/:id

Обновляет товар CRM-каталога. Передавайте только изменяемые поля плоско в корне JSON — без обёртки fields. В ответ приходит полный объект обновлённого товара.

Параметры

Параметр	Тип	Обяз.	Описание
`id` (path)	number	да	Идентификатор товара. Список: `GET /v1/products`

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

Поле	Тип	Обяз.	Описание
`name`	string	нет	Название товара
`price`	number	нет	Цена товара. Валюту задаёт `currency` или дополнительное имя `currencyId`
`currencyId`	string	нет	Дополнительное имя `currency` для записи. В ответах значение приходит в поле `currency`
`currency`	string	нет	Каноническое имя валюты цены. Если переданы оба имени, используется `currency`. Список: `GET /v1/currencies`
`active`	boolean	нет	Активен ли товар
`sectionId`	number	нет	Раздел каталога. Список: `GET /v1/product-sections`
`catalogId`	number	нет	Каталог товара. Список: `GET /v1/catalogs`
`measure`	number	нет	Идентификатор единицы измерения
`description`	string	нет	Описание товара
`descriptionType`	string	нет	Формат описания: `text` или `html`
`vatId`	number	нет	Идентификатор ставки НДС
`vatIncluded`	boolean	нет	НДС включён в цену
`sort`	number	нет	Порядок сортировки
`xmlId`	string	нет	Внешний идентификатор
`code`	string	нет	Символьный код товара
`createdBy`	number	RO	Идентификатор создавшего сотрудника
`modifyBy`	number	RO	Идентификатор изменившего сотрудника
`createdAt`	datetime	RO	Дата создания
`updatedAt`	datetime	RO	Дата последнего изменения

Примеры

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

Terminal

curl -X PATCH "https://vibecode.bitrix24.tech/v1/products/7027" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "price": 150
  }'

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

Terminal

curl -X PATCH "https://vibecode.bitrix24.tech/v1/products/7027" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "price": 150
  }'

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

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/products/7027', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    price: 150,
  }),
})

const { success, data } = await res.json()
console.log('Новая цена:', data.price)

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

javascript

const res = await fetch('https://vibecode.bitrix24.tech/v1/products/7027', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    price: 150,
  }),
})

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

Поля ответа

Поле	Тип	Описание
`success`	boolean	Всегда `true` при успехе
`data`	object	Объект обновлённого товара: базовые поля — см. Поля товара, плюс пользовательские свойства `PROPERTY_<N>`

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

Показаны основные поля. В ответ также входят свойства каталога вида PROPERTY_<N> — см. Получить товар.

JSON

{
  "success": true,
  "data": {
    "id": 7027,
    "name": "Настольная лампа",
    "code": "nastolnaya_lampa",
    "active": true,
    "previewPicture": null,
    "detailPicture": null,
    "sort": 500,
    "xmlId": "7027",
    "updatedAt": "2026-06-16T08:48:21.000Z",
    "createdAt": "2026-06-16T08:48:18.000Z",
    "modifyBy": 1,
    "createdBy": 1,
    "catalogId": 25,
    "sectionId": null,
    "description": null,
    "descriptionType": "text",
    "price": 150,
    "currency": "RUB",
    "vatId": null,
    "vatIncluded": false,
    "measure": null
  }
}

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

404 — товар не найден: