Работа с товарами (products)

Управление контентом, ценами и остатками

Работа с товарами

Управление контентом, ценами и остатками

Категории, предметы и характеристики

Для доступа к методам используйте токен для категории Контент

Родительские категории товаров{{ /content/v2/object/parent/all }}

Описание метода

Возвращает список всех родительских категорий товаров

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale

string

Example: locale=en

Параметр выбора языка (ru, en, zh) значений поля name. Не используется в песочнице

Responses

Response samples

200
400
401
403
429

Content type

application/json

{"data": [{"name": "Электроника",
"id": 479,
"isVisible": true
}
],
"error": false,
"errorText": "",
"additionalErrors": ""
}

Список предметов{{ /content/v2/object/all }}

Описание метода

Возвращает список всех доступных предметов, родительских категорий предметов и их ID

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

name	string Example: name=Носки Поиск по наименованию предмета (Носки), поиск работает по подстроке, искать можно на любом из поддерживаемых языков.
limit	integer Example: limit=1000 Количество подкатегорий (предметов), максимум 1 000
locale	string Example: locale=en Язык полей ответа (`ru`, `en`, `zh`). Не используется в песочнице
offset	integer Example: offset=5000 Номер позиции, с которой необходимо получить ответ
parentID	integer Example: parentID=1000 ID родительской категории предмета

Responses

Response samples

200
401
429

Content type

application/json

{"data": [{"subjectID": 2560,
"parentID": 479,
"subjectName": "3D очки",
"parentName": "Электроника"
},
{"subjectID": 1152,
"parentID": 858,
"subjectName": "3D-принтеры",
"parentName": "Оргтехника"
}
],
"error": false,
"errorText": "",
"additionalErrors": null
}

Характеристики предмета{{ /content/v2/object/charcs/{subjectId} }}

Описание метода

Возвращает список характеристик предмета по его ID

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

path Parameters

subjectId

required

integer

Example: 105

ID предмета

query Parameters

locale

string

Example: locale=en

Параметр выбора языка (ru, en, zh) значений полей subjectName, name. Не используется в песочнице

Responses

Response samples

200
400
401
403
429

Content type

application/json

{"data": [{"charcID": 54337,
"subjectName": "Кроссовки",
"subjectID": 105,
"name": "Размер",
"required": false,
"unitName": "см",
"maxCount": 0,
"popular": false,
"charcType": 4
}
],
"error": false,
"errorText": "",
"additionalErrors": null
}

Цвет{{ /content/v2/directory/colors }}

Описание метода

Возвращает значения характеристики Цвет

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale

string

Example: locale=en

Параметр выбора языка (ru, en, zh) значений полей subjectName, name. Не используется в песочнице

Responses

Response samples

200
400
401
403
429

Content type

application/json

{"data": [{"name": "персиковый мелок",
"parentName": "оранжевый"
}
],
"error": false,
"errorText": "",
"additionalErrors": ""
}

Пол{{ /content/v2/directory/kinds }}

Описание метода

Возвращает значения характеристики Пол

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale

string

Example: locale=en

Параметр выбора языка (ru, en, zh) значений полей subjectName, name. Не используется в песочнице

Responses

Response samples

200
400
401
403
429

Content type

application/json

{"data": ["Мужской"
],
"error": false,
"errorText": "",
"additionalErrors": ""
}

Страна производства{{ /content/v2/directory/countries }}

Описание метода

Возвращает значения характеристики Страна производства

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale

string

Example: locale=en

Параметр выбора языка (ru, en, zh) значений полей subjectName, name. Не используется в песочнице

Responses

Response samples

200
400
401
403
429

Content type

application/json

{"data": [{"name": "Афганистан",
"fullName": "Исламский Эмират Афганистан"
}
],
"error": false,
"errorText": "",
"additionalErrors": ""
}

Сезон{{ /content/v2/directory/seasons }}

Описание метода

Возвращает значения характеристики Сезон

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale

string

Example: locale=en

Параметр выбора языка (ru, en, zh) значений полей subjectName, name. Не используется в песочнице

Responses

Response samples

200
400
401
403
429

Content type

application/json

{"data": ["демисезон"
],
"error": false,
"errorText": "",
"additionalErrors": ""
}

ТНВЭД-код{{ /content/v2/directory/tnved }}

Описание метода

Возвращает список ТНВЭД-кодов по ТНВЭД-коду и ID предмета

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

subjectID required	integer Example: subjectID=105 ID предмета
search	integer Example: search=6106903000 Поиск по ТНВЭД-коду. Работает только в паре с subjectID
locale	string Example: locale=en Язык (`ru`, `en`, `zh`) для значений полей `subjectName`, `name`. Не используется в песочнице

Responses

Response samples

200
400
401
403
429

Content type

application/json

{"data": [{"tnved": "6106903000",
"isKiz": true
}
],
"error": false,
"errorText": "",
"additionalErrors": null
}

Ставка НДС{{ /content/v2/directory/vat }}

Описание метода

Возвращает значения характеристики Ставка НДС

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale

required

string

Example: locale=ru

Язык значения элементов data (ru, en, zh). Не используется в песочнице

Responses

Response samples

200
400
401
403
429

Content type

application/json

{"data": ["0",
"10",
"20",
"Без НДС",
"13"
],
"error": false,
"errorText": "",
"additionalErrors": null
}

Карточки товаров

Для доступа к методам используйте токен для категории Контент

Создание и редактирование карточки товара

Лимиты карточек товаров{{ /content/v2/cards/limits }}

Описание метода

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

Формула для получения количества карточек, которые можно создать: (freeLimits + paidLimits) - количество созданных карточек.

Созданными считаются карточки, которые можно получить через методы список номенклатур и список номенклатур в корзине

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Responses

Response samples

200
401
403
429

Content type

application/json

{"data": {"freeLimits": 1500,
"paidLimits": 10
},
"error": false,
"errorText": "",
"additionalErrors": null
}

Создание карточек товаров{{ /content/v2/cards/upload }}

Описание метода

Создаёт карточки товаров. В карточке можно указать описание и характеристики товара.
Как создать карточку:

Получите список всех категорий
Получите список доступных предметов (подкатегорий)
Получите характеристики, которые можно задавать в этом предмете (подкатегории). Для характеристик Цвет, Пол, Страна производства, Сезон, Ставка НДС, ТНВЭД используйте значения из раздела.
Отправьте запрос. Если ответ Успешно (200), но какие-то карточки не создались, получите список несозданных номенклатур.

Габариты товаров можно указать только в сантиметрах.
В одном запросе можно создать максимум 100 карточек (imtID) и по 30 номенклатур (nmID) в каждой. Максимальный размер запроса 10 Мб
Создание карточки товара происходит асинхронно. После отправки запрос становится в очередь на обработку.

Карточка считается созданной, если создалась хотя бы одна номенклатура в ней. Если во время обработки запроса в очереди получены ошибки, то номенклатура считается ошибочной.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json

Array

subjectID required	integer ID предмета
required	Array of objects Массив вариантов товара. В каждой карточке товара может быть не более 30 номенклатур

Responses

Request samples

Payload

Content type

application/json

Example

creatingOneCard

[{"subjectID": 105,
"variants": [{"vendorCode": "АртикулПродавца",
"title": "Наименование товара",
"description": "Описание товара",
"brand": "Бренд",
"dimensions": {"length": 55,
"width": 40,
"height": 15
},
"characteristics": [{"id": 12,
"value": ["Turkish flag"
]
},
{"id": 25471,
"value": 1200
},
{"id": 14177449,
"value": ["red"
]
}
],
"sizes": [{"techSize": "S",
"wbSize": "42",
"price": 5000,
"skus": ["88005553535"
]
}
]
}
]
}
]

Response samples

200
400
401
413
429

Content type

application/json

{"data": null,
"error": false,
"errorText": "",
"additionalErrors": { }
}

Редактирование карточек товаров{{ /content/v2/cards/update }}

Описание метода

Обновляет карточки товаров. Данные для обновления можно получить через список номенклатур.

Карточка товара перезаписывается при обновлении. Поэтому в запросе нужно передать все параметры карточки, в том числе те, которые вы не собираетесь обновлять.

Габариты товаров можно указать только в сантиметрах.

Нельзя редактировать или удалять баркоды, но можно добавить баркод к существующему. Параметры photos, video и tags редактировать или удалять через этот метод нельзя.

Если ответ Успешно (200), но какие-то карточки обновились, получите список несозданных номенклатур.

В одном запросе можно отредактировать максимум 3000 номенклатур (nmID). Максимальный размер запроса 10 Мб

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json

Array

nmID required	integer Артикул WB
vendorCode required	string Артикул продавца
brand	string Бренд
title	string Наименование товара
description	string Описание товара. Максимальное количество символов зависит от категории товара. Стандарт — 2000, минимум — 1000, максимум — 5000. Подробно о правилах описания в Правилах заполнения карточки товара в разделе Инструкции на портале продавцов.
	object Габариты упаковки товара. Указывать в сантиметрах для любого товара.
	Array of objects Характеристики товара
required	Array of objects Массив размеров артикула. Для безразмерного товара все равно нужно передавать данный массив без параметров (wbSize и techSize), но с баркодом.

Responses

Request samples

Payload

Content type

application/json

[{"nmID": 11111111,
"vendorCode": "wbiz72wmro",
"brand": "",
"title": "Свитер женский оверсайз с горлом",
"description": "12345",
"dimensions": {"length": 0,
"width": 0,
"height": 0
},
"characteristics": [{"id": 14177450,
"value": ["хлопок 50% акрил 50%"
]
},
{"id": 50,
"value": ["свободный крой"
]
}
],
"sizes": [{"chrtID": 12345678,
"techSize": "ONE SIZE",
"wbSize": "78-90",
"skus": ["123487653460134"
]
}
]
}
]

Response samples

Content type

application/json

{"data": null,
"error": false,
"errorText": "",
"additionalErrors": { }
}

Добавление номенклатур к карточкам товаров{{ /content/v2/cards/upload/add }}

Описание метода

Добавляет к карточкам товаров новые номенклатуры. Габариты товаров можно указать только в сантиметрах. Добавление номенклатуры к карточке товара происходит асинхронно. После отправки запрос становится в очередь на обработку. Если ответ Успешно (200), но какие-то карточки не создались, получите список несозданных номенклатур. Максимальный размер запроса 10 Мб

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json

imtID	integer `imtID` карточки товара, к которой добавляется номенклатура
	Array of objects Структура добавляемой номенклатуры

Responses

Request samples

Payload

Content type

application/json

{"imtID": 987654321,
"cardsToAdd": [{"vendorCode": "myVariant1",
"title": "Наименование товара",
"description": "Описание товара",
"brand": "Бренд",
"dimensions": {"length": 55,
"width": 40,
"height": 15
},
"characteristics": [{"id": 12,
"value": ["Russian flag"
]
},
{"id": 25471,
"value": 1300
},
{"id": 14177449,
"value": ["blue"
]
}
],
"sizes": [{"skus": ["12345678"
]
}
]
},
{"vendorCode": "myVariant2",
"title": "Наименование товара",
"description": "Описание товаров",
"brand": "Бренд",
"dimensions": {"length": 55,
"width": 40,
"height": 15
},
"characteristics": [{"id": 12,
"value": ["Russian flag"
]
},
{"id": 25471,
"value": 1300
},
{"id": 14177449,
"value": ["blue"
]
}
],
"sizes": [{"skus": ["222222222222"
]
}
]
}
]
}

Response samples

200
400
401
413
429

Content type

application/json

{"data": null,
"error": false,
"errorText": "",
"additionalErrors": { }
}

Объединение и разъединение номенклатур{{ /content/v2/cards/moveNm }}

Описание метода

Объединяет и разъединяет номенклатуры в одной карточке товара.
Для объединения номенклатур отправьте список номенклатур с указанием ID карточки товара в теле запроса. В одной карточке можно объединять не более 30 номенклатур.
Для удаления номенклатуры из карточки товара отправьте номенклатуру без указания ID карточки в теле запроса. Для этой номенклатуры создастся новая карточка.
Если вы удалите из карточки товара сразу несколько номенклатур, все удаленные номенклатуры объединятся в одной новой карточке товара.
Чтобы присвоить каждой номенклатуре уникальную карточку товара, необходимо передавать по одной номенклатуре за запрос.
Максимальный размер запроса 10 Мб

Объединить можно только номенклатуры с одинаковыми предметами.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json

One of

targetIMT required	integer Существующий у продавца `imtID`, под которым необходимо объединить номенклатуры
nmIDs required	Array of integers `nmID`, которые необходимо объединить (максимум 30)

Responses

Request samples

Payload

Content type

application/json

Example

requestMoveNmsImtConn

{"targetIMT": 123,
"nmIDs": [837459235,
828572090
]
}

Response samples

Content type

application/json

{"data": null,
"error": false,
"errorText": "",
"additionalErrors": { }
}

Генерация баркодов{{ /content/v2/barcodes }}

Описание метода

Генерирует массив уникальных баркодов для создания размера номенклатуры в карточке товара

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

count

integer

Кол-во баркодов которые надо сгенерировать, максимальное доступное количество баркодов для генерации - 5 000

Responses

Request samples

Payload

Content type

application/json

{"count": 100
}

Response samples

200
401
403
429

Content type

application/json

{"data": ["5032781145187"
],
"error": false,
"errorText": "",
"additionalErrors": ""
}

Добавить медиафайлы{{ /content/v3/media/file }}

Описание метода

Добавляет один медиафайл для товара (номенклатуры).

Требования к изображениям:

максимум изображений для одного товара (номенклатуры) — 30
минимальное разрешение — 700x900 px
максимальный размер — 32 Мб
минимальное качество — 65%
форматы — JPG, PNG, BMP, GIF (статичные), WebP

Требования к видео:

максимум 1 видео для одного товара (номенклатуры)
максимальный размер — 50 Мб
форматы — MOV, MP4

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

header Parameters

X-Nm-Id

required

string

Example: 213864079

Артикул WB

X-Photo-Number

required

integer

Example: 2

Номер медиафайла на загрузку, начинается с 1. При загрузке видео всегда указывайте 1.

Чтобы добавить изображение к уже загруженным, номер медиафайла должен быть больше количества уже загруженных медиафайлов.

Request Body schema: multipart/form-data
required

uploadfile

string <binary>

Responses

Response samples

200
400
401
403
429

Content type

application/json

{"data": { },
"error": false,
"errorText": "",
"additionalErrors": null
}

Изменить медиафайлы{{ /content/v3/media/save }}

Описание метода

Меняет набор медиафайлов для товара (номенклатуры).

Новые медиафайлы (data) полностью заменяют старые (mediaFiles). Чтобы добавить новые медиафайлы, укажите ссылки и на новые, и на старые медиафайлы.

Требования к изображениям:

максимум изображений для одного товара (номенклатуры) — 30
минимальное разрешение — 700×900 px
максимальный размер — 32 Мб
минимальное качество — 65%
форматы — JPG, PNG, BMP, GIF (статичные), WebP

Требования к видео:

максимум 1 видео для одного товара (номенклатуры)
максимальный размер — 50 Мб
форматы — MOV, MP4

Если хотя бы одно изображение в запросе не соответствует требованиям, то даже при успешном ответе ни одно изображение не загрузится

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

nmId	integer Артикул WB
data	Array of strings Ссылки на изображения в том порядке, в котором они будут на карточке товара

Responses

Request samples

Payload

Content type

application/json

{"nmId": 213864079,
"data": ["https://basket-stage-02.wildberries.ru/vol669/part66964/66964260/images/big/2.jpg"
]
}

Response samples

Content type

application/json

{"data": { },
"error": false,
"errorText": "",
"additionalErrors": null
}

Номенклатуры

Для доступа к методам используйте токен для категории Контент

Получение информации о созданных карточках товаров, номенклатурах и размерах

Список номенклатур{{ /content/v2/get/cards/list }}

Описание метода

Метод доступен по токену с категорией Продвижение

Возвращает список созданных номенклатур.

Чтобы получить больше 100 номенклатур, необходимо воспользоваться пагинацией:

Сделать первый запрос:

        {
          "settings": {                      
            "cursor": {
              "limit": 100
            },
            "filter": {
              "withPhoto": -1
            }
          }
        }

Пройти в конец полученного списка номенклатур, скопировать из cursor две строки:
- "updatedAt": "***"
- "nmID": ***
Вставить скопированные строки в cursor запроса, повторить запрос.
Повторять пункты 2 и 3, пока total в ответе не станет меньше чем limit в запросе. Это будет означать, что вы получили все карточки.

В ответе метода не будет карточек, находящихся в корзине. Получить такие карточки можно через отдельный метод.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale

string

Example: locale=ru

Язык для перевода полей ответа name, value и object: ru - русский, en - английский, zh - китайский.

Не используется в песочнице.

Request Body schema: application/json
required

object

Настройки

Responses

Request samples

Payload

Content type

application/json

{"settings": {"sort": {"ascending": false
},
"filter": {"textSearch": "",
"allowedCategoriesOnly": true,
"tagIDs": [ ],
"objectIDs": [ ],
"brands": [ ],
"imtID": 0,
"withPhoto": -1
},
"cursor": {"limit": 11
}
}
}

Response samples

200
400
401
403
429

Content type

application/json

{"cards": [{"nmID": 12345678,
"imtID": 123654789,
"nmUUID": "01bda0b1-5c0b-736c-b2be-d0a6543e9be",
"subjectID": 7771,
"subjectName": "AKF системы",
"vendorCode": "wb7f6mumjr1",
"brand": "",
"title": "",
"photos": [{"big": "https://basket-10.wbbasket.ru/vol1592/part159206/159206280/images/big/1.webp",
"c246x328": "https://basket-10.wbbasket.ru/vol1592/part159206/159206280/images/c246x328/1.webp",
"c516x688": "https://basket-10.wbbasket.ru/vol1592/part159206/159206280/images/c516x688/1.webp",
"square": "https://basket-10.wbbasket.ru/vol1592/part159206/159206280/images/square/1.webp",
"tm": "https://basket-10.wbbasket.ru/vol1592/part159206/159206280/images/tm/1.webp"
}
],
"video": "https://videonme-basket-12.wbbasket.ru/vol137/part22557/225577433/hls/1440p/index.m3u8",
"dimensions": {"length": 0,
"width": 0,
"height": 0,
"isValid": false
},
"characteristics": [{"id": 14177449,
"name": "Цвет",
"value": ["красно-сиреневый"
]
}
],
"sizes": [{"chrtID": 316399238,
"techSize": "0",
"skus": ["987456321654"
]
}
],
"tags": [{"id": 592569,
"name": "Популярный",
"color": "D1CFD7"
}
],
"createdAt": "2023-12-06T11:17:00.96577Z",
"updatedAt": "2023-12-06T11:17:00.96577Z"
}
],
"cursor": {"updatedAt": "2023-12-06T11:17:00.96577Z",
"nmID": 123654123,
"total": 1
}
}

Список несозданных номенклатур с ошибками{{ /content/v2/cards/error/list }}

Описание метода

Возвращает список номенклатур и список ошибок создания карточки товара

Чтобы убрать номенклатуру из списка ошибок, нужно повторно сделать запрос на создание карточки товара с исправленными ошибками.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale

string

Example: locale=en

Параметр выбора языка значений полей ответа (для которых предусмотрена мультиязычность).

Не используется в песочнице.

Responses

Response samples

200
400
401
403
429

Content type

application/json

{"data": [{"object": "Блузки",
"vendorCode": "6000000001",
"updateAt": "2022-06-15T14:37:13Z",
"errors": ["Поля Рос. размер, Размер обязательны для заполнения"
],
"objectID": 41
}
],
"error": false,
"errorText": "",
"additionalErrors": ""
}

Перенос номенклатуры в корзину{{ /content/v2/cards/delete/trash }}

Описание метода

Переносит номенклатуру в корзину. При этом карточка товара не удаляется.

При переносе номенклатуры в корзину данная номенклатура выходит из карточки товара, то есть ей присваивается новый imtID.

Карточка товара удаляется автоматически, если лежит в корзине больше 30 дней. Очистка корзины происходит каждую ночь по московскому времени

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

Array

nmIDs

Array of integers

Артикул WB (max. 1000)

Responses

Request samples

Payload

Content type

application/json

[{"nmIDs": [987654321,
123456789
]
}
]

Response samples

200
400
401
403
429

Content type

application/json

{"data": null,
"error": false,
"errorText": "",
"additionalErrors": { }
}

Восстановление номенклатуры из корзины{{ /content/v2/cards/recover }}

Описание метода

Восстанавливает номенклатуру из корзины

Номенклатура не возвращается к изначальной карточке товара при восстановлении. Номенклатура сохраняет тот же imtID, что был присвоен ей при перемещении в корзину.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

Array

nmIDs

Array of arrays

Артикул WB (max. 1000)

Responses

Request samples

Payload

Content type

application/json

[{"nmIDs": [123456789,
987654321
]
}
]

Response samples

200
400
401
403
429

Content type

application/json

{"data": null,
"error": false,
"errorText": "",
"additionalErrors": { }
}

Список номенклатур в корзине{{ /content/v2/get/cards/trash }}

Описание метода

Метод доступен по токену с категорией Продвижение

Возвращает список номенклатур в корзине.

Чтобы получить больше 100 номенклатур, необходимо воспользоваться пагинацией.

Сделать первый запрос:

        {
          "settings": {                      
            "cursor": {
              "limit": 100
            }
          }
        }

Пройти в конец полученного списка номенклатур, скопировать из cursor две строки:
- "trashedAt": "***"
- "nmID": ***
Вставить скопированные строки в cursor запроса, повторить запрос.
Повторять пункты 2 и 3, пока total в ответе не станет меньше чем limit в запросе. Это будет означать, что вы получили все карточки.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale

string

Enum: "ru" "en" "zh"

Язык полей ответа name, value и object: ru, en, zh.

Не используется в песочнице

Request Body schema: application/json
required

object

Настройки

Responses

Request samples

Payload

Content type

application/json

{"settings": {"sort": {"ascending": false
},
"filter": {"textSearch": ""
},
"cursor": {"limit": 11
}
}
}

Response samples

200
400
401
403
429

Content type

application/json

{"cards": [{"nmID": 1234567,
"vendorCode": "wb5xsy5ftj",
"subjectID": 1436,
"subjectName": "Ведра хозяйственные",
"photos": [{"big": "https://basket-10.wbbasket.ru/vol1592/part159206/159206280/images/big/1.webp",
"c246x328": "https://basket-10.wbbasket.ru/vol1592/part159206/159206280/images/c246x328/1.webp",
"c516x688": "https://basket-10.wbbasket.ru/vol1592/part159206/159206280/images/c516x688/1.webp",
"square": "https://basket-10.wbbasket.ru/vol1592/part159206/159206280/images/square/1.webp",
"tm": "https://basket-10.wbbasket.ru/vol1592/part159206/159206280/images/tm/1.webp"
}
],
"video": "https://videonme-basket-12.wbbasket.ru/vol137/part22557/225577433/hls/1440p/index.m3u8",
"sizes": [{"chrtID": 111111111,
"techSize": "0",
"skus": ["xxxxxxxxxxxx"
]
}
],
"dimensions": {"length": 0,
"width": 0,
"height": 0,
"isValid": false
},
"createdAt": "2023-12-05T14:55:09.323462Z",
"trashedAt": "2023-12-06T10:57:42.193028Z"
}
],
"cursor": {"trashedAt": "2023-12-06T10:57:42.193028Z",
"nmID": 194128521,
"total": 1
}
}

Список тегов{{ /content/v2/tags }}

Описание метода

Возвращает список тегов продавца

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Responses

Response samples

200
401
403
429

Content type

application/json

{"data": [{"id": 1,
"color": "D1CFD7",
"name": "Sale"
}
],
"error": false,
"errorText": "",
"additionalErrors": ""
}

Создание тега{{ /content/v2/tag }}

Описание метода

Создает один тег. Можно создать максимум 15 тегов для одного продавца. Максимальная длина тега 15 символов

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

color	string Цвет тега. Доступные цвета: `D1CFD7` - серый `FEE0E0` - красный `ECDAFF` - фиолетовый `E4EAFF` - синий `DEF1DD` - зеленый `FFECC7` - желтый
name	string Имя тега

Responses

Request samples

Payload

Content type

application/json

{"color": "D1CFD7",
"name": "Sale"
}

Response samples

200
400
401
403
429

Content type

application/json

Успешно

{"data": null,
"error": false,
"errorText": "",
"additionalErrors": null
}

Изменение тега{{ /content/v2/tag/{id} }}

Описание метода

Меняет данные тега: имя и цвет

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

path Parameters

id

required

integer

Example: 1

Числовой ID тега

Request Body schema: application/json
required

color	string Цвет тега
name	string Имя тега

Responses

Request samples

Payload

Content type

application/json

{"color": "D1CFD7",
"name": "Sale"
}

Response samples

200
400
401
403
429

Content type

application/json

Example

responseOK200

Успешно

{"data": null,
"error": false,
"errorText": "",
"additionalErrors": null
}

Удаление тега{{ /content/v2/tag/{id} }}

Описание метода

Удаляет тег

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

path Parameters

id

required

integer

Example: 1

Числовой ID тега

Responses

Response samples

200
400
401
403
429

Content type

application/json

Example

responseOK200

Успешно

{"data": null,
"error": false,
"errorText": "",
"additionalErrors": null
}

Управление тегами в карточке товара{{ /content/v2/tag/nomenclature/link }}

Описание метода

Добавляет или снимает теги в карточке товара. При снятии тега с карточки товара сам тег продавца не удаляется. К карточке можно добавить максимум 15 тегов

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

nmID

integer

Артикул WB

tagsIDs

Array of integers

Массив числовых ID тегов.
Что бы снять теги с карточки товара, необходимо передать пустой массив.
Чтобы добавить теги к уже имеющимся в карточке товара, необходимо в запросе передать новые теги и теги, которые уже есть в карточке товара.

Responses

Request samples

Payload

Content type

application/json

{"nmID": 179891389,
"tagsIDs": [123456
]
}

Response samples

200
400
401
403
429

Content type

application/json

Успешно

{"data": null,
"error": false,
"errorText": "",
"additionalErrors": null
}

Цены и скидки

Для доступа к методам используйте токен для категории Цены и скидки

С помощью этих методов можно устанавливать цены и скидки.

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

Статусы загрузки:

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

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

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

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

Установить цены и скидки{{ /api/v2/upload/task }}

Описание метода

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

Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

Array of objects (Goods)

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

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

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

Responses

Request samples

Payload

Content type

application/json

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

Response samples

200
208
400
401
429

Content type

application/json

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

Установить цены для размеров{{ /api/v2/upload/task/size }}

Описание метода

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

Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

Array of objects (SizeGoodsBody)

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

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

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

Responses

Request samples

Payload

Content type

application/json

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

Response samples

200
208
400
401
429

Content type

application/json

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

Состояние обработанной загрузки{{ /api/v2/history/tasks }}

Описание метода

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

Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

uploadID

required

integer

Example: uploadID=146567

ID загрузки

Responses

Response samples

200
400
401
429

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"
}

Детализация обработанной загрузки{{ /api/v2/history/goods/task }}

Описание метода

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

Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца

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 samples

200
400
401
429

Content type

application/json

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

Состояние необработанной загрузки{{ /api/v2/buffer/tasks }}

Описание метода

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

Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

uploadID

required

integer

Example: uploadID=146567

ID загрузки

Responses

Response samples

200
400
401
429

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": ""
}

Детализация необработанной загрузки{{ /api/v2/buffer/goods/task }}

Описание метода

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

Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца

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 samples

200
400
401
429

Content type

application/json

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

Получить товары{{ /api/v2/list/goods/filter }}

Описание метода

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

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

Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца

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 Артикул WB, по которому искать товар

Responses

Response samples

200
400
401
429

Content type

application/json

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

Получить размеры товара{{ /api/v2/list/goods/size/nm }}

Описание метода

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

Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца

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 Артикул WB

Responses

Response samples

200
400
401
429

Content type

application/json

{"data": {"listGoods": [{"nmID": 123,
"sizeID": 98989887,
"vendorCode": "34552332",
"price": 25000,
"currencyIsoCode4217": "RUB",
"discountedPrice": 14250,
"discount": 43,
"techSizeName": "42",
"editableSizePrice": true
}
]
},
"error": false,
"errorText": "string"
}

Получить товары в карантине{{ /api/v2/quarantine/goods }}

Описание метода

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

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

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

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

Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

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

Responses

Response samples

200
400
401
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": ""
}

Остатки

Для доступа к методам используйте токен для категории Маркетплейс

Остатки на складах продавцов

Получить остатки товаров{{ /api/v3/stocks/{warehouseId} }}

Описание метода

Возвращает остатки товаров

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца

Authorizations:

HeaderApiKey

path Parameters

warehouseId

required

integer <int64>

Example: 1

ID склада продавца

Request Body schema: application/json
required

skus	Array of strings [ 1 .. 1000 ] items Массив баркодов

Responses

Request samples

Payload

Content type

application/json

{"skus": ["BarcodeTest123"
]
}

Response samples

Content type

application/json

{"stocks": [{"sku": "BarcodeTest123",
"amount": 10
}
]
}

Обновить остатки товаров{{ /api/v3/stocks/{warehouseId} }}

Описание метода

Обновляет остатки товаров

Имена параметров запроса не валидируются. При отправке некорректных имен вы получите успешный ответ (204), но остатки не обновятся.

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца

Authorizations:

HeaderApiKey

path Parameters

warehouseId

required

integer <int64>

Example: 1

ID склада продавца

Request Body schema: application/json

required

Array of objects [ 1 .. 1000 ] items

Массив баркодов товаров и их остатков

Responses

Request samples

Payload

Content type

application/json

{"stocks": [{"sku": "BarcodeTest123",
"amount": 10
}
]
}

Response samples

Content type

application/json

Example

IncorrectRequestBody

{"code": "IncorrectRequestBody",
"message": "Некорректное тело запроса"
}

Удалить остатки товаров{{ /api/v3/stocks/{warehouseId} }}

Описание метода

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

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

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца

Authorizations:

HeaderApiKey

path Parameters

warehouseId

required

integer <int64>

Example: 1

ID склада продавца

Request Body schema: application/json
required

skus	Array of strings [ 1 .. 1000 ] items Массив баркодов

Responses

Request samples

Payload

Content type

application/json

{"skus": ["BarcodeTest123"
]
}

Response samples

400
401
403
404
429

Content type

application/json

Example

IncorrectRequestBody

{"code": "IncorrectRequestBody",
"message": "Некорректное тело запроса"
}