Методы сервиса. Поставки.
GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/incomes с параметрами.
При получении данных Вы указываете в запросе дату (dateFrom), от которых выгружается информация (по «дата/время обновления информации в сервисе»).
Итоговый набор данных, возвращаемых API:
Данные обновляются 1 раз в 15 минут. (Точное время отображается в поле lastChangeDate).
Методы сервиса. Склад.
GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/stocks с параметрами.
При получении данных Вы указываете в запросе дату (dateFrom), от которых выгружается информация (по «дата/время обновления информации в сервисе»).
Сервис статистики не хранит историю остатков товаров, поэтому получить данные об остатках товаров на прошедшую, не сегодняшнюю, дату невозможно. Можно получить данные только на момент запроса к API.
Итоговый набор данных, возвращаемых API:
Пояснение количественных полей:
• Quantity — "количество, доступное для продажи" — доступно на сайте, можно добавить в корзину.
• quantityFull — "количество полное" — то, что не продано (числится на складе)
• quantityNotInOrders — "количество не в заказе" — числится на складе, и при этом не числится в незавершенном заказе.
• Данные обновляются 3 раза в день - в 6-15, 11-20 и в 16-20. (Точное время отображается в поле lastChangeDate)
Методы сервиса. Заказы.
GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/orders с параметрами.
Если параметр flag=0 (или не указан в строке запроса), при вызове API возвращаются данные у которых значение поля lastChangeDate (дата время обновления информации в сервисе) больше переданного в вызов значения параметра dateFrom. При этом количество возвращенных строк данных варьируется в интервале от 0 до примерно 100000.
Если параметр flag = 1, то будет выгружена информация обо всех заказах или продажах с датой равной переданному параметру dateFrom (в данном случае время в дате значения не имеет). При этом количество возвращенных строк данных равно количеству всех заказов или продаж, сделанных в дате, переданной в параметре dateFrom.
Итоговый набор данных, возвращаемых API:
Важно: Гарантируется хранение данных заказов не более 90 дней от текущей даты.
Пояснение полей:
• totalPrice*(100-discountPercent)/100= pricewithdisc (как и Методах сервиса. Продажи)
• Архивные данные (заказы с датами ранее 90 дней от текущей даты) нужно загружать по датам, с параметром flag = 1.
• Данные обновляются 1 раз в 30 минут. (Точное время отображается в поле lastChangeDate)
• Каждое 3-е число месяца происходит пересчёт данных API за предыдущий месяц, в результате чего происходит корректировка данных. В связи с этим рекомендуем перезагружать данные API каждый месяц за предыдущий 4-го числа.
Методы сервиса. Продажи.
GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/sales с параметрами.
Если параметр flag=0 (или не указан в строке запроса), при вызове API возвращаются данные у которых значение поля lastChangeDate (дата время обновления информации в сервисе) больше переданного в вызов значения параметра dateFrom. При этом количество возвращенных строк данных варьируется в интервале от 0 до примерно 100000.
Если параметр flag = 1, то будет выгружена информация обо всех заказах или продажах с датой равной переданному параметру dateFrom (в данном случае время в дате значения не имеет). При этом количество возвращенных строк данных равно количеству всех заказов или продаж, сделанных в дате, переданной в параметре dateFrom. Также в продажах выгружаются возвраты (количество/цена со знаком минус).
Итоговый набор данных, возвращаемых API:
Важно: Гарантируется хранение данных продаж не более 90 дней от текущей даты.
• Формула вычисления pricewithdisc: Pricewithdisc = totalprice*((100 – discountPercent)/100 ) *((100 – promoCodeDiscount)/100 ) *((100 – spp)/100 )
• Архивные данные (продажи с датами ранее 90 дней от текущей даты) нужно загружать по датам, с параметром flag = 1.
• Данные обновляются 1 раз в 30 минут. (Точное время отображается в поле lastChangeDate)
• Каждое 3-е число месяца происходит пересчёт данных API за предыдущий месяц, в результате чего происходит корректировка данных. В связи с этим рекомендуем перезагружать данные API каждый месяц за предыдущий 4-го числа.
Методы сервиса. Отчет о продажах по реализации
GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/reportDetailByPeriod с параметрами
Итоговый набор данных по продажам, возвращаемый API:
Параметры:
• dateFrom – начальная дата периода. Например, если dateFrom = 2020-07-06, то в результате вызова API будет получен отчет за неделю от 06 по 12 июля 2020 года.
• dateTo – конечная дата периода.
• limit – максимальное количество строк отчета получаемых в результате вызова API. Рекомендуем загружать отчет небольшими частями, например, по 100 000 строк на один вызов.
• rrdid – уникальный идентификатор строки отчета. Необходим для получения отчета частями. Загрузку отчета нужно начинать с rrdid = 0, и при последующих вызовах API передавать максимальное значение rrdid полученное в результате предыдущего вызова. Таким образом для загрузки одного отчета может понадобится вызывать API до тех пор, пока количество возвращаемых строк не станет равным нулю.
По АПИ можно получать данные за произвольный заданный период начиная с июня 2020г.
Важно: в API хранятся данные не более трех последних месяцев.
Тестирование данной обработки проводилось на конфигурации Управления торговлей 11.4.6.166.