API docs by Redocly

API цен и скидок

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

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

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

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

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

Content type
application/json
{
  • "data": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": false,
  • "errorText": ""
}

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

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

Authorizations:
HeaderApiKey
Request Body schema: application/json
required
Array of objects (SizeGoodsBody)

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

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

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

Responses

Response Schema: application/json
object
error
boolean

Флаг ошибки

errorText
string

Текст ошибки

Request samples

Content type
application/json
{
  • "data": [
    ]
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": false,
  • "errorText": ""
}

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

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

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

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": {
    },
  • "error": false,
  • "errorText": "The product is in quarantine"
}

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

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

Authorizations:
HeaderApiKey
query Parameters
limit
required
integer <uint>
Example: limit=10

Сколько элементов вывести на одной странице (пагинация). Максимум 1 000 элементов

offset
integer <uint>
Example: offset=0

Сколько элементов пропустить

uploadID
required
integer
Example: uploadID=146567

ID загрузки

Responses

Response Schema: application/json
object

Response samples

Content type
application/json
{
  • "data": {
    }
}

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

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

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": {
    },
  • "error": false,
  • "errorText": ""
}

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

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

Authorizations:
HeaderApiKey
query Parameters
limit
required
integer <uint>
Example: limit=10

Сколько элементов вывести на одной странице (пагинация). Максимум 1 000 элементов

offset
integer <uint>
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": {
    },
  • "error": false,
  • "errorText": ""
}

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

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

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

Authorizations:
HeaderApiKey
query Parameters
limit
required
integer <uint>
Example: limit=10

Сколько элементов вывести на одной странице (пагинация). Максимум 1 000 элементов

offset
integer <uint>
Example: offset=0

Сколько элементов пропустить

filterNmID
integer
Example: filterNmID=44589768676

Артикул Wildberries, по которому искать товар

Responses

Response Schema: application/json
object

Response samples

Content type
application/json
{
  • "data": {
    }
}

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

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

Authorizations:
HeaderApiKey
query Parameters
limit
required
integer <uint>
Example: limit=10

Сколько элементов вывести на одной странице (пагинация). Максимум 1 000 элементов

offset
integer <uint>
Example: offset=0

Сколько элементов пропустить

nmID
required
integer
Example: nmID=1

Артикул Wildberries

Responses

Response Schema: application/json
object
error
boolean

Флаг ошибки

errorText
string

Текст ошибки

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": false,
  • "errorText": "string"
}