метод REST scope: catalog

catalog.product.offer.update

Обновить поля вариации товара

Кто может выполнять: администратор

Описание

Метод обновляет поля вариации товара.

Параметры

id catalog_product_offer.id обязательный

Идентификатор вариации товара.

Для получения идентификаторов вариаций товара необходимо использовать catalog.product.offer.list

fields object обязательный

Значения полей для обновления вариации товара

Параметр fields

name string необязательный

Наименование вариации товара

active string необязательный

Признак активности. Возможные значения:
- Y — да
- N — нет

code string необязательный

Символьный код

xmlId string необязательный

Внешний код

barcodeMulti string необязательный

Уникальные штрихкоды для каждого экземпляра. Возможные значения:
- Y — да
- N — нет

canBuyZero string необязательный

Разрешается ли покупка вариации товара при ее отсутствии. Возможные значения:
- Y — да
- N — нет

createdBy user.id необязательный

Кем создан

modifiedBy user.id необязательный

Кем изменен

dateActiveFrom datetime необязательный

Дата начала активности

dateActiveTo datetime необязательный

Дата окончания активности

dateCreate datetime необязательный

Дата создания

iblockSectionId catalog_section.id необязательный

Идентификатор основного раздела информационного блока

IblockSection array необязательный

Массив со всеми разделами, к которым привязана вариация

measure catalog_measure.id необязательный

Единица измерения

previewText string необязательный

Описание для анонса

detailText string необязательный

Детальное описание

previewPicture object необязательный

Картинка для анонса. Объект в формате {fileData: [value1, value2]}, где value1 — название файла картинки с расширением, value2 — картинка в формате base64.

Для удаления картинки используется объект в формате {remove: 'Y'}

detailPicture object необязательный

Детальная картинка. Объект в формате {fileData: [value1, value2]}, где value1 — название файла картинки с расширением, value2 — картинка в формате base64.

Для удаления картинки используется объект в формате {remove: 'Y'}

previewTextType string необязательный

Тип описания для анонса. Возможные значения:
- text — текст
- html — HTML

detailTextType string необязательный

Тип детального описания. Возможные значения:
- text — текст
- html — HTML

sort integer необязательный

Сортировка

subscribe string необязательный

Разрешение подписки на вариацию товара. Возможные значения:
- Y — да
- N — нет
- D — по умолчанию

vatId catalog_vat.id необязательный

Идентификатор НДС

vatIncluded string необязательный

Включен ли НДС в цену. Возможные значения:
- Y — да
- N — нет

height double необязательный

Высота вариации товара

length double необязательный

Длина вариации товара

weight double необязательный

Вес вариации товара

width double необязательный

Ширина вариации товара

quantityTrace string необязательный

Режим количественного учета. Возможные значения:
- Y — включен
- N — выключен
- D — по умолчанию

purchasingCurrency string необязательный

Валюта закупочной цены.

Список валют можно получить методом crm.currency.list.

Не редактируется при включенном складском учете

purchasingPrice double необязательный

Закупочная цена.

Не редактируется при включенном складском учете

quantity double необязательный

Количество.

Не редактируется при включенном складском учете

quantityReserved double необязательный

Зарезервированное количество.

Не редактируется при включенном складском учете

recurSchemeLength integer необязательный

Длина периода оплаты.

Используется только в коробочной версии для продажи контента

recurSchemeType string необязательный

Единица времени периода оплаты. Возможные значения:
- H — час
- D — день
- W — неделя
- M — месяц
- Q — квартал
- S — полугодие
- Y — год

Используется только в коробочной версии для продажи контента

trialPriceId integer необязательный

Товар для пробной оплаты.

Используется только в коробочной версии для продажи контента

withoutOrder string необязательный

Продление без оформления заказа. Возможные значения:
- Y — да
- N — нет

Используется только в коробочной версии для продажи контента

parentId object необязательный

Идентификатор головного товара. Значение указывается в формате {value: value, valueId: valueId}, где value — идентификатор головного товара, а valueId — идентификатор значения свойства.

Для получения идентификаторов головных товаров необходимо использовать catalog.product.sku.list

propertyN object необязательный

Значение свойства вариации товара, где N — идентификатор свойства. Свойств может быть несколько.

Значение указывается в формате {valueId: valueId, value: value} либо в формате [{valueId: valueId1, value: value1}, ..., {valueId: valueIdN, value: valueN}], если свойство множественное. Здесь valueId — идентификатор значения свойства, а value — значение свойства.

Если не указать valueId, то существующее значение будет удалено из базы данных и заменено на новое, указанное в value. Если свойство множественное, то все существующие значения свойства, для которых не был указан valueId, будут удалены. Исключение — свойства типа «файл»: их значения, не переданные в запросе, сохраняются, но valueId оставшихся значений после удаления меняются.

valueId всех свойств вариации товара можно получить с помощью методов catalog.product.offer.get и catalog.product.offer.list

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":1286,"fields":{"iblockId":24,"name":"Вариация товара","active":"Y","barcodeMulti":"Y","canBuyZero":"Y","code":"Tovar","createdBy":1,"dateActiveFrom":"2024-05-28T10:00:00","dateActiveTo":"2024-05-29T10:00:00","dateCreate":"2024-05-27T10:00:00","detailPicture":{"fileData":["detailPicture.png","iVBORw0KGgoAAAANSUhEUgAAAMgAAADIBAMAAABfdrOtAAAAG1BMVEX37ff/­///58fn9+v3+/P779vv8+Pz47/j68/oDfe+3AAAACXBIWXMAAA7EAAAOxAGV­Kw4bAAABrUlEQVR4nO3UT0/CMBjH8ccx2I56IFynkHg1SgxHHCocSfQFGKP3­+e++xL1wn7bPUCAeKF5Mvp+EluX3ZN3ariIAAAAAAAAAAAAAAAAA/q2TwrXZ­ib94LTbj5GdgVbtKxhdXS+2uL270ajQbL9fz4WzcXwVWtbNeIdmt3qSQtwdJ­Ssku1/NHkfdVEKriHFey0G4haS3+ty4ZtEGoipMW+VS7T2m0zc+28tICq4rT­qXtuJV7kWdvsUJtuoc1Hm08ssKo4B1Wn1i6tJu5qrj9dA8lWEzOQEFhV3CCN­Tph2naJ0V+eu0SV+ry3WWQqBVcUNsgiP16ndS4SnzuffL5LWEgKrihqje7Y9­iDTN6mZ38geDNNX2dEm338b5XPafrmRuj/dj4fULfGoXeFTJ/guvayybW1i3­Vl7aM7h+3y2c+y07FfeZjaT9GHVrNYXPG/fkIbCqCPf+9d1WKiWtJSyP21r+­FaTrZ8+CULW7XliCUe0PyIUdkD29qQzdv7A0FoSq3R0fqaU78d0hPtw86hMX­99vAqqJlp757/W3vhMCqAAAAAAAAAAAAAAAAAPxbX82/SILlk9xfAAAAAElF­TkSuQmCCiVBORw0KGgoAAAANSUhEUgAAAMgAAADIBAMAAABfdrOtAAAAG1BM­VEX37ff////58fn9+v3+/P779vv8+Pz47/j68/oDfe+3AAAACXBIWXMAAA7E­AAAOxAGVKw4bAAABrUlEQVR4nO3UT0/CMBjH8ccx2I56IFynkHg1SgxHHCoc­SfQFGKP3+e++xL1wn7bPUCAeKF5Mvp+EluX3ZN3ariIAAAAAAAAAAAAAAAAA­/q2TwrXZib94LTbj5GdgVbtKxhdXS+2uL270ajQbL9fz4WzcXwVWtbNeIdmt­3qSQtwdJSsku1/NHkfdVEKriHFey0G4haS3+ty4ZtEGoipMW+VS7T2m0zc+2­8tICq4rTqXtuJV7kWdvsUJtuoc1Hm08ssKo4B1Wn1i6tJu5qrj9dA8lWEzOQ­EFhV3CCNTph2naJ0V+eu0SV+ry3WWQqBVcUNsgiP16ndS4SnzuffL5LWEgKr­ihqje7Y9iDTN6mZ38geDNNX2dEm338b5XPafrmRuj/dj4fULfGoXeFTJ/guv­ayybW1i3Vl7aM7h+3y2c+y07FfeZjaT9GHVrNYXPG/fkIbCqCPf+9d1WKiWt­JSyP21r+FaTrZ8+CULW7XliCUe0PyIUdkD29qQzdv7A0FoSq3R0fqaU78d0h­Ptw86hMX99vAqqJlp757/W3vhMCqAAAAAAAAAAAAAAAAAPxbX82/SILlk9xf­AAAAAElFTkSuQmCC"]},"detailText":"","detailTextType":"text","height":100,"iblockSectionId":47,"length":100,"measure":5,"modifiedBy":1,"previewPicture":{"fileData":["previewPicture.png","iVBORw0KGgoAAAANSUhEUgAAAMgAAADIBAMAAABfdrOtAAAAG1BMVEX37ff/­///58fn9+v3+/P779vv8+Pz47/j68/oDfe+3AAAACXBIWXMAAA7EAAAOxAGV­Kw4bAAABrUlEQVR4nO3UT0/CMBjH8ccx2I56IFynkHg1SgxHHCocSfQFGKP3­+e++xL1wn7bPUCAeKF5Mvp+EluX3ZN3ariIAAAAAAAAAAAAAAAAA/q2TwrXZ­ib94LTbj5GdgVbtKxhdXS+2uL270ajQbL9fz4WzcXwVWtbNeIdmt3qSQtwdJ­Ssku1/NHkfdVEKriHFey0G4haS3+ty4ZtEGoipMW+VS7T2m0zc+28tICq4rT­qXtuJV7kWdvsUJtuoc1Hm08ssKo4B1Wn1i6tJu5qrj9dA8lWEzOQEFhV3CCN­Tph2naJ0V+eu0SV+ry3WWQqBVcUNsgiP16ndS4SnzuffL5LWEgKrihqje7Y9­iDTN6mZ38geDNNX2dEm338b5XPafrmRuj/dj4fULfGoXeFTJ/guvayybW1i3­Vl7aM7h+3y2c+y07FfeZjaT9GHVrNYXPG/fkIbCqCPf+9d1WKiWtJSyP21r+­FaTrZ8+CULW7XliCUe0PyIUdkD29qQzdv7A0FoSq3R0fqaU78d0hPtw86hMX­99vAqqJlp757/W3vhMCqAAAAAAAAAAAAAAAAAPxbX82/SILlk9xfAAAAAElF­TkSuQmCCiVBORw0KGgoAAAANSUhEUgAAAMgAAADIBAMAAABfdrOtAAAAG1BM­VEX37ff////58fn9+v3+/P779vv8+Pz47/j68/oDfe+3AAAACXBIWXMAAA7E­AAAOxAGVKw4bAAABrUlEQVR4nO3UT0/CMBjH8ccx2I56IFynkHg1SgxHHCoc­SfQFGKP3+e++xL1wn7bPUCAeKF5Mvp+EluX3ZN3ariIAAAAAAAAAAAAAAAAA­/q2TwrXZib94LTbj5GdgVbtKxhdXS+2uL270ajQbL9fz4WzcXwVWtbNeIdmt­3qSQtwdJSsku1/NHkfdVEKriHFey0G4haS3+ty4ZtEGoipMW+VS7T2m0zc+2­8tICq4rTqXtuJV7kWdvsUJtuoc1Hm08ssKo4B1Wn1i6tJu5qrj9dA8lWEzOQ­EFhV3CCNTph2naJ0V+eu0SV+ry3WWQqBVcUNsgiP16ndS4SnzuffL5LWEgKr­ihqje7Y9iDTN6mZ38geDNNX2dEm338b5XPafrmRuj/dj4fULfGoXeFTJ/guv­ayybW1i3Vl7aM7h+3y2c+y07FfeZjaT9GHVrNYXPG/fkIbCqCPf+9d1WKiWt­JSyP21r+FaTrZ8+CULW7XliCUe0PyIUdkD29qQzdv7A0FoSq3R0fqaU78d0h­Ptw86hMX99vAqqJlp757/W3vhMCqAAAAAAAAAAAAAAAAAPxbX82/SILlk9xf­AAAAAElFTkSuQmCC"]},"previewText":"","previewTextType":"text","purchasingCurrency":"RUB","purchasingPrice":1000,"quantity":10,"quantityReserved":1,"quantityTrace":"Y","recurSchemeLength":1,"recurSchemeType":"D","sort":100,"subscribe":"Y","trialPriceId":175,"vatId":1,"vatIncluded":"Y","weight":100,"width":100,"withoutOrder":"Y","xmlId":"1286","property261":{"value":"test","valueId":9868},"property262":[{"value":"test1","valueId":9869},{"value":"test2","valueId":9870}]}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.product.offer.update

Ответ

HTTP-статус: 200

{
    "result": {
        "offer": {
            "active": "Y",
            "available": "Y",
            "bundle": "N",
            "canBuyZero": "Y",
            "code": "Tovar",
            "createdBy": 1,
            "dateActiveFrom": "2024-05-28T10:00:00+03:00",
            "dateActiveTo": "2024-05-29T10:00:00+03:00",
            "dateCreate": "2024-05-27T10:00:00+03:00",
            "detailPicture": {
                "id": "6540",
                "url": "\/rest\/catalog.product.download?fields%5BfieldName%5D=detailPicture\u0026fields%5BfileId%5D=6540\u0026fields%5BproductId%5D=1286",
                "urlMachine": "\/rest\/catalog.product.download?fields%5BfieldName%5D=detailPicture\u0026fields%5BfileId%5D=6540\u0026fields%5BproductId%5D=1286"
            },
            "detailText": null,
            "detailTextType": "text",
            "height": 100,
            "iblockId": 24,
            "iblockSectionId": null,
            "id": 1286,
            "length": 100,
            "measure": 5,
            "modifiedBy": 1,
            "name": "Вариация товара",
            "parentId": {
                "value": "1275",
                "valueId": "9867"
            },
            "previewPicture": {
                "id": "6539",
                "url": "\/rest\/catalog.product.download?fields%5BfieldName%5D=previewPicture\u0026fields%5BfileId%5D=6539\u0026fields%5BproductId%5D=1286",
                "urlMachine": "\/rest\/catalog.product.download?fields%5BfieldName%5D=previewPicture\u0026fields%5BfileId%5D=6539\u0026fields%5BproductId%5D=1286"
            },
            "previewText": null,
            "previewTextType": "text",
            "property261": {
                "value": "test",
                "valueId": "9868"
            },
            "property262": [
                {
                    "value": "test1",
                    "valueId": "9869"
                },
                {
                    "value": "test2",
                    "valueId": "9870"
                }
            ],
            "purchasingCurrency": "RUB",
            "purchasingPrice": "1000.000000",
            "quantity": 10,
            "quantityReserved": 1,
            "quantityTrace": "Y",
            "sort": 100,
            "subscribe": "Y",
            "timestampX": "2024-06-17T13:12:43+03:00",
            "type": 4,
            "vatId": 1,
            "vatIncluded": "Y",
            "weight": 100,
            "width": 100,
            "xmlId": "1286"
        }
    },
    "time": {
        "start": 1718626362.930888,
        "finish": 1718626363.968511,
        "duration": 1.0376231670379639,
        "processing": 0.6055271625518799,
        "date_start": "2024-06-17T15:12:42+03:00",
        "date_finish": "2024-06-17T15:12:43+03:00"
    }
}

Возвращаемые данные

result object

Корневой элемент ответа

offer catalog_product_offer

Объект с информацией об обновленной вариации товара

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":200040300010,
    "error_description":"Access denied"
}
Код Описание Значение
200040300043 Недостаточно прав для обновления информационного блока
200040300050 Недостаточно прав для привязки элемента информационного блока к разделу
200040300040 Недостаточно прав для обновления вариации товара
200040300000 Информационный блок с указанным идентификатором не найден
200040300010 Недостаточно прав для чтения торгового каталога
100 Не указан параметр id
100 Не указан или пустой параметр fields
0 Раздел с указанным идентификатором не существует
0 Ставка НДС с указанным идентификатором не существует
0 Указанная валюта закупочной цены не существует
0 Пользователь с указанным идентификатором, создавший вариацию товара, не существует
0 Пользователь с указанным идентификатором, изменивший вариацию товара, не существует
0 Вариация товара с указанным идентификатором не существует в информационном блоке с указанным идентификатором
0 Вариация товара с указанным идентификатором не существует
0 Другие ошибки (например, фатальные ошибки)

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.

Меню
Мы в соцсетях