API цен и скидок

С помощью этих методов можно устанавливать цены и скидки. Максимум — 10 запросов за 6 секунд суммарно для всех методов раздела Цены и скидки.

Установка цен и скидок

Проверяйте статусы обновлений с помощью методов из раздела Состояния загрузок. У методов может быть ответ Успешно (200), даже если не обновились данные у каких-то товаров или размеров (например, из-за слишком низкой цены или скидки)

Установить цены и скидки

Устанавливает цены и скидки для товаров

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

Array of objects (Goods)

Товары, цены и скидки для них. Максимум 1 000 товаров. Цена и скидка не могут быть пустыми одновременно.

Если новая цена со скидкой будет хотя бы в 3 раза меньше старой, она попадёт в карантин и товар будет продаваться по старой цене. Ошибка об этом будет в ответах методов Состояния загрузок

Вы можете изменить цену или скидку с помощью API либо вывести товар из карантина в личном кабинете

Responses

Response Schema: application/json

	object
error	boolean Флаг ошибки
errorText	string Текст ошибки

Request samples

Payload

Content type

application/json

{"data": [{"nmID": 123,
"price": 999,
"discount": 30
}
]
}

Response samples

Content type

application/json

{"data": {"id": 0,
"alreadyExists": false
},
"error": false,
"errorText": ""
}

Установить цены для размеров

Устанавливает цены отдельно для размеров. Работает только для товаров из категорий, где можно устанавливать цены отдельно для разных размеров. Для таких товаров в ответе метода Получить товары по артикулам editableSizePrice: true.

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

Array of objects (SizeGoodsBody)

Размеры и цены для них. Максимум 1 000 размеров

Для товаров с поразмерной установкой цен карантин не применяется

Responses

Response Schema: application/json

	object
error	boolean Флаг ошибки
errorText	string Текст ошибки

Request samples

Payload

Content type

application/json

{"data": [{"nmID": 123,
"sizeID": 98989887,
"price": 999
}
]
}

Response samples

Content type

application/json

{"data": {"id": 0,
"alreadyExists": false
},
"error": false,
"errorText": ""
}

Установить скидки WB Клуба

Устанавливает скидки в рамках подписки WB Клуб

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

Array of objects (ClubDisc)

Товары и скидки WB Клуба для них. Максимум 1 000 товаров.

Responses

Response Schema: application/json

	object
error	boolean Флаг ошибки
errorText	string Текст ошибки

Request samples

Payload

Content type

application/json

{"data": [{"nmID": 123,
"clubDiscount": 5
}
]
}

Response samples

Content type

application/json

{"data": {"id": 0,
"alreadyExists": false
},
"error": false,
"errorText": ""
}

Состояния загрузок

Когда вы обновляете цены или скидки, данные по каким-то товарам могут не обновиться. Например, если вы передали неправильную цену или скидку. Проверяйте статус загрузки с помощью метода Состояние обработанной загрузки. Статусы загрузки:

3 — обработана, в товарах нет ошибок, цены и скидки обновились.
4 — отменена.
5 — обработана, но в товарах есть ошибки. Для товаров без ошибок цены и скидки обновились, а ошибки в остальных товарах можно получить с помощью метода Детализация обработанной загрузки.
6 — обработана, но во всех товарах есть ошибки. Их тоже можно получить с помощью метода Детализация обработанной загрузки.

Если вы задаёте цены и скидки в календаре акций, загрузка с такими товарами попадает в обработку. Цены и скидки изменятся к началу акции.

У такой загрузки статус 1, а получить информацию про нее можно с помощью методов Детализация необработанной загрузки и Состояние необработанной загрузки

У загрузки не может быть статуса 2.

Состояние обработанной загрузки

Возвращает информацию про обработанную загрузку

Authorizations:

HeaderApiKey

query Parameters

uploadID

required

integer

Example: uploadID=146567

ID загрузки

Responses

Response Schema: application/json

	object (SupplierTaskMetadata)
error	boolean Флаг ошибки
errorText	string Текст ошибки Ошибка `The product is in quarantine` возникает, если новая цена со скидкой хотя бы в 3 раза меньше старой. Вы можете изменить цену или скидку с помощью API либо вывести товар из карантина в личном кабинете

Response samples

Content type

application/json

{"data": {"uploadID": 395643565,
"status": 3,
"uploadDate": "2022-08-21T22:00:13+02:00",
"activationDate": "2022-08-21T22:00:13+02:00",
"overAllGoodsNumber": 0,
"successGoodsNumber": 0
},
"error": false,
"errorText": "The product is in quarantine"
}

Детализация обработанной загрузки

Возвращает информацию о товарах в обработанной загрузке, в том числе, об ошибках в них

Authorizations:

HeaderApiKey

query Parameters

limit required	integer <uint> Example: limit=10 Сколько элементов вывести на одной странице (пагинация). Максимум 1 000 элементов
offset	integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные
uploadID required	integer Example: uploadID=146567 ID загрузки

Responses

Response Schema: application/json

object

Response samples

Content type

application/json

{"data": {"uploadID": 3235236546,
"historyGoods": [{"nmID": 544833232,
"vendorCode": "34552332",
"sizeID": 54483342,
"techSizeName": "42",
"price": 1500,
"currencyIsoCode4217": "RUB",
"discount": 25,
"clubDiscount": 5,
"status": 1,
"errorText": "The product is in quarantine"
}
]
}
}

Состояние необработанной загрузки

Возвращает информацию про загрузку в обработке

Authorizations:

HeaderApiKey

query Parameters

uploadID

required

integer

Example: uploadID=146567

ID загрузки

Responses

Response Schema: application/json

	object (SupplierTaskMetadataBuffer)
error	boolean Флаг ошибки
errorText	string Текст ошибки

Response samples

Content type

application/json

{"data": {"uploadID": 395643565,
"status": 1,
"uploadDate": "2022-08-21T22:00:13+02:00",
"activationDate": "2022-08-21T22:00:13+02:00",
"overAllGoodsNumber": 100,
"successGoodsNumber": 0
},
"error": false,
"errorText": ""
}

Детализация необработанной загрузки

Возвращает информацию о товарах из загрузки в обработке, в том числе, об ошибках в них

Authorizations:

HeaderApiKey

query Parameters

limit required	integer <uint> Example: limit=10 Сколько элементов вывести на одной странице (пагинация). Максимум 1 000 элементов
offset	integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные
uploadID required	integer Example: uploadID=146567 ID загрузки

Responses

Response Schema: application/json

	object
error	boolean Флаг ошибки
errorText	string Текст ошибки

Response samples

Content type

application/json

{"data": {"uploadID": 3235236546,
"bufferGoods": [{"nmID": 544833232,
"vendorCode": "34552332",
"sizeID": 54483342,
"techSizeName": "XXL",
"price": 1500,
"currencyIsoCode4217": "RUB",
"discount": 25,
"clubDiscount": 5,
"status": 1,
"errorText": null
}
]
},
"error": false,
"errorText": ""
}

Списки товаров

Получить товары

Возвращает информацию о товаре по его артикулу. Чтобы получить информацию обо всех товарах, оставьте артикул пустым

Authorizations:

HeaderApiKey

query Parameters

limit required	integer <uint> Example: limit=10 Сколько элементов вывести на одной странице (пагинация). Максимум 1 000 элементов
offset	integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные
filterNmID	integer Example: filterNmID=44589768676 Артикул Wildberries, по которому искать товар

Responses

Response Schema: application/json

object

Response samples

200
400
401
429

Content type

application/json

{"data": {"listGoods": [{"nmID": 98486,
"vendorCode": "07326060",
"sizes": [{"sizeID": 3123515574,
"price": 500,
"discountedPrice": 350,
"clubDiscountedPrice": 332.5,
"techSizeName": "42"
}
],
"currencyIsoCode4217": "RUB",
"discount": 30,
"clubDiscount": 5,
"editableSizePrice": true
}
]
}
}

Получить размеры товара

Возвращает информацию о всех размерах одного товара. Работает только для товаров из категорий, где можно устанавливать цены отдельно для разных размеров. Для таких товаров в ответе метода Получить товары по артикулам editableSizePrice: true.

Authorizations:

HeaderApiKey

query Parameters

limit required	integer <uint> Example: limit=10 Сколько элементов вывести на одной странице (пагинация). Максимум 1 000 элементов
offset	integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные
nmID required	integer Example: nmID=1 Артикул Wildberries

Responses

Response Schema: application/json

	object
error	boolean Флаг ошибки
errorText	string Текст ошибки

Response samples

200
400
401
429

Content type

application/json

{"data": {"listGoods": [{"nmID": 123,
"sizeID": 98989887,
"vendorCode": "34552332",
"price": 1000,
"currencyIsoCode4217": "RUB",
"discountedPrice": 700,
"clubDiscountedPrice": 665,
"discount": 30,
"clubDiscount": 5,
"techSizeName": "42",
"editableSizePrice": true
}
]
},
"error": false,
"errorText": "string"
}

Карантин

Получить товары в карантине

Возвращает информацию о товарах в карантине.

Если новая цена товара со скидкой будет минимум в 3 раза меньше старой, товар попадёт в карантин и будет продаваться по старой цене. Ошибка об этом будет в ответах методов состояний загрузок.

Вы можете изменить цену или скидку с помощью API либо вывести товар из карантина в личном кабинете.

Для товаров с поразмерной установкой цен карантин не применяется

Authorizations:

HeaderApiKey

query Parameters

limit required	integer <uint> Example: limit=10 Сколько элементов вывести на одной странице (пагинация). Максимум 1 000 элементов
offset	integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные

Responses

Response Schema: application/json

	object
error	boolean Флаг ошибки
errorText	string Текст ошибки

Response samples

200
400
401
422
429

Content type

application/json

{"data": {"quarantineGoods": [{"nmID": 206025152,
"sizeID": null,
"techSizeName": "",
"currencyIsoCode4217": "RUB",
"newPrice": 134,
"oldPrice": 4000,
"newDiscount": 25,
"oldDiscount": 25,
"priceDiff": -2899.5
}
]
},
"error": false,
"errorText": ""
}

Календарь акций

С помощью этих методов можно получать информацию об акциях и принимать в них участие.
Максимум 10 запросов за 6 секунд суммарно для всех методов

Список акций

Возвращает список акций с датами и временем проведения

Authorizations:

HeaderApiKey

query Parameters

startDateTime required	string <RFC3339> Example: startDateTime=2023-09-01T00:00:00Z Начало периода, формат `YYYY-MM-DDTHH:MM:SSZ`
endDateTime required	string <RFC3339> Example: endDateTime=2024-08-01T23:59:59Z Конец периода, формат `YYYY-MM-DDTHH:MM:SSZ`
allPromo required	boolean Default: false Показать акции: `false` — доступные для участия `true` — все акции
limit	integer <uint> [ 1 .. 1000 ] Example: limit=10 Количество запрашиваемых акций
offset	integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные

Responses

Response Schema: application/json

object

Response samples

Content type

application/json

{"data": {"promotions": [{"id": 123,
"name": "скидки",
"startDateTime": "2023-06-05T21:00:00Z",
"endDateTime": "2023-06-05T21:00:00Z",
"type": "regular"
}
]
}
}

Детальная информация по акциям

Возвращает подробную информацию о выбранных акциях

Authorizations:

HeaderApiKey

query Parameters

promotionIDs

required

string [ 1 .. 100 ] items unique

Example: promotionIDs=1&promotionIDs=3&promotionIDs=64

ID акций, по которым нужно вернуть информацию

Responses

Response Schema: application/json

object

Response samples

Content type

application/json

{"data": {"promotions": [{"id": 123,
"name": "ХИТЫ ГОДА",
"description": "В акции принимают участие самые популярные товары 2023 года. Карточки товаров будут выделены плашкой «ХИТ ГОДА», чтобы покупатели замечали эти товары среди других. Также они будут размещены под баннерами на главной странице и примут участие в PUSH-уведомлениях. С ценами для вступления в акцию вы можете ознакомиться ниже.",
"advantages": ["Плашка",
"Баннер",
"Топ выдачи товаров"
],
"startDateTime": "2023-06-05T21:00:00Z",
"endDateTime": "2023-06-05T21:00:00Z",
"inPromoActionLeftovers": 45,
"inPromoActionTotal": 123,
"notInPromoActionLeftovers": 3,
"notInPromoActionTotal": 10,
"participationPercentage": 10,
"type": "auto",
"exceptionProductsCount": 10,
"ranging": [{"condition": "productsInPromotion",
"participationRate": 10,
"boost": 7
},
{"condition": "calculateProducts",
"participationRate": 20,
"boost": 17
},
{"condition": "allProducts",
"participationRate": 35,
"boost": 30
}
]
}
]
}
}

Список товаров для участия в акции

Возвращает список товаров, подходящих для участия в акции.

Неприменимо для автоакций

Authorizations:

HeaderApiKey

query Parameters

promotionID required	integer Example: promotionID=1 ID акции
inAction required	boolean Default: false Example: inAction=true Участвует в акции: `true` — да `false` — нет
limit	integer <uint> [ 1 .. 1000 ] Example: limit=10 Количество запрашиваемых товаров
offset	integer <uint> >= 0 Example: offset=0 После какого элемента выдавать данные

Responses

Response Schema: application/json

object

Response samples

Content type

application/json

{"data": {"nomenclatures": [{"id": 162579635,
"inAction": true,
"price": 1500,
"currencyCode": "RUB",
"planPrice": 1000,
"discount": 15,
"planDiscount": 34
}
]
}
}

Добавить товар в акцию

Создаёт загрузку товара в акцию.
Состояние загрузки можно проверить с помощью отдельных методов

Неприменимо для автоакций

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

object

Responses

Response Schema: application/json

object

Request samples

Payload

Content type

application/json

{"data": {"promotionID": 1,
"uploadNow": true,
"nomenclatures": [1,
3,
642
]
}
}

Response samples

Content type

application/json

{"data": {"alreadyExists": false,
"uploadID": 11
}
}

API цен и скидок

Установка цен и скидок

Установить цены и скидки

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Установить цены для размеров

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Установить скидки WB Клуба

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Состояния загрузок

Состояние обработанной загрузки

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Детализация обработанной загрузки

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Состояние необработанной загрузки

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Детализация необработанной загрузки

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Списки товаров

Получить товары

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Получить размеры товара

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Карантин

Получить товары в карантине

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Календарь акций

Список акций

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Детальная информация по акциям

Authorizations:

query Parameters

Responses

Response Schema: application/json

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required