Поиск

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

Работа с товарами включает в себя:

  1. Создание и редактирование карточек товаров: в том числе, получение категорий, предметов и характеристик товаров и загрузку медиафайлов.
  2. Настройку ярлыков для удобного поиска товаров.
  3. Установку цен и скидок.
  4. Управление остатками товаров и складами, если вы работаете по модели продаж со склада продавца.

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

Работа с товарами включает в себя:

  1. Создание и редактирование карточек товаров: в том числе, получение категорий, предметов и характеристик товаров и загрузку медиафайлов.
  2. Настройку ярлыков для удобного поиска товаров.
  3. Установку цен и скидок.
  4. Управление остатками товаров и складами, если вы работаете по модели продаж со склада продавца.

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

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

Для создания карточек товаров необходимо:

  1. Определить родительскую категорию, к которой будет относиться товар.
  2. Внутри категории выбрать предмет.
  3. Подобрать для каждого предмета характеристики товара. Характеристики Цвет, Пол, Страна производства, Сезон, Ставка НДС и ТНВЭД-код можно получить с помощью отдельных методов.

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

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

Метод предоставляет названия и ID всех родительских категорий для создания карточек товаров: например, Электроника, Бытовая химия, Рукоделие.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
locale
string
Example: locale=en

Язык поля ответа name:

  • ru — русский
  • en — английский
  • zh — китайский

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

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "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

Content type
application/json
{
  • "data": [
    ],
  • "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

Язык полей ответа subjectName и name:

  • ru — русский
  • en — английский
  • zh — китайский

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

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

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

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

Метод предоставляет возможные значения характеристики предмета Цвет.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
locale
string
Example: locale=en

Язык полей ответа subjectName и name:

  • ru — русский
  • en — английский
  • zh — китайский

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

Responses

Response samples

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

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

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

Метод предоставляет возможные значения характеристики предмета Пол.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
locale
string
Example: locale=en

Язык полей ответа subjectName и name:

  • ru — русский
  • en — английский
  • zh — китайский

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

Responses

Response samples

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

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

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

Метод предоставляет возможные значения характеристики предмета Страна производства.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
locale
string
Example: locale=en

Язык полей ответа subjectName и name:

  • ru — русский
  • en — английский
  • zh — китайский

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

Responses

Response samples

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

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

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

Метод предоставляет возможные значения характеристики предмета Сезон.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
locale
string
Example: locale=en

Язык полей ответа subjectName и name:

  • ru — русский
  • en — английский
  • zh — китайский

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

Responses

Response samples

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

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

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

Метод предоставляет возможные значения характеристики предмета Ставка НДС.

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
locale
required
string
Example: locale=ru

Язык полей ответа subjectName и name:

  • ru — русский
  • en — английский
  • zh — китайский

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

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

ТНВЭД-код{{ /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 — китайский

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

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "error": false,
  • "errorText": "",
  • "additionalErrors": null
}

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

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

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

  1. Проверьте лимиты для создания карточек товаров.
  2. Вы можете сгенерировать баркоды для карточек товаров. Но если вы создадите карточку товара без баркода, он будет сгенерирован автоматически. Либо вы можете использовать свой баркод.

Можно создавать карточки товаров:

  1. Объединёнными или необъединёнными.
  2. Объединёнными с уже существующими карточками товаров.

Объединить и разъединить карточки товаров можно через imtID — ID карточки в WB для объединения.

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

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

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

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

(freeLimits + paidLimits) - количество созданных карточек

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

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

Responses

Response samples

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

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

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

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

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
count
integer

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

Responses

Request samples

Content type
application/json
{
  • "count": 100
}

Response samples

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

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

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

Метод создаёт карточки товаров c указанием описаний и характеристик товаров.

Есть две формы запроса: для создания отдельных и объединённых карточек товаров.

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

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

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
Request Body schema: application/json
Array
subjectID
required
integer

ID предмета

required
Array of objects

Массив вариантов товара. В каждой карточке товара может быть не более 30 карточек товаров

Responses

Request samples

Content type
application/json
Example
[
  • {
    }
]

Response samples

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

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

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

Метод создаёт новые карточки товаров, объединяя их с существующими карточками.

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

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

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
Request Body schema: application/json
imtID
integer

imtID карточки товара, к которой добавляется карточка товара

Array of objects

Структура добавляемой карточки товара

Responses

Request samples

Content type
application/json
{
  • "imtID": 987654321,
  • "cardsToAdd": [
    ]
}

Response samples

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

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

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

После создания карточек товаров вы можете:

  1. Получать списки с подробной информацией об уже созданных карточках. Если вы не увидели карточку товара в списке, при её создании произошла ошибка.
  2. Объединять и разъединять созданные карточки.
  3. Редактировать данные карточки товара.
  4. Работать с корзиной: можно переносить карточки товаров в корзину и восстанавливать их.
  5. Получать списки карточек товаров в корзине.

Список карточек товаров{{ /content/v2/get/cards/list }}

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

Метод предоставляет список созданных карточек товаров.

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

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

  1. Сделайте первый запрос:
            {
              "settings": {                      
                "cursor": {
                  "limit": 100
                },
                "filter": {
                  "withPhoto": -1
                }
              }
            }
  2. Пройдите в конец полученного списка карточек товаров.
  3. Скопируйте из cursor две строки:
    • "updatedAt": "***"
    • "nmID": ***
  4. Вставьте скопированные строки в параметр запроса cursor.
  5. Повторите запрос.
  6. Повторяйте пункты со 2 по 5, пока поле 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

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

Response samples

Content type
application/json
{}

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

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

Метод предоставляет список карточек товаров, при создании или редактировании которых произошли ошибки, с описанием этих ошибок.

Чтобы убрать карточку товара из списка, нужно повторно сделать запрос на создание или редактирование карточки товара с исправленными ошибками.
Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
locale
string
Example: locale=en

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

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

Responses

Response samples

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

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

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

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

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

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

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

Максимум 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

Content type
application/json
[
  • {
    }
]

Response samples

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

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

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

Метод объединяет и разъединяет карточки товаров. Карточки товаров считаются объединёнными, если у них одинаковый imtID.

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

Если вы разъедините одновременно несколько карточек товаров, эти карточки объединятся в одну и получат новый imtID.
Чтобы присвоить каждой карточке товара уникальный imtID, необходимо передавать по одной карточке товара за запрос.

Максимальный размер запроса 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

Content type
application/json
Example
{
  • "targetIMT": 123,
  • "nmIDs": [
    ]
}

Response samples

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

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

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

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

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

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

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
nmIDs
Array of integers

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

Responses

Request samples

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

Response samples

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

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

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

Метод восстанавливает карточки товаров из корзины.

Карточка товара сохраняет тот же imtID, что был присвоен ей при перемещении в корзину.
Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
nmIDs
Array of integers

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

Responses

Request samples

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

Response samples

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

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

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

Метод предоставляет список карточек товаров в корзине.

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

  1. Сделайте первый запрос:
            {
              "settings": {                      
                "cursor": {
                  "limit": 100
                },
                "filter": {
                  "withPhoto": -1
                }
              }
            }
  2. Пройдите в конец полученного списка карточек товаров.
  3. Скопируйте из cursor две строки:
    • "updatedAt": "***"
    • "nmID": ***
  4. Вставьте скопированные строки в параметр запроса cursor.
  5. Повторите запрос.
  6. Повторяйте пункты со 2 по 5, пока поле 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

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

Response samples

Content type
application/json
{}

Медиафайлы

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

Управлять медиафайлами в карточке товара можно двумя способами:

  1. Через прямую загрузку одного медиафайла в карточку товара.
  2. Через перечисление ссылок на медиафайлы. В этом случае новые медиафайлы заменяют медиафайлы, уже добавленные в карточку товара.

Загрузить медиафайл{{ /content/v3/media/file }}

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

Метод загружает и добавляет один медиафайл к карточке товара.

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

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

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

  • максимум одно видео для одной карточки товара
  • максимальный размер — 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

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

Загрузить медиафайлы по ссылкам{{ /content/v3/media/save }}

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

Метод загружает набор медиафайлов в карточку товара через указание ссылок в запросе.

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

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

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

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

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

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

Максимум 100 запросов в минуту для всех методов категории Контент на один аккаунт продавца
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
nmId
integer

Артикул WB

data
Array of strings

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

Responses

Request samples

Response samples

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

Ярлыки

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

Ярлыки позволяют быстро фильтровать и искать карточки товаров в личном кабинете. В разделе вам доступны методы:

  1. Получения списка ярлыков продавца. Эти ярлыки можно использовать в карточках товаров.
  2. Добавления новых ярлыков.
  3. Изменения существующих ярлыков.
  4. Удаления ярлыков.
  5. Управления ярлыками в карточке товара: добавления или удаления ярлыка.

Список ярлыков{{ /content/v2/tags }}

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

Метод предоставляет список и характеристики всех ярлыков продавца для группировки и фильтрации товаров.

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

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "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

Content type
application/json
{
  • "color": "D1CFD7",
  • "name": "Sale"
}

Response samples

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

Content type
application/json
{
  • "color": "D1CFD7",
  • "name": "Sale"
}

Response samples

Content type
application/json
Example

Успешно

{
  • "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

Content type
application/json
Example

Успешно

{
  • "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

Content type
application/json
{
  • "nmID": 179891389,
  • "tagsIDs": [
    ]
}

Response samples

Content type
application/json

Успешно

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

Цены и скидки

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

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

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

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

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

  • 3 — обработана. В товарах нет ошибок, цены и скидки обновились.
  • 4 — отменена
  • 5 — обработана, но в товарах есть ошибки. Ошибки можно получить с помощью метода детализации обработанной загрузки. Для товаров без ошибок цены и скидки обновились.
  • 6 — обработана, но во всех товарах есть ошибки. Ошибки можно получить с помощью метода детализации обработанной загрузки.
У загрузки не может быть статуса 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

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

Response samples

Content type
application/json
{
  • "data": {
    },
  • "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 размеров.

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

Responses

Request samples

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

Response samples

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

Установить скидки WB Клуба{{ /api/v2/upload/task/club-discount }}

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

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

Получить информацию о процессе установки цен и скидок можно с помощью методов состояния и детализации обработанной загрузки.
Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
Array of objects (ClubDisc)

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

Responses

Request samples

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

Response samples

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

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

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

Метод предоставляет информацию об обработанной загрузке цен и скидок.

Обработанная загрузка — это загрузка цен и скидок для товаров и размеров товаров, а также скидок WB Клуба.
Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
uploadID
required
integer
Example: uploadID=146567

ID загрузки

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "error": false,
  • "errorText": "The product is in quarantine"
}

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

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

Метод предоставляет информацию о товарах и об ошибках в товарах в обработанной загрузке.

Обработанная загрузка — это загрузка цен и скидок для товаров и размеров товаров, а также скидок WB Клуба.
Максимум 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

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

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

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

Метод предоставляет информацию про загрузку скидок в обработке.

Необработанная загрузка — это загрузка скидок для календаря акций. Такие скидки применятся к товарам только в момент начала акции.
Максимум 10 запросов за 6 секунд для всех методов категории Цены и скидки на один аккаунт продавца
Authorizations:
HeaderApiKey
query Parameters
uploadID
required
integer
Example: uploadID=146567

ID загрузки

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "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

Content type
application/json
{
  • "data": {
    },
  • "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

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

Получить размеры товара{{ /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

Content type
application/json
{
  • "data": {
    },
  • "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

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

Склады продавца

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

На складах продавца доступно управление остатками товаров.

Чтобы работать со складами продавца, вы можете:

  1. Получать список складов WB, если вы работаете по схеме FBS (Fulfillment by Seller). Это нужно, чтобы связывать склады WB и склады продавца при создании и редактировании склада.
  2. Получать список складов продавца, если работаете по модели продаж со склада продавца.
  3. Создавать склады продавца.
  4. Обновлять склады продавца.
  5. Удалять склады продавца.

Получить список складов WB{{ /api/v3/offices }}

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

Метод предоставляет список всех складов WB для привязки к складам продавца. Предназначен для определения складов WB, чтобы сдавать готовые заказы по схеме FBS (Fulfillment by Seller).

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

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Получить список складов продавца{{ /api/v3/warehouses }}

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

Метод предоставляет список всех складов продавца. Может использоваться для получения остатков товаров.

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

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Создать склад продавца{{ /api/v3/warehouses }}

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

Метод создаёт склад продавца для работы с остатками товаров. Нужно привязать к складу продавца склад WB для работы по схеме FBS (Fulfillment by Seller).

Нельзя привязывать склад WB, который уже используется
Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
name
required
string [ 1 .. 200 ] characters

Имя склада продавца

officeId
required
integer >= 1

ID склада WB

Responses

Request samples

Content type
application/json
{
  • "name": "Склад Коледино",
  • "officeId": 15
}

Response samples

Content type
application/json
{
  • "id": 2
}

Обновить склад продавца{{ /api/v3/warehouses/{warehouseId} }}

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

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

Нельзя привязывать склад WB, который уже используется
Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца
Authorizations:
HeaderApiKey
path Parameters
warehouseId
required
integer <int64>
Example: 1

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

Request Body schema: application/json
required
name
required
string [ 1 .. 200 ] characters

Имя склада продавца

officeId
required
integer >= 1

ID склада WB

Responses

Request samples

Content type
application/json
{
  • "name": "Склад Коледино",
  • "officeId": 15
}

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectRequestBody",
  • "message": "Некорректное тело запроса"
}

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

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

Метод удаляет склад продавца из списка складов.

Максимум 300 запросов в минуту для всех методов категории Маркетплейс на один аккаунт продавца
Authorizations:
HeaderApiKey
path Parameters
warehouseId
required
integer <int64>
Example: 1

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

Responses

Response samples

Content type
application/json
{
  • "title": "unauthorized",
  • "detail": "token problem; token is malformed: could not base64 decode signature: illegal base64 data at input byte 84",
  • "code": "07e4668e--a53a3d31f8b0-[UK-oWaVDUqNrKG]; 03bce=277; 84bd353bf-75",
  • "requestId": "7b80742415072fe8b6b7f7761f1d1211",
  • "origin": "s2s-api-auth-catalog",
  • "status": 401,
  • "statusText": "Unauthorized",
  • "timestamp": "2024-09-30T06:52:38Z"
}

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

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

Если вы работаете по модели продаж со склада продавца, через эти методы вы можете:

  1. Обновлять остатки товаров.
  2. Удалять остатки. После удаления остатки можно будет загрузить повторно.
  3. Проверять количество остатков.

Обновить остатки товаров{{ /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

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

Response samples

Content type
application/json
Example
{
  • "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

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

Response samples

Content type
application/json
Example
{
  • "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

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

Response samples

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