# Closing documents
{% list tabs %}
- Info
**The method is available for [all models](https://yandex.ru/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.ru/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 %}
Returns a ZIP archive with closing documents in the format PDF for the specified month.
{% cut "Состав документов в зависимости от типа договора" %}
* **Placement agreement**
* [the act of rendered services](*acts-main-act)
* [the invoice](*acts-main-invoice)
* [summary report on statistics data](*acts-main-report)
* [report on the execution of the assignment and on the settlement of mutual claims](*acts-main-agent) (agent's report)
* **Promotion agreement** (not concluded in Russia after September 30, 2024)
* [the act of rendering services](*acts-discounts-act)
* [the invoice](*acts-discounts-invoice) if the tax scheme requires it
* **Marketing agreement**
* [the act of rendered services](*acts-marketing-act)
* [the invoice](*acts-main-invoice)
* [advance payment invoice](*acts-marketing-invoice)
* [personal account statement](*acts-marketing-account)
* [details of the report](*acts-marketing-details)
{% endcut %}
You can find out the generation status and get a link to the archive using a request. [GET v2/reports/info/{reportId}](https://yandex.ru/dev/market/partner-api/doc/en/reference/reports/getReportInfo.md).
|
**⚙️ Limit:** 1 000 requests per hour
|
|-|
## Request
POST {.openapi__method}
```text translate=no
https://api.partner.market.yandex.ru/v2/reports/closure-documents/generate
```
### Body
{% cut "application/json" %}
```json translate=no
{
"campaignId": 1,
"monthOfYear": {
"year": 2025,
"month": 12
},
"contractTypes": [
"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.ru/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}
||
||
_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}
||
||
_contractTypes_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string[] | null
Types of contracts that require closing documents.
If you do not specify them, the archive with documents for all found contracts will be returned.
_Min items:_{.json-schema-reset .json-schema-assertion} `1`
_Max items:_{.json-schema-reset .json-schema-assertion} `3`
_Unique items:_{.json-schema-reset .json-schema-assertion} `true`
{% cut "**Example**" %}{.json-schema-example}
```json translate=no
[
"INCOME"
]
```
{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}
## Responses
## 200 OK
ZIP archive with closing documents in the format PDF.
### 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 %}
## 400 Bad Request
The request contains incorrect data. [More information about the error](https://yandex.ru/dev/market/partner-api/doc/en/concepts/error-codes.md#400)
### 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 %}
## 401 Unauthorized
The authorization data is not specified in the request. [More information about the error](https://yandex.ru/dev/market/partner-api/doc/en/concepts/error-codes.md#401)
### 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 %}
## 403 Forbidden
The authorization data is incorrect or access to the resource is prohibited. [More information about the error](https://yandex.ru/dev/market/partner-api/doc/en/concepts/error-codes.md#403)
### 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 %}
## 420 Method Failure
The resource access limit has been exceeded. [More information about the error](https://yandex.ru/dev/market/partner-api/doc/en/concepts/error-codes.md#420)
### 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 %}
## 500 Internal Server Error
Internal error of the Market. [More information about the error](https://yandex.ru/dev/market/partner-api/doc/en/concepts/error-codes.md#500)
### 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 %}
- Console
```openapi-sandbox translate=no
pathParams: []
searchParams: []
headers: []
body: |-
{
"campaignId": 1,
"monthOfYear": {
"year": 2025,
"month": 12
},
"contractTypes": [
"INCOME"
]
}
schema:
description: |
The data required to request the closing documents.
type: object
required:
- campaignId
- monthOfYear
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
contractTypes:
description: >
Types of contracts that require closing documents.
If you do not specify them, the archive with documents for all found
contracts will be returned.
type: array
uniqueItems: true
minItems: 1
maxItems: 3
nullable: true
items:
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/generate
host: https://api.partner.market.yandex.ru
```
{% endlist %}