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

Инструкция по работе с разделом

386

Дата публикации: 21.04.2025

Возможности раздела

С помощью API для работы с товарами вы можете:

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

Получать актуальную информацию о товарах благодаря автоматизированной обработке товаров.

Оптимизировать управление ассортиментом, если у вас много товаров.

Управление товарами

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

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

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

Чтобы создать карточку товара, соблюдайте порядок действий:

Шаг 1. Проверить доступные лимиты на создание карточек товаров

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

Лимит — это количество карточек, которое можно создать. Лимит зависит от оборота ваших товаров: чем выше оборот, тем больше можно создать карточек товаров.

Используйте метод GET /content/v2/cards/limits, чтобы получить бесплатные и платные лимиты. Так получится выяснить, сколько карточек товара вы можете создать.

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

POST /content/v2/get/cards/list — список карточек товаров
POST /content/v2/get/cards/trash — cписок карточек товаров в корзине. Карточки в корзине также учитываются в лимитах.

Итоговый лимит можно посчитать по формуле:

[Общее количество доступных вам лимитов (бесплатных и платных)] - [Общее количество существующих у вас карточек товаров (активных и в корзине)]

Если вас устраивает полученный лимит, переходите к следующему шагу.

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

Шаг 2. Получить ID предмета

Для создания карточки товара через API вам нужно знать ID предмета — subjectID. Предмет — это обобщенное название типа товара.

Также предмет — это подкатегория родительской категории товара. Например, для категории Обувь предметами могут быть Кеды, Кроссовки, Туфли и так далее. Предмет всегда будет связан с родительской категорией.

В Wildberries используется собственный справочник категорий и предметов. Это помогает:

покупателям — искать товары на маркетплейсе, сортировать результаты поиска.
продавцам — управлять списком товаров в магазине.

Чтобы получить subjectID, используйте методы:

GET /content/v2/object/parent/all — в ответе будут данные родительских категорий товаров. Выберите подходящую категорию и запомните её ID. В других методах вы будете использовать его как параметр parentID.
GET /content/v2/object/all — используйте parentID из предыдущего метода, чтобы получить данные предметов. В ответе выберите предмет, который будет обозначать ваш товар, и сохраните ID этого предмета — subjectID.

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

Характеристики товара зависят от ID предмета. Например, у одежды будет характеристика Размер со значениями 40, 42, 44 и так далее. У других предметов, например, обуви или украшений, значения характеристики Размер будут другими.

Укажите характеристики при создании или редактировании карточки товара в массиве characteristics. Вы можете получить характеристики через метод GET /content/v2/object/charcs/{subjectId}: размеры, материалы, единицы измерения и так далее. В параметре запроса subjectId используйте ID предмета из шага 2.

Значения характеристик могут быть любыми. Ограничение будет только в типе данных: символы, числа и так далее.

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

GET /content/v2/directory/colors — цвет
GET /content/v2/directory/kinds — пол
GET /content/v2/directory/countries — страна производства
GET /content/v2/directory/seasons — сезон
GET /content/v2/directory/vat — ставка НДС
GET /content/v2/directory/tnved — ТНВЭД-код

Шаг 4. Сгенерировать баркоды

Шаг необязателен: если вы забудете добавить баркод, он будет сгенерирован автоматически.

У каждого товара должна быть маркировка — штрихкод или баркод. Для маркировки товаров в Wildberries мы используем понятие баркод. С помощью баркода работники склада идентифицируют ваш товар.

Также баркод — это ID размера товара у продавца. Даже если формально товар безразмерный, у него все равно будет баркод.

Обычно баркоды уже нанесены на упаковку товара производителем. Если вы сами производитель или по какой-то причине на вашем товаре нет баркода от производителя, вам нужно сгенерировать баркод с помощью метода POST /content/v2/barcodes.

Шаг 5. Создать карточку товара

Карточки товаров можно создать с помощью метода POST /content/v2/cards/upload. При создании укажите ID предмета subjectId и характеристики товара, полученные на предыдущих шагах.

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

Каждая созданная карточка будет иметь поле imtID — ID объединённой карточки товара. Поле imtID нужно для редактирования, удаления и объединения карточек товаров. Получить imtID можно с помощью метода списка всех активных карточек товаров — POST /content/v2/get/cards/list.

Также поле imtID нужно, чтобы создавать карточки товаров, присоединяя их к уже существующим: с помощью метода POST /content/v2/cards/upload/add.

Шаг 6. Проверить ошибки

Если при создании карточки товара произойдет ошибка, вы получите код состояния 200 Успешно, но карточка товара не будет создана. Поэтому проверяйте ошибки с помощью метода — GET /content/v2/cards/error/list. Метод вернет список карточек товаров, при создании которых произошли ошибки, с описанием этих ошибок.

Исправьте полученные ошибки и повторите запрос.

Полезные ссылки в справочном центре:

Редактирование карточек товаров

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

Можно отредактировать до 3 000 карточек за один запрос.

Порядок действий:

Шаг 1. Выбрать карточку товара для редактирования и получить её данные

Выберите, какие карточки товаров вы хотите отредактировать. Получите:

Артикул карточки товара в WB — nmID
Артикул продавца карточки товара — vendorCode

Получите данные карточки с помощью метода списка существующих и не находящихся в корзине карточек товаров — POST /content/v2/get/cards/list.

Шаг 2. Изменить данные о товарах

Подготовьте новые объекты карточек товаров. Измените нужные параметры этих объектов.

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

GET /content/v2/directory/colors — цвет
GET /content/v2/directory/kinds — пол
GET /content/v2/directory/countries — страна производства
GET /content/v2/directory/seasons — сезон
GET /content/v2/directory/vat — ставка НДС
GET /content/v2/directory/tnved — ТНВЭД-код

Редактировать или удалять баркоды нельзя, но можно добавить дополнительный баркод к карточке товара. Новые баркоды можно сгенерировать с помощью метода POST /content/v2/barcodes.

Параметры карточки photos, video и tags нужно редактировать отдельно, через методы медиафайлов и ярлыков.

Шаг 3. Использовать метод редактирования карточек

Используйте метод редактирования карточек товаров POST /content/v2/cards/update, чтобы обновить карточки и добавить в них новые данные из шага 2.

Шаг 4. Проверить ошибки

Если при редактировании карточки товара произойдет ошибка, вы получитье код состояния 200 Успешно, но карточка товара не будет изменена. Поэтому проверяйте ошибки с помощью метода — GET /content/v2/cards/error/list. Метод вернет список карточек товаров, при создании которых произошли ошибки, с описанием этих ошибок.

Исправьте полученные ошибки и повторите запрос.

Объединение и разъединение карточек товаров

Товары одной категории, но разных цветов, объёмов или вкусов можно объединить в одну карточку. Например, платья одной модели в белом, сером и чёрном цветах.

Для покупателя это будет выглядеть как один товар с различными вариантами: удобно заказать несколько штук и выбрать подходящий в пункте выдачи. В таких карточках отзывы и рейтинг будут едиными для всех вариантов товара.

С помощью API можно объединять и разъединять карточки товаров.

Порядок действий для объединения карточек:

Шаг 1. Выбрать карточки товаров для объединения

Выберите, какие карточки товаров вы хотите объединить. Получите:

ID объединённой карточки товара — imtID
Артикул карточки товара в WB — nmID

Получите imtID и nmID с помощью метода списка существующих и не находящихся в корзине карточек товаров — POST /content/v2/get/cards/list.

Шаг 2. Объединить карточки товаров

Чтобы объединить карточки товаров, в запросе метода POST /content/v2/cards/moveNm укажите targetIMT — ID объединенной карточки товара imtID. Под этим imtID вы объедините карточки товаров.

Перечислите в параметре запроса nmIDs артикулы товаров WB nmID, которые нужно объединить.

Шаг 3. Проверить ошибки

Если при объединении карточек товаров произойдет ошибка, вы получитье код состояния 200 Успешно, но карточки товаров не будут объединены. Поэтому проверяйте ошибки с помощью метода — GET /content/v2/cards/error/list. Метод вернет список карточек товаров, при создании которых произошли ошибки, с описанием этих ошибок.

Исправьте полученные ошибки и повторите запрос.

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

Для разъединения карточек используйте тот же метод: POST /content/v2/cards/moveNm. Перечислите в параметре запроса nmIDs — артикулы товаров WB nmID. Эти nmID вы разъедините.

Для разъединенных карточек будут автоматически сгенерированы новые ID карточек товара — imtID.

Полезные ссылки в справочном центре:

Объединение карточек товаров

Медиафайлы

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

С помощью медиафайлов вы также сможете привлечь покупателей и повысить доверие к вашему товару. Если у вас есть собственная база данных товаров или ERP-система, вы можете синхронизировать её с маркетплейсом через API.

Порядок действий:

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

Для загрузки медиафайлов в карточку товара нужно знать артикул товара WB — nmID. Получите nmID через метод списка карточек товаров — POST /content/v2/get/cards/list.

Шаг 2. Загрузить медиафайлы в карточку товара

Загрузите фото или видео в карточку товара через методы:

POST /content/v3/media/file — загрузка файла. Если вам доступен исходный медиафайл, загрузите его в карточку товара напрямую.
POST /content/v3/media/save — добавление ссылки на файл. Если вы хотите использовать не сам медиафайл, а ссылку на него — например, с вашего хранилища или другого сайта, — используйте метод загрузки медиафайла по ссылке. Подойдут только ссылки, которые оканчиваются именем файла с его расширением — например, https://web-address/filename.png. Передавайте ссылки на изображения в том порядке, в котором вы хотите видеть их в карточке товара. Ссылка на видео может быть в любой позиции массива.

Обратите внимание:

При подготовке медиафайлов учитывайте требования к фото и видео на Wildberries.
Видео в карточке товара всегда будет отображаться первым.

Данные методы подходят как для загрузки новых медиафайлов в карточку товара, так и для замены уже существующих медиафайлов.

В методе прямой загрузки медиафайлов — POST /content/v3/media/file — файлы заменяются через их порядковые номера в карточке товара. Например, если в карточке нет второго изображения, то при загрузке нескольких изображений, второе будет добавлено в карточку как новое. Если в карточке уже есть второе изображение, оно будет заменено на то, которое вы загрузили.

Чтобы добавить новые медиафайлы через ссылки — POST /content/v3/media/save — укажите в запросе ссылки одновременно и на новые, и на существующие медиафайлы. Ссылки на изображения нужно передавать в том порядке, в котором вы хотите видеть их в карточке товара. Ссылка на видео может располагаться в любой позиции массива. Чтобы заменить или удалить текущий медиафайл, не указывайте ссылку на него в запросе.

Шаг 3. Проверить ошибки

Рекомендуем учитывать требования к видео и изображениям, которые указаны в описаниях методов. Если видео или хотя бы одно изображение в запросе не соответствует требованиям, то даже при ответе 200 Успешно ни один медиафайл не загрузится.

После загрузки медиафайлов рекомендуем получить список карточек товаров — POST /content/v2/get/cards/list — ещё раз. Метод вернет все данные по существующим карточкам товаров, в том числе информацию о фото photos и видео video.

Если какой-либо медиафайл не был добавлен в карточку или не обновился, нужно загрузить этот файл еще раз.

Полезные ссылки в справочном центре:

Ярлыки

Ярлыки или теги — это текстовые метки или ключевые слова. С помощью ярлыков вы можете группировать и фильтровать карточки товаров. Например, можно разделить сезонные товары или добавить, например, ярлык Архив для товаров, которые больше не продаются.

Через API вы можете:

GET /content/v2/tags — получать списки ярлыков с ID и характеристиками ярлыков.
POST /content/v2/tag — создавать новые ярлыки. За один раз можно создать один ярлык. У продавца может быть максимум 15 ярлыков.
PATCH /content/v2/tag/{id} — менять существующие ярлыки. Укажите ID ярлыка, который вы хотите изменить. Узнать ID ярлыка можно с помощью метода получения ярлыков — GET /content/v2/tags.
DELETE /content/v2/tag/{id} — удалять ярлыки. Укажите ID ярлыка, который вы хотите удалить. Узнать ID ярлыка можно с помощью метода получения ярлыков — GET /content/v2/tags.
POST /content/v2/tag/nomenclature/link — управлять ярлыками в карточках товаров. Вы можете добавлять или удалять ярлыки у конкретной карточки товара. Одна карточка может иметь не более 15 ярлыков. Если передать в запросе пустой массив, с карточки товара будут сняты все ярлыки. Для управления ярлыками в карточке товара нужно знать артикул товара WB nmID. Получить его можно через метод списка карточек товаров — POST /content/v2/get/cards/list.

Полезные ссылки в справочном центре:

Ярлыки для фильтрации товаров

Баркоды

Баркоды можно генерировать с помощью метода POST /content/v2/barcodes. За один запрос можно создать до 5000 баркодов, а затем использовать их, например, при создании карточек товаров или добавления дополнительного баркода к существующей карточке товара. Укажите в запросе количество баркодов, которое нужно сгенерировать. Баркоды возвращаются в формате чисел.

Полезные ссылки в справочном центре:

Удаление карточек товаров

Вы можете удалить карточку товара, если:

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

При удалении карточки товаров попадают в корзину. До полного удаления карточки из корзины покупатели видят товар из карточки в каталоге WB и могут его купить.

За один запрос вы можете удалить максимум 1000 карточек товаров.

Порядок действий для удаления карточек:

Шаг 1. Получить артикулы карточек товаров для удаления

Укажите, какие карточки товаров нужно удалить, через артикул карточки товара в WB — nmID. Получите nmID с помощью метода списка существующих и не находящихся в корзине карточек товаров — POST /content/v2/get/cards/list.

Шаг 2. Удалить карточки товаров

Перенесите карточки товаров в корзину с помощью метода POST /content/v2/cards/delete/trash.

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

Карточку нельзя удалить из корзины, если:

по карточке есть остатки.
карточка участвует в активной поставке.
по карточке были продажи в течение последних 28 дней.

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

При удалении карточка товара перемещается в корзину. Там она будет доступна ещё 30 календарных дней. После этого она будет полностью удалена.

До полного удаления карточки из корзины покупатели видят товар из карточки в каталоге WB и могут его купить.

Восстановить карточку товара из корзины можно в течение 30 дней. За один запрос вы можете удалить до 1000 карточек товаров.

Порядок действий для восстановления карточек:

Шаг 1. Получить список карточек в корзине

Укажите, какие карточки товаров нужно восстановить, через артикул карточки товара в WB — nmID. Для восстановления карточки товаров должны находиться в корзине.

Получите nmID с помощью метода списка карточек товаров в корзине — POST /content/v2/get/cards/trash.

Шаг 2. Восстановить карточки товаров

Восстановите карточки товаров из корзины через их nmIDс помощью метода POST /content/v2/cards/recover.

Цены и скидки

Методы цен и скидок позволяют:

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

Назначение и изменение цен для товаров

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

Порядок действий:

Шаг 1. Получить данные о ценах товаров

Для настройки цен вам нужно знать артикулы товаров в WB — nmID.

Чтобы получить цены и nmID всех ваших товаров, используйте метод списка товаров с ценами — GET /api/v2/list/goods/filter — без параметра filterNmID.

Если вы хотите получить цену одного товара и вам известен его nmID, укажите параметр filterNmID в запросе метода GET /api/v2/list/goods/filter.

Вы также можете получить nmID товара с помощью метода списка существующих и не находящихся в корзине карточек товаров — POST /content/v2/get/cards/list.

Шаг 2. Установить цены товаров

Установите или измените цену товара с помощью метода установки цен и скидок — POST /api/v2/upload/task.

В одном запросе вы можете указать до 1000 товаров. Используйте данные о товаре из шага 1.

Шаг 3. Проверить статус операции

Цены товаров могут обновляться несколько минут. Если в новых ценах будут ошибки, цены не обновятся.

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

Рекомендуем проверить статус изменения цен. Для этого используйте ID загрузки — uploadID. Его можно найти в ответе метода установки цен и скидок — POST /api/v2/upload/task — из шага 2.

Подробнее о проверке читайте в инструкции о проверке статуса изменения цен и скидок товаров.

Полезные ссылки в справочном центре:

Назначение и изменение цен для размеров товаров

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

Порядок действий:

Шаг 1. Получить данные о ценах товаров с размерами

Для настройки цен на размеры товаров вам нужно знать артикулы товаров в WB — nmID. Также товар должен относиться к категории, где можно установить цены отдельно для разных размеров.

Если вы хотите получить цены одного товара и вам известен его nmID, укажите параметр filterNmID в запросе метода GET /api/v2/list/goods/filter. Вы можете получить nmID товара с помощью метода списка существующих и не находящихся в корзине карточек товаров — POST /content/v2/get/cards/list.

В ответе метода GET /api/v2/list/goods/filter у каждого товара будет поле editableSizePrice. Если его значение равно:

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

Шаг 2. Получить размеры товара

Чтобы установить отдельные цены для разных размеров одного товара, нужно получить информацию обо всех размерах этого товара и их актуальных ценах. Получите данные с помощью метода списка размеров товара с ценами — GET /api/v2/list/goods/size/nm.

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

Установите или измените цену товара с помощью метода установки цен для размеров — POST /api/v2/upload/task/size.

В одном запросе вы можете указать до 1000 товаров. Используйте данные о товаре из шага 2.

Шаг 4. Проверить статус операции

Цены размеров товаров могут обновляться несколько минут. Если в новых ценах будут ошибки, цены не обновятся.

Если цена изменится больше, чем в 3 раза, товар может попасть в карантин. Такие товары доступны для покупателей, но продаются по цене до попадания товара в карантин.

Рекомендуем проверить статус изменения цен. Для этого используйте ID загрузки — uploadID. Его можно найти в ответе метода установки цен для размеров — POST /api/v2/upload/task/size — из шага 3.

Подробнее о проверке читайте в инструкции о проверке статуса изменения цен и скидок товаров.

Скидки на товары

Скидки для участников WB Клуба нужно настраивать отдельно.

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

Вы не можете задать скидки отдельно для размеров, только на товар в целом.

Порядок действий:

Шаг 1. Получить данные о скидках на товары

Узнайте артикулы товаров в WB — nmID, чтобы управлять скидками на товары. Получите данные с помощью метода списка товаров с ценами — GET /api/v2/list/goods/filter. Передавать параметр filterNmID не нужно.

Если вы хотите получить скидку для одного товара, укажите nmID в параметре filterNmID. Получите nmID с помощью метода списка существующих и не находящихся в корзине карточек товаров — POST /content/v2/get/cards/list.

Шаг 2. Установить скидки на товары

Установите или измените скидку на товар с помощью метода установки цен и скидок — POST /api/v2/upload/task. В одном запросе вы можете указать до 1000 товаров. Используйте данные из шага 1.

Чтобы отключить скидку, измените её значение на 0.

Шаг 3. Проверить статус операции

Скидки на товары могут обновляться несколько минут. Если в новых скидках будут ошибки, скидки не обновятся.

Рекомендуем проверить статус изменения скидок. Для этого используйте ID загрузки — uploadID. Его можно найти в ответе метода установки цен и скидок — POST /api/v2/upload/task — из шага 2.

Подробнее о проверке читайте в инструкции о проверке статуса изменения цен и скидок товаров.

Скидки для WB Клуба

Вы можете установить дополнительную скидку для участников WB Клуба — такие покупатели увидят специальную пометку у товара в каталоге. Также товар появится в разделе клубных скидок на сайте и в мобильном приложении.

Порядок действий:

Шаг 1. Получить данные о товарах, их ценах и скидках

Узнайте артикулы товаров в WB — nmID, чтобы управлять скидками на товары для участников WB Клуба. Получите данные с помощью метода списка товаров с ценами — GET /api/v2/list/goods/filter. Передавать параметр filterNmID не нужно.

Если вы хотите получить скидку WB Клуба для одного товара, укажите nmID в параметре filterNmID. Получите nmID с помощью метода списка существующих и не находящихся в корзине карточек товаров — POST /content/v2/get/cards/list.

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

Установите или измените скидку на товар с помощью метода установки скидок для WB Клуба — POST /api/v2/upload/task/club-discount. В одном запросе вы можете указать до 1000 товаров. Используйте данные из шага 1.

Чтобы отключить скидку для WB Клуба, измените её значение на 0.

Шаг 3. Проверить статус операции

Скидки на товары могут обновляться несколько минут. Если в новых скидках будут ошибки, скидки не обновятся.

Рекомендуем проверить статус изменения скидок. Для этого используйте ID загрузки — uploadID. Его можно найти в ответе метода установки скидок для WB Клуба — POST /api/v2/upload/task/club-discount — из шага 2.

Подробнее о проверке читайте в инструкции о проверке статуса изменения цен и скидок товаров.

Полезные ссылки в справочном центре:

Проверка статуса изменения цен и скидок товаров

Если в новых ценах или скидках есть ошибки, цены и скидки товаров не изменятся.

Чтобы проверить состояние загрузки, используйте ID загрузки — uploadID. Его можно найти в ответах методов установки:

Затем используйте методы:

Состояния обработанной загрузки — GET /api/v2/buffer/tasks — статус загрузки, время создания загрузки, время отправки в обработку, количество товаров в загрузке и товаров без ошибок.
Детализации обработанной загрузки по товарам — GET /api/v2/buffer/goods/task.

Полезные ссылки в справочном центре:

Как проверить обновление цен и скидок

Карантин

Карантин цен:

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

Получите данные о товарах в карантине с помощью метода списка товаров в карантине — GET /api/v2/quarantine/goods.

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

Полезные ссылки в справочном центре:

Карантин цен

Склады и остатки товаров на складах

Используйте методы складов продавца и остатков товаров, если вы работаете по модели продаж со склада продавца с типами доставок: FBS, DBS, EDBS, DBW, Самовывоз.

Через API вы можете создать склад только для типа доставки FBS — Fulfillment by Seller.

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

Через API вы можете:

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

Получение списка складов продавца

Метод получения списка складов продавца — GET /api/v3/warehouses — возвращает список существующих складов продавца и информацию по каждому складу:

название склада
ID склада
ID склада WB, к которому привязан склад продавца
тип товаров на складе:
- малогабаритные — стандартные
- крупногабаритные — КГТ
- сверхгабаритные — СГТ
тип доставки со склада:
- FBS — Fulfillment by Seller — продавец доставляет товар на склад WB, товар к покупателю доставляет WB.
- DBS — Delivery by Seller — продавец своими силами доставляет товар до покупателя. Доставка занимает от 5 часов до 35 дней.
- EDBS — Express Delivery by Seller — продавец доставляет товар в течение 4 часов с момента заказа.
- DBW — Delivery by Wildberries — за заказом к продавцу приезжает курьер WB и доставляет товар покупателю.
- Самовывоз — покупатель заказывает товар в WB и забирает его в магазине продавца.

Создание склада продавца

Через API вы можете создать склад только для типа доставки FBS — Fulfillment by Seller.

Порядок действий:

Шаг 1. Получить список складов Wildberries

Каждый виртуальный склад продавца должен быть связан с физическим складом Wildberries. Поэтому при создании виртуального склада вам нужно указать ID склада Wildberries officeId.

Получите данные и ID складов Wildberries с помощью метода списка складов WB — GET /api/v3/offices.

Шаг 2. Создать склад продавца

Создайте склад продавца с помощью метода POST /api/v3/warehouses. Укажите:

название склада — понятное и удобное для вас.
ID склада Wildberries officeId из шага 1. На этот склад вы будете отгружать товары.

Обновление информации о складе

Вы можете изменить название или привязку виртуального склада продавца к физическому складу Wildberries.

Порядок действий:

Шаг 1. Получить ID склада продавца для изменения

Узнайте ID склада продавца warehouseId для обновления склада. Получите данные с помощью метода списка складов продавца — GET /api/v3/warehouses.

Шаг 2. Получить список складов Wildberries

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

Узнайте ID склада Wildberries officeId. Через officeId вы можете изменить привязку склада продавца к складу WB.

Получите данные и ID складов Wildberries с помощью метода списка складов WB — GET /api/v3/offices.

Шаг 3. Обновить информацию о складе продавца

Измените название и привязку склада продавца с помощью метода обновления склада продавца — PUT /api/v3/warehouses/{warehouseId}.

Удаление склада

Порядок действий:

Шаг 1. Получить ID склада продавца для удаления

Узнайте ID склада продавца warehouseId для удаления склада. Получите данные с помощью метода списка складов продавца — GET /api/v3/warehouses.

Шаг 2. Удалить склад продавца

Удалите склад продавца с помощью метода DELETE /api/v3/warehouses/{warehouseId}.

Получение остатков товаров на складе

После того как вы создадите карточки товаров и добавите склад, укажите информацию об остатках товаров на складе. Остатки — это все товары в наличии.

Порядок действий:

Шаг 1. Получить ID склада продавца для проверки остатков

За один запрос вы можете проверить остатки на одном складе продавца. Для этого получите ID склада продавца warehouseId с помощью метода списка складов продавца — GET /api/v3/warehouses.

Шаг 2. Получить баркоды товаров для проверки остатков

Остатки товаров можно проверить по баркодам товаров skus. Баркод — это маркировка товара.

Получите баркоды ваших товаров с помощью метода списка существующих и не находящихся в корзине карточек товаров — POST /content/v2/get/cards/list.

Шаг 3. Получить остатки товаров

Получите остатки товаров с помощью метода POST /api/v3/stocks/{warehouseId}.

В URL запроса укажите ID склада продавца warehouseId из шага 1.
В теле запроса укажите список баркодов товаров skus из шага 2.

Метод вернет:

список баркодов товаров на складе продавца
количество товаров у каждого баркода

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

Порядок действий:

Шаг 1. Получить ID склада продавца для обновления остатков

За один запрос вы можете обновить остатки на одном складе продавца. Для этого получите ID склада продавца warehouseId с помощью метода списка складов продавца — GET /api/v3/warehouses.

Шаг 2. Получить баркоды товаров для обновления остатков

Остатки товаров можно обновить по баркодам товаров skus. Баркод — это маркировка товара. Через баркоды также можно добавить новые товары на склад.

Шаг 3. Обновить остатки товаров

Обновите остатки товаров с помощью метода PUT /api/v3/stocks/{warehouseId}.

В URL запроса укажите ID склада продавца warehouseId из шага 1.
В теле запроса укажите список баркодов товаров skus из шага 2 и количество остатков по каждому из них. Вы можете добавить на склад новые баркоды товаров с остатками.

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

Порядок действий:

Шаг 1. Получить ID склада продавца для удаления остатков

За один запрос вы можете удалить остатки на одном складе продавца. Для этого получите ID склада продавца warehouseId с помощью метода списка складов продавца — GET /api/v3/warehouses.

Шаг 2. Получить баркоды товаров для удаления остатков

Остатки товаров можно удалить по баркодам товаров skus. Баркод — это маркировка товара.

Шаг 3. Удалить остатки товаров

Удалите остатки товаров с помощью метода с помощью метода DELETE /api/v3/stocks/{warehouseId}.

В URL запроса укажите ID склада продавца warehouseId из шага 1.
В теле запроса укажите список баркодов товаров skus из шага 2. Эти товары будут удалены со склада.

Полезные ссылки в справочном центре:

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