Получить список новых сборочных заданий
http
GET /api/v3/dbs/orders/newБаза: https://marketplace-api.wildberries.ru · Модуль: dbs · Раздел: Сборочные задания DBS · Документация спецификации ↗
Метод возвращает список всех новых сборочных заданий, которые есть у продавца на момент запроса.
Лимит запросов на один профиль продавца для методов сборочных заданий DBS:
| Период | Лимит | Интервал | Всплеск |
|---|---|---|---|
| 1 мин | 300 запросов | 200 мс | 20 запросов |
Один запрос с кодами ответов 4XX учитывается как 10 запросов. |
В песочнице — максимум 1 запрос в секунду суммарно для всех методов Маркетплейса.
Ответы
| Код | Описание | Схема |
|---|---|---|
200 | Успешно | GetV3DbsOrdersNewResponse200 |
401 | Не авторизован | object |
402 | Требуется платёж | object |
403 | Доступ запрещён | Error |
429 | Слишком много запросов | object |
Структура 200:
ordersOrderNewDBS[]— Список новых сборочных заданийsalePriceinteger<int64>— Цена в валюте продажи с учетом скидки продавца, без учета скидки WB Клуба, умноженная на 100. Предоставляется в информационных целяхrequiredMetastring[]— Список идентификаторов маркировки, доступных для сборочного задания. Указывать IMEI обязательно для предметаСмартфоны,"subjectId":515commentstring— Комментарий покупателяoptionsobject— Опции заказаisB2bboolean— Признак B2B-продажи: -false— не B2B-продажа -true— B2B-продажа
addressobject— Адрес покупателя для доставки. При доставке заказов в ПВЗ указан адрес ПВЗfullAddressstring— Адрес доставкиlongitudenumber<float64>— Долготаlatitudenumber<float64>— Широта
orderUidstring— ID транзакции для группировки сборочных заданий. Сборочные задания в одной корзине покупателя будут иметь одинаковыйorderUIDgroupIdstring<UUID>— ID группы сборочных заданий. Объединяет сборочные задания, поступившие на один склад (warehouseId) в рамках одной транзакции покупателя (orderUid)articlestring— Артикул продавцаcolorCodestring— Код цвета (только для колеруемых товаров)ridobject— Уникальный ID заказа. Примечание:rid— этоsridв ответах методов: - Заявки покупателей на возврат - Лента заказов - Заказы - Продажи - Отчёт о возвратах и перемещении товаров - Детализации к отчётам реализации по ID отчётов - Детализации к отчётам реализации за период - Детализации к отчётам об издержках на приём платежей по ID отчётов - Детализации к отчётам об издержках на приём платежей за периодcreatedAtstring— Дата создания сборочного заданияdeliveryTypestring=dbs|edbs|dbsPickupPoint— Тип доставки: -dbs— доставка силами продавца -dbsPickupPoint— доставка силами продавца в ПВЗ -edbs— экспресс-доставка силами продавцаskusstring[]— Массив баркодов товараidinteger<int64>— ID сборочного заданияwarehouseIdinteger<int64>— ID склада продавца, на который поступило сборочное заданиеnmIdinteger<int64>— Артикул WBchrtIdinteger<int64>— ID размера товара в системе WBpriceinteger<int64>— Цена в валюте продажи с учетом всех скидок, кроме скидки по WB Кошельку, умноженная на 100. Код валюты продажи указан в полеcurrencyCode. Предоставляется в информационных целяхfinalPriceinteger<int64>— Сумма к оплате покупателем в валюте продажи с учётом всех скидок, умноженная на 100. Код валюты продажи указан в полеcurrencyCode. Предоставляется в информационных целях. Используйте значение поляfinalPrice, только если в ответе метода получения цен продавца и сумм к оплате вернулось"data": null. Во всех остальных случаях используйте значение поляoriginalFinalPriceиз ответа того же методаconvertedFinalPriceinteger<int64>— Сумма к оплате покупателем в валюте страны продавца с учетом всех скидок, умноженная на 100. Предоставляется в информационных целях. Используйте значение поляconvertedFinalPrice, только если в ответе метода получения цен продавца и сумм к оплате вернулось"data": null. Во всех остальных случаях используйте значение поляconvertedOriginalFinalPriceиз ответа того же методаconvertedPriceinteger<int64>— Цена в валюте страны продавца с учетом всех скидок, кроме скидки по WB Кошельку, умноженная на 100. Предоставляется в информационных целяхcurrencyCodeinteger<ISO 4217>— Код валюты продажиconvertedCurrencyCodeinteger<ISO 4217>— Код валюты страны продавцаcargoTypeinteger<int64>=1|2|3— Тип товара: -1— малогабаритный товар (МГТ) -2— сверхгабаритный товар (СГТ) -3— крупногабаритный товар (КГТ+)isZeroOrderboolean— Признак заказа товара с нулевым остатком: -false— заказ сделан на товар с ненулевым остатком -true— заказ сделан на товар с нулевым остатком. Такой заказ можно отменить без штрафа за отменуwbStickerIdinteger<int64>— ID стикера. Отображается только для заказов в ПВЗ
Структура 401:
titlestring— Заголовок ошибкиdetailstring— Детали ошибкиcodestring— Внутренний код ошибкиrequestIdstring— Уникальный ID запросаoriginstring— ID внутреннего сервиса WBstatusnumber— HTTP статус-кодstatusTextstring— Расшифровка HTTP статус-кодаtimestampstring— Дата и время запроса
Структура 402:
titlestring— Заголовок ошибкиdetailstring— Детали ошибки. Ошибка возвращается только сервисам из Каталога решений для бизнеса
Структура 403:
codestring— Код ошибкиmessagestring— Описание ошибкиdataobject— Дополнительные данные ошибки
Структура 429:
titlestring— Заголовок ошибкиdetailstring— Детали ошибкиcodestring— Внутренний код ошибкиrequestIdstring— Уникальный ID запросаoriginstring— ID внутреннего сервиса WBstatusnumber— HTTP статус-кодstatusTextstring— Расшифровка HTTP статус-кодаtimestampstring— Дата и время запроса
Примеры вызова
Аргументы показаны именами параметров — подставьте свои значения. Языки, в клиенте которых этой операции нет, не показаны.
python
from wb_api_client.dbs import Configuration, ApiClient
from wb_api_client.dbs.api import DbsApi
cfg = Configuration(access_token="<ваш JWT WB>")
api = DbsApi(ApiClient(cfg))
result = api.get_v3_dbs_orders_new()
print(result)ts
import {
Configuration,
DbsApi,
} from "@valeryverkhoturov/wb-api-client/dbs";
const cfg = new Configuration({});
cfg.setAccessToken("<ваш JWT WB>");
const api = new DbsApi(cfg);
const { data } = await api.getV3DbsOrdersNew();
console.log(data);go
import (
"context"
"fmt"
wbdbs "github.com/ValeryVerkhoturov/wb-api-client-go/dbs"
)
cfg := wbdbs.NewConfiguration()
cfg.SetAccessToken("<ваш JWT WB>")
client := wbdbs.NewAPIClient(cfg)
result, _, err := client.DbsAPI.GetV3DbsOrdersNew(context.Background()).Execute()
if err != nil {
panic(err)
}
fmt.Printf("%+v\n", result)java
import io.github.valeryverkhoturov.wbapi.dbs.ApiClient;
import io.github.valeryverkhoturov.wbapi.dbs.SecretString;
import io.github.valeryverkhoturov.wbapi.dbs.api.DbsApi;
ApiClient client = new ApiClient();
client.setAccessToken(new SecretString("<ваш JWT WB>"));
DbsApi api = new DbsApi(client);
System.out.println(api.getV3DbsOrdersNew());php
use ValeryVerkhoturov\WbApiClient\Dbs\Configuration;
use ValeryVerkhoturov\WbApiClient\Dbs\SecretString;
use ValeryVerkhoturov\WbApiClient\Dbs\Api\DbsApi;
use GuzzleHttp\Client;
$config = (new Configuration())
->setAccessTokenSecret(new SecretString('<ваш JWT WB>'));
$api = new DbsApi(new Client(), $config);
print_r($api->getV3DbsOrdersNew());bsl
#Использовать "wb-api-client"
Настройки = Новый Конфигурация();
Настройки.УстановитьТокен("<ваш JWT WB>");
Клиент = Новый DbsApi(Настройки);
Сообщить(Клиент.GetV3DbsOrdersNew().Тело);csharp
using ValeryVerkhoturov.WbApiClient.Dbs.Api;
using ValeryVerkhoturov.WbApiClient.Dbs.Client;
var config = new Configuration();
config.AccessTokenSecret = new SecretString("<ваш JWT WB>");
var api = new DbsApi(config);
Console.WriteLine(api.GetV3DbsOrdersNew());rust
use wb_api_client::dbs::apis::{configuration::Configuration, dbs_api};
#[tokio::main]
async fn main() {
let mut cfg = Configuration::new();
cfg.set_access_token("<ваш JWT WB>");
let result = dbs_api::get_v3_dbs_orders_new(&cfg).await;
println!("{:#?}", result);
}