---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/step-by-step/reports.md
  - https://yandex.com/dev/market/partner-api/doc/ru/step-by-step/reports.md
  - https://yandex.com/dev/market/partner-api/doc/zh/step-by-step/reports.md
  - href: zh/step-by-step/reports.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/zh/llms.txt

# 如何接收报告和文件

  都市人   允许您接收报告和文档。 [他们的类型](#generate)

生成需要时间，因此首先需要对生成本身提出请求，然后接收完成的报告或文档。



<!-- source: zh/_includes/mermaid/reports.md -->
```mermaid
%%{
  init: {
    'theme': 'base',
    'themeVariables': {
      'primaryColor': '#FDF3E8',
      'primaryTextColor': '#000000',
      'primaryBorderColor': '#BA9C80',
      'lineColor': '#BA9C80',
      'secondaryColor': '#94E1C4',
      'tertiaryColor': '#F84E57',
      'noteBkgColor': '#FED58D'
    }
  }
}%%

sequenceDiagram
    participant Merchant as 您的商店
    participant Market as Yandex Market

    rect rgb(251, 243, 232)
        note right of Merchant: 获取报告或文档
        Merchant ->>+ Market: POST v2/reports/<report_name>/generate
        Market ->> Market: 将报告或文档<br>加入生成队列。
        Market -->>- Merchant: OK: 用于获取生成结果的标识符，<br>以及预计生成时间<br>(reportId + estimatedGenerationTime)。
    end

    opt
      rect rgb(251, 243, 232)
        note right of Merchant: 可选步骤
        note right of Merchant: 检查生成状态
        Merchant ->> Market: GET v2/reports/info/<report_id>
        Market -->> Merchant: OK: 状态及剩余时间<br>(status + estimatedGenerationTime)。
      end
    end

    rect rgb(251, 243, 232)
        note right of Merchant: 在estimatedGenerationTime指定时间后获取生成的报告或文档
        Merchant ->> Market: GET v2/reports/info/<report_id>
        Market -->> Merchant: OK: 状态及下载链接。<br>生成成功 — status = DONE + file。<br>生成失败 — status = FAILED 或 status = NODATA。
    end
```
<!-- endsource: zh/_includes/mermaid/reports.md -->


## 如何订购报告或文件 {#generate}

发出与您需要的报告或文档类型相匹配的请求。 在请求中，设置设置和过滤器，并指定要获取结果的格式。 可用的格式在每个方法的描述中指定。


#|
|| **报告或文件类型**                  | **如何开始生成**                                                                                                 ||


|| 市场推广帐目报告                     |[POST v1/businesses/{businessId}/reports/marketing-detalization/generate](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateMarketingDetalizationReport.md)||
|| 复盖推广报告                |[POST v2/reports/banners-statistics/generate](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateBannersStatisticsReport.md)                       ||
|| 印象提升报告                        |[POST v2/reports/shows-boost/generate](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateShowsBoostReport.md)                                     ||
|| 销售促进报告                         |[POST v2/reports/boost-consolidated/generate](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateBoostConsolidatedReport.md)                       ||
|| 货架报告                               |[POST v2/reports/shelf-statistics/generate](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateShelfsStatisticsReport.md)                          ||


|#

## 如何知道报告或文件是否已准备就绪？ {#status}

提出要求 [GET v2/reports/info/{reportId}](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/getReportInfo.md).

您将收到报告或文档生成的状态以及生成完成之前剩余的大致时间。

## 如何获得现成的报告或文件 {#get}

生成时间结束后，重复请求。 [GET v2/reports/info/{reportId}](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/getReportInfo.md).<br><br>如果报告或文档已生成，您将收到一个下载链接。<br><br> {% note warning "Срок действия ссылки" %} <br><br>链接是相关的 **60分钟** 从收到响应的那一刻起。 每个请求 `GET /v2/reports/info/{reportId}` 生成新的已签名链接，该链接具有有限的有效期。<br><br>**整合建议:** 收到链接后，立即下载报告并保存给自己。 不要保存链接以供以后使用。 — 过期后将失效.<br><br> :no-translate[{% endnote %}]