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

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

销售分析报告

方法适用于所有模式.

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

开始生成指定期间的销售分析报告。 这是什么报告

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

报告列说明：

表单Аналитика продаж（文件sales_funnel_report）

CSV中的列名

JSON中的列名

XLSX中的列名

值类型

DAY

day

День

string

MONTH

month

Месяц

string

YEAR

year

Год

integer

CATEGORY_NAME

categoryName

Категория

string

BRAND_NAME

brandName

Бренд

string

OFFER_ID

offerId

Ваш SKU

string

OFFER_NAME

offerName

Название товара

string

BY_MSKU_SHOWS

byMskuShows

Показы товаров всех продавцов, шт.

integer

VISIBILITY_INDEX

visibilityIndex

Индекс видимости, %

string

SHOWS

shows

Показы моих товаров, шт.

integer

SHOWS_WITH_PROMOTION

showsWithPromotion

Показы моих товаров с акциями, шт.

integer

SHOWS_SHARE

showsShare

Доля показов с бустом, %

number

CLICKS

clicks

Клики по товарам, шт.

integer

CLICKS_WITH_PROMOTION

clicksWithPromotion

Клики по товарам с акциями, шт.

integer

TO_CART_CONVERSION

toCartConversion

Конверсия из показа в корзину, %

number

TO_CART

toCart

Добавления в корзину, шт.

integer

TO_CART_WITH_PROMOTION

toCartWithPromotion

Добавления в корзину по акциям, шт.

integer

TO_CART_SHARE

toCartShare

Доля добавлений товаров с бустом в корзину, %

number

ORDER_ITEMS

orderItems

Заказанные товары, шт.

integer

ORDER_ITEMS_WITH_PROMOTION

orderItemsWithPromotion

Заказанные товары по акциям, шт.

integer

ORDER_ITEMS_TOTAL_AMOUNT

orderItemsTotalAmount

Заказано товаров на сумму, ₽

integer

ORDER_ITEMS_TOTAL_AMOUNT_WITH_PROMOTION

orderItemsTotalAmountWithPromotion

Заказано товаров с акциями на сумму, ₽

integer

TO_ORDER_CONVERSION

toOrderConversion

Конверсия из корзины в заказ, %

number

ORDER_ITEMS_SHARE

orderItemsShare

Доля заказанных товаров с бустом, %

number

ORDER_ITEMS_DELIVERED_COUNT

orderItemsDeliveredCount

Доставлено за период, шт.

integer

ORDER_ITEMS_DELIVERED_COUNT_WITH_PROMOTION

orderItemsDeliveredCountWithPromotion

Доставлено за период по акциям, шт.

string

ORDER_ITEMS_DELIVERED_TOTAL_AMOUNT

orderItemsDeliveredTotalAmount

Доставлено за период на сумму, ₽

integer

ORDER_ITEMS_DELIVERED_TOTAL_AMOUNT_WITH_PROMOTION

orderItemsDeliveredTotalAmountWithPromotion

Доставлено за период по акциям на сумму, ₽

integer

ORDER_ITEMS_DELIVERED_FROM_ORDERED_COUNT

orderItemsDeliveredFromOrderedCount

Доставлено из заказанных за период, шт.

integer

ORDER_ITEMS_DELIVERED_FROM_ORDERED_TOTAL_AMOUNT

orderItemsDeliveredFromOrderedTotalAmount

Доставлено из заказанных на сумму за период, ₽

integer

ORDER_ITEMS_DELIVERED_FROM_ORDERED_TOTAL_AMOUNT_WITH_PROMOTION

orderItemsDeliveredFromOrderedTotalAmountWithPromotion

Доставлено из заказанных на сумму за период по акциям, ₽

integer

ORDER_ITEMS_CANCELED_COUNT

orderItemsCanceledCount

Отмены и невыкупы за период, шт.

integer

ORDER_ITEMS_CANCELED_BY_CREATED_AT_COUNT

orderItemsCanceledByCreatedAtCount

Отмены и невыкупы заказанного за период, шт.

integer

ORDER_ITEMS_RETURNED_COUNT

orderItemsReturnedCount

Возвращённые товары за период, шт.

integer

ORDER_ITEMS_RETURNED_BY_CREATED_AT_COUNT

orderItemsReturnedByCreatedAtCount

Возвраты заказанного за период, шт.

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

Request

POST

https://api.partner.market.yandex.ru/v2/reports/shows-sales/generate

Query parameters

Name

Description

format

Type: string

报告或文档的格式。 报告格式:

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

Default: FILE

Enum: FILE, CSV, JSON

Body

application/json
{
  "businessId": 1,
  "campaignId": 1,
  "dateFrom": "2025-08-22",
  "dateTo": "2025-09-22",
  "grouping": "CATEGORIES"
}

Name

Description

dateFrom

Type: string<date>

期的开始，包括在内。

日期格式: YYYY-MM-DD.

Example: 2025-08-22

dateTo

Type: string<date>

期结束，包括在内。

日期格式: YYYY-MM-DD.

Example: 2025-09-22

grouping

Type: string

报表数据的分组。 可能的值:

  • CATEGORIES — 按类别分组。
  • OFFERS — 按产品分组。

Enum: CATEGORIES, OFFERS

businessId

Type: integer

内阁ID。 要找到答案，请使用请求 GET v2/campaigns.

ℹ️ 什么是市场上的橱柜和商店？

Min value: 1

campaignId

Type: integer

广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。

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

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

⚠️ 不要把它与:

  • 商店的标识符，显示在商家的个人帐户中。
  • 广告活动。

Min value: 1

Responses

200 OK

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

Body

application/json
{
  "status": "OK"
}

Type: object

400 Bad Request

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

Body

application/json
{
  "status": "OK"
}

Type: object

401 Unauthorized

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

Body

application/json
{
  "status": "OK"
}

Type: object

403 Forbidden

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

Body

application/json
{
  "status": "OK"
}

Type: object

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK"
}

Type: object

420 Method Failure

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

Body

application/json
{
  "status": "OK"
}

Type: object

500 Internal Server Error

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

Body

application/json
{
  "status": "OK"
}

Type: object

pathParams: []
searchParams:
  - description: 报告或文档的格式。
    name: format
    in: query
    required: false
    schema:
      description: |
        报告格式:

        * `FILE` — 电子表格文件（XLSX).
        * `CSV` — 每个报告表都有一个包含CSV文件的ZIP存档。
        * `JSON` — 每个报告表都有一个带有JSON文件的ZIP压缩包.
      type: string
      enum:
        - FILE
        - CSV
        - JSON
      default: FILE
headers: []
body: |-
  {
    "businessId": 1,
    "campaignId": 1,
    "dateFrom": "2025-08-22",
    "dateTo": "2025-09-22",
    "grouping": "CATEGORIES"
  }
schema:
  description: |
    生成报告所需的数据。

    请求必须包含 `businessId`，或 `campaignId` 但不是同时两种。
  type: object
  required:
    - dateFrom
    - dateTo
    - grouping
  properties:
    businessId:
      description: "内阁ID。 要找到答案，请使用请求 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [什么是市场上的橱柜和商店？](https://yandex.ru/support/marketplace/account/introduction.html)\n"
      type: integer
      format: int64
      minimum: 1
    campaignId:
      description: "广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。\n\n您可以使用查询找到它 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ **设置** 在左边的菜单中，选择 **Api和模块**:\n\n* 座 **运动ID**;\n* 标签 **查询日志** →块中的下拉列表 **显示日志**.\n\n⚠️ 不要把它与:\n- 商店的标识符，显示在商家的个人帐户中。\n- 广告活动。\n"
      type: integer
      format: int64
      minimum: 1
    dateFrom:
      type: string
      format: date
      description: |
        期的开始，包括在内。

        日期格式: `YYYY-MM-DD`.
      example: '2025-08-22'
    dateTo:
      type: string
      format: date
      description: |
        期结束，包括在内。

        日期格式: `YYYY-MM-DD`.
      example: '2025-09-22'
    grouping:
      type: string
      description: |
        报表数据的分组。
        可能的值:
        * `CATEGORIES` — 按类别分组。
        * `OFFERS` — 按产品分组。
      enum:
        - CATEGORIES
        - OFFERS
bodyType: application/json
method: post
security:
  - type: apiKey
    name: 'Api-Key'
    in: header
  - type: oauth2
    x-inline: true
    flows:
      implicit:
        authorizationUrl: https://oauth.yandex.ru/authorize
        scopes:
          market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
path: v2/reports/shows-sales/generate
host: https://api.partner.market.yandex.ru

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

上一篇
退款决定的转移和确认
下一篇
销售地理报告