catalog.productPropertyEnum.update
Изменить значение списочного свойства
Описание
Метод catalog.productPropertyEnum.update изменяет значение списочного свойства.
Параметры
id
integer
обязательный
Идентификатор значения списочного свойства.
Идентификатор можно получить методом catalog.productPropertyEnum.list
fields
object
обязательный
Набор полей обновляемого значения списка (подробное описание)
Параметр fields
propertyId
catalog_product_property.id
обязательный
Идентификатор свойства товара или вариации.
Идентификаторы свойств можно получить методом catalog.productProperty.list
value
string
обязательный
Значение элемента списка
xmlId
string
обязательный
Внешний идентификатор значения списка. Должен быть уникальным в рамках свойства
def
char
необязательный
Признак значения по умолчанию. Допустимые значения:
- Y — по умолчанию
- N — не по умолчанию
sort
integer
необязательный
Индекс сортировки
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":1739,"fields":{"propertyId":431,"value":"Средний","xmlId":"M","def":"N","sort":110}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.productPropertyEnum.update
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":1739,"fields":{"propertyId":431,"value":"Средний","xmlId":"M","def":"N","sort":110},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/catalog.productPropertyEnum.update
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
// Shape of the payload returned in result (match the "response handling" section of the page)
type ProductPropertyEnumUpdateResult = {
productPropertyEnum: {
def: string,
id: number,
propertyId: number,
sort: number,
value: string,
xmlId: string,
},
}
try {
const response = await $b24.actions.v2.call.make<ProductPropertyEnumUpdateResult>({
method: 'catalog.productPropertyEnum.update',
params: {
id: 1739,
fields: {
propertyId: 431,
value: 'Medium',
xmlId: 'M',
def: 'N',
sort: 110,
},
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info(result.productPropertyEnum)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function updateProductPropertyEnum() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'catalog.productPropertyEnum.update',
params: {
id: 1739,
fields: {
propertyId: 431,
value: 'Medium',
xmlId: 'M',
def: 'N',
sort: 110,
},
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info(result.productPropertyEnum)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', updateProductPropertyEnum)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.catalog.product_property_enum.update(
bitrix_id=1739,
fields={
"propertyId": 431,
"value": "Средний",
"xmlId": "M",
"sort": 110,
},
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'catalog.productPropertyEnum.update',
[
'id' => 1739,
'fields' => [
'propertyId' => 431,
'value' => 'Средний',
'xmlId' => 'M',
'def' => 'N',
'sort' => 110,
],
]
);
print_r($response->getResponseData()->getResult());
} catch (\Throwable $exception) {
echo $exception->getMessage();
}
BX24.callMethod(
'catalog.productPropertyEnum.update',
{
id: 1739,
fields: {
propertyId: 431,
value: 'Средний',
xmlId: 'M',
def: 'N',
sort: 110,
}
},
function(result) {
if (result.error()) {
console.error(result.error());
} else {
console.log(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'catalog.productPropertyEnum.update',
[
'id' => 1739,
'fields' => [
'propertyId' => 431,
'value' => 'Средний',
'xmlId' => 'M',
'def' => 'N',
'sort' => 110,
]
]
);
print_r($result);
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "catalog.productPropertyEnum.update", b24.Params{
"id": 1739,
"fields": b24.Params{
"propertyId": 431,
"value": "Средний",
"xmlId": "M",
"def": "N",
"sort": 110,
},
})
if err != nil {
return fmt.Errorf("catalog.productPropertyEnum.update: %w", err)
}
// Метод заворачивает ответ в объект с ключом "productPropertyEnum".
raw, ok := b24.Unwrap(res.Result, "productPropertyEnum")
if !ok {
return fmt.Errorf("в ответе нет ключа productPropertyEnum")
}
var item struct {
Def string `json:"def"`
ID b24.ID `json:"id"`
PropertyID b24.ID `json:"propertyId"`
Sort int `json:"sort"`
Value string `json:"value"`
XmlID string `json:"xmlId"`
}
if err := json.Unmarshal(raw, &item); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println(item.Def, item.ID)
Ответ
HTTP-статус: 200
{
"result": {
"productPropertyEnum": {
"def": "N",
"id": 1739,
"propertyId": 431,
"sort": 110,
"value": "Средний",
"xmlId": "M"
}
},
"time": {
"start": 1774339029,
"finish": 1774339030.119726,
"duration": 1.1197259426116943,
"processing": 1,
"date_start": "2026-03-24T10:57:09+03:00",
"date_finish": "2026-03-24T10:57:10+03:00",
"operating_reset_at": 1774339629,
"operating": 0.1804349422454834
}
}
Возвращаемые данные
result
object
Корневой объект ответа
productPropertyEnum
catalog_product_property_enum
Объект обновленного значения списочного свойства
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "0",
"error_description": "productPropertyEnum does not exist."
}
| Код | Описание | Значение |
|---|---|---|
0 |
Access Denied | Недостаточно прав для изменения свойства инфоблока |
0 |
productPropertyEnum does not exist. | Значение списочного свойства с переданным id не найдено или не относится к торговому каталогу |
0 |
The specified property does not belong to a product catalog | Свойство с переданным propertyId не относится к торговому каталогу |
0 |
Required fields: xmlId | Не передано обязательное поле xmlId |
0 |
Internal error updating enumeration value. Try updating again. | Внутренняя ошибка при обновлении значения списка |
100 |
Could not find value for parameter {id} | Не передан обязательный параметр id |

