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.

Report on convergence with 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

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}.

Explanation of the report columns:

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

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

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

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

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

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

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

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

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

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

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

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

Explanation of the report columns:

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

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

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

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

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

Explanation of the report columns:

Sheet Полки (file advertiser_operations_shelf)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

DEDUCTED_BONUSES

deductedBonuses

Списано бонусов

number

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Буст продаж, оплата за показы (file advertiser_operations_cpm_boost)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

DEDUCTED_BONUSES

deductedBonuses

Списано бонусов

number

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Буст продаж, оплата за продажи (file advertiser_operations_cpa_auction_promotion)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

DEDUCTED_BONUSES

deductedBonuses

Списано бонусов

number

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Баннеры (бронирование) (file advertiser_operations_package_banners)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

DEDUCTED_BONUSES

deductedBonuses

Списано бонусов

number

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Баннеры (аукцион) (file advertiser_operations_auction_banners)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

DEDUCTED_BONUSES

deductedBonuses

Списано бонусов

number

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Пуши (бронирование) (file advertiser_operations_package_pushes)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Пуши (аукцион) (file advertiser_operations_auction_pushes)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Поп-ап уведомления (бронировани (file advertiser_operations_package_popups)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Поп-ап уведомления (аукцион) (file advertiser_operations_auction_popups)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Полки с оплатой по дням (file advertiser_operations_cpd_promotion)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Рекламно-информационные материа (file advertiser_operations_marketing_promo_yandex_market)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

SERVICE_TYPE

serviceType

Тип услуги

string

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Реклама на внешних площадках (file advertiser_operations_marketing_promo_web)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

SERVICE_TYPE

serviceType

Тип услуги

string

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet ТВ реклама (file advertiser_operations_marketing_promo_tv)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

SERVICE_TYPE

serviceType

Тип услуги

string

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Информационная рассылка по зада (file advertiser_operations_marketing_promo_mailing)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

SERVICE_TYPE

serviceType

Тип услуги

string

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Организация и проведение маркет (file advertiser_operations_marketing_promo_for_sales)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

SERVICE_TYPE

serviceType

Тип услуги

string

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Специальные размещения (file advertiser_operations_marketing_promo_adfox)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

SERVICE_TYPE

serviceType

Тип услуги

string

CAMPAIGN_NAME

campaignName

Кампания

string

OPERATION_TYPE

operationType

Тип операции

string

CABINET_TYPE

cabinetType

Тип кабинета

string

CABINET_NAME

cabinetName

Название кабинета

string

Sheet Отзывы за баллы (file advertiser_operations_paid_opinion)

CSV column name

JSON column name

XLSX column name

Value type

DATE

date

Дата

string

SUM

sum

Сумма (с НДС), ₽

number

BRAND

brand

Бренд

string

CATEGORY

category

Категория

string

MODEL

model

Товар

string

MARKET_URL

marketUrl

Ссылка на Маркет

string

, Limit: 100 requests per hour

Request

POST

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

Query parameters

Name

Description

format

Type: ReportFormatType

The format of the report or document.

ReportFormatType

Report format:

  • FILE — a spreadsheet file (XLSX).
  • CSV — ZIP archive with CSV files for each report sheet.
  • JSON — ZIP archive with JSON files for each report sheet.

Type

Description

ReportFormatType

Default: FILE

Enum: FILE, CSV, JSON

Body

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

Name

Description

campaignId*

Type: integer<int64>

The 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 the name of your business and go to the page:

  • Modules and APIs → block Sending data to Yandex.Market.
  • Query log → drop-down list in the block Show logs.

, Do not send the store's ID instead, which is indicated in the seller's account on the Market next to the store's name and in some reports.

contractType*

Type: ClosureDocumentsContractType

Type of agreement:

  • INCOME — the accommodation agreement.

  • OUTCOME — a promotion agreement.

  • MARKETING — a marketing contract.

Enum: INCOME, OUTCOME, MARKETING

monthOfYear*

Type: ClosureDocumentsMonthOfYearDTO

The month for which the necessary closing documents were generated.

ClosureDocumentsContractType

Type of agreement:

  • INCOME — the accommodation agreement.

  • OUTCOME — a promotion agreement.

  • MARKETING — a marketing contract.

Type

Description

ClosureDocumentsContractType

Enum: INCOME, OUTCOME, MARKETING

ClosureDocumentsMonthOfYearDTO

Month and year.

Name

Description

month*

Type: integer<int32>

The month number.

Example: 12

Min value: 1

Max value: 12

year*

Type: integer<int32>

Year.

Example: 2025

Responses

200 OK

In response, you receive an identifier that allows you to find out the generation status and download the finished report.

Body

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

Name

Description

result

Type: GenerateReportDTO

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

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

GenerateReportDTO

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

Name

Description

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.

ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

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: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

ApiErrorDTO

The general error format.

Name

Description

code*

Type: string

The error code.

message

Type: string

Description of the 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: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • 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: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • 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: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • 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: ApiErrorDTO[]

A list of errors.
The general error format.

Min items: 1

status

Type: ApiResponseStatusType

The type of response. Possible values:

  • OK — there are no mistakes.
  • ERROR — an error occurred while processing the request.

Enum: OK, ERROR

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