---
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: en/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/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 be changed.

{% endnote %}

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

# Report on convergence with closing documents

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

{% list tabs %}

- Info

  
  <!-- source: en/_auto/method_scopes/generateClosureDocumentsDetalizationReport.md -->
  **The method is available for [all models](https://yandex.com/dev/market/partner-api/doc/en/overview/business.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/generateClosureDocumentsDetalizationReport.md -->
  
  
  Starts the generation of a report on convergence with closing documents, depending on the type of contract.
  
  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).
  
  
  {% list tabs %}
  
  
  - Placement agreement
  
    
    <!-- source: en/_auto/reports/period_closure/period_closure_income.md -->
    Explanation of the report columns:

    {% cut "Sheet **Order execution report** (file **period_closure_income_summary**)" %}

    #|
    || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** ||
    || PAYMENTS | payments | Report payments | string ||
    || PAYMENTS_DESCRIPTION | paymentsDescription | What are these payments? | string ||
    || PAYMENT_SUM | paymentSum | Payment amount* | number ||
    |#

    {% endcut %}

    {% cut "Sheet **Received from consumers** (file **period_closure_income_payments**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Returned to consumers** (file **period_closure_income_refunds**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Sold on behalf of the customer** (file **period_closure_income_sold_refunds**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Returned sold items** (file **period_closure_income_sold_defect_refunds**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Withheld for Yandex Market services** (file **period_closure_income_fees**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Fines withheld** (file **period_closure_income_fines**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Compensation from Yandex Market** (file **period_closure_income_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 ||
    || TRANSACTION_DATE | transactionDate | Payment information/Transaction date | string ||
    || TRANSACTION_ID | transactionId | Payment information/Transaction ID | string ||
    || ORDER_ID | orderId | Payment information/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Premium** (file **period_closure_income_netting**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Premium correction** (file **period_closure_income_premium_correction**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Acquired the right of claim** (file **period_closure_income_cession**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Debt cancellation** (file **period_closure_income_debt_write_off**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **To be transferred to you** (file **period_closure_income_will_be_paid**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Transferred to your account** (file **period_closure_income_paid**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}
    <!-- endsource: en/_auto/reports/period_closure/period_closure_income.md -->
  
  
  - Promotion agreement
  
    
    <!-- source: en/_auto/reports/period_closure/period_closure_outcome.md -->
    Explanation of the report columns:

    {% cut "Sheet **Certificate of promotion services** (file **period_closure_outcome_summary**)" %}

    #|
    || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** ||
    || SERVICES | services | Services in the certificate | string ||
    || SERVICES_DESCRIPTION | servicesDescription | Compensation for this service | string ||
    || SERVICES_SUM | servicesSum | Service cost* | number ||
    |#

    {% endcut %}

    {% cut "Sheet **Marketplace discounts** (file **period_closure_outcome_subsidy**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Yandex Plus points** (file **period_closure_outcome_plus**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Bonus for completing challenge** (file **period_closure_outcome_benefits**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}

    {% cut "Sheet **Marketplace discounts on delivery** (file **period_closure_outcome_delivery**)" %}

    #|
    || **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/Number of order or certificate of services rendered | integer ||
    || SHOP_ORDER_ID | shopOrderId | Payment information/Your order number | string ||
    ||
    ORDER_CREATION_DATE
    |
    orderCreationDate
    |
    Payment information/The date of the order or certificate of services rendered
    |
    string
    ||
    || CLAIM_NUMBER | claimNumber | Payment information/Claim number and date | string ||
    || ORDER_TYPE | orderType | Payment information/Order type | string ||
    || OFFER_ID | offerId | Payment information/Your SKU | string ||
    || OFFER_NAME | offerName | Payment information/Product name | string ||
    || COUNT | count | Payment information/Quantity, units | 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 ||
    || BANK_ORDER_DATE | bankOrderDate | Payment information/Payment order date | string ||
    || BANK_ORDER_ID | bankOrderId | Payment information/Payment order number | integer ||
    ||
    BANK_ORDER_SUM
    |
    bankOrderSum
    |
    Payment information/Payment order amount or the amount withheld for services
    |
    number
    ||
    |#

    {% endcut %}
    <!-- endsource: en/_auto/reports/period_closure/period_closure_outcome.md -->
  
  
  
  {% endlist %}
  
  
  
  <!-- source: en/_auto/method_limits/generateClosureDocumentsDetalizationReport.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/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
  
  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}
  ||
  |#{.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
  
  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.
  
  You can find it using a query [GET v2/campaigns](https://yandex.com/dev/market/partner-api/doc/en/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**:
  
  * block **Campaign ID**;
  * tab **Query log** → drop-down list in the block **Show logs**.
  
  ⚠️ Do not confuse it with:
  - the store's identifier, which is displayed in the merchant's personal account.
  - advertising campaigns.
  
  
  _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
  
  Type of agreement:
  
  * `INCOME` — the accommodation agreement.
  
  * `OUTCOME` — the promotion agreement.
  
  
  _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
  
  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 %}
  
  Month and year.
  
  
  {% 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
  
  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. [Learn more about errors in reports and documents](https://yandex.com/dev/market/partner-api/doc/en/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
  
      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 Yandex. 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
  headers: []
  body: |-
    {
      "campaignId": 1,
      "monthOfYear": {
        "year": 2025,
        "month": 12
      },
      "contractType": "INCOME"
    }
  schema:
    description: |
      The data required to generate the report.
    type: object
    required:
      - campaignId
      - monthOfYear
      - contractType
    properties:
      campaignId:
        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
      monthOfYear:
        description: |
          Month and year.
        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
      contractType:
        description: |
          Type of agreement:
  
          * `INCOME` — the accommodation agreement.
  
          * `OUTCOME` — the promotion agreement.
        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: en/api/reports/generateClosureDocumentsDetalizationReport.md -->


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