报告的结构及内容如有更改，恕不另行通知。

例如，可以添加新列或更改工作表的名称。

市场价格报告

Deprecated

方法适用于所有模式.

如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一

我应该使用哪种方法而不是过时的方法？

POST v2/reports/goods-prices/generate

开始生成"市场价格"报告。

该报告仅返回50,000种产品的信息。 如果您有更多，请使用过滤器。

本报告中的数据不断更新

因此，信息是在它，并在卖方的帐户上的市场上的页面 价格；价格 它可能会有所不同。

您可以使用请求查找生成状态并获取指向已完成报告的链接。 GET v2/reports/info/{reportId}.

报告列说明：

表单Отчет "Цены на рынке"（文件business_prices_v2_report）

CSV中的列名

JSON中的列名

XLSX中的列名

值类型

SHOP_SKU

shopSku

SKU

string

OFFER

offer

Товар на Маркете

string

CATEGORY

category

Категория

string

MERCH_PRICE_WITH_PROMOS

merchPriceWithPromos

Ваша цена (Со скидками за ваш счёт, ₽)

integer

MERCH_PRICE_WITH_PROMOS

merchPriceWithPromos

Со скидками за ваш счёт, ₽

integer

MERCH_PRICE

merchPrice

Ваша цена, ₽

integer

PRICE_GREEN_THRESHOLD

priceGreenThreshold

Порог для привлекательной цены, ₽

integer

HOW_MUCH_TO_REDUCE

howMuchToReduce

На сколько снизить (до привлекательной цены, ₽)

integer

PRICE_RED_THRESHOLD

priceRedThreshold

Порог для умеренно привлекательной цены, ₽

integer

ON_DISPLAY

onDisplay

На витрине, ₽

integer

SHOWS_FOR_30_DAYS

showsFor30Days

Показы товара за 30 дней

integer

SALES_COUNT_FOR_30_DAYS

salesCountFor30Days

Продажи за 30 дней, шт.

integer

SALES_FOR_30_DAYS

salesFor30Days

Продажи за 30 дней, ₽

integer

MINIMUM_PRICE_ON_MARKETPLACES

minimumPriceOnMarketplaces

Минимальная на рынке, ₽

integer

MARKETPLACE_WITH_BEST_PRICE_WITHOUT_MARKET

marketplaceWithBestPriceWithoutMarket

Площадка с лучшей ценой (без учёта Маркета)

string

PRICE_VALUE_OUTSIDE_MARKET

priceValueOutsideMarket

Цена на этой площадке, ₽

integer

PRICE_VALUE_ON_MARKET

priceValueOnMarket

Цена в этом магазине, ₽

integer

SHOP_WITH_BEST_PRICE_ON_MARKET

shopWithBestPriceOnMarket

Магазин с лучшей ценой на Маркете

string

COMPARISON_OF_YOUR_PRICES_ON_MARKETPLACES

comparisonOfYourPricesOnMarketplaces

Сравнение ваших цен на площадках

string

PRICE

price

Цена, ₽

integer
⚙️ 限制: 每小时100个请求

Request

POST

https://api.partner.market.yandex.ru/v2/reports/prices/generate

Query parameters

Name

Description

format

Type: ReportFormatType

报告或文档的格式。

ReportFormatType

报告格式:

  • FILE — 电子表格文件（XLSX).
  • CSV — 每个报告表都有一个包含CSV文件的ZIP存档。
  • JSON — 每个报告表都有一个带有JSON文件的ZIP压缩包.

Type

Description

ReportFormatType

Default: FILE

Enum: FILE, CSV, JSON

Body

application/json
{
    "businessId": 0,
    "campaignId": 0,
    "categoryIds": [
        0
    ],
    "creationDateFrom": "string",
    "creationDateTo": "string"
}

Name

Description

businessId

Type: integer<int64>

内阁ID。

在大多数情况下需要。 如果指定，则省略 campaignId.

campaignId

Type: integer<int64>

活动ID。

只有在橱柜中有独特价格的商店并且您希望收到他们的报告时才发送它。 在这种情况下，发送 businessId 不需要。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置 在左边的菜单中，选择 Api和模块:

  • 座 运动ID;
  • 标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

categoryIds

Type: integer<int32>[]

在市场上按类别过滤。

Min value (exclusive): 0

Min items: 1

Unique items  

creationDateFrom

Type: string<date>

在添加第一个产品信息时进行筛选 — 期的开始。

日期格式: DD-MM-YYYY.

creationDateTo

Type: string<date>

在添加第一个产品信息时进行筛选 — 期的结束。

日期格式: DD-MM-YYYY.

Responses

200 OK

作为响应，您会收到一个标识符，该标识符允许您查找生成状态并下载完成的报告。

Body

application/json
{
    "status": "OK",
    "result": {
        "reportId": "string",
        "estimatedGenerationTime": 0
    }
}

Name

Description

status*

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

result

Type: GenerateReportDTO

跟踪生成状态和接收完成的报告或文档所需的ID。

ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

GenerateReportDTO

跟踪生成状态和接收完成的报告或文档所需的ID。

Name

Description

estimatedGenerationTime*

Type: integer<int64>

以毫秒为单位的预期生成时间。

reportId*

Type: string

跟踪生成状态和接收完成的报告或文档所需的ID。

400 Bad Request

请求包含不正确的数据。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

ApiErrorDTO

一般错误格式。

Name

Description

code*

Type: string

的错误代码。

message

Type: string

错误的描述。

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

500 Internal Server Error

市场的内部错误。 有关错误的更多信息

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: ApiErrorDTO[]

错误列表。
一般错误格式。

Min items: 1

status

Type: ApiResponseStatusType

响应的类型。 可能的值:

  • OK — 没有错误。
  • ERROR — 处理请求时出错。

Enum: OK, ERROR

No longer supported, please use an alternative and newer version.

上一篇
作出退款决定（DBS)
下一篇
仓库一览表