--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/market/partner-api/doc/en/reference/reports/generateGoodsRealizationReport.md - https://yandex.com/dev/market/partner-api/doc/ru/reference/reports/generateGoodsRealizationReport.md - https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateGoodsRealizationReport.md - href: en/reference/reports/generateGoodsRealizationReport.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 %}
# Implementation Report {% list tabs %} - Info **The method is available for models: [FBY](https://yandex.com/dev/market/partner-api/doc/en/overview/fby.md), [FBS](https://yandex.com/dev/market/partner-api/doc/en/overview/fbs.md), [Express](https://yandex.com/dev/market/partner-api/doc/en/overview/express.md) and [DBS](https://yandex.com/dev/market/partner-api/doc/en/overview/dbs.md).** {% cut "**If you are using an API Key token, one of the accesses in the list is required to call the method**" %} * finance-and-accounting — [View financial data and reports](https://yandex.com/dev/market/partner-api/doc/en/_auto/scopes_summary/pages/finance-and-accounting.md) * all-methods — Full account management * all-methods:read-only — View all data {% endcut %} Starts the generation of the implementation report for the specified period. [What kind of report is this](https://yandex.ru/support/marketplace/ru/accounting/transactions#sales-report) 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 %} - FBY, FBS, Express Explanation of the report columns: {% cut "Sheet **Items handed over for delivery** (file **transferred_to_delivery**)" %} #| || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** || || ORDER_ID | orderId | Orders/Order number | integer || || YOUR_ORDER_ID | yourOrderId | Orders/Your order number | string || || ORDER_TYPE | orderType | Orders/Order type | string || || OFFER_NAME | offerName | Orders/Product name | string || || YOUR_SKU | yourSku | Orders/Your SKU | string || || SHOP_SKU | shopSku | Orders/${mbi.reports.statistics:mbi.reports.statistics.column.shop.sku} | string || || TRANSFERRED_TO_DELIVERY_COUNT | transferredToDeliveryCount | Orders/Number transferred for delivery, items | integer || || ORDER_CREATION_DATE | orderCreationDate | Orders/Order creation date | string || || TRANSFERRED_TO_DELIVERY_DATE | transferredToDeliveryDate | Orders/Date goods were handed over for delivery | string || || DELIVERY_DATE | deliveryDate | Orders/Product delivery date | string || || PAYMENT_TYPE | paymentType | Orders/Payment method | string || || VAT | vat | Orders/VAT rate | string || || PRICE_WITH_VAT_AND_NO_DISCOUNT | priceWithVatAndNoDiscount | Orders/The price includes VAT without discounts per piece. | number || || SHOP_MARKETPLACE_DISCOUNT | shopMarketplaceDiscount | Orders/Your discount on the marketplace promotion is 1 pc. | number || || SPASIBO_DISCOUNT | spasiboDiscount | Orders/Your discount on Savings bonuses is only (per piece) for 1 piece. | number || || YANDEX_PLUS_DISCOUNT | yandexPlusDiscount | Orders/Your discount on Yandex points.Advantages per 1 pc . | number || || PRICE_WITH_VAT_AND_ALL_DISCOUNTS | priceWithVatAndAllDiscounts | Orders/Price with VAT, including all discounts per piece. | number || || TRANSFERRED_TO_DELIVERY_PRICE_SUM_WITH_VAT_AND_NO_DISCOUNTS | transferredToDeliveryPriceSumWithVatAndNoDiscounts | Orders/The cost of all delivered pieces with VAT excluding discounts | number || || TRANSFERRED_TO_DELIVERY_DISCOUNT_SUM | transferredToDeliveryDiscountSum | Orders/The sum of all discounts for delivered pieces | number || || TRANSFERRED_TO_DELIVERY_PRICE_SUM_WITH_VAT_AND_DISCOUNTS | transferredToDeliveryPriceSumWithVatAndDiscounts | Orders/The cost of all delivered pieces with VAT, including all discounts | number || || RNPT | rnpt | Orders/Registration number of the customs declaration or the Registration Number of Batch of Products subject to tracking (RNBP) | string || || RECEIPT_ID | receiptId | Orders/Receipt number | string || || RECEIPT_LINK | receiptLink | Orders/Receipt link | string || || RECEIPT_DATETIME | receiptDatetime | Orders/Receipt printing date | string || || ORGANIZATION | organization | Sales to businesses/Information about buyer/Organization name | string || || INN | inn | Sales to businesses/Information about buyer/INN (taxpayer identification number) | string || || KPP | kpp | Sales to businesses/Information about buyer/KPP (Tax Registration Reason Code) | string || || ORGANIZATION_JUR_ADDRESS | organizationJurAddress | Sales to businesses/Information about buyer/Legal address | string || || UPD_STATUS | updStatus | Sales to businesses/Electronic document management/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Electronic document management/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Electronic document management/UPD number | string || || UPD_STATUS | updStatus | Sales to businesses/Documents/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Documents/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Documents/UPD number | string || || UKD_STATUS | ukdStatus | Sales to businesses/Documents/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Documents/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Documents/UKD number | string || || CONSIGNMENT_NOTE_DATE | consignmentNoteDate | Sales to businesses/Paper document management/Packing list date | string || || CONSIGNMENT_NOTE_NUMBER | consignmentNoteNumber | Sales to businesses/Paper document management/Packing list number | string || || INVOICE_DATE | invoiceDate | Sales to businesses/Paper document management/Invoice date | string || || INVOICE_NUMBER | invoiceNumber | Sales to businesses/Paper document management/Invoice number | string || |# {% endcut %} {% cut "Sheet **Products delivered** (file **delivered**)" %} #| || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** || || ORDER_ID | orderId | Orders/Order number | integer || || YOUR_ORDER_ID | yourOrderId | Orders/Your order number | string || || ORDER_TYPE | orderType | Orders/Order type | string || || OFFER_NAME | offerName | Orders/Product name | string || || YOUR_SKU | yourSku | Orders/Your SKU | string || || SHOP_SKU | shopSku | Orders/${mbi.reports.statistics:mbi.reports.statistics.column.shop.sku} | string || || TRANSFERRED_TO_DELIVERY_COUNT | transferredToDeliveryCount | Orders/Number transferred for delivery, items | integer || || DELIVERED_COUNT | deliveredCount | Orders/Delivered, items | integer || || ORDER_CREATION_DATE | orderCreationDate | Orders/Order creation date | string || || TRANSFERRED_TO_DELIVERY_DATE | transferredToDeliveryDate | Orders/Date goods were handed over for delivery | string || || DELIVERY_DATE | deliveryDate | Orders/Product delivery date | string || || PAYMENT_TYPE | paymentType | Orders/Payment method | string || || VAT | vat | Orders/VAT rate | string || || PRICE_WITH_VAT_AND_NO_DISCOUNT | priceWithVatAndNoDiscount | Orders/The price includes VAT without discounts per piece. | number || || SHOP_MARKETPLACE_DISCOUNT | shopMarketplaceDiscount | Orders/Your discount on the marketplace promotion is 1 pc. | number || || SPASIBO_DISCOUNT | spasiboDiscount | Orders/Your discount on Savings bonuses is only (per piece) for 1 piece. | number || || YANDEX_PLUS_DISCOUNT | yandexPlusDiscount | Orders/Your discount on Yandex points.Advantages per 1 pc . | number || || PRICE_WITH_VAT_AND_ALL_DISCOUNTS | priceWithVatAndAllDiscounts | Orders/Price with VAT, including all discounts per piece. | number || || DELIVERED_PRICE_SUM_WITH_VAT_AND_NO_DISCOUNTS | deliveredPriceSumWithVatAndNoDiscounts | Orders/The cost of all delivered pieces with VAT excluding discounts | number || || DELIVERED_DISCOUNT_SUM | deliveredDiscountSum | Orders/The sum of all discounts for delivered pieces | number || || DELIVERED_PRICE_SUM_WITH_VAT_AND_DISCOUNTS | deliveredPriceSumWithVatAndDiscounts | Orders/The cost of all delivered pieces with VAT, including all discounts | number || || RNPT | rnpt | Orders/Registration number of the customs declaration or the Registration Number of Batch of Products subject to tracking (RNBP) | string || || RECEIPT_ID | receiptId | Orders/Receipt number | string || || RECEIPT_LINK | receiptLink | Orders/Receipt link | string || || RECEIPT_DATETIME | receiptDatetime | Orders/Receipt printing date | string || || ORGANIZATION | organization | Sales to businesses/Information about buyer/Organization name | string || || INN | inn | Sales to businesses/Information about buyer/INN (taxpayer identification number) | string || || KPP | kpp | Sales to businesses/Information about buyer/KPP (Tax Registration Reason Code) | string || || ORGANIZATION_JUR_ADDRESS | organizationJurAddress | Sales to businesses/Information about buyer/Legal address | string || || UPD_STATUS | updStatus | Sales to businesses/Electronic document management/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Electronic document management/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Electronic document management/UPD number | string || || UPD_STATUS | updStatus | Продажи бизнесу/Документы/Статус УПД | string || || UPD_DATE | updDate | Продажи бизнесу/Документы/Дата УПД | string || || UPD_NUMBER | updNumber | Продажи бизнесу/Документы/Номер УПД | string || || CONSIGNMENT_NOTE_DATE | consignmentNoteDate | Sales to businesses/Paper document management/Packing list date | string || || CONSIGNMENT_NOTE_NUMBER | consignmentNoteNumber | Sales to businesses/Paper document management/Packing list number | string || || INVOICE_DATE | invoiceDate | Sales to businesses/Paper document management/Invoice date | string || || INVOICE_NUMBER | invoiceNumber | Sales to businesses/Paper document management/Invoice number | string || |# {% endcut %} {% cut "Sheet **Unpurchased items** (file **unredeemed**)" %} #| || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** || || ORDER_ID | orderId | Orders/Order number | integer || || YOUR_ORDER_ID | yourOrderId | Orders/Your order number | string || || ORDER_TYPE | orderType | Orders/Order type | string || || OFFER_NAME | offerName | Orders/Product name | string || || YOUR_SKU | yourSku | Orders/Your SKU | string || || SHOP_SKU | shopSku | Orders/${mbi.reports.statistics:mbi.reports.statistics.column.shop.sku} | string || || TRANSFERRED_TO_DELIVERY_COUNT | transferredToDeliveryCount | Orders/Number transferred for delivery, items | integer || || UNREDEEMED_COUNT | unredeemedCount | Orders/Unpurchased, items | integer || || ORDER_CREATION_DATE | orderCreationDate | Orders/Order creation date | string || || TRANSFERRED_TO_DELIVERY_DATE | transferredToDeliveryDate | Orders/Date goods were handed over for delivery | string || || DELIVERY_DATE | deliveryDate | Orders/Product delivery date | string || || UNREDEEMED_WAREHOUSE_OR_SC_ACCEPT_DATE | unredeemedWarehouseOrScAcceptDate | Orders/Date of acceptance of the non-purchase by the warehouse or sorting center | string || || PAYMENT_TYPE | paymentType | Orders/Payment method | string || || VAT | vat | Orders/VAT rate | string || || PRICE_WITH_VAT_AND_NO_DISCOUNT | priceWithVatAndNoDiscount | Orders/The price includes VAT without discounts per piece. | number || || SHOP_MARKETPLACE_DISCOUNT | shopMarketplaceDiscount | Orders/Your discount on the marketplace promotion is 1 pc. | number || || SPASIBO_DISCOUNT | spasiboDiscount | Orders/Your discount on Savings bonuses is only (per piece) for 1 piece. | number || || YANDEX_PLUS_DISCOUNT | yandexPlusDiscount | Orders/Your discount on Yandex points.Advantages per 1 pc . | number || || PRICE_WITH_VAT_AND_ALL_DISCOUNTS | priceWithVatAndAllDiscounts | Orders/Price with VAT, including all discounts per piece. | number || || UNREDEEMED_PRICE_SUM_WITH_VAT_AND_NO_DISCOUNTS | unredeemedPriceSumWithVatAndNoDiscounts | Orders/The cost of all non-purchased pieces with VAT excluding discounts | number || || UNREDEEMED_DISCOUNT_SUM | unredeemedDiscountSum | Orders/The sum of all discounts for non-purchased pieces | number || || UNREDEEMED_PRICE_SUM_WITH_VAT_AND_DISCOUNTS | unredeemedPriceSumWithVatAndDiscounts | Orders/Стоимость всех невыкупленных штук с НДС с учётом всех скидок | number || || RNPT | rnpt | Orders/Registration number of the customs declaration or the Registration Number of Batch of Products subject to tracking (RNBP) | string || || RECEIPT_ID | receiptId | Orders/Receipt number | string || || RECEIPT_LINK | receiptLink | Orders/Receipt link | string || || RECEIPT_DATETIME | receiptDatetime | Orders/Receipt printing date | string || || ORGANIZATION | organization | Sales to businesses/Information about buyer/Organization name | string || || INN | inn | Sales to businesses/Information about buyer/INN (taxpayer identification number) | string || || KPP | kpp | Sales to businesses/Information about buyer/KPP (Tax Registration Reason Code) | string || || ORGANIZATION_JUR_ADDRESS | organizationJurAddress | Sales to businesses/Information about buyer/Legal address | string || || UKD_STATUS | ukdStatus | Sales to businesses/Electronic document management/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Electronic document management/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Electronic document management/UKD number | string || || CONSIGNMENT_NOTE_DATE | consignmentNoteDate | Sales to businesses/Paper document management/Packing list date | string || || CONSIGNMENT_NOTE_NUMBER | consignmentNoteNumber | Sales to businesses/Paper document management/Packing list number | string || || INVOICE_DATE | invoiceDate | Sales to businesses/Paper document management/Invoice date | string || || INVOICE_NUMBER | invoiceNumber | Sales to businesses/Paper document management/Invoice number | string || || ADJUSTMENT_INVOICE_DATE | adjustmentInvoiceDate | Sales to businesses/Paper document management/Adjustment invoice date | string || || ADJUSTMENT_INVOICE_NUMBER | adjustmentInvoiceNumber | Sales to businesses/Paper document management/Adjustment invoice number | string || || REDEEMED_PRICE | redeemedPrice | Sales to businesses/The cost of the purchased product | string || || UPD_STATUS | updStatus | Sales to businesses/Electronic document management/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Electronic document management/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Electronic document management/UPD number | string || || UPD_STATUS | updStatus | Sales to businesses/Documents/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Documents/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Documents/UPD number | string || || UKD_STATUS | ukdStatus | Sales to businesses/Documents/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Documents/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Documents/UKD number | string || || REDEEMED_PRICE | redeemedPrice | Sales to businesses/Documents/The cost of the purchased product | string || |# {% endcut %} {% cut "Sheet **Returned items** (file **returned**)" %} #| || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** || || ORDER_ID | orderId | Orders/Order number | integer || || YOUR_ORDER_ID | yourOrderId | Orders/Your order number | string || || ORDER_TYPE | orderType | Orders/Order type | string || || OFFER_NAME | offerName | Orders/Product name | string || || YOUR_SKU | yourSku | Orders/Your SKU | string || || SHOP_SKU | shopSku | Orders/${mbi.reports.statistics:mbi.reports.statistics.column.shop.sku} | string || || DELIVERED_COUNT | deliveredCount | Orders/Quantity, items | integer || || RETURNED_COUNT | returnedCount | Orders/Returned, items | integer || || ORDER_CREATION_DATE | orderCreationDate | Orders/Order creation date | string || || TRANSFERRED_TO_DELIVERY_DATE | transferredToDeliveryDate | Orders/Date goods were handed over for delivery | string || || DELIVERY_DATE | deliveryDate | Orders/Product delivery date | string || || RETURN_WAREHOUSE_OR_SC_ACCEPT_DATE | returnWarehouseOrScAcceptDate | Orders/Return acceptance date by the warehouse or sorting center | string || || PAYMENT_TYPE | paymentType | Orders/Payment method | string || || VAT | vat | Orders/VAT rate | string || || PRICE_WITH_VAT_AND_NO_DISCOUNT | priceWithVatAndNoDiscount | Orders/The price includes VAT without discounts per piece. | number || || SHOP_MARKETPLACE_DISCOUNT | shopMarketplaceDiscount | Orders/Your discount on the marketplace promotion is 1 pc. | number || || SPASIBO_DISCOUNT | spasiboDiscount | Orders/Your discount on Savings bonuses is only (per piece) for 1 piece. | number || || YANDEX_PLUS_DISCOUNT | yandexPlusDiscount | Orders/Your discount on Yandex points.Advantages per 1 pc . | number || || PRICE_WITH_VAT_AND_ALL_DISCOUNTS | priceWithVatAndAllDiscounts | Orders/Price with VAT, including all discounts per piece. | number || || RETURN_PRICE_SUM_WITH_VAT_AND_NO_DISCOUNTS | returnPriceSumWithVatAndNoDiscounts | Orders/The cost of all returned pieces with VAT excluding discounts | number || || RETURN_DISCOUNT_SUM | returnDiscountSum | Orders/The sum of all discounts for returned pieces | number || || RETURN_PRICE_SUM_WITH_VAT_AND_DISCOUNTS | returnPriceSumWithVatAndDiscounts | Orders/The cost of all returned pieces with VAT, including all discounts | number || || ORGANIZATION | organization | Sales to businesses/Information about buyer/Organization name | string || || INN | inn | Sales to businesses/Information about buyer/INN (taxpayer identification number) | string || || KPP | kpp | Sales to businesses/Information about buyer/KPP (Tax Registration Reason Code) | string || || ORGANIZATION_JUR_ADDRESS | organizationJurAddress | Sales to businesses/Information about buyer/Legal address | string || || UPD_STATUS | updStatus | Sales to businesses/Documents/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Documents/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Documents/UPD number | string || || UKD_STATUS | ukdStatus | Sales to businesses/Documents/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Documents/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Documents/UKD number | string || || REDEEMED_PRICE | redeemedPrice | Sales to businesses/Documents/The cost of the purchased product | number || || UPD_STATUS | updStatus | Sales to businesses/Electronic document management/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Electronic document management/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Electronic document management/UPD number | string || || UKD_STATUS | ukdStatus | Sales to businesses/Electronic document management/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Electronic document management/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Electronic document management/UKD number | string || || CONSIGNMENT_NOTE_DATE | consignmentNoteDate | Sales to businesses/Paper document management/Packing list date | string || || CONSIGNMENT_NOTE_NUMBER | consignmentNoteNumber | Sales to businesses/Paper document management/Packing list number | string || || INVOICE_DATE | invoiceDate | Sales to businesses/Paper document management/Invoice date | string || || INVOICE_NUMBER | invoiceNumber | Sales to businesses/Paper document management/Invoice number | string || || ADJUSTMENT_INVOICE_DATE | adjustmentInvoiceDate | Sales to businesses/Paper document management/Adjustment invoice date | string || || ADJUSTMENT_INVOICE_NUMBER | adjustmentInvoiceNumber | Sales to businesses/Paper document management/Adjustment invoice number | string || || REDEEMED_PRICE | redeemedPrice | Sales to businesses/The cost of the purchased product | number || || RNPT | rnpt | Orders/Registration number of the customs declaration or the Registration Number of Batch of Products subject to tracking (RNBP) | string || || RECEIPT_ID | receiptId | Orders/Receipt number | string || || RECEIPT_LINK | receiptLink | Orders/Receipt link | string || || RECEIPT_DATETIME | receiptDatetime | Orders/Receipt printing date | string || |# {% endcut %} {% cut "Sheet **Lost items** (file **lost_items**)" %} #| || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** || || ORDER_ID | orderId | Orders/Order number | integer || || YOUR_ORDER_ID | yourOrderId | Orders/Your order number | string || || ORDER_TYPE | orderType | Orders/Order type | string || || OFFER_NAME | offerName | Orders/Product name | string || || YOUR_SKU | yourSku | Orders/Your SKU | string || || SHOP_SKU | shopSku | Orders/${mbi.reports.statistics:mbi.reports.statistics.column.shop.sku} | string || || TRANSFERRED_TO_DELIVERY_COUNT | transferredToDeliveryCount | Orders/Number transferred for delivery, items | integer || || ORDER_CREATION_DATE | orderCreationDate | Orders/Order creation date | string || || TRANSFERRED_TO_DELIVERY_DATE | transferredToDeliveryDate | Orders/Date goods were handed over for delivery | string || || DELIVERY_DATE | deliveryDate | Orders/Product delivery date | string || || PAYMENT_TYPE | paymentType | Orders/Payment method | string || || VAT | vat | Orders/VAT rate | string || || PRICE_WITH_VAT_AND_NO_DISCOUNT | priceWithVatAndNoDiscount | Orders/The price includes VAT without discounts per piece. | number || || SHOP_MARKETPLACE_DISCOUNT | shopMarketplaceDiscount | Orders/Your discount on the marketplace promotion is 1 pc. | number || || SPASIBO_DISCOUNT | spasiboDiscount | Orders/Your discount on Savings bonuses is only (per piece) for 1 piece. | number || || YANDEX_PLUS_DISCOUNT | yandexPlusDiscount | Orders/Your discount on Yandex points.Advantages per 1 pc . | number || || PRICE_WITH_VAT_AND_ALL_DISCOUNTS | priceWithVatAndAllDiscounts | Orders/Price with VAT, including all discounts per piece. | number || || TRANSFERRED_TO_DELIVERY_PRICE_SUM_WITH_VAT_AND_NO_DISCOUNTS | transferredToDeliveryPriceSumWithVatAndNoDiscounts | Orders/The cost of all delivered pieces with VAT excluding discounts | number || || TRANSFERRED_TO_DELIVERY_DISCOUNT_SUM | transferredToDeliveryDiscountSum | Orders/The sum of all discounts for delivered pieces | number || || TRANSFERRED_TO_DELIVERY_PRICE_SUM_WITH_VAT_AND_DISCOUNTS | transferredToDeliveryPriceSumWithVatAndDiscounts | Orders/The cost of all delivered pieces with VAT, including all discounts | number || || RNPT | rnpt | Orders/Registration number of the customs declaration or the Registration Number of Batch of Products subject to tracking (RNBP) | string || || RECEIPT_ID | receiptId | Orders/Receipt number | string || || RECEIPT_LINK | receiptLink | Orders/Receipt link | string || || RECEIPT_DATETIME | receiptDatetime | Orders/Receipt printing date | string || || COMPENSATION_DATE | compensationDate | Compensations/Autocompensation date | string || || COMPENSATION_AMOUNT | compensationAmount | Compensations/The amount of auto compensation | number || || LOST_RETURN_RECEIVED_DATE | lostReturnReceivedDate | Compensations/Warehouse acceptance or merchant pickup date | string || || DECOMPENSATION_DATE | decompensationDate | Compensations/Decompensation date | string || || DECOMPENSATION_AMOUNT | decompensationAmount | Compensations/The amount of decompensation | number || || ORGANIZATION | organization | Sales to businesses/Information about buyer/Organization name | string || || INN | inn | Sales to businesses/Information about buyer/INN (taxpayer identification number) | string || || KPP | kpp | Sales to businesses/Information about buyer/KPP (Tax Registration Reason Code) | string || || ORGANIZATION_JUR_ADDRESS | organizationJurAddress | Sales to businesses/Information about buyer/Legal address | string || || UPD_STATUS | updStatus | Sales to businesses/Electronic document management/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Electronic document management/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Electronic document management/UPD number | string || || CONSIGNMENT_NOTE_DATE | consignmentNoteDate | Sales to businesses/Paper document management/Packing list date | string || || CONSIGNMENT_NOTE_NUMBER | consignmentNoteNumber | Sales to businesses/Paper document management/Packing list number | string || || INVOICE_DATE | invoiceDate | Sales to businesses/Paper document management/Invoice date | string || || INVOICE_NUMBER | invoiceNumber | Sales to businesses/Paper document management/Invoice number | string || || UKD_STATUS | ukdStatus | Sales to businesses/Electronic document management/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Electronic document management/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Electronic document management/UKD number | string || || ADJUSTMENT_INVOICE_DATE | adjustmentInvoiceDate | Sales to businesses/Paper document management/Adjustment invoice date | string || || ADJUSTMENT_INVOICE_NUMBER | adjustmentInvoiceNumber | Sales to businesses/Paper document management/Adjustment invoice number | string || |# {% endcut %} - DBS Explanation of the report columns: {% cut "Sheet **Sent for delivery** (file **transferred_to_delivery**)" %} #| || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** || || ORDER_ID | orderId | Orders/Order number | integer || || YOUR_ORDER_ID | yourOrderId | Orders/Your order number | string || || ORDER_TYPE | orderType | Orders/Order type | string || || OFFER_NAME | offerName | Orders/Title | string || || YOUR_SKU | yourSku | Orders/Your SKU | string || || SHOP_SKU | shopSku | Orders/${mbi.reports.statistics:mbi.reports.statistics.column.shop.sku} | string || || TRANSFERRED_TO_DELIVERY_COUNT | transferredToDeliveryCount | Orders/Number transferred for delivery, items | integer || || ORDER_CREATION_DATE | orderCreationDate | Orders/Order creation date | string || || TRANSFERRED_TO_DELIVERY_DATE | transferredToDeliveryDate | Orders/Date goods were handed over for delivery | string || || DELIVERY_DATE | deliveryDate | Orders/Product delivery date | string || || PAYMENT_TYPE | paymentType | Orders/Payment method | string || || VAT | vat | Orders/VAT rate | string || || PRICE_WITH_VAT_AND_NO_DISCOUNT | priceWithVatAndNoDiscount | Orders/The price includes VAT without discounts per piece. | number || || SHOP_MARKETPLACE_DISCOUNT | shopMarketplaceDiscount | Orders/Your discount on the marketplace promotion is 1 pc. | number || || SPASIBO_DISCOUNT | spasiboDiscount | Orders/Your discount on Savings bonuses is only (per piece) for 1 piece. | number || || YANDEX_PLUS_DISCOUNT | yandexPlusDiscount | Orders/Your discount on Yandex points.Advantages per 1 pc . | number || || PRICE_WITH_VAT_AND_ALL_DISCOUNTS | priceWithVatAndAllDiscounts | Orders/Price with VAT, including all discounts per piece. | number || || TRANSFERRED_TO_DELIVERY_PRICE_SUM_WITH_VAT_AND_NO_DISCOUNTS | transferredToDeliveryPriceSumWithVatAndNoDiscounts | Orders/The cost of all delivered pieces with VAT excluding discounts | number || || TRANSFERRED_TO_DELIVERY_DISCOUNT_SUM | transferredToDeliveryDiscountSum | Orders/The sum of all discounts for delivered pieces | number || || TRANSFERRED_TO_DELIVERY_PRICE_SUM_WITH_VAT_AND_DISCOUNTS | transferredToDeliveryPriceSumWithVatAndDiscounts | Orders/The cost of all delivered pieces with VAT, including all discounts | number || || RNPT | rnpt | Orders/Registration number of the customs declaration or the Registration Number of Batch of Products subject to tracking (RNBP) | string || || RECEIPT_ID | receiptId | Orders/Receipt number | string || || RECEIPT_LINK | receiptLink | Orders/Receipt link | string || || RECEIPT_DATETIME | receiptDatetime | Orders/Receipt printing date | string || || ORGANIZATION | organization | Sales to businesses/Information about buyer/Organization name | string || || INN | inn | Sales to businesses/Information about buyer/INN (taxpayer identification number) | string || || KPP | kpp | Sales to businesses/Information about buyer/KPP (Tax Registration Reason Code) | string || || ORGANIZATION_JUR_ADDRESS | organizationJurAddress | Sales to businesses/Information about buyer/Legal address | string || || UPD_STATUS | updStatus | Sales to businesses/Electronic document management/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Electronic document management/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Electronic document management/UPD number | string || || UPD_STATUS | updStatus | Sales to businesses/Documents/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Documents/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Documents/UPD number | string || || UKD_STATUS | ukdStatus | Sales to businesses/Documents/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Documents/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Documents/UKD number | string || || CONSIGNMENT_NOTE_DATE | consignmentNoteDate | Sales to businesses/Paper document management/Packing list date | string || || CONSIGNMENT_NOTE_NUMBER | consignmentNoteNumber | Sales to businesses/Paper document management/Packing list number | string || || INVOICE_DATE | invoiceDate | Sales to businesses/Paper document management/Invoice date | string || || INVOICE_NUMBER | invoiceNumber | Sales to businesses/Paper document management/Invoice number | string || |# {% endcut %} {% cut "Sheet **Delivered** (file **delivered**)" %} #| || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** || || ORDER_ID | orderId | Orders/Order number | integer || || YOUR_ORDER_ID | yourOrderId | Orders/Your order number | string || || ORDER_TYPE | orderType | Orders/Order type | string || || OFFER_NAME | offerName | Orders/Title | string || || YOUR_SKU | yourSku | Orders/Your SKU | string || || SHOP_SKU | shopSku | Orders/${mbi.reports.statistics:mbi.reports.statistics.column.shop.sku} | string || || TRANSFERRED_TO_DELIVERY_COUNT | transferredToDeliveryCount | Orders/Number transferred for delivery, items | integer || || DELIVERED_COUNT | deliveredCount | Orders/Delivered, items | integer || || ORDER_CREATION_DATE | orderCreationDate | Orders/Order creation date | string || || TRANSFERRED_TO_DELIVERY_DATE | transferredToDeliveryDate | Orders/Date goods were handed over for delivery | string || || DELIVERY_DATE | deliveryDate | Orders/Product delivery date | string || || PAYMENT_TYPE | paymentType | Orders/Payment method | string || || VAT | vat | Orders/VAT rate | string || || PRICE_WITH_VAT_AND_NO_DISCOUNT | priceWithVatAndNoDiscount | Orders/The price includes VAT without discounts per piece. | number || || SHOP_MARKETPLACE_DISCOUNT | shopMarketplaceDiscount | Orders/Your discount on the marketplace promotion is 1 pc. | number || || SPASIBO_DISCOUNT | spasiboDiscount | Orders/Your discount on Savings bonuses is only (per piece) for 1 piece. | number || || YANDEX_PLUS_DISCOUNT | yandexPlusDiscount | Orders/Your discount on Yandex points.Advantages per 1 pc . | number || || PRICE_WITH_VAT_AND_ALL_DISCOUNTS | priceWithVatAndAllDiscounts | Orders/Price with VAT, including all discounts per piece. | number || || DELIVERED_PRICE_SUM_WITH_VAT_AND_NO_DISCOUNTS | deliveredPriceSumWithVatAndNoDiscounts | Orders/The cost of all delivered pieces with VAT excluding discounts | number || || DELIVERED_DISCOUNT_SUM | deliveredDiscountSum | Orders/The sum of all discounts for delivered pieces | number || || DELIVERED_PRICE_SUM_WITH_VAT_AND_DISCOUNTS | deliveredPriceSumWithVatAndDiscounts | Orders/The cost of all delivered pieces with VAT, including all discounts | number || || RNPT | rnpt | Orders/Registration number of the customs declaration or the Registration Number of Batch of Products subject to tracking (RNBP) | string || || RECEIPT_ID | receiptId | Orders/Receipt number | string || || RECEIPT_LINK | receiptLink | Orders/Receipt link | string || || RECEIPT_DATETIME | receiptDatetime | Orders/Receipt printing date | string || || ORGANIZATION | organization | Sales to businesses/Information about buyer/Organization name | string || || INN | inn | Sales to businesses/Information about buyer/INN (taxpayer identification number) | string || || KPP | kpp | Sales to businesses/Information about buyer/KPP (Tax Registration Reason Code) | string || || ORGANIZATION_JUR_ADDRESS | organizationJurAddress | Sales to businesses/Information about buyer/Legal address | string || || UPD_STATUS | updStatus | Sales to businesses/Electronic document management/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Electronic document management/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Electronic document management/UPD number | string || || UPD_STATUS | updStatus | Продажи бизнесу/Документы/Статус УПД | string || || UPD_DATE | updDate | Продажи бизнесу/Документы/Дата УПД | string || || UPD_NUMBER | updNumber | Продажи бизнесу/Документы/Номер УПД | string || || CONSIGNMENT_NOTE_DATE | consignmentNoteDate | Sales to businesses/Paper document management/Packing list date | string || || CONSIGNMENT_NOTE_NUMBER | consignmentNoteNumber | Sales to businesses/Paper document management/Packing list number | string || || INVOICE_DATE | invoiceDate | Sales to businesses/Paper document management/Invoice date | string || || INVOICE_NUMBER | invoiceNumber | Sales to businesses/Paper document management/Invoice number | string || |# {% endcut %} {% cut "Sheet **Unbought** (file **unredeemed**)" %} #| || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** || || ORDER_ID | orderId | Orders/Order number | integer || || YOUR_ORDER_ID | yourOrderId | Orders/Your order number | string || || ORDER_TYPE | orderType | Orders/Order type | string || || OFFER_NAME | offerName | Orders/Title | string || || YOUR_SKU | yourSku | Orders/Your SKU | string || || SHOP_SKU | shopSku | Orders/${mbi.reports.statistics:mbi.reports.statistics.column.shop.sku} | string || || TRANSFERRED_TO_DELIVERY_COUNT | transferredToDeliveryCount | Orders/Number transferred for delivery, items | integer || || UNREDEEMED_COUNT | unredeemedCount | Orders/Not redeemed, PCs. | integer || || ORDER_CREATION_DATE | orderCreationDate | Orders/Order creation date | string || || TRANSFERRED_TO_DELIVERY_DATE | transferredToDeliveryDate | Orders/Date goods were handed over for delivery | string || || DELIVERY_DATE | deliveryDate | Orders/Product delivery date | string || || UNREDEEMED_WAREHOUSE_OR_SC_ACCEPT_DATE | unredeemedWarehouseOrScAcceptDate | Orders/Date of acceptance of the non-purchase by the warehouse or sorting center | string || || PAYMENT_TYPE | paymentType | Orders/Payment method | string || || VAT | vat | Orders/VAT rate | string || || PRICE_WITH_VAT_AND_NO_DISCOUNT | priceWithVatAndNoDiscount | Orders/The price includes VAT without discounts per piece. | number || || SHOP_MARKETPLACE_DISCOUNT | shopMarketplaceDiscount | Orders/Your discount on the marketplace promotion is 1 pc. | number || || SPASIBO_DISCOUNT | spasiboDiscount | Orders/Your discount on Savings bonuses is only (per piece) for 1 piece. | number || || YANDEX_PLUS_DISCOUNT | yandexPlusDiscount | Orders/Your discount on Yandex points.Advantages per 1 pc . | number || || PRICE_WITH_VAT_AND_ALL_DISCOUNTS | priceWithVatAndAllDiscounts | Orders/Price with VAT, including all discounts per piece. | number || || UNREDEEMED_PRICE_SUM_WITH_VAT_AND_NO_DISCOUNTS | unredeemedPriceSumWithVatAndNoDiscounts | Orders/The cost of all non-purchased pieces with VAT excluding discounts | number || || UNREDEEMED_DISCOUNT_SUM | unredeemedDiscountSum | Orders/The sum of all discounts for non-purchased pieces | number || || UNREDEEMED_PRICE_SUM_WITH_VAT_AND_DISCOUNTS | unredeemedPriceSumWithVatAndDiscounts | Orders/Стоимость всех невыкупленных штук с НДС с учётом всех скидок | number || || RNPT | rnpt | Orders/Registration number of the customs declaration or the Registration Number of Batch of Products subject to tracking (RNBP) | string || || RECEIPT_ID | receiptId | Orders/Receipt number | string || || RECEIPT_LINK | receiptLink | Orders/Receipt link | string || || RECEIPT_DATETIME | receiptDatetime | Orders/Receipt printing date | string || || ORGANIZATION | organization | Sales to businesses/Information about buyer/Organization name | string || || INN | inn | Sales to businesses/Information about buyer/INN (taxpayer identification number) | string || || KPP | kpp | Sales to businesses/Information about buyer/KPP (Tax Registration Reason Code) | string || || ORGANIZATION_JUR_ADDRESS | organizationJurAddress | Sales to businesses/Information about buyer/Legal address | string || || UKD_STATUS | ukdStatus | Sales to businesses/Electronic document management/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Electronic document management/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Electronic document management/UKD number | string || || CONSIGNMENT_NOTE_DATE | consignmentNoteDate | Sales to businesses/Paper document management/Packing list date | string || || CONSIGNMENT_NOTE_NUMBER | consignmentNoteNumber | Sales to businesses/Paper document management/Packing list number | string || || INVOICE_DATE | invoiceDate | Sales to businesses/Paper document management/Invoice date | string || || INVOICE_NUMBER | invoiceNumber | Sales to businesses/Paper document management/Invoice number | string || || ADJUSTMENT_INVOICE_DATE | adjustmentInvoiceDate | Sales to businesses/Paper document management/Adjustment invoice date | string || || ADJUSTMENT_INVOICE_NUMBER | adjustmentInvoiceNumber | Sales to businesses/Paper document management/Adjustment invoice number | string || || REDEEMED_PRICE | redeemedPrice | Sales to businesses/The cost of the purchased product | string || || UPD_STATUS | updStatus | Sales to businesses/Electronic document management/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Electronic document management/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Electronic document management/UPD number | string || || UPD_STATUS | updStatus | Sales to businesses/Documents/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Documents/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Documents/UPD number | string || || UKD_STATUS | ukdStatus | Sales to businesses/Documents/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Documents/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Documents/UKD number | string || || REDEEMED_PRICE | redeemedPrice | Sales to businesses/Documents/The cost of the purchased product | string || |# {% endcut %} {% cut "Sheet **Returned** (file **returned**)" %} #| || **CSV column name** | **JSON column name** | **XLSX column name** | **Value type** || || ORDER_ID | orderId | Orders/Order number | integer || || YOUR_ORDER_ID | yourOrderId | Orders/Your order number | string || || ORDER_TYPE | orderType | Orders/Order type | string || || OFFER_NAME | offerName | Orders/Title | string || || YOUR_SKU | yourSku | Orders/Your SKU | string || || SHOP_SKU | shopSku | Orders/${mbi.reports.statistics:mbi.reports.statistics.column.shop.sku} | string || || DELIVERED_COUNT | deliveredCount | Orders/Quantity, items | integer || || RETURNED_COUNT | returnedCount | Orders/Returned, items | integer || || ORDER_CREATION_DATE | orderCreationDate | Orders/Order creation date | string || || TRANSFERRED_TO_DELIVERY_DATE | transferredToDeliveryDate | Orders/Date goods were handed over for delivery | string || || DELIVERY_DATE | deliveryDate | Orders/Product delivery date | string || || RETURN_WAREHOUSE_OR_SC_ACCEPT_DATE | returnWarehouseOrScAcceptDate | Orders/Date of issue of the refund to you | string || || PAYMENT_TYPE | paymentType | Orders/Payment method | string || || VAT | vat | Orders/VAT rate | string || || PRICE_WITH_VAT_AND_NO_DISCOUNT | priceWithVatAndNoDiscount | Orders/The price includes VAT without discounts per piece. | number || || SHOP_MARKETPLACE_DISCOUNT | shopMarketplaceDiscount | Orders/Your discount on the marketplace promotion is 1 pc. | number || || SPASIBO_DISCOUNT | spasiboDiscount | Orders/Your discount on Savings bonuses is only (per piece) for 1 piece. | number || || YANDEX_PLUS_DISCOUNT | yandexPlusDiscount | Orders/Your discount on Yandex points.Advantages per 1 pc . | number || || PRICE_WITH_VAT_AND_ALL_DISCOUNTS | priceWithVatAndAllDiscounts | Orders/Price with VAT, including all discounts per piece. | number || || RETURN_PRICE_SUM_WITH_VAT_AND_NO_DISCOUNTS | returnPriceSumWithVatAndNoDiscounts | Orders/The cost of all returned pieces with VAT excluding discounts | number || || RETURN_DISCOUNT_SUM | returnDiscountSum | Orders/The sum of all discounts for returned pieces | number || || RETURN_PRICE_SUM_WITH_VAT_AND_DISCOUNTS | returnPriceSumWithVatAndDiscounts | Orders/The cost of all returned pieces with VAT, including all discounts | number || || ORGANIZATION | organization | Sales to businesses/Information about buyer/Organization name | string || || INN | inn | Sales to businesses/Information about buyer/INN (taxpayer identification number) | string || || KPP | kpp | Sales to businesses/Information about buyer/KPP (Tax Registration Reason Code) | string || || ORGANIZATION_JUR_ADDRESS | organizationJurAddress | Sales to businesses/Information about buyer/Legal address | string || || UPD_STATUS | updStatus | Sales to businesses/Documents/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Documents/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Documents/UPD number | string || || UKD_STATUS | ukdStatus | Sales to businesses/Documents/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Documents/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Documents/UKD number | string || || REDEEMED_PRICE | redeemedPrice | Sales to businesses/Documents/The cost of the purchased product | number || || UPD_STATUS | updStatus | Sales to businesses/Electronic document management/UPD status | string || || UPD_DATE | updDate | Sales to businesses/Electronic document management/UPD date | string || || UPD_NUMBER | updNumber | Sales to businesses/Electronic document management/UPD number | string || || UKD_STATUS | ukdStatus | Sales to businesses/Electronic document management/UKD status | string || || UKD_DATE | ukdDate | Sales to businesses/Electronic document management/UKD date | string || || UKD_NUMBER | ukdNumber | Sales to businesses/Electronic document management/UKD number | string || || CONSIGNMENT_NOTE_DATE | consignmentNoteDate | Sales to businesses/Paper document management/Packing list date | string || || CONSIGNMENT_NOTE_NUMBER | consignmentNoteNumber | Sales to businesses/Paper document management/Packing list number | string || || INVOICE_DATE | invoiceDate | Sales to businesses/Paper document management/Invoice date | string || || INVOICE_NUMBER | invoiceNumber | Sales to businesses/Paper document management/Invoice number | string || || ADJUSTMENT_INVOICE_DATE | adjustmentInvoiceDate | Sales to businesses/Paper document management/Adjustment invoice date | string || || ADJUSTMENT_INVOICE_NUMBER | adjustmentInvoiceNumber | Sales to businesses/Paper document management/Adjustment invoice number | string || || REDEEMED_PRICE | redeemedPrice | Sales to businesses/The cost of the purchased product | number || || RNPT | rnpt | Orders/Registration number of the customs declaration or the Registration Number of Batch of Products subject to tracking (RNBP) | string || || RECEIPT_ID | receiptId | Orders/Receipt number | string || || RECEIPT_LINK | receiptLink | Orders/Receipt link | string || || RECEIPT_DATETIME | receiptDatetime | Orders/Receipt printing date | string || |# {% endcut %} {% endlist %} |
**⚙️ Limit without subscription:** 1 request per 2 minutes
**⭐️ [Limit with Medium subscription](https://yandex.ru/support/marketplace/ru/marketing/subscription):** 1 request per minute
| |-| ## Request
POST {.openapi__method} ```text translate=no https://api.partner.market.yandex.ru/v2/reports/goods-realization/generate ```
### 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}
### Body {% cut "application/json" %} ```json translate=no { "campaignId": 1, "year": 2025, "month": 12 } ``` {% 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} || || _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}
## Responses
## 200 OK In response, you receive an identifier that allows you to find out the generation status and download the finished report.
### 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.com/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.com/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.com/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 %}
## 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)
### 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.com/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 Yandex. Market. [More information about the error](https://yandex.com/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: - 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, "year": 2025, "month": 12 } schema: description: > Data required to generate the report: the campaign ID and the period for which the report is needed. type: object required: - campaignId - year - month 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 year: description: Year. type: integer format: int32 example: 2025 month: description: The month number. type: integer format: int32 minimum: 1 maximum: 12 example: 12 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/goods-realization/generate host: https://api.partner.market.yandex.ru ``` {% endlist %}
[*Deprecated]: No longer supported, please use an alternative and newer version.