---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/reference/reports/generateClosureDocumentsDetalizationReport.md
  - https://yandex.com/dev/market/partner-api/doc/ru/reference/reports/generateClosureDocumentsDetalizationReport.md
  - https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateClosureDocumentsDetalizationReport.md
  - href: zh/reference/reports/generateClosureDocumentsDetalizationReport.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

{% note warning "报告的结构及内容如有更改，恕不另行通知" %}

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

{% endnote %}

<!-- source: zh/api/reports/generateClosureDocumentsDetalizationReport.md -->
<div class="openapi">

# 关于与结束文件趋同的报告

<!-- markdownlint-disable-file -->

{% list tabs %}

- Info

  
  <!-- source: zh/_auto/method_scopes/generateClosureDocumentsDetalizationReport.md -->
  **方法适用于[所有模式](https://yandex.com/dev/market/partner-api/doc/zh/overview/business.md).**

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

  * finance-and-accounting — [查看财务信息和报告](https://yandex.com/dev/market/partner-api/doc/zh/_auto/scopes_summary/pages/finance-and-accounting.md)
  * all-methods — 全面管理账户
  * all-methods:read-only — 查看所有数据

  {% endcut %}
  <!-- endsource: zh/_auto/method_scopes/generateClosureDocumentsDetalizationReport.md -->
  
  
  根据合同的类型，开始生成收敛报告和结束文件。
  
  您可以使用请求查找生成状态并获取指向已完成报告的链接。 [GET v2/reports/info/{reportId}](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/getReportInfo.md).
  
  
  {% list tabs %}
  
  
  - 就业协议
  
    
    <!-- source: zh/_auto/reports/period_closure/period_closure_income.md -->
    报告列说明：

    {% cut "表单**订单执行报告**（文件**period_closure_income_summary**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || PAYMENTS | payments | 报告付款 | string ||
    || PAYMENTS_DESCRIPTION | paymentsDescription | 这些付款是什么？ | string ||
    || PAYMENT_SUM | paymentSum | 付款金额* | number ||
    |#

    {% endcut %}

    {% cut "表单**已从消费者接收**（文件**period_closure_income_payments**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**退回给消费者**（文件**period_closure_income_refunds**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**以客户名义进行的销售**（文件**period_closure_income_sold_refunds**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**已售出商品的退货**（文件**period_closure_income_sold_defect_refunds**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**为 Yandex Market 服务预扣**（文件**period_closure_income_fees**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**扣缴罚款**（文件**period_closure_income_fines**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**Yandex Market 的补偿**（文件**period_closure_income_compensations**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**奖金**（文件**period_closure_income_netting**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**奖励调整**（文件**period_closure_income_premium_correction**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**取得求偿权**（文件**period_closure_income_cession**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**取消债务**（文件**period_closure_income_debt_write_off**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**要转移给您**（文件**period_closure_income_will_be_paid**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**转移至您的帐户**（文件**period_closure_income_paid**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}
    <!-- endsource: zh/_auto/reports/period_closure/period_closure_income.md -->
  
  
  - 推广协议
  
    
    <!-- source: zh/_auto/reports/period_closure/period_closure_outcome.md -->
    报告列说明：

    {% cut "表单**促销服务证书**（文件**period_closure_outcome_summary**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || SERVICES | services | 证书中的服务 | string ||
    || SERVICES_DESCRIPTION | servicesDescription | 该服务的补偿 | string ||
    || SERVICES_SUM | servicesSum | 服务成本* | number ||
    |#

    {% endcut %}

    {% cut "表单**交易平台折扣**（文件**period_closure_outcome_subsidy**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**Yandex Plus 积分**（文件**period_closure_outcome_plus**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**完成挑战的奖金**（文件**period_closure_outcome_benefits**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}

    {% cut "表单**交易平台配送折扣**（文件**period_closure_outcome_delivery**）" %}

    #|
    || **CSV中的列名** | **JSON中的列名** | **XLSX中的列名** | **值类型** ||
    || BUSINESS_ID | businessId | 企业信息/企业帐户 ID | integer ||
    || MODEL | model | 企业信息/运营模式 | string ||
    || PARTNER_ID | partnerId | 企业信息/商店 ID | integer ||
    || SHOP_NAME | shopName | 企业信息/商店名称 | string ||
    || INN | inn | 企业信息/INN（纳税人识别号） | string ||
    || PLACEMENT_CONTRACT | placementContract | 企业信息/投放协议编号 | string ||
    || PROMOTION_CONTRACT | promotionContract | 企业信息/促销协议编号 | string ||
    || TRANSACTION_DATE | transactionDate | 付款信息/交易日期 | string ||
    || TRANSACTION_ID | transactionId | 付款信息/交易 ID | string ||
    || ORDER_ID | orderId | 付款信息/所提供服务的订单或证书编号 | integer ||
    || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
    || ORDER_CREATION_DATE | orderCreationDate | 付款信息/所提供服务的订单或证书的日期 | string ||
    || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
    || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
    || OFFER_ID | offerId | 付款信息/您的 SKU | string ||
    || OFFER_NAME | offerName | 付款信息/商品名称 | string ||
    || COUNT | count | 付款信息/数量，单位 | integer ||
    || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
    || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
    || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
    || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
    || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
    || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
    || BANK_ORDER_SUM | bankOrderSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
    |#

    {% endcut %}
    <!-- endsource: zh/_auto/reports/period_closure/period_closure_outcome.md -->
  
  
  
  {% endlist %}
  
  
  
  <!-- source: zh/_auto/method_limits/generateClosureDocumentsDetalizationReport.md -->
  |<div style="text-align: left;">**⚙️ 没有订阅的限制:** 1 请求 在 2 分钟<br>**⭐️ [使用中等订阅限制](https://yandex.ru/support/marketplace/ru/marketing/subscription):** 1 请求 每分钟</div>|
  |-|
  <!-- endsource: zh/_auto/method_limits/generateClosureDocumentsDetalizationReport.md -->
  
  
  
  ## Request
  
  <div class="openapi__requests">
  
  <div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">
  
  <div class="openapi__request">
  
  POST {.openapi__method}
  ```text translate=no
  https://api.partner.market.yandex.ru/v2/reports/closure-documents/detalization/generate
  ```
  
  </div>
  
  </div>
  
  </div>
  
  ### Query parameters
  
  #|
  || **Name** | **Description** ||
  ||
  
  _format_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  报告或文档的格式。
  报告格式:
  
  * `FILE` — 电子表格文件（XLSX).
  * `CSV` — 每个报告表都有一个包含CSV文件的ZIP存档。
  * `JSON` — 每个报告表都有一个带有JSON文件的ZIP压缩包.
  
  
  _Default:_{.json-schema-reset .json-schema-value} `FILE`
  
  _Enum:_{.json-schema-reset .json-schema-value} `FILE`, `CSV`, `JSON`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "campaignId": 1,
    "monthOfYear": {
      "year": 2025,
      "month": 12
    },
    "contractType": "INCOME"
  }
  ```
  
  {% endcut %}
  
  #|
  || **Name** | **Description** ||
  ||
  
  _campaignId_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: integer
  
  广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。
  
  您可以使用查询找到它 [GET v2/campaigns](https://yandex.com/dev/market/partner-api/doc/zh/reference/campaigns/getCampaigns.md) 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ **设置** 在左边的菜单中，选择 **Api和模块**:
  
  * 座 **运动ID**;
  * 标签 **查询日志** →块中的下拉列表 **显示日志**.
  
  ⚠️ 不要把它与:
  - 商店的标识符，显示在商家的个人帐户中。
  - 广告活动。
  
  
  _Min value:_{.json-schema-reset .json-schema-assertion} `1`
  {.table-cell}
  ||
  ||
  
  _contractType_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: string
  
  协议类型:
  
  * `INCOME` — 的住宿协议。
  
  * `OUTCOME` — 的推广协议。
  
  
  _Enum:_{.json-schema-reset .json-schema-value} `INCOME`, `OUTCOME`, `MARKETING`
  {.table-cell}
  ||
  ||
  
  _monthOfYear_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  {% cut "**Type**: object" %}
  
  #|
  ||
  
  _month_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: integer
  
  月号。
  
  _Min value:_{.json-schema-reset .json-schema-assertion} `1`
  
  _Max value:_{.json-schema-reset .json-schema-assertion} `12`
  {.table-cell}
  ||
  ||
  
  _year_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: integer
  
  年。
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  {% endcut %}
  
  月份和年份。
  
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  {
    "year": 2025,
    "month": 12
  }
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  </div>
  
  ## Responses
  
  <div class="openapi__response__code__200">
  
  ## 200 OK
  
  作为响应，您会收到一个标识符，该标识符允许您查找生成状态并下载完成的报告。
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "result": {
      "reportId": "example",
      "estimatedGenerationTime": 0
    }
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _status_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    响应的类型。
    可能的值:
    * `OK` — 没有错误。
    * `ERROR` — 处理请求时出错。
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    服务器响应的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK"
    }
    ```
  
    {% endcut %}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _result_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _estimatedGenerationTime_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: integer
  
    预计生成时间以毫秒为单位。
    {.table-cell}
    ||
    ||
  
    _reportId_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    跟踪生成状态和接收完成的报告或文档所需的ID。
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    跟踪生成状态和接收完成的报告或文档所需的ID。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "reportId": "example",
      "estimatedGenerationTime": 0
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "result": {
        "reportId": "example",
        "estimatedGenerationTime": 0
      }
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__400">
  
  ## 400 Bad Request
  
  请求包含不正确的数据。 [详细了解报告和文档中的错误](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#reports)
  
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__401">
  
  ## 401 Unauthorized
  
  请求中未指定授权数据。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#401)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__403">
  
  ## 403 Forbidden
  
  授权数据不正确或禁止访问资源。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#403)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__404">
  
  ## 404 Not Found
  
  找不到请求的资源。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#404)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__420">
  
  ## 420 Method Failure
  
  已超出资源访问限制。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#420)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__500">
  
  ## 500 Internal Server Error
  
  市场的内部错误。 [有关错误的更多信息](https://yandex.com/dev/market/partner-api/doc/zh/concepts/error-codes.md#500)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      响应的类型。
      可能的值:
      * `OK` — 没有错误。
      * `ERROR` — 处理请求时出错。
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      服务器响应的标准包装器。
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      的错误代码。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      错误的描述。
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      错误列表。
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    服务器错误的标准包装器。
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
        

- Console

  ```openapi-sandbox translate=no
  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: |-
    {
      "campaignId": 1,
      "monthOfYear": {
        "year": 2025,
        "month": 12
      },
      "contractType": "INCOME"
    }
  schema:
    description: |
      生成报告所需的数据。
    type: object
    required:
      - campaignId
      - monthOfYear
      - contractType
    properties:
      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
      monthOfYear:
        description: |
          月份和年份。
        type: object
        required:
          - year
          - month
        properties:
          year:
            description: 年。
            type: integer
            format: int32
            example: 2025
          month:
            description: 月号。
            type: integer
            format: int32
            minimum: 1
            maximum: 12
            example: 12
      contractType:
        description: |
          协议类型:
  
          * `INCOME` — 的住宿协议。
  
          * `OUTCOME` — 的推广协议。
        type: string
        enum:
          - INCOME
          - OUTCOME
          - MARKETING
  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/closure-documents/detalization/generate
  host: https://api.partner.market.yandex.ru
  
  ```
        

{% endlist %}


</div>
<!-- endsource: zh/api/reports/generateClosureDocumentsDetalizationReport.md -->


[*Deprecated]: No longer supported, please use an alternative and newer version.