---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.3
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/reference/reports/generateUnitedNettingReport.md
  - https://yandex.com/dev/market/partner-api/doc/ru/reference/reports/generateUnitedNettingReport.md
  - https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateUnitedNettingReport.md
  - href: zh/reference/reports/generateUnitedNettingReport.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/generateUnitedNettingReport.md -->
<div class="openapi">

# 付款报告

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

{% list tabs %}

- Info

  
  <!-- source: zh/_auto/method_scopes/generateUnitedNettingReport.md -->
  **方法适用于模式：[FBY](https://yandex.com/dev/market/partner-api/doc/zh/overview/fby.md), [FBS](https://yandex.com/dev/market/partner-api/doc/zh/overview/fbs.md), [Express](https://yandex.com/dev/market/partner-api/doc/zh/overview/express.md) 和 [DBS](https://yandex.com/dev/market/partner-api/doc/zh/overview/dbs.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/generateUnitedNettingReport.md -->
  
  
  开始生成指定期间的付款报告。 [这是什么报告](https://yandex.ru/support/marketplace/ru/accounting/transactions#all-pay)
  
  您可以使用请求查找生成状态并获取指向已完成报告的链接。 [GET v2/reports/info/{reportId}](https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/getReportInfo.md).
  
  报告的类型取决于请求中填写了哪些字段:
  
  #|
  || **报告类型** | **需要哪些字段？** | **评论** ||
  || 关于期间的付款 | `dateFrom` 和 `dateTo` |
    该报告包括选定期间支付和应计的所有款项。
  
    示例：如果转账于8月31日完成并于9月1日入账，则这两个月都将包含在报告中。
  ||
  || 关于付款订单 | `bankOrderId` 和 `bankOrderDateTime` |—||
  || [关于Yandex的。市场点](*баллы_маркета) | `monthOfYear` |—||
  |#
  
  您不能通过一个请求订购多种类型的报告。
  
  
  <!-- source: zh/_auto/reports/united/netting/generator/united_netting.md -->
  报告列说明：

  {% cut "表单**付款报告**（文件**transaction_date**）" %}

  #|
  || **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 ||
  || ORDER_DELIVERY_DATE | orderDeliveryDate | 付款信息/订单送达日期 | string ||
  || CLAIM_NUMBER | claimNumber | 付款信息/索赔编号和日期 | string ||
  || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
  || SHOP_SKU | shopSku | 付款信息/您的 SKU | string ||
  || ACT_ID | actId | 付款信息/已提供服务证书编号 | integer ||
  || ACT_DATE | actDate | 付款信息/提供服务证书的日期 | string ||
  ||
  OFFER_OR_SERVICE_NAME
  |
  offerOrServiceName
  |
  付款信息/产品（收费）或服务（持有）名称

  |
  string
  ||
  || COUNT | count | 付款信息/数量 | integer ||
  || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
  || VAT_RATE | vatRate | 付款信息/增值税税率 | string ||
  || VAT_SUM | vatSum | 付款信息/增值税金额 | number ||
  || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
  || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
  || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
  || BONUS_ACCOUNT_YEAR_MONTH | bonusAccountYearMonth | 付款信息/参与联合促销活动的奖金计算期 | string ||
  || BANK_ORDER_DATE | bankOrderDate | 付款信息/付款订单日期 | string ||
  || BANK_ORDER_ID | bankOrderId | 付款信息/付款订单号 | integer ||
  || BANK_SUM | bankSum | 付款信息/付款订单金额或预扣服务费金额 | number ||
  || COMMENTS | comments | 付款信息/评论 | string ||
  |#

  {% endcut %}

  {% cut "表单**付款订单报告**（文件**netting_report_accruals**）" %}

  #|
  || **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 ||
  || ORDER_ID | orderId | 有关应计的信息/订单或装运编号 | integer ||
  || ORDER_CREATION_DATE | orderCreationDate | 有关应计的信息/订单创建日期 | string ||
  || ORDER_DELIVERY_DATE | orderDeliveryDate | 有关应计的信息/订单送达日期 | string ||
  || CLAIM_NUMBER | claimNumber | 有关应计的信息/索赔编号和日期 | string ||
  || ORDER_TYPE | orderType | 有关应计的信息/订单类型 | string ||
  || SHOP_SKU | shopSku | 有关应计的信息/您的 SKU | string ||
  || OFFER_NAME | offerName | 有关应计的信息/商品名称 | string ||
  || COUNT | count | 有关应计的信息/数量 | integer ||
  || TRANSACTION_SUM | transactionSum | 有关应计的信息/交易金额 | number ||
  || TRANSACTION_SOURCE | transactionSource | 有关应计的信息/交易来源 | string ||
  || ACT_ID | actId | 有关应计的信息/已提供服务证书编号 | integer ||
  || ACT_DATE | actDate | 有关应计的信息/提供服务证书的日期 | string ||
  || TRANSACTION_DATE | transactionDate | 有关应计的信息/交易日期 | string ||
  || TRANSACTION_ID | transactionId | 有关应计的信息/交易 ID | string ||
  |#

  {% endcut %}

  {% cut "表单**付款订单报告**（文件**netting_report_returns_and_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 ||
  || ORDER_ID | orderId | 关于买家退款和补偿的信息/订单或装运编号 | integer ||
  || ORDER_CREATION_DATE | orderCreationDate | 关于买家退款和补偿的信息/创建日期 | string ||
  || ORDER_DELIVERY_DATE | orderDeliveryDate | 关于买家退款和补偿的信息/订单送达日期 | string ||
  || ORDER_TYPE | orderType | 关于买家退款和补偿的信息/订单类型 | string ||
  || SHOP_SKU | shopSku | 关于买家退款和补偿的信息/您的 SKU | string ||
  || OFFER_NAME | offerName | 关于买家退款和补偿的信息/商品名称 | string ||
  || COUNT | count | 关于买家退款和补偿的信息/数量 | integer ||
  || TRANSACTION_SUM | transactionSum | 关于买家退款和补偿的信息/交易金额 | number ||
  || TRANSACTION_SOURCE | transactionSource | 关于买家退款和补偿的信息/交易来源 | string ||
  || TRANSACTION_DATE | transactionDate | 关于买家退款和补偿的信息/交易日期 | string ||
  || TRANSACTION_ID | transactionId | 关于买家退款和补偿的信息/交易 ID | string ||
  |#

  {% endcut %}

  {% cut "表单**付款订单报告**（文件**netting_report_retentions**）" %}

  #|
  || **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 ||
  || ACT_ID | actId | 有关预扣金额的信息/已提供服务证书编号 | integer ||
  || ACT_DATE | actDate | 有关预扣金额的信息/提供服务证书的日期 | string ||
  || SERVICE_NAME | serviceName | 有关预扣金额的信息/要预扣的服务名称 | string ||
  || TRANSACTION_SUM | transactionSum | 有关预扣金额的信息/交易金额 | number ||
  || TRANSACTION_SOURCE | transactionSource | 有关预扣金额的信息/交易来源 | string ||
  || TRANSACTION_DATE | transactionDate | 有关预扣金额的信息/交易日期 | string ||
  || TRANSACTION_ID | transactionId | 有关预扣金额的信息/交易 ID | string ||
  |#

  {% endcut %}

  {% cut "表单**积分报告**（文件**netting_bonuses**）" %}

  #|
  || **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 ||
  || ORDER_ID | orderId | 付款信息/订单或装运编号 | integer ||
  || SHOP_ORDER_ID | shopOrderId | 付款信息/您的订单号 | string ||
  || ORDER_CREATION_DATE | orderCreationDate | 付款信息/订单创建日期 | string ||
  || ORDER_DELIVERY_DATE | orderDeliveryDate | 付款信息/订单送达日期 | string ||
  || ORDER_TYPE | orderType | 付款信息/订单类型 | string ||
  || SHOP_SKU | shopSku | 付款信息/您的 SKU | string ||
  ||
  OFFER_OR_SERVICE_NAME
  |
  offerOrServiceName
  |
  付款信息/产品（收费）或服务（持有）名称

  |
  string
  ||
  || COUNT | count | 付款信息/数量 | integer ||
  || TRANSACTION_SUM | transactionSum | 付款信息/交易金额 | number ||
  || TRANSACTION_TYPE | transactionType | 付款信息/交易类型 | string ||
  || TRANSACTION_SOURCE | transactionSource | 付款信息/交易来源 | string ||
  || PAYMENT_STATUS | paymentStatus | 付款信息/状态 | string ||
  || COMMENTS | comments | 付款信息/评论 | string ||
  || BONUS_ACCOUNT_YEAR_MONTH | bonusAccountYearMonth | 付款信息/联合促销奖励的生成月份 | string ||
  |#

  {% endcut %}
  <!-- endsource: zh/_auto/reports/united/netting/generator/united_netting.md -->
  
  
  
  <!-- source: zh/_auto/method_limits/generateUnitedNettingReport.md -->
  |<div style="text-align: left;">**⚙️ 没有订阅的限制:** 1 请求 在 2 分钟<br>**⭐️ [使用中等订阅限制](https://yandex.ru/support/marketplace/ru/marketing/subscription):** 1 请求 每分钟</div>|
  |-|
  <!-- endsource: zh/_auto/method_limits/generateUnitedNettingReport.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/united-netting/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}
  ||
  ||
  
  _language_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  报告或文件的语言。
  报告的语言:
  
  * `RU` — 俄语。
  * `EN` — 英语。
  
  
  _Enum:_{.json-schema-reset .json-schema-value} `RU`, `EN`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "businessId": 1,
    "dateTimeFrom": "2025-01-01T00:00:00Z",
    "dateTimeTo": "2025-01-01T00:00:00Z",
    "dateFrom": "2025-08-22",
    "dateTo": "2025-01-01",
    "bankOrderId": 0,
    "bankOrderDateTime": "2025-01-01T00:00:00Z",
    "monthOfYear": {
      "year": 2025,
      "month": 12
    },
    "placementPrograms": [
      "FBS"
    ],
    "inns": [
      "example"
    ],
    "campaignIds": [
      1
    ]
  }
  ```
  
  {% endcut %}
  
  #|
  || **Name** | **Description** ||
  ||
  
  _businessId_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: integer
  
  内阁ID。  
  
  
  
  _Min value:_{.json-schema-reset .json-schema-assertion} `1`
  {.table-cell}
  ||
  ||
  
  _bankOrderDateTime_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string&lt;date-time&gt;
  
  付款订单的日期。
  
  _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
  {.table-cell}
  ||
  ||
  
  _bankOrderId_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: integer
  
  支付订单的编号。
  {.table-cell}
  ||
  ||
  
  _campaignIds_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: integer[] &#124; null
  
  报表中需要的那些商店的营销活动Id列表。
  
  
  _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
  _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  [
    1
  ]
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  ||
  
  _dateFrom_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string&lt;date&gt;
  
  期的开始，包括在内。
  
  日期格式: `YYYY-MM-DD`.
  
  
  _Example:_{.json-schema-reset .json-schema-example} `2025-08-22`
  {.table-cell}
  ||
  ||
  
  _dateTimeFrom_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
  {.table-cell}|
  **Type**: string&lt;date-time&gt;
  
  
  {% note warning "Параметр устарел и будет отключен 12.10.2026." %}
  
  
  相反，使用 `dateFrom`.
  
  
  {% endnote %}
  
  
  期的开始，包括在内。
  
  
  _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
  {.table-cell}
  ||
  ||
  
  _dateTimeTo_{.json-schema-reset .json-schema-property .json-schema-deprecated}_[ ](*Deprecated)_{.openapi-deprecated .openapi-deprecated-compact}
  {.table-cell}|
  **Type**: string&lt;date-time&gt;
  
  
  {% note warning "Параметр устарел и будет отключен 12.10.2026." %}
  
  
  相反，使用 `dateTo`.
  
  
  {% endnote %}
  
  
  期结束，包括在内。 最长期限 — 3个月。
  
  
  _Example:_{.json-schema-reset .json-schema-example} `2025-01-01T00:00:00Z`
  {.table-cell}
  ||
  ||
  
  _dateTo_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string&lt;date&gt;
  
  期结束，包括在内。 最长期限 — 3个月。
  
  日期格式: `YYYY-MM-DD`.
  
  
  _Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
  {.table-cell}
  ||
  ||
  
  _inns_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string[] &#124; null
  
  报告中需要的客栈名单.
  
  _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
  _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  [
    "example"
  ]
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  ||
  
  _monthOfYear_{.json-schema-reset .json-schema-property}
  {.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}
  ||
  ||
  
  _placementPrograms_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string[] &#124; null
  
  报告中需要的模型列表。
  
  
  _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
  _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  [
    "FBS"
  ]
  ```
  
  {% 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#400)
  
  <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
  
  Yandex中的内部错误。 市场。 [有关错误的更多信息](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
    - description: 报告或文件的语言。
      name: language
      in: query
      required: false
      schema:
        description: |
          报告的语言:
  
          * `RU` — 俄语。
          * `EN` — 英语。
        type: string
        enum:
          - RU
          - EN
  headers: []
  body: |-
    {
      "businessId": 1,
      "dateTimeFrom": "2025-01-01T00:00:00Z",
      "dateTimeTo": "2025-01-01T00:00:00Z",
      "dateFrom": "2025-08-22",
      "dateTo": "2025-01-01",
      "bankOrderId": 0,
      "bankOrderDateTime": "2025-01-01T00:00:00Z",
      "monthOfYear": {
        "year": 2025,
        "month": 12
      },
      "placementPrograms": [
        "FBS"
      ],
      "inns": [
        "example"
      ],
      "campaignIds": [
        1
      ]
    }
  schema:
    description: |
      生成报告所需的数据：市场活动ID、需要报告的期间以及过滤器。
    type: object
    required:
      - businessId
    properties:
      businessId:
        description: "内阁ID。  {% if audience == \"partner\" %} 要找到答案，请使用请求 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [什么是市场上的橱柜和商店？](https://yandex.ru/support/marketplace/account/introduction.html)\n\n:::no-translate\n{% endif %}\n:::\n\n"
        type: integer
        format: int64
        minimum: 1
      dateTimeFrom:
        description: |
  
          {% note warning "Параметр устарел и будет отключен 12.10.2026." %}
  
  
          相反，使用 `dateFrom`.
  
  
          {% endnote %}
  
  
          期的开始，包括在内。
        format: date-time
        type: string
        deprecated: true
        x-deprecation-config:
          shutdown-date: '2026-10-12'
          replacement-field: dateFrom
      dateTimeTo:
        description: |
  
          {% note warning "Параметр устарел и будет отключен 12.10.2026." %}
  
  
          相反，使用 `dateTo`.
  
  
          {% endnote %}
  
  
          期结束，包括在内。 最长期限 — 3个月。
        format: date-time
        type: string
        deprecated: true
        x-deprecation-config:
          shutdown-date: '2026-10-12'
          replacement-field: dateTo
      dateFrom:
        type: string
        format: date
        description: |
          期的开始，包括在内。
  
          日期格式: `YYYY-MM-DD`.
        example: '2025-08-22'
      dateTo:
        description: |
          期结束，包括在内。 最长期限 — 3个月。
  
          日期格式: `YYYY-MM-DD`.
        format: date
        type: string
      bankOrderId:
        description: 支付订单的编号。
        format: int64
        type: integer
      bankOrderDateTime:
        description: 付款订单的日期。
        format: date-time
        type: string
      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
      placementPrograms:
        description: |
          报告中需要的模型列表。
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          description: >
            商店使用的模型:
  
  
            * `FBS` — FBS 或
            Express.
  
            * `FBY` — FBY.
  
            * `DBS` — DBS.
  
            * `LAAS` — 拉斯。
          type: string
          enum:
            - FBS
            - FBY
            - DBS
            - LAAS
      inns:
        description: 报告中需要的客栈名单.
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          type: string
      campaignIds:
        description: |
          报表中需要的那些商店的营销活动Id列表。
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          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
  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/united-netting/generate
  host: https://api.partner.market.yandex.ru
  
  ```
        

{% endlist %}


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

[*баллы_маркета] 关于它是什么，请阅读 [燕基科斯.对卖家的市场帮助](https://yandex.ru/support/marketplace/ru/accounting/market-points).


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