Closing documents

The method is available for models: FBY, FBS, Express and DBS.

If you are using an API Key token, one of the accesses in the list is required to call the method

Returns a ZIP archive with closing documents in the format PDF for the specified month.

The composition of the documents depends on the type of contract

  • Placement agreement

    • act on services rendered
    • invoice
    • summary report on statistics
    • report on the execution of the assignment and on the settlement of mutual claims (agent's report)

  • Promotion agreement (not concluded in Russia after September 30, 2024)

    • service provision act
    • invoice if the tax scheme requires it

  • Marketing agreement

    • act on services rendered
    • invoice
    • advance invoice
    • personal account statement
    • details to the act

You can find out the generation status and get a link to the archive using a request. GET v2/reports/info/{reportId}.

⚙️ Limit: 1,000 requests per hour

Request

POST

https://api.partner.market.yandex.ru/v2/reports/closure-documents/generate

Body

application/json
{
    "campaignId": 0,
    "monthOfYear": {
        "year": 2025,
        "month": 12
    },
    "contractTypes": [
        "INCOME"
    ]
}

Name

Description

campaignId*

Type: integer<int64>

The store's campaign ID.

You can find it using a query GET v2/campaigns 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.

⚠️ It does not match the store's ID (which is indicated in the merchant's account on the Market next to the store's name and in some reports). It is linked to the store one-to-one. Does not apply to advertising campaigns.

Min value: 1

monthOfYear*
Type: object

month*

Type: integer<int32>

The month number.

Example: 12

Min value: 1

Max value: 12

year*

Type: integer<int32>

Year.

Example: 2025

Month and year.

contractTypes

Type: string[]

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 of agreement:

  • INCOME — the accommodation agreement.

  • OUTCOME — the promotion agreement.

  • MARKETING — a marketing contract.

Enum: INCOME, OUTCOME, MARKETING

Min items: 1

Max items: 3

Unique items  

Responses

200 OK

ZIP archive with closing documents in the format PDF.

Body

application/json
{
    "status": "OK",
    "result": {
        "reportId": "string",
        "estimatedGenerationTime": 0
    }
}

Name

Description

status*

Type: string

The type of response. Possible values:

  • OK — There are no errors.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

result
Type: object

estimatedGenerationTime*

Type: integer<int64>

Expected generation time in milliseconds.

reportId*

Type: string

The ID that will be needed to track the generation status and receive the finished report or document.

The ID that will be needed to track the generation status and receive the finished report or document.

400 Bad Request

The request contains incorrect data. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: object[]

A list of errors.
The general error format.

Min items: 1

status

Type: string

The type of response. Possible values:

  • OK — There are no errors.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

401 Unauthorized

The authorization data is not specified in the request. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: object[]

A list of errors.
The general error format.

Min items: 1

status

Type: string

The type of response. Possible values:

  • OK — There are no errors.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

403 Forbidden

The authorization data is incorrect or access to the resource is prohibited. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: object[]

A list of errors.
The general error format.

Min items: 1

status

Type: string

The type of response. Possible values:

  • OK — There are no errors.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

420 Method Failure

The resource access limit has been exceeded. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: object[]

A list of errors.
The general error format.

Min items: 1

status

Type: string

The type of response. Possible values:

  • OK — There are no errors.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

500 Internal Server Error

Internal error in Yandex. Market. More information about the error

Body

application/json
{
    "status": "OK",
    "errors": [
        {
            "code": "string",
            "message": "string"
        }
    ]
}

Name

Description

errors

Type: object[]

A list of errors.
The general error format.

Min items: 1

status

Type: string

The type of response. Possible values:

  • OK — There are no errors.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

No longer supported, please use an alternative and newer version.

It lists all the services that the Market has provided to the seller over the past month.

Read more about the act in Yandex.Market Help for sellers.

It lists all the services that the Market has provided to the seller over the past month.

This is a mandatory document regulated by a special Government decree.

The invoice contains the same information as in the certificate of services rendered. It is more convenient to use an act for accounting and analysis.

This is a mandatory document regulated by a special Government decree.

The invoice contains the same information as the service delivery certificate. It is more convenient to use an act for accounting and analysis.

The store's accountant needs a summary report to reflect the sale of goods in accounting.

The report is compiled for stores operating according to the models FBY and FBS. It indicates how many items and for what amount:

  • sent to customers;
  • delivered to customers;
  • The buyers did not buy back;
  • the buyers returned it.
The report is in the same PDF-the file is that of a certificate of services rendered.

Read more about the report in Yandex.Market Help for sellers.

The report shows how much money the Market has received from customers, how much it has already transferred to the seller, and how much it still owes.

Read more about the report in Yandex.Market Help for sellers.

The act states:

  • the total amount of all discounts on products that the Market has provided to customers;
  • the total amount of all shipping discounts that the Market has provided to customers (only for the model DBS);
  • the total amount of payments in Plus points.

Shows the amount on the balance at the beginning of the month that the seller has not spent yet. The document is useful for an accountant.

Shows the seller's balance — expenses and the balance at the end of the month.

Shows the services provided by all the brands of the seller or advertiser. The details are useful for accounting purposes.

Previous
Report on the cost of services
Next
Report on convergence with closing documents