/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

}

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

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

Дополнительные поля для создания кванта, обязательны для заполнения

Поле

Тип\формат

Описание

multiplicity

string

Кратность кванта

parentPackageId

string

Идентификатор варианта, для которого создается квант (обязательный параметр для создания короба)

shortName

string

Наименование кванта

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

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

{

 "parentPackageId": "566335464",

 "multiplicity": "5",

 "shortName": "test monokorob",

 "productId": "1256635834",

 "isArchived": false,

 "barcodes": []

}

Обновление отдельных полей варианта(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": [ "желтый", "красный", "синий", "бело-синий" ] } ]}