Отчёты (reports)

Отчеты по товарам, удержаниям, платной приемке и платному хранению

Отчёты

Отчеты по товарам, удержаниям, платной приемке и платному хранению

Отчёты по товарам

Для доступа к методам используйте токен для категории Статистика

Отчёты можно сохранять в Excel

Поставки{{ /api/v1/supplier/incomes }}

Описание метода

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom

required

string <RFC3339>

Дата и время последнего изменения по поставке.
Дата в формате RFC3339. Можно передать дату или дату со временем. Время можно указывать с точностью до секунд или миллисекунд.
Время передаётся в часовом поясе Мск (UTC+3).
Примеры:

2019-06-20
2019-06-20T23:59:59
2019-06-20T00:00:00.12345
2017-03-25T00:00:00

Responses

Response samples

200
401
429

Content type

application/json

[{"incomeId": 12345,
"number": "",
"date": "2022-05-08T00:00:54",
"lastChangeDate": "2022-05-08T00:44:15.5",
"supplierArticle": "ABCDEF",
"techSize": "0",
"barcode": "2000328074123",
"quantity": 3,
"totalPrice": 0,
"dateClose": "2022-05-08T00:00:00",
"warehouseName": "Подольск",
"nmId": 1234567,
"status": "Принято"
}
]

Склад{{ /api/v1/supplier/stocks }}

Описание метода

Возвращает остатки товаров на складах WB. Данные обновляются раз в 30 минут. Сервис статистики не хранит историю остатков товаров, поэтому получить данные о них можно только на текущий момент

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom

required

string <RFC3339>

Дата и время последнего изменения по товару.
Для получения полного остатка следует указывать максимально раннее значение.
Например, 2019-06-20
Дата в формате RFC3339. Можно передать дату или дату со временем. Время можно указывать с точностью до секунд или миллисекунд.
Время передаётся в часовом поясе Мск (UTC+3).
Примеры:

2019-06-20
2019-06-20T23:59:59
2019-06-20T00:00:00.12345
2017-03-25T00:00:00

Responses

Response samples

200
401
429

Content type

application/json

[{"lastChangeDate": "2023-07-05T11:13:35",
"warehouseName": "Краснодар",
"supplierArticle": "443284",
"nmId": 1439871458,
"barcode": "2037401340280",
"quantity": 33,
"inWayToClient": 1,
"inWayFromClient": 0,
"quantityFull": 34,
"category": "Посуда и инвентарь",
"subject": "Формы для запекания",
"brand": "X",
"techSize": "0",
"Price": 185,
"Discount": 0,
"isSupply": true,
"isRealization": false,
"SCCode": "Tech"
}
]

Заказы{{ /api/v1/supplier/orders }}

Описание метода

Возвращает заказы. Данные обновляются раз в 30 минут. 1 строка = 1 заказ = 1 единица товара. Для определения заказа рекомендуем использовать поле srid. Данные заказа хранятся 90 дней от даты заказа

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom

required

string <RFC3339>

Дата и время последнего изменения по заказу.
Дата в формате RFC3339. Можно передать дату или дату со временем. Время можно указывать с точностью до секунд или миллисекунд.
Время передаётся в часовом поясе Мск (UTC+3).
Примеры:

2019-06-20
2019-06-20T23:59:59
2019-06-20T00:00:00.12345
2017-03-25T00:00:00

flag

integer

Default: 0

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

Responses

Response samples

200
400
401
429

Content type

application/json

[{"date": "2022-03-04T18:08:31",
"lastChangeDate": "2022-03-06T10:11:07",
"warehouseName": "Подольск",
"countryName": "Россия",
"oblastOkrugName": "Центральный федеральный округ",
"regionName": "Московская",
"supplierArticle": "12345",
"nmId": 1234567,
"barcode": "123453559000",
"category": "Бытовая техника",
"subject": "Мультистайлеры",
"brand": "Тест",
"techSize": "0",
"incomeID": 56735459,
"isSupply": false,
"isRealization": true,
"totalPrice": 1887,
"discountPercent": 18,
"spp": 26,
"finishedPrice": 1145,
"priceWithDisc": 1547,
"isCancel": true,
"cancelDate": "2022-03-09T00:00:00",
"orderType": "Клиентский",
"sticker": "926912515",
"gNumber": "34343462218572569531",
"srid": "11.rf9ef11fce1684117b0nhj96222982382.3.0"
}
]

Продажи{{ /api/v1/supplier/sales }}

Описание метода

Возвращает продажи и возвраты. Данные обновляются раз в 30 минут. 1 строка = 1 заказ = 1 единица товара. Для определения заказа рекомендуем использовать поле srid. Данные заказа хранятся 90 дней от даты продажи

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom

required

string <RFC3339>

Дата и время последнего изменения по продаже/возврату.
Дата в формате RFC3339. Можно передать дату или дату со временем. Время можно указывать с точностью до секунд или миллисекунд.
Время передаётся в часовом поясе Мск (UTC+3).
Примеры:

2019-06-20
2019-06-20T23:59:59
2019-06-20T00:00:00.12345
2017-03-25T00:00:00

flag

integer

Default: 0

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

Responses

Response samples

200
400
401
429

Content type

application/json

[{"date": "2022-03-04T18:08:31",
"lastChangeDate": "2022-03-06T10:11:07",
"warehouseName": "Подольск",
"countryName": "Россия",
"oblastOkrugName": "Центральный федеральный округ",
"regionName": "Московская",
"supplierArticle": "12345",
"nmId": 1234567,
"barcode": "123453559000",
"category": "Бытовая техника",
"subject": "Мультистайлеры",
"brand": "Тест",
"techSize": "0",
"incomeID": 56735459,
"isSupply": false,
"isRealization": true,
"totalPrice": 1887,
"discountPercent": 18,
"spp": 20,
"paymentSaleAmount": 93,
"forPay": 1284.01,
"finishedPrice": 1145,
"priceWithDisc": 1547,
"saleID": "S9993700024",
"orderType": "Клиентский",
"sticker": "926912515",
"gNumber": "34343462218572569531",
"srid": "11.rf9ef11fce1684117b0nhj96222982382.3.0"
}
]

Отчёт по товарам с обязательной маркировкой{{ /api/v1/analytics/excise-report }}

Описание метода

Возвращает операции по маркируемым товарам

Максимум 10 запросов за 5 часов на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string Начало отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры: `2023-12-01` `2023-12-01T23:59:59` `2023-12-01T00:00:00.12345` `2023-12-01T00:00:00`
dateTo required	string Конец отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры: `2023-12-01` `2023-12-01T23:59:59` `2023-12-01T00:00:00.12345` `2023-12-01T00:00:00`

Request Body schema: application/json
optional

countries

Array of strings

Items Enum: "AM" "BY" "KG" "KZ" "RU" "UZ"

Код стран по стандарту ISO 3166-2. Чтобы получить данные по всем странам, оставьте параметр пустым

Responses

Request samples

Payload

Content type

application/json

{"countries": ["AM",
"RU"
]
}

Response samples

200
401
429

Content type

application/json

{"response": {"data": [{"name": "Россия",
"price": 100,
"currency_name_short": "руб",
"excise_short": "0102900254680370215_Re/=lSbNiGD",
"barcode": 2038893425820,
"nm_id": 169085355,
"operation_type_id": 1,
"fiscal_doc_number": 12345678,
"fiscal_dt": "2024-01-01",
"fiscal_drive_number": "string",
"rid": 606217433440,
"srid": "7513432034713632943.1.0"
}
]
}
}

Отчёт по остаткам на складах

Для доступа к методам используйте токен для категории Аналитика

Чтобы загрузить отчёт об остатках на складах WB:

Создайте отчёт.
Дождитесь, когда отчёт будет готов. Вы можете проверить статус готовности отчета. Готовый отчёт хранится 2 часа.
Получите отчёт.

Создать отчёт{{ /api/v1/warehouse_remains }}

Описание метода

Создаёт задание на генерацию отчёта. Параметры groupBy и filter можно задать в любой комбинации — аналогично версии в личном кабинете.

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale	string Default: "ru" Example: locale=ru Язык полей ответа `subjectName` и `warehouseName`: `ru` — русский `en` — английский `zh` — китайский. Значения `warehouseName` на английском
groupByBrand	boolean Default: "false" Example: groupByBrand=true Разбивка по брендам
groupBySubject	boolean Default: "false" Example: groupBySubject=true Разбивка по предметам
groupBySa	boolean Default: "false" Example: groupBySa=true Разбивка по артикулам продавца
groupByNm	boolean Default: "false" Example: groupByNm=true Разбивка по артикулам WB. Если `groupByNm=true`, в ответе будет поле `volume`
groupByBarcode	boolean Default: "false" Example: groupByBarcode=true Разбивка по баркодам
groupBySize	boolean Default: "false" Example: groupBySize=true Разбивка по размерам
filterPics	integer Default: "0" Example: filterPics=1 Фильтр по фото: `-1` — без фото `0` — не применять фильтр `1` — с фото
filterVolume	integer Default: "0" Example: filterVolume=3 Фильтр по объёму: `-1` — без габаритов `0` — не применять фильтр `3` — свыше трёх литров

Responses

Response samples

200
400
401
429

Content type

application/json

{"data": {"taskId": "219eaecf-e532-4bd8-9f15-8036ec1b042d"
}
}

Проверить статус{{ /api/v1/warehouse_remains/tasks/{task_id}/status }}

Описание метода

Возвращает статус задания на генерацию

Максимум 1 запрос в 5 секунд на один аккаунт продавца

Authorizations:

HeaderApiKey

path Parameters

task_id

required

string

Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2

ID задания на генерацию

Responses

Response samples

200
400
401
429

Content type

application/json

{"data": {"id": "cad56ec5-91ec-43a2-b5e8-efcf244cf309",
"status": "done"
}
}

Получить отчёт{{ /api/v1/warehouse_remains/tasks/{task_id}/download }}

Описание метода

Возвращает отчёт по ID задания

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

path Parameters

task_id

required

string

Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2

ID задания на генерацию

Responses

Response samples

200
400
401
429

Content type

application/json

[{"brand": "Wonderful",
"subjectName": "Фотоальбомы",
"vendorCode": "41058/прозрачный",
"nmId": 183804172,
"barcode": "2037031652319",
"techSize": "0",
"volume": 1.33,
"inWayToClient": 31,
"inWayFromClient": 24,
"quantityWarehousesFull": 134,
"warehouses": [{"warehouseName": "Невинномысск",
"quantity": 134
}
]
}
]

Отчёты по удержаниям

Для доступа к методам используйте токен для категории Аналитика

Самовыкупы{{ /api/v1/analytics/antifraud-details }}

Описание метода

Возвращает отчёт по удержаниям за самовыкупы. Отчёт формируется каждую неделю по средам, до 7:00 по московскому времени, и содержит данные за одну неделю. Можно получить отчёт за всё время с августа 2023.

Удержание за самовыкуп — 30% от стоимости товаров. Минимальная сумма всех удержаний — 100 000 ₽, если за неделю в ПВЗ привезли больше ваших товаров, чем на 100 000 ₽

Максимум 10 запросов за 100 минут на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

date	string Example: date=2023-12-01 Дата, которая входит в отчётный период, `ГГГГ-ММ-ДД`. Чтобы получить данные за всё время с августа 2023, не указывайте этот параметр

Responses

Response samples

200
400
401
429

Content type

application/json

{"details": [{"nmID": 123456789,
"sum": 3540,
"currency": "RUB",
"dateFrom": "2023-08-23",
"dateTo": "2023-08-29"
}
]
}

Подмена товара{{ /api/v1/analytics/incorrect-attachments }}

Описание метода

Возвращает отчёт об удержаниях за отправку не тех товаров, пустых коробок или коробок без товара, но с посторонними предметами. В таких случаях удерживается 100% от стоимости заказа.

Можно получить отчёт максимум за 31 день. Доступны данные с июня 2023

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string Example: dateFrom=2023-12-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string Example: dateTo=2023-12-15 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response samples

200
400
401
429

Content type

application/json

{"report": [{"amount": 24514.5,
"date": "2023-12-15",
"lostReason": "Подмена. Вместо большой железной дороги поступила маленькая коробка.",
"nmID": 123456789,
"photoUrl": "https://mstatic.wbstatic.net/writeoff_to_the_seller/12345678911-2023-06-21T12:13:37.768Z-1.png",
"shkID": 14555724540
}
]
}

Коэффициент логистики и хранения{{ /api/v1/analytics/storage-coefficient }}

Описание метода

Возвращает коэффициенты логистики и хранения. Они рассчитываются на неделю, с понедельника по воскресенье.

В начале каждой недели для продавца рассчитывается новый коэффициент логистики и хранения. Затем стоимость логистики и хранения умножается на коэффициент этой недели.

Коэффициент считается на основе расхождения фактических и заявленных габаритов упаковки товара:

Измеряем товары.
Работники склада измеряют по одному товару каждого наименования с учётом упаковки (кроме товаров меньше 2 литров). Для расчёта используются измерения за 30 дней до начала текущей недели.
Считаем коэффициент для товара.
Результаты измерений сравниваются с габаритами из карточки товара. В зависимости от разницы каждому наименованию присваивается коэффициент по товару.
Считаем коэффициент логистики и хранения.
Коэффициент логистики и хранения — это средний коэффициент по товарам.

Коэффициент логистики и хранения равен 1, если:

По товарам продавца сделано меньше 10 уникальных измерений
Средняя разница в габаритах не больше 10%

Для продавцов с коэффициентом 1 стоимость логистики и хранения не увеличивается.

Можно получить данные с 31 октября 2022

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

date	string Example: date=2023-12-01 Дата, которая входит в отчётный период, `ГГГГ-ММ-ДД`

Responses

Response samples

200
400
401
429

Content type

application/json

{"report": [{"actualHeight": 6,
"actualLength": 39,
"actualVolume": 7.02,
"actualWidth": 30,
"date": "2023-04-11T12:21:19Z",
"dimensionDifference": 101.74,
"height": 10,
"length": 30,
"logWarehouseCoef": 1,
"nmID": 123456789,
"photoUrls": ["https://photos.wbstatic.net/handheld-goods-measurements-photo/123456789_73984211-e6c3-44e2-66af-0d44d2620308.jpg",
"https://photos.wbstatic.net/handheld-goods-measurements-photo/123456789_8ee5ff5e-c6bb-426c-7d12-c2dd228c0f62.jpg"
],
"title": "Сухой корм для крупных собак ассорти мясное, 10 кг",
"volume": 6.9,
"width": 23
}
]
}

Маркировка товара{{ /api/v1/analytics/goods-labeling }}

Описание метода

Возвращает отчёт о штрафах за отсутствие обязательной маркировки товаров. В отчёте представлены фотографии товаров, на которых маркировка отсутствует либо не считывается. Можно получить данные максимум за 31 день, доступны данные с марта 2024

Максимум 10 запросов за 10 минут на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string <date> Example: dateFrom=2024-04-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string <date> Example: dateTo=2024-04-30 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response samples

200
400
401
429

Content type

application/json

{"report": [{"amount": 1500,
"date": "2024-03-26T01:00:00Z",
"incomeId": 18484008,
"nmID": 49434732,
"photoUrls": ["https://static-basket-03.wildberries.ru/vol54/photo-fixation-violation-shk-excise/12345678900-1811460999-1.jpg",
"https://static-basket-03.wildberries.ru/vol54/photo-fixation-violation-shk-excise/12345678900-1811461000-2.jpg",
"https://static-basket-03.wildberries.ru/vol54/photo-fixation-violation-shk-excise/12345678900-1811461001-3.jpg"
],
"shkID": 17346434621,
"sku": "4630153500834"
}
]
}

Смена характеристик{{ /api/v1/analytics/characteristics-change }}

Описание метода

Возвращает отчёт об удержаниях за смену характеристик товара. Если товары после приёмки не соответствуют заявленным цветам и размерам, и на складе их перемаркировали с правильными характеристиками, по таким товарам назначается штраф. Можно получить отчёт максимум за 31 день, доступны данные с 28 декабря 2021

Максимум 10 запросов за 10 минут на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string <date> Example: dateFrom=2024-04-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string <date> Example: dateTo=2024-04-30 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response samples

200
400
401
429

Content type

application/json

{"report": [{"amount": 135890,
"date": "2024-03-01T01:00:00Z",
"newBarcode": "22222222222222",
"newColor": "темно-синий,голубой",
"newSa": "hjt13/темно-синий,голубой",
"newShkID": 44444444444,
"newSize": "80",
"nmID": 123654789,
"oldBarcode": "111111111111111",
"oldColor": "темно-синий,голубой",
"oldSa": "hjt13/темно-синий,голубой",
"oldShkID": 333333333,
"oldSize": "43"
}
]
}

Платная приёмка

Для доступа к методам используйте токен для категории Аналитика

Получить отчёт{{ /api/v1/analytics/acceptance-report }}

Описание метода

Возвращает даты и стоимость приёмки. Можно получить отчёт максимум за 31 день

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string Example: dateFrom=2023-12-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string Example: dateTo=2023-12-15 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response samples

200
400
401
429

Content type

application/json

{"report": [{"count": 40,
"giCreateDate": "2023-08-23",
"incomeId": 11834106,
"nmID": 123456789,
"shkСreateDate": "2023-04-10",
"subjectName": "Добавки пищевые",
"total": 200.5
}
]
}

Платное хранение

Для доступа к методам используйте токен для категории Аналитика

Чтобы получить отчёт:

Сгенерируйте отчёт
Дождитесь, когда отчёт будет готов. Вы можете проверить статус готовности отчёта. Готовый отчёт хранится 2 часа, после чего его нельзя будет получить.
Получите отчёт

Создать отчёт{{ /api/v1/paid_storage }}

Описание метода

Создаёт задание на генерацию отчёта. Можно получить отчёт максимум за 8 дней

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string Example: dateFrom=2022-01-01 Начало отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры: `2019-06-20` `2019-06-20T23:59:59` `2019-06-20T00:00:00.12345` `2017-03-25T00:00:00`
dateTo required	string Example: dateTo=2022-01-09 Конец отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры: `2019-06-20` `2019-06-20T23:59:59` `2019-06-20T00:00:00.12345` `2017-03-25T00:00:00`

Responses

Response samples

200
400
401
429

Content type

application/json

{"data": {"taskId": "219eaecf-e532-4bd8-9f15-8036ec1b042d"
}
}

Проверить статус{{ /api/v1/paid_storage/tasks/{task_id}/status }}

Описание метода

Возвращает статус задания на генерацию отчёта

Максимум 1 запрос в 5 секунд на один аккаунт продавца

Authorizations:

HeaderApiKey

path Parameters

task_id

required

string

Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2

ID задания на генерацию

Responses

Response samples

200
401
429

Content type

application/json

{"data": {"id": "cad56ec5-91ec-43a2-b5e8-efcf244cf309",
"status": "done"
}
}

Получить отчёт{{ /api/v1/paid_storage/tasks/{task_id}/download }}

Описание метода

Возвращает отчёт по ID задания

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

path Parameters

task_id

required

string

Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2

ID задания на генерацию

Responses

Response samples

200
401
429

Content type

application/json

[{"date": "2023-10-01",
"logWarehouseCoef": 1,
"officeId": 507,
"warehouse": "Коледино",
"warehouseCoef": 1.7,
"giId": 123456,
"chrtId": 1234567,
"size": "0",
"barcode": "",
"subject": "Маски одноразовые",
"brand": "1000 Каталог",
"vendorCode": "567383",
"nmId": 1234567,
"volume": 12,
"calcType": "короба: без габаритов",
"warehousePrice": 7.65,
"barcodesCount": 1,
"palletPlaceCode": 0,
"palletCount": 0,
"originalDate": "2023-03-01",
"loyaltyDiscount": 10,
"tariffFixDate": "2023-10-01",
"tariffLowerDate": "2023-11-01"
}
]

Продажи по регионам

Для доступа к методам используйте токен для категории Аналитика

Получить отчёт{{ /api/v1/analytics/region-sale }}

Описание метода

Возвращает данные продаж, сгруппированные по регионам стран. Можно получить отчёт максимум за 31 день.

Максимум 1 запрос в 10 секунд на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string Example: dateFrom=2023-12-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string Example: dateTo=2023-12-15 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response samples

200
400
401
429

Content type

application/json

{"report": [{"cityName": "деревня Суханово",
"countryName": "Россия",
"foName": "Центральный федеральный округ",
"nmID": 177974431,
"regionName": "Московская область",
"sa": "112233445566778899",
"saleInvoiceCostPrice": 592.11,
"saleInvoiceCostPricePerc": 43.0547333297454,
"saleItemInvoiceQty": 4
}
]
}

Доля бренда в продажах

Для доступа к методам используйте токен для категории Аналитика

Отчёты по доле бренда продавца в продажах.

Для получения отчёта вам понадобятся:

Можно получить отчёт максимум за год

Бренды продавца{{ /api/v1/analytics/brand-share/brands }}

Описание метода

Возвращает список брендов продавца.

Можно получить только бренды, которые:

продавались за последние 90 дней
есть на складе WB

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

Responses

Response samples

200
401
429

Content type

application/json

{"data": ["1000 | Каталог",
"1000 Каталог",
"AndBerries",
"H&M",
"Mirtex",
"PlayToday",
"Test1",
"WOW",
"[\"Colambetta\"]",
"dubs",
"test",
"Бест Трикотаж",
"Тест"
]
}

Родительские категории бренда{{ /api/v1/analytics/brand-share/parent-subjects }}

Описание метода

Возвращает родительские категории бренда.

Можно получить данные с 1 ноября 2022 года, максимум за 365 дней.

Максимум 1 запрос 5 секунд на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

locale	string Default: "ru" Example: locale=ru Язык поля ответа `parentName`: `ru` — русский `en` — английский `zh` — китайский
brand required	string Example: brand=H%26M Бренд
dateFrom required	string Example: dateFrom=2023-12-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string Example: dateTo=2023-12-15 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response samples

200
400
401
429

Content type

application/json

{"data": [{"parentId": 3,
"parentName": "Аксессуары"
},
{"parentId": 7,
"parentName": "Игрушки"
},
{"parentId": 1,
"parentName": "Одежда"
},
{"parentId": 239,
"parentName": "Спортивный товар"
}
]
}

Получить отчёт{{ /api/v1/analytics/brand-share }}

Описание метода

Возвращает отчёт по доле бренда в продажах.

Можно получить данные с 1 ноября 2022 года, максимум за 365 дней.

Максимум 1 запрос 5 секунд на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

parentId required	integer Example: parentId=1 ID родительской категории
brand required	string Example: brand=H%26M Бренд
dateFrom required	string Example: dateFrom=2023-12-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string Example: dateTo=2023-12-15 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response samples

200
400
401
429

Content type

application/json

{"report": [{"applyDate": "2023-10-31",
"brandRating": 5,
"pricePercent": 0.68,
"qtyPercent": 1
},
{"applyDate": "2023-11-01",
"brandRating": 5,
"pricePercent": 0.65,
"qtyPercent": 0.99
},
{"applyDate": "2023-11-02",
"brandRating": 4,
"pricePercent": 0.74,
"qtyPercent": 1.23
},
{"applyDate": "2023-11-03",
"brandRating": 2,
"pricePercent": 0.76,
"qtyPercent": 1.39
}
]
}

Скрытые товары

Для доступа к методам используйте токен для категории Аналитика

Заблокированные карточки{{ /api/v1/analytics/banned-products/blocked }}

Описание метода

Возвращает список заблокированных карточек

Максимум 1 запрос 10 секунд на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

sort

required

string

Enum: "brand" "nmId" "title" "vendorCode" "reason"

Example: sort=nmId

Сортировка

brand — по бренду
nmId — по артикулу WB
title — по наименованию товара
vendorCode — по артикулу продавца
reason — по причине блокировки

order

required

string

Enum: "desc" "asc"

Example: order=asc

Порядок выдачи

desc — от наибольшего числового значения к наименьшему, от последнего по алфавиту значения к первому
asc — от наименьшего числового значения к наибольшему, от первого по алфавиту значения к последнему

Responses

Response samples

200
400
401
429

Content type

application/json

{"report": [{"brand": "Тест22",
"nmId": 82722944,
"title": "Гуминовые кислоты - биоактивный противовирусный комплекс на",
"vendorCode": "пкdeир76",
"reason": "Контактные данные Продавца и ссылки на иные сайты/группы/сообщества на фотографиях Товара"
}
]
}

Скрытые из каталога{{ /api/v1/analytics/banned-products/shadowed }}

Описание метода

Возвращает список товаров, скрытых из каталога

Максимум 1 запрос 10 секунд на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

sort

required

string

Enum: "brand" "nmId" "title" "vendorCode" "nmRating"

Example: sort=title

Сортировка

brand — по бренду
nmId — по артикулу WB
title — по наименованию товара
vendorCode — по артикулу продавца
nmRating — по рейтингу товара

order

required

string

Enum: "desc" "asc"

Example: order=desc

Порядок выдачи

desc — от наибольшего числового значения к наименьшему, от последнего по алфавиту значения к первому
asc — от наименьшего числового значения к наибольшему, от первого по алфавиту значения к последнему

Responses

Response samples

200
400
401
429

Content type

application/json

{"report": [{"brand": "Трикотаж",
"nmId": 166658151,
"title": "ВАЗ",
"vendorCode": "DP02/черный",
"nmRating": 3.1
}
]
}

Отчёт по возвратам товаров

Для доступа к методам используйте токен для категории Аналитика

Получить отчёт{{ /api/v1/analytics/goods-return }}

Описание метода

Возвращает перечень возвратов товаров продавцу. Одним запросом можно получить отчёт максимум за 31 день.

Максимум 1 запрос минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string <date> Example: dateFrom=2024-08-13 Дата начала отчётного периода
dateTo required	string <date> Example: dateTo=2024-08-27 Дата окончания отчётного периода

Responses

Response samples

200
400
401
429

Content type

application/json

{"report": [{"barcode": "1680063403480",
"brand": "dub",
"dstOfficeAddress": "Жуковский Улица Маяковского 19",
"dstOfficeId": 310105,
"isStatusActive": 0,
"nmId": 12862181,
"orderDt": "2024-08-26",
"returnType": "Возврат заблокированного товара",
"shkId": 23411783472,
"srid": "f4f02193-289d-4303-aead-73b5b6d40dd9.99",
"status": "В пути в пвз",
"stickerId": "33811984302",
"subjectName": "Багажные бирки",
"techSize": "0"
}
]
}

Отчёты (reports)

Отчёты

Отчёты по товарам

Поставки{{ /api/v1/supplier/incomes }}

Authorizations:

query Parameters

Responses

Response samples

Склад{{ /api/v1/supplier/stocks }}

Authorizations:

query Parameters

Responses

Response samples

Заказы{{ /api/v1/supplier/orders }}

Authorizations:

query Parameters

Responses

Response samples

Продажи{{ /api/v1/supplier/sales }}

Authorizations:

query Parameters

Responses

Response samples

Отчёт по товарам с обязательной маркировкой{{ /api/v1/analytics/excise-report }}

Authorizations:

query Parameters

Request Body schema: application/jsonoptional

Responses

Request samples

Response samples

Отчёт по остаткам на складах

Создать отчёт{{ /api/v1/warehouse_remains }}

Authorizations:

query Parameters

Responses

Response samples

Проверить статус{{ /api/v1/warehouse_remains/tasks/{task_id}/status }}

Authorizations:

path Parameters

Responses

Response samples

Получить отчёт{{ /api/v1/warehouse_remains/tasks/{task_id}/download }}

Authorizations:

path Parameters

Responses

Response samples

Отчёты по удержаниям

Самовыкупы{{ /api/v1/analytics/antifraud-details }}

Authorizations:

query Parameters

Responses

Response samples

Подмена товара{{ /api/v1/analytics/incorrect-attachments }}

Authorizations:

query Parameters

Responses

Response samples

Коэффициент логистики и хранения{{ /api/v1/analytics/storage-coefficient }}

Authorizations:

query Parameters

Responses

Response samples

Маркировка товара{{ /api/v1/analytics/goods-labeling }}

Authorizations:

query Parameters

Responses

Response samples

Смена характеристик{{ /api/v1/analytics/characteristics-change }}

Authorizations:

query Parameters

Responses

Response samples

Платная приёмка

Получить отчёт{{ /api/v1/analytics/acceptance-report }}

Authorizations:

query Parameters

Responses

Response samples

Платное хранение

Создать отчёт{{ /api/v1/paid_storage }}

Request Body schema: application/json
optional