报告的结构及内容如有更改,恕不另行通知。
例如,可以添加新列或更改工作表的名称。
营业额报告
方法适用于模式FBY.
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
开始生成指定日期的营业额报告。 这是什么报告
您可以使用请求查找生成状态并获取指向已完成报告的链接。 GET v2/reports/info/{reportId}.
报告列说明:
表单Все категории(文件turnover)
|
CSV中的列名 |
JSON中的列名 |
XLSX中的列名 |
值类型 |
|
WAREHOUSE_NAME |
warehouseName |
Склад Маркета |
string |
|
MACROREGION_NAME |
macroregionName |
Кластер |
string |
|
CATEGORY |
category |
Категория |
string |
|
SHOP_SKU |
shopSku |
Ваш SKU |
string |
|
MARKET_SKU |
marketSku |
SKU на Маркете |
integer |
|
OFFER_NAME |
offerName |
Название товара |
string |
|
LENGTH |
length |
Длина, мм |
integer |
|
WIDTH |
width |
Ширина, мм |
integer |
|
HEIGHT |
height |
Высота, мм |
integer |
|
VOLUME |
volume |
Объём, л |
number |
|
TURNOVER |
turnover |
Оборачиваемость |
string |
|
MARKET_RECOMMENDATION |
marketRecommendation |
Рекомендация Маркета |
string |
|
AVG_SOLD_VOLUME |
avgSoldVolume |
Среднесуточный объём проданных товаров, л |
number |
|
AVG_SOLD_ITEMS |
avgSoldItems |
Среднесуточное количество проданных товаров, шт. |
number |
|
AVG_SOLD_VOLUME_ON_STOCK |
avgSoldVolumeOnStock |
Среднесуточный объём товаров на складе, л |
number |
|
ITEMS_ON_STOCK |
itemsOnStock |
Остаток на последний день периода, шт. |
integer |
|
AMOUNT |
amount |
Стоимость платного хранения.* |
number |
表单Льготное хранение(文件preferential_categories_turnover)
|
CSV中的列名 |
JSON中的列名 |
XLSX中的列名 |
值类型 |
|
WAREHOUSE_NAME |
warehouseName |
Склад Маркета |
string |
|
MACROREGION_NAME |
macroregionName |
Кластер |
string |
|
CATEGORY |
category |
Категория |
string |
|
SHOP_SKU |
shopSku |
Ваш SKU |
string |
|
MARKET_SKU |
marketSku |
SKU на Маркете |
integer |
|
OFFER_NAME |
offerName |
Название товара |
string |
|
LENGTH |
length |
Длина, мм |
integer |
|
WIDTH |
width |
Ширина, мм |
integer |
|
HEIGHT |
height |
Высота, мм |
integer |
|
VOLUME |
volume |
Объём, л |
number |
|
TURNOVER |
turnover |
Оборачиваемость |
number |
|
MARKET_RECOMMENDATION |
marketRecommendation |
Рекомендация Маркета |
string |
|
AVG_SOLD_VOLUME |
avgSoldVolume |
Среднесуточный объём проданных товаров, л |
number |
|
AVG_SOLD_ITEMS |
avgSoldItems |
Среднесуточное количество проданных товаров, шт. |
number |
|
AVG_SOLD_VOLUME_ON_STOCK |
avgSoldVolumeOnStock |
Среднесуточный объём товаров на складе, л |
number |
|
ITEMS_ON_STOCK |
itemsOnStock |
Остаток на последний день периода, шт. |
integer |
|
AMOUNT |
amount |
Стоимость платного хранения.* |
number |
| ⚙️ 限制: 每小时100个请求 |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/reports/goods-turnover/generate
Query parameters
|
Name |
Description |
|
format |
Type: string 报告或文档的格式。 报告格式:
Default: Enum: |
Body
application/json
{
"campaignId": 1,
"date": "2025-01-01"
}
|
Name |
Description |
|
campaignId |
Type: integer 广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:
⚠️ 不要把它与:
Min value: |
|
date |
Type: string<date> 需要计算营业额的日期。 如果省略该参数,则使用当前日期。 日期格式: Example: |
Responses
200 OK
作为响应,您会收到一个标识符,该标识符允许您查找生成状态并下载完成的报告。
Body
application/json
{
"status": "OK"
}
Type: object
500 Internal Server Error
Yandex中的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK"
}
Type: object
No longer supported, please use an alternative and newer version.