Сервис статистики

Внимание!
Данные постоянно обновляются. Все изменения просматривайте в разделе «Новости» на наличие
актуальной информации. Для правильной работы раздела мы рекомендуем использовать Chrome и
периодически чистить cookie браузера.
 Общее описание

На портале в разделе «Мой профиль» - «Доступ к

апи» вы самостоятельно можете сгенерировать API
ключ для получения этих данных.
Для начала работы с API необходимо сгенерировать
токен в настройках поставщика. Данный раздел
доступен только владельцу продавца. Описание
запросов и методов для взаимодействия с API
доступно в свагере по ссылке.
 Методы сервиса. Поставки.
• GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/incomes с параметрами.
• Пример: https://suppliers-stats.wildberries.ru/api/v1/supplier/incomes?dateFrom=2017-03-25T21%3A00%3A00.000Z&key=<ключ, выдаваемый поставщику>
• При получении данных Вы указываете в запросе дату и время (dateFrom), от которых выгружается информация (по «дата/время обновления информации в
сервисе»).

Итоговый набор данных, возвращаемых API:

Наименование поля в Поле

наборе данных
incomeid номер поставки
Number номер УПД
Date дата поступления
lastChangeDate дата и время обновления информации в
сервисе Данные обновляются 1 раз в 15 минут.
SupplierArticle ваш артикул (Точное время отображается в поле lastChangeDate)
TechSize размер
Barcode штрих-код
Quantity кол-во
totalPrice цена из УПД
dateClose дата принятия (закрытия) у нас
warehouseName название склада
nmid Код WB
status Текущий статус поставки
Методы сервиса. Склад.
GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/stocks с параметрами.
Пример: https://suppliers-stats.wildberries.ru/api/v1/supplier/stocks?dateFrom=2017-03-25T21%3A00%3A00.000Z&key=<ключ, выдаваемый поставщику>

При получении данных Вы указываете в запросе дату и время (dateFrom), от которых выгружается информация (по «дата/время обновления информации в сервисе»).

Сервис статистики не хранит историю остатков товаров, поэтому получить данные об остатках товаров на прошедшую, не сегодняшнюю, дату невозможно.
Можно получить данные только на момент запроса к API.

Итоговый набор данных, возвращаемых API:

Наименование поля в Поле Пояснение количественных полей:

наборе данных
lastChangeDate дата и время обновления информации в сервисе
supplierArticle ваш артикул • Quantity — "количество, доступное для продажи" —
techSize размер доступно на сайте, можно добавить в корзину.
Barcode штрих-код •
Quantity кол-во, доступное для продажи quantityFull — "количество полное" — то, что не
isSupply договор поставки продано (числится на складе)
isRealization договор реализации
quantityFull кол-во полное
•
quantityNotInOrders кол-во не в заказе quantityNotInOrders — "количество не в заказе" —
warehouseName название склада числится на складе, и при этом не числится в
inWayToClient в пути к клиенту (штук) незавершенном заказе.
inWayFromClient в пути от клиента (штук)
nmid код WB • Данные обновляются 3 раза в день - в 6-15, 11-20 и в
subject предмет
category категория
16-20. (Точное время отображается в поле
DaysOnSite кол-во дней на сайте lastChangeDate)
brand бренд
SCCode код контракта
Методы сервиса. Заказы.
GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/orders с параметрами.
Пример: https://suppliers-stats.wildberries.ru/api/v1/supplier/orders?dateFrom=2017-03-25T21%3A00%3A00.000Z&flag=0&key=<ключ, выдаваемый поставщику>

Если параметр flag=0 (или не указан в строке запроса), при вызове API возвращаются данные у которых значение поля lastChangeDate (дата время обновления информации в
сервисе) больше переданного в вызов значения параметра dateFrom. При этом количество возвращенных строк данных варьируется в интервале от 0 до примерно 100000.
Если параметр flag = 1, то будет выгружена информация обо всех заказах или продажах с датой равной переданному параметру dateFrom (в данном случае время в дате
значения не имеет). При этом количество возвращенных строк данных равно количеству всех заказов или продаж, сделанных в дате, переданной в параметре dateFrom.

Итоговый набор данных, возвращаемых API:

Наименование поля в наборе данных Поле

number номер заказа
date дата заказа
lastChangeDate дата время обновления информации в сервисе • totalPrice*(100-discountPercent)/100= pricewithdisc (как и Методах
supplierArticle ваш артикул сервиса. Продажи)
techSize размер
barcode штрих-код Важно: Гарантируется хранение данных заказов не более 90 дней от
quantity кол-во текущей даты.
totalPrice цена до согласованной скидки/промо/спп
discountPercent согласованный итоговый дисконт. • Архивные данные (заказы с датами ранее 90 дней от текущей даты)
warehouseName склад отгрузки нужно загружать по датам, с параметром flag = 1.
oblast область
incomeID номер поставки • Данные обновляются 1 раз в 30 минут. (Точное время отображается в
odid уникальный идентификатор позиции заказа поле lastChangeDate)
nmid Код WB
subject предмет • Каждое 3-е число месяца происходит пересчёт данных API за
category категория предыдущий месяц, в результате чего происходит корректировка
brand бренд данных. В связи с этим рекомендуем перезагружать данные API
is_cancel признак отмены заказа (0 – отмены не было, 1 – отмена была каждый месяц за предыдущий 4-го числа.
cancel_dt дата отмены заказа
Методы сервиса. Продажи.
Итоговый набор данных, возвращаемых API:
Наименование поля Поле
в наборе данных
Number номер документа
Date дата продажи GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/sales с параметрами.
lastChangeDate дата время обновления информации в Пример: https://suppliers-stats.wildberries.ru/api/v1/supplier/sales?dateFrom=2017-03-
сервисе
supplierArticle
25T21%3A00%3A00.000Z&flag=0&key=<ключ, выдаваемый поставщику>
ваш артикул
techSize размер
barcode штрих-код Если параметр flag=0 (или не указан в строке запроса), при вызове API возвращаются данные у которых значение
quantity кол-во поля lastChangeDate (дата время обновления информации в сервисе) больше переданного в вызов значения
totalPrice начальная розничная цена товара
discountPercent согласованная скидка на товар параметра dateFrom. При этом количество возвращенных строк данных варьируется в интервале от 0 до примерно
isSupply договор поставки 100000.
isRealization договор реализации
orderId номер исходного заказа ("Номер заказа" из Если параметр flag = 1, то будет выгружена информация обо всех заказах или продажах с датой равной переданному
сервиса "Заказы") параметру dateFrom (в данном случае время в дате значения не имеет). При этом количество возвращенных строк
promoCodeDiscount согласованный промокод данных равно количеству всех заказов или продаж, сделанных в дате, переданной в параметре dateFrom.
warehouseName склад отгрузки
countryName страна Также в продажах выгружаются возвраты (количество/цена со знаком минус).
oblastOkrugName округ
regionName регион
incomeID номер поставки • Формула вычисления pricewithdisc:
saleID уникальный идентификатор продажи/возврата Pricewithdisc = totalprice*((100 – discountPercent)/100 ) *((100 – promoCodeDiscount)/100 ) *((100 – spp)/100 )
(SXXXXXXXXXX — продажа, RXXXXXXXXXX —
возврат, DXXXXXXXXXXX — доплата) Важно: Гарантируется хранение данных продаж не более 90 дней от текущей даты.
odid уникальный идентификатор позиции заказа
spp согласованная скидка постоянного покупателя
(СПП) • Архивные данные (продажи с датами ранее 90 дней от текущей даты) нужно загружать по датам, с
forpay к перечислению поставщику параметром flag = 1.
finished_price фактическая цена из заказа (с учетом всех скидок,
включая и от ВБ)
pricewithdisc цена, от которой считается вознаграждение • Данные обновляются 1 раз в 30 минут. (Точное время отображается в поле lastChangeDate)
поставщика forpay (с учетом всех согласованных
скидок)
nmId код WB • Каждое 3-е число месяца происходит пересчёт данных API за предыдущий месяц, в результате чего
subject предмет происходит корректировка данных. В связи с этим рекомендуем перезагружать данные API каждый месяц
category категория за предыдущий 4-го числа.
brand бренд
IsStorno 1-продажа сторнирована, 0 – не сторнирована
Методы сервиса. Отчет о продажах по реализации
GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/reportDetailByPeriod с параметрами
Пример: https://suppliers-stats.wildberries.ru/api/v1/supplier/reportDetailByPeriod?dateFrom=2020-06-01&key=<ключ, выдаваемый поставщику>&limit=1000&rrdid=0&dateto=2020-
06-30
Итоговый набор данных по продажам, возвращаемый API:
Наименование поля в наборе данных
realizationreport_id Номер отчета
Поле Параметры:
suppliercontract_code Договор • dateFrom – начальная дата периода. Например, если dateFrom = 2020-07-06, то в
rr_dt Дата операции
rrd_id Номер строки результате вызова API будет получен отчет за неделю от 06 по 12 июля 2020 года.
gi_id номер поставки
subject_name Предмет
NM_id
brand_name
Артикул
Бренд
• dateTo – конечная дата периода.
sa_name Артикул поставщика
ts_name Размер
barcode Баркод • limit – максимальное количество строк отчета получаемых в результате вызова API.
doc_type_name Тип документа
quantity Количество
Рекомендуем загружать отчет небольшими частями, например, по 100 000 строк на
nds
cost_amount
Ставка НДС
Себестоимость Сумма
один вызов.
retail_price Цена розничная
retail_amount Сумма продаж(Возвратов)
retail_commission Сумма комиссии продаж • rrdid – уникальный идентификатор строки отчета. Необходим для получения отчета
sale_percent Согласованная скидка
commission_percent Процент комиссии
частями. Загрузку отчета нужно начинать с rrdid = 0, и при последующих вызовах API
customer_reward
supplier_reward
Вознаграждение покупателю
Вознаграждение поставщику
передавать максимальное значение rrdid полученное в результате предыдущего
office_name Склад вызова. Таким образом для загрузки одного отчета может понадобится вызывать API до
supplier_oper_name Обоснование для оплаты
order_dt Даты заказа тех пор, пока количество возвращаемых строк не станет равным нулю.
sale_dt Дата продажи
shk_id ШК
retail_price_withdisc_rub
for_pay
Цена розничная с учетом согласованной скидки
К перечислению поставщику
По АПИ можно получать данные за произвольный заданный период начиная с июня
for_pay_nds К перечислению поставщику НДС 2020г.
delivery_amount Кол-во доставок
return_amount Кол-во возвратов
delivery_rub Стоимость логистики
gi_box_type_name Тип коробов
Важно: в API хранятся данные не более трех последних месяцев.
product_discount_for_report Согласованный продуктовый дисконт
supplier_promo Промокод
supplier_spp Скидка постоянного покупателя
 Получить отчет по КиЗам Пример запроса
/api/v1/supplier/excise-goods?key=&dateFrom=2019-01-27T21%3A00%3A00.000Z
 [GET-запрос на адрес https://suppliers-stats.wildberries.ru/api/v1/supplier/excise-goods
 key string – Api ключ поставщика response
 dateFrom time - время, с которого нужно получить отчет
Status: 200

"id": 2494004,

"inn": "9729022802",

"finishedPrice": 3501,

"operationTypeId": 1,

"fiscalDt": "2020-09-29T16:18:00Z",

"docNumber": 218390,

"fnNumber": "9280440300760936",

"regNumber": "0004558848032018",

"excise":
"010466007941042921uBS,euRqB<mNe91806992tl/HJNtOutgoOLEYhZ+dD3ocTTdPLpSYvxab8lAaMkKM1u+e
kQHQDR8p/HtpQi9UzXLZyMi8jkVT52SBLabiZg==",

"date": "2020-09-29T13:30:12.217Z"

},

...

]
 Пояснения
 date - дата, когда данные появились в системе (по ним и
отслеживать изменение, появление новых)

 docnumber - номер фискального документа

 excise – акциз (он же киз)

 finishedPrice - цена товара с учетом НДС

 fiscalDt - время фискализации

 fnnumber - номер фискального накопителя

 id – внутренний код операции

 operationTypeId - тип операции (тип операции 1 - продажа, 2 -

возврат)

 regNumber - регистрационный номер ККТ

inn - ИНН поставщика