---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.5
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: en/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/en/llms.txt

{% note warning "The structure and content of the reports are subject to change without prior notice." %}

For example, a new column may be added or the name of the sheet may change.

{% endnote %}

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

# Payment Report

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

{% list tabs %}

- Info

  
  <!-- source: en/_auto/method_scopes/generateUnitedNettingReport.md -->
  **The method is available for models: [FBY](https://yandex.com/dev/market/partner-api/doc/en/overview/fby.md), [FBS](https://yandex.com/dev/market/partner-api/doc/en/overview/fbs.md), [Express](https://yandex.com/dev/market/partner-api/doc/en/overview/express.md) and [DBS](https://yandex.com/dev/market/partner-api/doc/en/overview/dbs.md).**

  {% cut "**If you are using an API Key token, one of the accesses in the list is required to call the method**" %}

  * finance-and-accounting — [View financial data and reports](https://yandex.com/dev/market/partner-api/doc/en/_auto/scopes_summary/pages/finance-and-accounting.md)
  * all-methods — Full account management
  * all-methods:read-only — View all data

  {% endcut %}
  <!-- endsource: en/_auto/method_scopes/generateUnitedNettingReport.md -->
  
  
  Starts the generation of the payment report for the specified period. [What kind of report is this](https://yandex.ru/support/marketplace/ru/accounting/transactions#all-pay)
  
  You can find out the generation status and get a link to the finished report using a request. [GET v2/reports/info/{reportId}](https://yandex.com/dev/market/partner-api/doc/en/reference/reports/getReportInfo.md).
  
  The type of report depends on which fields are filled in in the request:
  
  #|
  || **Report type** | **What fields are needed?** | **Comment** ||
  || About payments for the period | `dateFrom` and `dateTo` |
    The report includes all payments that were paid and accrued during the selected period.
  
    Example: if the transfer was completed on August 31 and credited on September 1, it will be included in the report for both months.
  ||
  || About the payment order | `bankOrderId` and `bankOrderDateTime` |—||
  || [About Yandex.Market points](*баллы_маркета) | `monthOfYear` |—||
  |#
  
  You cannot order multiple types of reports with a single request.
  
  
  <!-- source: en/_auto/reports/united/netting/generator/united_netting.md -->
  Explanation of the report columns:

  {% cut "Sheet **Payment report** (file **transaction_date**)" %}

  #|
  || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** ||
  || BUSINESS_ID | businessId | Business information/Business account ID | integer ||
  || MODEL | model | Business information/Operation models | string ||
  || PARTNER_ID | partnerId | Business information/Store IDs | integer ||
  || SHOP_NAME | shopName | Business information/Store names | string ||
  || INN | inn | Business information/INN (taxpayer identification number) | string ||
  || PLACEMENT_CONTRACT | placementContract | Business information/Agreement numbers for placement | string ||
  || PROMOTION_CONTRACT | promotionContract | Business information/Agreement numbers for promotion | string ||
  || TRANSACTION_DATE | transactionDate | Payment information/Transaction date | string ||
  || TRANSACTION_ID | transactionId | Payment information/Transaction ID | string ||
  || ORDER_ID | orderId | Payment information/Order or shipment number | integer ||
  || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
  || ORDER_CREATION_DATE | orderCreationDate | Payment information/Order creation date | string ||
  || ORDER_DELIVERY_DATE | orderDeliveryDate | Payment information/Order delivery date | string ||
  || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
  || ORDER_TYPE | orderType | Payment information/Order type | string ||
  || SHOP_SKU | shopSku | Payment information/Your SKU | string ||
  || ACT_ID | actId | Payment information/Certificate of services rendered number | integer ||
  || ACT_DATE | actDate | Payment information/Date of the сertificate of services rendered | string ||
  ||
  OFFER_OR_SERVICE_NAME
  |
  offerOrServiceName
  |
  Payment information/Name of the product (to charge) or service (to hold)

  |
  string
  ||
  || COUNT | count | Payment information/Quantity | integer ||
  || TRANSACTION_SUM | transactionSum | Payment information/Transaction amount | number ||
  || TRANSACTION_TYPE | transactionType | Payment information/Transaction type | string ||
  || TRANSACTION_SOURCE | transactionSource | Payment information/Transaction source | string ||
  || PAYMENT_STATUS | paymentStatus | Payment information/Status | string ||
  ||
  BONUS_ACCOUNT_YEAR_MONTH
  |
  bonusAccountYearMonth
  |
  Payment information/The billing period of the bonus for participation in joint promotions
  |
  string
  ||
  || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
  || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
  || BANK_SUM | bankSum | Payment information/Payment order amount or the amount withheld for services | number ||
  || COMMENTS | comments | Payment information/Comments | string ||
  |#

  {% endcut %}

  {% cut "Sheet **Payment order report** (file **netting_report_accruals**)" %}

  #|
  || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** ||
  || BUSINESS_ID | businessId | Business information/Business account ID | integer ||
  || MODEL | model | Business information/Operation models | string ||
  || PARTNER_ID | partnerId | Business information/Store IDs | integer ||
  || SHOP_NAME | shopName | Business information/Store names | string ||
  || INN | inn | Business information/INN (taxpayer identification number) | string ||
  || PLACEMENT_CONTRACT | placementContract | Business information/Agreement numbers for placement | string ||
  || PROMOTION_CONTRACT | promotionContract | Business information/Agreement numbers for promotion | string ||
  || ORDER_ID | orderId | Information about accruals/Order or shipment number | integer ||
  || ORDER_CREATION_DATE | orderCreationDate | Information about accruals/Order creation date | string ||
  || ORDER_DELIVERY_DATE | orderDeliveryDate | Information about accruals/Order delivery date | string ||
  || CLAIM_NUMBER | claimNumber | Information about accruals/Claim number and date | string ||
  || ORDER_TYPE | orderType | Information about accruals/Order type | string ||
  || SHOP_SKU | shopSku | Information about accruals/Your SKU | string ||
  || OFFER_NAME | offerName | Information about accruals/Product name | string ||
  || COUNT | count | Information about accruals/Quantity | integer ||
  || TRANSACTION_SUM | transactionSum | Information about accruals/Transaction amount | number ||
  || TRANSACTION_SOURCE | transactionSource | Information about accruals/Transaction source | string ||
  || ACT_ID | actId | Information about accruals/Certificate of services rendered number | integer ||
  || ACT_DATE | actDate | Information about accruals/Date of the сertificate of services rendered | string ||
  || TRANSACTION_DATE | transactionDate | Information about accruals/Transaction date | string ||
  || TRANSACTION_ID | transactionId | Information about accruals/Transaction ID | string ||
  |#

  {% endcut %}

  {% cut "Sheet **Payment order report** (file **netting_report_returns_and_compensations**)" %}

  #|
  || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** ||
  || BUSINESS_ID | businessId | Business information/Business account ID | integer ||
  || MODEL | model | Business information/Operation models | string ||
  || PARTNER_ID | partnerId | Business information/Store IDs | integer ||
  || SHOP_NAME | shopName | Business information/Store names | string ||
  || INN | inn | Business information/INN (taxpayer identification number) | string ||
  || PLACEMENT_CONTRACT | placementContract | Business information/Agreement numbers for placement | string ||
  || PROMOTION_CONTRACT | promotionContract | Business information/Agreement numbers for promotion | string ||
  || ORDER_ID | orderId | Information about buyer refunds and compensation/Order or shipment number | integer ||
  ||
  ORDER_CREATION_DATE
  |
  orderCreationDate
  |
  Information about buyer refunds and compensation/Creation date
  |
  string
  ||
  ||
  ORDER_DELIVERY_DATE
  |
  orderDeliveryDate
  |
  Information about buyer refunds and compensation/Order delivery date
  |
  string
  ||
  || ORDER_TYPE | orderType | Information about buyer refunds and compensation/Order type | string ||
  || SHOP_SKU | shopSku | Information about buyer refunds and compensation/Your SKU | string ||
  || OFFER_NAME | offerName | Information about buyer refunds and compensation/Product name | string ||
  || COUNT | count | Information about buyer refunds and compensation/Quantity | integer ||
  ||
  TRANSACTION_SUM
  |
  transactionSum
  |
  Information about buyer refunds and compensation/Transaction amount
  |
  number
  ||
  ||
  TRANSACTION_SOURCE
  |
  transactionSource
  |
  Information about buyer refunds and compensation/Transaction source
  |
  string
  ||
  ||
  TRANSACTION_DATE
  |
  transactionDate
  |
  Information about buyer refunds and compensation/Transaction date
  |
  string
  ||
  || TRANSACTION_ID | transactionId | Information about buyer refunds and compensation/Transaction ID | string ||
  |#

  {% endcut %}

  {% cut "Sheet **Payment order report** (file **netting_report_retentions**)" %}

  #|
  || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** ||
  || BUSINESS_ID | businessId | Business information/Business account ID | integer ||
  || MODEL | model | Business information/Operation models | string ||
  || PARTNER_ID | partnerId | Business information/Store IDs | integer ||
  || SHOP_NAME | shopName | Business information/Store names | string ||
  || INN | inn | Business information/INN (taxpayer identification number) | string ||
  || PLACEMENT_CONTRACT | placementContract | Business information/Agreement numbers for placement | string ||
  || PROMOTION_CONTRACT | promotionContract | Business information/Agreement numbers for promotion | string ||
  || ACT_ID | actId | Information about withheld amounts/Certificate of services rendered number | integer ||
  ||
  ACT_DATE
  |
  actDate
  |
  Information about withheld amounts/Date of the сertificate of services rendered
  |
  string
  ||
  || SERVICE_NAME | serviceName | Information about withheld amounts/Name of service to be withheld | string ||
  || TRANSACTION_SUM | transactionSum | Information about withheld amounts/Transaction amount | number ||
  || TRANSACTION_SOURCE | transactionSource | Information about withheld amounts/Transaction source | string ||
  || TRANSACTION_DATE | transactionDate | Information about withheld amounts/Transaction date | string ||
  || TRANSACTION_ID | transactionId | Information about withheld amounts/Transaction ID | string ||
  |#

  {% endcut %}

  {% cut "Sheet **Bonuses report** (file **netting_bonuses**)" %}

  #|
  || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** ||
  || BUSINESS_ID | businessId | Business information/Business account ID | integer ||
  || MODEL | model | Business information/Operation models | string ||
  || PARTNER_ID | partnerId | Business information/Store IDs | integer ||
  || SHOP_NAME | shopName | Business information/Store names | string ||
  || INN | inn | Business information/INN (taxpayer identification number) | string ||
  || PLACEMENT_CONTRACT | placementContract | Business information/Agreement numbers for placement | string ||
  || PROMOTION_CONTRACT | promotionContract | Business information/Agreement numbers for promotion | string ||
  || TRANSACTION_DATE | transactionDate | Payment information/Transaction date | string ||
  || ORDER_ID | orderId | Payment information/Order or shipment number | integer ||
  || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
  || ORDER_CREATION_DATE | orderCreationDate | Payment information/Order creation date | string ||
  || ORDER_DELIVERY_DATE | orderDeliveryDate | Payment information/Order delivery date | string ||
  || ORDER_TYPE | orderType | Payment information/Order type | string ||
  || SHOP_SKU | shopSku | Payment information/Your SKU | string ||
  ||
  OFFER_OR_SERVICE_NAME
  |
  offerOrServiceName
  |
  Payment information/Name of the product (to charge) or service (to hold)

  |
  string
  ||
  || COUNT | count | Payment information/Quantity | integer ||
  || TRANSACTION_SUM | transactionSum | Payment information/Transaction amount | number ||
  || TRANSACTION_TYPE | transactionType | Payment information/Transaction type | string ||
  || TRANSACTION_SOURCE | transactionSource | Payment information/Transaction source | string ||
  || PAYMENT_STATUS | paymentStatus | Payment information/Status | string ||
  || COMMENTS | comments | Payment information/Comments | string ||
  ||
  BONUS_ACCOUNT_YEAR_MONTH
  |
  bonusAccountYearMonth
  |
  Payment information/The month of the premium formation for participation in joint promotions
  |
  string
  ||
  |#

  {% endcut %}
  <!-- endsource: en/_auto/reports/united/netting/generator/united_netting.md -->
  
  
  
  <!-- source: en/_auto/method_limits/generateUnitedNettingReport.md -->
  |<div style="text-align: left;">**⚙️ Limit without subscription:** 1 request per 2 minutes<br>**⭐️ [Limit with Medium subscription](https://yandex.ru/support/marketplace/ru/marketing/subscription):** 1 request per minute</div>|
  |-|
  <!-- endsource: en/_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
  
  The format of the report or document.
  Report format:
  
  * `FILE` — the spreadsheet file (XLSX).
  * `CSV` — A ZIP archive with CSV files for each report sheet.
  * `JSON` — A ZIP archive with JSON files for each report sheet.
  
  
  _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
  
  The language of the report or document.
  Language of the report:
  
  * `RU` — Russian language.
  * `EN` — English language.
  
  
  _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
  
  Cabinet ID.   To find out, use the request [GET v2/campaigns](https://yandex.com/dev/market/partner-api/doc/en/reference/campaigns/getCampaigns.md).
  
  ℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)
  
  
  
  
  _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;
  
  The date of the payment order.
  
  _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
  
  The number of the payment order.
  {.table-cell}
  ||
  ||
  
  _campaignIds_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: integer[] &#124; null
  
  The list of campaign IDs of those stores that are needed in the report.
  
  
  _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;
  
  The beginning of the period, inclusive.
  
  Date format: `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." %}
  
  
  Instead, use `dateFrom`.
  
  
  {% endnote %}
  
  
  The beginning of the period, inclusive.
  
  
  _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." %}
  
  
  Instead, use `dateTo`.
  
  
  {% endnote %}
  
  
  End of the period, inclusive. Maximum period — 3 months.
  
  
  _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;
  
  End of the period, inclusive. Maximum period — 3 months.
  
  Date format: `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
  
  The list of INN's that are needed in the report.
  
  _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
  
  The month number.
  
  _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
  
  Year.
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  {% endcut %}
  
  The month for which the report on the Market points is needed.
  
  {% 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
  
  The list of models that are needed in the report.
  
  
  _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
  
  In response, you receive an identifier that allows you to find out the generation status and download the finished report.
  
  <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
  
    The type of response.
    Possible values:
    * `OK` — There are no errors.
    * `ERROR` — an error occurred while processing the request.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The standard wrapper for server responses.
  
    {% 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
  
    Expected generation time in milliseconds.
    {.table-cell}
    ||
    ||
  
    _reportId_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    The ID that will be needed to track the generation status and receive the finished report or document.
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The ID that will be needed to track the generation status and receive the finished report or document.
  
    {% 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
  
  The request contains incorrect data. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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
  
  The authorization data is not specified in the request. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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
  
  The authorization data is incorrect or access to the resource is prohibited. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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
  
  The requested resource was not found. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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
  
  The resource access limit has been exceeded. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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
  
  Internal error of the Market. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/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
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% 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
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _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 %}
  
    A standard wrapper for server errors.
  
    {% 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: The format of the report or document.
      name: format
      in: query
      required: false
      schema:
        description: >
          Report format:
  
  
          * `FILE` — the spreadsheet file
          (XLSX).
  
          * `CSV` — A ZIP archive with CSV files for
          each report sheet.
  
          * `JSON` — A ZIP archive with JSON files
          for each report sheet.
        type: string
        enum:
          - FILE
          - CSV
          - JSON
        default: FILE
    - description: The language of the report or document.
      name: language
      in: query
      required: false
      schema:
        description: |
          Language of the report:
  
          * `RU` — Russian language.
          * `EN` — English language.
        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: >
      The data required to generate the report: the campaign ID, the period for
      which the report is needed, as well as filters.
    type: object
    required:
      - businessId
    properties:
      businessId:
        description: "Cabinet ID.  {% if audience == \"partner\" %} To find out, use the request [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [What is a cabinet and a store on the Market?](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." %}
  
  
          Instead, use `dateFrom`.
  
  
          {% endnote %}
  
  
          The beginning of the period, inclusive.
        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." %}
  
  
          Instead, use `dateTo`.
  
  
          {% endnote %}
  
  
          End of the period, inclusive. Maximum period — 3 months.
        format: date-time
        type: string
        deprecated: true
        x-deprecation-config:
          shutdown-date: '2026-10-12'
          replacement-field: dateTo
      dateFrom:
        type: string
        format: date
        description: |
          The beginning of the period, inclusive.
  
          Date format: `YYYY-MM-DD`.
        example: '2025-08-22'
      dateTo:
        description: |
          End of the period, inclusive. Maximum period — 3 months.
  
          Date format: `YYYY-MM-DD`.
        format: date
        type: string
      bankOrderId:
        description: The number of the payment order.
        format: int64
        type: integer
      bankOrderDateTime:
        description: The date of the payment order.
        format: date-time
        type: string
      monthOfYear:
        description: The month for which the report on the Market points is needed.
        type: object
        required:
          - year
          - month
        properties:
          year:
            description: Year.
            type: integer
            format: int32
            example: 2025
          month:
            description: The month number.
            type: integer
            format: int32
            minimum: 1
            maximum: 12
            example: 12
      placementPrograms:
        description: |
          The list of models that are needed in the report.
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          description: >
            The model that the store uses:
  
  
            * `FBS` — FBS or
            Express.
  
            * `FBY` — FBY.
  
            * `DBS` — DBS.
  
            * `LAAS` — LaaS.
          type: string
          enum:
            - FBS
            - FBY
            - DBS
            - LAAS
      inns:
        description: The list of INN's that are needed in the report.
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          type: string
      campaignIds:
        description: |
          The list of campaign IDs of those stores that are needed in the report.
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          description: "The ID of the campaign (store) — The technical identifier that represents your store in the Yandex Market system when working through the API. It is uniquely linked to your store, but it is intended only for automated interaction.\n\nYou can find it using a query [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) or find it in the seller's office on the Market. Click on your account icon → **Settings** and in the menu on the left, select **APIs and modules**:\n\n* block **Campaign ID**;\n* tab **Query log** → drop-down list in the block **Show logs**.\n\n⚠️ Do not confuse it with:\n- the store's identifier, which is displayed in the merchant's personal account.\n- advertising campaigns.\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: en/api/reports/generateUnitedNettingReport.md -->

[*баллы_маркета] About what it is, read in [Yandex.Market Help for sellers](https://yandex.ru/support/marketplace/ru/accounting/market-points).


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