Перейти к содержанию

Заказы

GET /api/v1/supplier/orders

Метод возвращает информацию о заказах.
Данные обновляются раз в 30 минут.

1 строка = 1 заказ = 1 сборочное задание = 1 единица товара.
Для определения заказа рекомендуем использовать поле srid.

Информация о заказе хранится 90 дней с момента оформления.

В ответах могут отсутствовать заказы, по которым не подтверждена оплата. Например, заказы с отложенными платежами или оплатой в рассрочку. При этом, если по таким заказам есть продажи, вы можете получить их с помощью детализаций к отчётам реализации.
Чтобы получить все оформленные заказы, используйте Ленту заказов в личном кабинете.

Данные этого отчёта являются предварительными и служат для оперативного мониторинга

Для одного ответа на запрос с flag=0 или без flag в системе установлено условное ограничение 80000 строк. Поэтому, чтобы получить все заказы, может потребоваться более, чем один запрос. Во втором и далее запросе в параметре dateFrom используйте полное значение поля lastChangeDate из последней строки ответа на предыдущий запрос.
Если в ответе отдаётся пустой массив [], все заказы уже выгружены.

В песочнице для параметров dateFrom и dateTo можно задать диапазон только за последние 4 месяца от текущей даты.

Лимит запросов на один аккаунт продавца:

Тип Период Лимит Интервал Всплеск
Персональный 1 мин 1 запрос 1 мин 10 запросов
Сервисный 1 мин 1 запрос 1 мин 10 запросов
Базовый с секретом 1 мин 1 запрос 1 мин 10 запросов
Базовый 3 ч 1 запрос 3 ч 1 запрос

Параметры

Имя Расположение Тип Обязательный Описание
dateFrom query string да Дата и время последнего изменения по заказу.
Дата в формате RFC3339. Можно передать дату или дату со временем. Время можно указывать с точностью до секунд или миллисекунд.
Время передаётся в часовом поясе Москва (UTC+3).
Примеры: - 2019-06-20 - 2019-06-20T23:59:59 - 2019-06-20T00:00:00.12345 - 2017-03-25T00:00:00
нет

Ответ: OrdersItem[]

Примеры вызова

import os
from wildberries_sdk import reports

token = os.getenv("WB_API_TOKEN")
api = reports.DefaultApi(
    reports.ApiClient(reports.Configuration(api_key={"HeaderApiKey": token}))
)
result = api.api_v1_supplier_orders_get(dateFrom=...)
print(result)
import { Configuration, DefaultApi } from 'wildberries-sdk';

const api = new DefaultApi(new Configuration({ apiKey: process.env.WB_API_TOKEN }));
const result = await api.apiV1SupplierOrdersGet({ ... });
console.log(result);
cfg := reports.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := reports.NewAPIClient(cfg)
result, _, err := client.DefaultApi.ApiV1SupplierOrdersGet(context.Background()).Execute()
<?php
$config = Wildberries\Sdk\Reports\Configuration::getDefaultConfiguration()
    ->setApiKey('Authorization', getenv('WB_API_TOKEN'));
$api = new Wildberries\Sdk\Reports\Api\DefaultApi(new GuzzleHttp\Client(), $config);
$result = $api->apiV1SupplierOrdersGet(...);
use wildberries_sdk_reports::apis::{configuration::Configuration, configuration::ApiKey, default_api};

let mut config = Configuration::new();
config.api_key = Some(ApiKey { prefix: None, key: std::env::var("WB_API_TOKEN").unwrap() });
let result = default_api::api_v1_supplier_orders_get(&config, ...).await?;