Продажи¶

GET /api/v1/supplier/sales

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

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

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

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

В ответах могут отсутствовать заказы, по которым не подтверждена оплата, даже если эти заказы есть в детализациях к отчётам реализации. Например, заказы с отложенными платежами или оплатой в рассрочку
Значения полей priceWithDisc и forPay рассчитываются по упрощённой логике и могут отличаться от retail_price_withdisc_rub и ppvz_for_pay соответственно в детализациях к отчётам реализации
Поля finishedPrice, priceWithDisc, forPay могут временно иметь значение 0: данные заполняются асинхронно, актуализируются в течение 24 часов
Для заказов, которые оплачены в валюте, отличной от валюты продавца, возможны округления цен из-за конвертации валют

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

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

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

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

Тип	Период	Лимит	Интервал	Всплеск
Персональный	1 мин	1 запрос	1 мин	1 запрос
Сервисный	1 мин	1 запрос	1 мин	1 запрос
Базовый с секретом	1 мин	1 запрос	1 мин	1 запрос
Базовый	2 ч	1 запрос	2 ч	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`
			нет

Ответ: SalesItem[]

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

PythonNode.jsGoPHPRust

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_sales_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.apiV1SupplierSalesGet({ ... });
console.log(result);

cfg := reports.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := reports.NewAPIClient(cfg)
result, _, err := client.DefaultApi.ApiV1SupplierSalesGet(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->apiV1SupplierSalesGet(...);

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_sales_get(&config, ...).await?;