Skip to main content

/api/lite/products/variants

У каждого продукта есть хотя бы один вариант.

Вариант – реальный товар, имеющий характеристики, вес, размеры.

 

Создание/редактирование варианта (POST /api/lite/products/variants)

/api/lite/products/variants

Создает или обновляет вариант к указанному продукту.

Поле Тип\формат Описание
productId string Идентификатор продукта, для которого создаются варианты
variantId string Идентификатор варианта для обновления. Если не указан, создается новый вариант.
extId string Дополнительный редактируемый код варианта.
article string Артикул производителя товара.
price decimal Цена розничной продажи. [deprecated]
oldPrice decimal "Старая цена" - используется для отображения перечеркнутой цены. [deprecated]
prices object Список цен
defaultImage string Ссылка на стандартное изображение варианта (из набор изображений продукта).
ordering double Число для сортировки между вариантами
optionsUsed array Массив используемых опций данным вариантом
code string Код варианта
stringValue string Значение опции варианта (строка)
decimalValue decimal Значение опции варианта (число)
weight decimal Вес товара в граммах
dimensions object Объект с характеристиками размеров товара. Задается в сантиметрах.
barcodes array Список ШК варианта
stock object Объект со списком кодов складов и остатков товаров на них
warehouseCode string Код склада
stockTotal integer

Опционально - установить общее количество товара в штуках на складе по умолчанию, включая количество в резерве. Только в сочетании с флагом updateStockTotal = true
updateStockTotal boolean

Флаг активации корректировки общего количества товара из поля stockTotal на складе по умолчанию

Пример вызова:

Пример запроса
{
    "productId": "1002",
    "variantId": "1024",
    "article": "POLO92/L/ЖЕЛ",
    "price": 990, //deprecated
    "oldPrice": 1200, //deprecated
  	"prices":[
      {
        "priceCode":"Розничная цена",
        "value":990
      },
      {
        "priceCode":"Цена до скидки",
        "value":1200
      }
    ],
    "defaultImage": "8b16a469-2b8c-4df4-85f2-c9c9afa1f921",
    "ordering": "123.123"
    "optionsUsed": [
        {
            "code": "size",
            "stringValue": "L"
        },
        {
            "code": "color",
            "stringValue": "желтый"
        }
    ],
    "weight": 500,
    "dimensions": {
        "height": 5,
        "width": 5,
        "depth": 10
    },
    "barcodes": [
                        {
                            "value": "42353456345345",
                            "isDefault": true,
                            "type": "COMMON"
                        },
                        {
                            "value": "34234232343",
                            "isDefault": false,
                          	"type": "WILDBERRIES"
                        }
     ],                 
     "stock": [
                        {
                            "warehouseCode": "9a84e96f-3e8c-8f74-3b7a-50a1d3c2a130",
                            "stockTotal": 111                          
                        }
                    ],
     "updateStockTotal":false
}

Обновление отдельных полей варианта(PATCH /api/lite/products/variants)

/api/lite/products/variants

Обновляет одно или несколько полей варианта, значения отсутствующих в запросе полей при этом не изменяются.

Тело запроса аналогично POST /api/lite/products/variants

productId и variantId - необходимо указывать обязательно

Пример вызова:

Пример запроса
{
	"productId":"1002",
	"variantId":"1024",
	"barcodes":[
		{
			"value":"42353456345345",
			"isDefault":true,
			"type":"COMMON"
		}
	]
}

ответ аналогичен POST /api/lite/products/variants

Удаление варианта (DELETE /api/lite/products/variants)

/api/lite/products/variants

Удаляет вариант продукта.

Невозможно удалить единственный вариант продукта. Также, невозможно удалить вариант, у которого есть складские остатки.

Параметры запроса: productId - код продукта, variantId - код варианта

 

Упорядочить значения опций продукта (POST /api/lite/product/options/reorder)

/api/lite/product/options/reorder

Упорядочивает значения опций для указанного продукта.

Если данной опции не существует - значение пропускается.

Поле Тип\формат Описание
productId string Идентификатор продукта, для которого создаются варианты
options array Массив опций
code string

Код опции
values string Массив значений для данной опции в требуемом порядке.

Пример вызова:

Пример запроса
{
    "productId": "1002",
    "options": [
        {
            "code": "size",
            "values": [
                "S",
                "M",
                "L",
                "XL"
            ]
        },
        {
            "code": "color",
            "values": [
                "желтый",
                "красный",
                "синий",
                "бело-синий"
            ]
        }
    ]
}
Наверх