Поиск
API docs by Redocly

Описание API Тестовый контур

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

Данные в тестовом контуре сгенерированы случайным образом и не принадлежат реальным продавцам.
Использование тестового контура не несёт риска непреднамеренного раскрытия информации.

Описание API Тестовый контур

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

Данные в тестовом контуре сгенерированы случайным образом и не принадлежат реальным продавцам.
Использование тестового контура не несёт риска непреднамеренного раскрытия информации.

Продвижение

Для доступа к тестовому контуру используйте адрес https://advert-api-sandbox.wildberries.ru.
Кампании будут удалены через 30 дней с момента внесения последних изменений.
Удаленные кампании (статус -1) будут удалены через 3 минуты.
Можно создать максимум 50 кампаний.
Максимальное количество запросов такое же, как и в основном API.

Статистика генерируется только для кампаний типа 8 — автоматическая кампания и 9 — Аукцион.
Для генерации статистики:

  • кампания должна быть в статусе 9— идут показы
  • у кампании типа 8 должна быть положительная ставка
  • у кампании типа 9 должна быть положительная ставка в каталоге
  • бюджет кампании должен быть положительным

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

Пополнить тестовый баланс{{ /adv/v1/test/update/balance }}

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

Обновляет тестовый баланс, счёт и бонусы

Authorizations:
HeaderApiKey
Request Body schema: application/json
balance
integer

Сумма пополнения счёта, ₽

net
integer

Сумма пополнения баланса, ₽

bonus
integer

Сумма пополнения бонусов, ₽

Responses

Request samples

Content type
application/json
{
  • "balance": 1000,
  • "net": 1000,
  • "bonus": 1000
}

Response samples

Content type
application/json
{
  • "balance": 9100,
  • "net": 8000,
  • "bonus": 10000
}

Маркетплейс DBS

Для доступа к тестовому контуру используйте адрес https://marketplace-api-sandbox.wildberries.ru.

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

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

Статусная модель DBS

Для сборочных заданий есть два типа статуса:

  1. supplierStatus — статус, который может изменить продавец
  2. wbStatus — статус в системе. Его может изменить только WB

В песочнице вы можете эмулировать действия WB, меняя поле wbStatus вручную. Используйте статусы:

wbStatus supplierStatus Описание Как перевести сборочное задание в данный статус
waiting new Новое сборочное задание Создать тестовое сборочное задание DBS
declined_by_client new Сборочное задание отменено покупателем. Доступно в течение часа после создания сборочного задания, только в песочнице. Сообщить, что покупатель отменил заказ
canceled cancel Сборочное задание отменено продавцом. Доступно до перевода сборочного задания на сборку. Отменить сборочное задание
waiting confirm На сборке Перевести сборочное задание на сборку
waiting deliver В доставке Перевести сборочное задание в доставку
sold receive Покупатель получил заказ Сообщить, что заказ принят покупателем
canceled_by_client reject Покупатель отказался от заказа Сообщить, что покупатель отказался от заказа

Создать тестовое сборочное задание DBS{{ /api/v3/test/dbs/orders/make }}

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

Метод позволяет создать тестовое сборочное задание для DBS, эмулируя действия покупателя.

Один запрос создает сборочные задания по товарам из одной корзины покупателя. У них единый ID транзакции — orderUid, который передается в ответах методов получения новых и завершённых сборочных заданий.

Сборочное задание создается если:

  1. Все баркоды товаров из запроса имеют остатки на DBS складах.
  2. Остаток на складе больше или равен сумме в запросе.
  3. Цена товара не равна нулю.
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
required
Array of objects [ 1 .. 10 ] items

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

Responses

Request samples

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

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectParameter",
  • "message": "Incorrect parameter"
}

Сообщить, что покупатель отменил заказ{{ /api/v3/test/dbs/orders/{orderId}/decline }}

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

Метод переводит сборочное задание в "wbStatus":"declined_by_client" — покупатель отменил заказ. Доступно в течение часа после создания сборочного задания.

Метод эмулирует действия WB

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64> >= 1

ID сборочного задания

Responses

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectParameter",
  • "message": "Incorrect parameter"
}

Маркетплейс FBS

Для доступа к тестовому контуру используйте адрес https://marketplace-api-sandbox.wildberries.ru.

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

Используются регулярные выражения для:

  • ID поставок — ^WB-GI-SAND-[0-9]+$
  • ID коробок — ^WB-TRBX-SAND-[0-9]+$

Статусная модель FBS

Для сборочных заданий есть два типа статуса:

  1. supplierStatus — статус, который может изменить продавец
  2. wbStatus — статус в системе. Его может изменить только WB

В песочнице вы можете эмулировать действия WB, меняя поле wbStatus вручную. Используйте статусы:

wbStatus supplierStatus Описание Как перевести сборочное задание в данный статус
waiting new Новое сборочное задание Создать тестовое сборочное задание FBS
declined_by_client new Сборочное задание отменено покупателем. Доступно в течение часа после создания сборочного задания, только в песочнице. Сообщить, что покупатель отменил заказ
waiting confirm На сборке Добавить сборочное задание к поставке
canceled cancel Сборочное задание отменено продавцом. Доступно на любом этапе до перевода поставки в доставку. Отменить сборочное задание
waiting complete В доставке Передать поставку в доставку
sorted complete WB принял сборочное задание Закрыть поставку
ready_for_pickup complete Заказ поступил на пункт выдачи Сообщить, что заказ поступил в пункт выдачи
sold complete Покупатель получил заказ в пункте выдачи Сообщить, что заказ принят покупателем
canceled_by_client complete Покупатель отказался от заказа в пункте выдачи Сообщить, что покупатель отказался от заказа

Создать тестовое сборочное задание FBS{{ /api/v3/test/fbs/orders/make }}

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

Метод позволяет создать тестовое сборочное задание для FBS, эмулируя действия покупателя.

Один запрос создает сборочные задания по товарам из одной корзины покупателя. У них единый ID транзакции — orderUid, который передается в ответах методов получения новых и всех сборочных заданий.

Сборочное задание создается если:

  1. Все баркоды товаров из запроса имеют остатки на FBS складах.
  2. Остаток на складе больше или равен сумме в запросе.
  3. Цена товара не равна нулю.
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
required
Array of objects or null (MakeOrder) [ 1 .. 10 ] items

Responses

Request samples

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

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectParameter",
  • "message": "Incorrect parameter"
}

Сообщить, что покупатель отменил заказ{{ /api/v3/test/fbs/orders/{orderId}/decline }}

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

Метод переводит сборочное задание в "wbStatus":"declined_by_client" — покупатель отменил заказ. Доступно в течение часа после создания сборочного задания.

Метод эмулирует действия WB

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64> >= 1

ID сборочного задания

Responses

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectParameter",
  • "message": "Incorrect parameter"
}

Закрыть поставку{{ /api/v3/test/fbs/supplies/{supplyId}/close }}

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

Метод закрывает поставку FBS и помечает все сборочные задания как требующие в повторной отгрузки.

Все перечисленные в запросе orderId помечаются, как требующие повторную отгрузку. Неуказанные orderId, относящиеся к данному supplyId переводятся в "wbStatus": "sorted".

Метод эмулирует действия WB

Authorizations:
HeaderApiKey
path Parameters
supplyId
required
string^WB-GI-SAND-[0-9]+$

ID поставки

Request Body schema: application/json
orderIds
required
Array of integers or null <int64> >= 0

Responses

Request samples

Content type
application/json
{
  • "orderIds": 9007199254740991
}

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectParameter",
  • "message": "Incorrect parameter"
}

Сообщить, что заказ поступил в пункт выдачи{{ /api/v3/test/fbs/orders/{orderId}/deliver }}

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

Метод переводит сборочное задание в "wbStatus":"ready_for_pickup" — заказ поступил в пункт выдачи.

Метод эмулирует действия WB

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64> >= 1

ID сборочного задания

Responses

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectParameter",
  • "message": "Incorrect parameter"
}

Сообщить, что заказ принят покупателем{{ /api/v3/test/fbs/orders/{orderId}/receive }}

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

Метод переводит сборочное задание в "wbStatus":"sold" — получено покупателем.

Метод эмулирует действия WB

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64> >= 1

ID сборочного задания

Request Body schema: application/json
required
code
required
string

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

Responses

Request samples

Content type
application/json
{
  • "code": "string"
}

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectParameter",
  • "message": "Incorrect parameter"
}

Сообщить, что покупатель отказался от заказа{{ /api/v3/test/fbs/orders/{orderId}/reject }}

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

Метод переводит сборочное задание в "wbStatus":"canceled_by_client" — отказ при получении.

Метод эмулирует действия WB

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64> >= 1

ID сборочного задания

Request Body schema: application/json
required
code
required
string

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

Responses

Request samples

Content type
application/json
{
  • "code": "string"
}

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectParameter",
  • "message": "Incorrect parameter"
}

Маркетплейс Самовывоз

Для доступа к тестовому контуру используйте адрес https://marketplace-api-sandbox.wildberries.ru.

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

Используются регулярные выражения для:

  • ID поставок — ^WB-GI-SAND-[0-9]+$
  • ID коробок — ^WB-TRBX-SAND-[0-9]+$
Всегда указывайте комбинацию "11111" в параметре запроса passCode тестового метода проверки, принадлежит ли сборочное задание покупателю

Статусная модель Самовывоз

Для сборочных заданий есть два типа статуса:

  1. supplierStatus — статус, который может изменить продавец
  2. wbStatus — статус в системе. Его может изменить только WB

В песочнице вы можете эмулировать действия WB, меняя поле wbStatus вручную. Используйте статусы:

wbStatus supplierStatus Описание Как перевести сборочное задание в данный статус
waiting new Новое сборочное задание Создать тестовое сборочное задание Самовывоз
declined_by_client new Сборочное задание отменено покупателем. Доступно в течение часа после создания сборочного задания, только в песочнице. Сообщить, что покупатель отменил заказ
waiting confirm На сборке Перевести сборочное задание на сборку
canceled cancel Сборочное задание отменено продавцом. Доступно до подтверждения выдачи сборочного задания. Отменить сборочное задание
ready_for_pickup prepare Сборочное задание готово к выдаче Сообщить, что сборочное задание готово к выдаче
sold receive Покупатель получил заказ Сообщить, что заказ принят покупателем
canceled_by_client reject Покупатель отказался от заказа Сообщить, что покупатель отказался от заказа

Создать тестовое сборочное задание Самовывоз{{ /api/v3/test/click-collect/orders/make }}

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

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

Один запрос создает сборочные задания по товарам из одной корзины покупателя. У них единый ID транзакции — orderUid, который передается в ответах методов получения новых и завершённых сборочных заданий.

Сборочное задание создается если:

  1. Все баркоды товаров из запроса имеют остатки на складах.
  2. Остаток на складе больше или равен сумме в запросе.
  3. Цена товара не равна нулю.
Authorizations:
HeaderApiKey
Request Body schema: application/json
required
required
Array of objects or null (MakeOrder) [ 1 .. 10 ] items

Responses

Request samples

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

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectParameter",
  • "message": "Incorrect parameter"
}

Сообщить, что покупатель отменил заказ{{ /api/v3/test/click-collect/orders/{orderId}/decline }}

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

Метод переводит сборочное задание в "wbStatus":"declined_by_client" — покупатель отменил заказ. Доступно в течение часа после создания сборочного задания.

Метод эмулирует действия WB

Authorizations:
HeaderApiKey
path Parameters
orderId
required
integer <int64> >= 1

ID сборочного задания

Responses

Response samples

Content type
application/json
Example
{
  • "code": "IncorrectParameter",
  • "message": "Incorrect parameter"
}