---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/reference/reports/generateUnitedOrdersReport.md
  - https://yandex.com/dev/market/partner-api/doc/ru/reference/reports/generateUnitedOrdersReport.md
  - https://yandex.com/dev/market/partner-api/doc/zh/reference/reports/generateUnitedOrdersReport.md
  - href: en/reference/reports/generateUnitedOrdersReport.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/market/partner-api/doc/en/llms.txt

{% note warning "The structure and content of the reports are subject to change without prior notice." %}

For example, a new column may be added or the name of the sheet may be changed.

{% endnote %}

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

# Order Report

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

{% list tabs %}

- Info

  
  <!-- source: en/_auto/method_scopes/generateUnitedOrdersReport.md -->
  **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**" %}

  * inventory-and-order-processing — [Order processing and inventory](https://yandex.com/dev/market/partner-api/doc/en/_auto/scopes_summary/pages/inventory-and-order-processing.md)
  * inventory-and-order-processing:read-only — [View order information](https://yandex.com/dev/market/partner-api/doc/en/_auto/scopes_summary/pages/inventory-and-order-processing_read-only.md)
  * promotion — [Product promotion](https://yandex.com/dev/market/partner-api/doc/en/_auto/scopes_summary/pages/promotion.md)
  * promotion:read-only — [View promotion information](https://yandex.com/dev/market/partner-api/doc/en/_auto/scopes_summary/pages/promotion_read-only.md)
  * finance-and-accounting — [View financial data and reports](https://yandex.com/dev/market/partner-api/doc/en/_auto/scopes_summary/pages/finance-and-accounting.md)
  * all-methods — Full account management
  * all-methods:read-only — View all data

  {% endcut %}
  <!-- endsource: en/_auto/method_scopes/generateUnitedOrdersReport.md -->
  
  
  Starts the generation of a report on orders for a specified period. [What kind of report is this](https://yandex.ru/support/marketplace/ru/accounting/transactions#get-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).
  
  
  <!-- source: en/_auto/reports/united/orders/generator/united_orders.md -->
  Explanation of the report columns:

  {% cut "Sheet **Order and product transactions** (file **orders_and_offers_transactions**)" %}

  #|
  || **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 ||
  || ORDER_ID | orderId | Information about orders/Order number | integer ||
  || PARTNER_ORDER_ID | partnerOrderId | Information about orders/Your order number | string ||
  || CREATION_DATE | creationDate | Information about orders/Creation date | string ||
  || ORDER_TYPE | orderType | Information about orders/Order type | string ||
  || SHOP_SKU | shopSku | Information about orders/Your SKU | string ||
  || OFFER_NAME | offerName | Information about orders/Product name | string ||
  ||
  PARTNER_PRICE_FOR_DELIVERY
  |
  partnerPriceForDelivery
  |
  Information about orders/Your price (per item)
  |
  number
  ||
  || BILLING_PRICE | billingPrice | Information about orders/Sale price (per item) | number ||
  ||
  COFINANCE_TRESHOLD
  |
  cofinanceTreshold
  |
  Information about orders/Your price reduction threshold for participating in co-financing at the time of ordering (per item)
  |
  number
  ||
  ||
  COFINANCE_VALUE
  |
  cofinanceValue
  |
  Information about orders/Your discount if the product was co-financed (per item)
  |
  number
  ||
  ||
  COFINANCE_SUBSIDY
  |
  cofinanceSubsidy
  |
  Information about orders/Yandex Market discount if item was co-financed
  |
  number
  ||
  ||
  MARKETPLACE_SUBSIDY
  |
  marketplaceSubsidy
  |
  Information about orders/Other Yandex Market discounts (per item)
  |
  number
  ||
  || SPASIBO | spasibo | Information about orders/Payment in Sberbank bonuses (per item) | number ||
  || YANDEX_PLUS | yandexPlus | Information about orders/Payment by Yandex Plus points (per item) | number ||
  ||
  TRANSFERRED_FOR_DELIVERY
  |
  transferredForDelivery
  |
  Information about orders/Transferred for delivery
  |
  integer
  ||
  || DELIVERED_OR_RETURNED | deliveredOrReturned | Information about orders/Delivered or returned | integer ||
  || DELIVERY_DATE | deliveryDate | Information about orders/Order delivery date | string ||
  || OFFER_STATUS | offerStatus | Information about orders/Product status | string ||
  || STATUS_CHANGED | statusChanged | Information about orders/Status changed | string ||
  || PAYMENT_TYPE | paymentType | Information about orders/Payment method | string ||
  || SHIPMENT_WAREHOUSE | shipmentWarehouse | Information about orders/Shipment warehouse | string ||
  || SHIPMENT_DATE | shipmentDate | Information about orders/Shipping date | string ||
  || DELIVERY_REGION | deliveryRegion | Information about orders/Delivery region | string ||
  || BUYER_PAYMENT_AMOUNT | buyerPaymentAmount | Buyer payment/Payment amount | number ||
  || BUYER_PAYMENT_BANK_ORDER_ID | buyerPaymentBankOrderId | Buyer payment/Payment order number | string ||
  || BUYER_PAYMENT_BANK_ORDER_DATE | buyerPaymentBankOrderDate | Buyer payment/Payment order date | string ||
  || BUYER_PAYMENT_ID | buyerPaymentId | Buyer payment/Payment ID | string ||
  || BUYER_PAYMENT_HANDLING_TIME | buyerPaymentHandlingTime | Buyer payment/Payment register date | string ||
  ||
  MARKETPLACE_DISCOUNT_PAYMENT_AMOUNT
  |
  marketplaceDiscountPaymentAmount
  |
  Payment for a Yandex Market discount/Payment amount
  |
  number
  ||
  ||
  MARKETPLACE_DISCOUNT_PAYMENT_BANK_ORDER_ID
  |
  marketplaceDiscountPaymentBankOrderId
  |
  Payment for a Yandex Market discount/Payment order number
  |
  string
  ||
  ||
  MARKETPLACE_DISCOUNT_PAYMENT_BANK_ORDER_DATE
  |
  marketplaceDiscountPaymentBankOrderDate
  |
  Payment for a Yandex Market discount/Payment order date
  |
  string
  ||
  ||
  MARKETPLACE_DISCOUNT_PAYMENT_ID
  |
  marketplaceDiscountPaymentId
  |
  Payment for a Yandex Market discount/Payment ID
  |
  string
  ||
  ||
  MARKETPLACE_DISCOUNT_PAYMENT_HANDLING_TIME
  |
  marketplaceDiscountPaymentHandlingTime
  |
  Payment for a Yandex Market discount/Payment register date
  |
  string
  ||
  ||
  SPASIBO_PAYMENT_AMOUNT
  |
  spasiboPaymentAmount
  |
  Payment for the discount with SberSpasibo bonus points/Payment amount
  |
  number
  ||
  ||
  SPASIBO_PAYMENT_BANK_ORDER_ID
  |
  spasiboPaymentBankOrderId
  |
  Payment for the discount with SberSpasibo bonus points/Payment order number
  |
  string
  ||
  ||
  SPASIBO_PAYMENT_BANK_ORDER_DATE
  |
  spasiboPaymentBankOrderDate
  |
  Payment for the discount with SberSpasibo bonus points/Payment order date
  |
  string
  ||
  ||
  SPASIBO_PAYMENT_ID
  |
  spasiboPaymentId
  |
  Payment for the discount with SberSpasibo bonus points/Payment ID
  |
  string
  ||
  ||
  SPASIBO_PAYMENT_HANDLING_TIME
  |
  spasiboPaymentHandlingTime
  |
  Payment for the discount with SberSpasibo bonus points/Payment register date
  |
  string
  ||
  ||
  YANDEX_PLUS_PAYMENT_AMOUNT
  |
  yandexPlusPaymentAmount
  |
  Payment for Yandex Plus discount/Payment amount
  |
  number
  ||
  ||
  YANDEX_PLUS_PAYMENT_BANK_ORDER_ID
  |
  yandexPlusPaymentBankOrderId
  |
  Payment for Yandex Plus discount/Payment order number
  |
  string
  ||
  ||
  YANDEX_PLUS_PAYMENT_BANK_ORDER_DATE
  |
  yandexPlusPaymentBankOrderDate
  |
  Payment for Yandex Plus discount/Payment order date
  |
  string
  ||
  || YANDEX_PLUS_PAYMENT_ID | yandexPlusPaymentId | Payment for Yandex Plus discount/Payment ID | string ||
  ||
  YANDEX_PLUS_PAYMENT_HANDLING_TIME
  |
  yandexPlusPaymentHandlingTime
  |
  Payment for Yandex Plus discount/Payment register date
  |
  string
  ||
  || REFUND_BUYER_PAYMENT_AMOUNT | refundBuyerPaymentAmount | Refund of buyer payment/Refund amount | number ||
  ||
  REFUND_BUYER_PAYMENT_BANK_ORDER_ID
  |
  refundBuyerPaymentBankOrderId
  |
  Refund of buyer payment/Payment order number
  |
  string
  ||
  ||
  REFUND_BUYER_PAYMENT_BANK_ORDER_DATE
  |
  refundBuyerPaymentBankOrderDate
  |
  Refund of buyer payment/Payment order date
  |
  string
  ||
  || REFUND_BUYER_PAYMENT_ID | refundBuyerPaymentId | Refund of buyer payment/Payment ID | string ||
  ||
  REFUND_BUYER_PAYMENT_HANDLING_TIME
  |
  refundBuyerPaymentHandlingTime
  |
  Refund of buyer payment/Payment register date
  |
  string
  ||
  ||
  REFUND_MARKETPLACE_DISCOUNT_PAYMENT_AMOUNT
  |
  refundMarketplaceDiscountPaymentAmount
  |
  Refund of payment for Yandex Market discount/Refund amount
  |
  number
  ||
  ||
  REFUND_MARKETPLACE_DISCOUNT_PAYMENT_BANK_ORDER_ID
  |
  refundMarketplaceDiscountPaymentBankOrderId
  |
  Refund of payment for Yandex Market discount/Payment order number
  |
  string
  ||
  ||
  REFUND_MARKETPLACE_DISCOUNT_PAYMENT_BANK_ORDER_DATE
  |
  refundMarketplaceDiscountPaymentBankOrderDate
  |
  Refund of payment for Yandex Market discount/Payment order date
  |
  string
  ||
  ||
  REFUND_MARKETPLACE_DISCOUNT_PAYMENT_ID
  |
  refundMarketplaceDiscountPaymentId
  |
  Refund of payment for Yandex Market discount/Payment ID
  |
  string
  ||
  ||
  REFUND_MARKETPLACE_DISCOUNT_PAYMENT_HANDLING_TIME
  |
  refundMarketplaceDiscountPaymentHandlingTime
  |
  Refund of payment for Yandex Market discount/Payment register date
  |
  string
  ||
  ||
  REFUND_SPASIBO_PAYMENT_AMOUNT
  |
  refundSpasiboPaymentAmount
  |
  Refund of the payment for the discount with SberSpasibo bonus points/Refund amount
  |
  number
  ||
  ||
  REFUND_SPASIBO_PAYMENT_BANK_ORDER_ID
  |
  refundSpasiboPaymentBankOrderId
  |
  Refund of the payment for the discount with SberSpasibo bonus points/Payment order number
  |
  string
  ||
  ||
  REFUND_SPASIBO_PAYMENT_BANK_ORDER_DATE
  |
  refundSpasiboPaymentBankOrderDate
  |
  Refund of the payment for the discount with SberSpasibo bonus points/Payment order date
  |
  string
  ||
  ||
  REFUND_SPASIBO_PAYMENT_ID
  |
  refundSpasiboPaymentId
  |
  Refund of the payment for the discount with SberSpasibo bonus points/Payment ID
  |
  string
  ||
  ||
  REFUND_SPASIBO_PAYMENT_HANDLING_TIME
  |
  refundSpasiboPaymentHandlingTime
  |
  Refund of the payment for the discount with SberSpasibo bonus points/Payment register date
  |
  string
  ||
  ||
  REFUND_YANDEX_PLUS_PAYMENT_AMOUNT
  |
  refundYandexPlusPaymentAmount
  |
  Refund of payment for Yandex Plus discount/Refund amount
  |
  number
  ||
  ||
  REFUND_YANDEX_PLUS_PAYMENT_BANK_ORDER_ID
  |
  refundYandexPlusPaymentBankOrderId
  |
  Refund of payment for Yandex Plus discount/Payment order number
  |
  string
  ||
  ||
  REFUND_YANDEX_PLUS_PAYMENT_BANK_ORDER_DATE
  |
  refundYandexPlusPaymentBankOrderDate
  |
  Refund of payment for Yandex Plus discount/Payment order date
  |
  string
  ||
  ||
  REFUND_YANDEX_PLUS_PAYMENT_ID
  |
  refundYandexPlusPaymentId
  |
  Refund of payment for Yandex Plus discount/Payment ID
  |
  string
  ||
  ||
  REFUND_YANDEX_PLUS_PAYMENT_HANDLING_TIME
  |
  refundYandexPlusPaymentHandlingTime
  |
  Refund of payment for Yandex Plus discount/Payment register date
  |
  string
  ||
  ||
  DEFECT_REFUND_PAYMENT_AMOUNT
  |
  defectRefundPaymentAmount
  |
  Reimbursement of expenses to the buyer if products of substandard quality are returned/Amount withheld
  |
  number
  ||
  ||
  DEFECT_REFUND_PAYMENT_BANK_ORDER_ID
  |
  defectRefundPaymentBankOrderId
  |
  Reimbursement of expenses to the buyer if products of substandard quality are returned/Payment order number
  |
  string
  ||
  ||
  DEFECT_REFUND_PAYMENT_BANK_ORDER_DATE
  |
  defectRefundPaymentBankOrderDate
  |
  Reimbursement of expenses to the buyer if products of substandard quality are returned/Payment order date
  |
  string
  ||
  ||
  DEFECT_REFUND_PAYMENT_ID
  |
  defectRefundPaymentId
  |
  Reimbursement of expenses to the buyer if products of substandard quality are returned/Payment ID
  |
  string
  ||
  ||
  DEFECT_REFUND_PAYMENT_HANDLING_TIME
  |
  defectRefundPaymentHandlingTime
  |
  Reimbursement of expenses to the buyer if products of substandard quality are returned/Payment register date
  |
  string
  ||
  ||
  NETTING_AMOUNT
  |
  nettingAmount
  |
  Points for Market discounts and Yandex Plus discounts/Bonuses amount
  |
  number
  ||
  ||
  NETTING_TRANSACTION_STATUS
  |
  nettingTransactionStatus
  |
  Points for Market discounts and Yandex Plus discounts/Status (for reference)
  |
  string
  ||
  |#

  {% endcut %}

  {% cut "Sheet **Order services and margin** (file **services_and_orders_margin**)" %}

  #|
  || **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 ||
  || ORDER_ID | orderId | Information about orders/Order number | integer ||
  || PARTNER_ORDER_ID | partnerOrderId | Information about orders/Your order number | string ||
  || ORDER_STATUS | orderStatus | Information about orders/Order status | string ||
  || CREATION_DATE | creationDate | Information about orders/Creation date | string ||
  || ORDER_TYPE | orderType | Information about orders/Order type | string ||
  ||
  SUMMARY_COMMISSION
  |
  summaryCommission
  |
  Information about funds/All Yandex Market services for orders
  |
  number
  ||
  || SUM_BILLING_PRICE_OF_ITEMS | sumBillingPriceOfItems | Information about funds/Sale price (per item) | number ||
  ||
  INCOME_WITHOUT_SERVICES
  |
  incomeWithoutServices
  |
  Information about funds/Revenue after deducting Yandex Market services
  |
  number
  ||
  ||
  BUYER_PAYMENT
  |
  buyerPayment
  |
  Information about funds/Buyer payment, excluding Yandex Market discounts and Plus points
  |
  number
  ||
  || BUYER_PAYMENT_STATUS | buyerPaymentStatus | Information about funds/Buyer payment status | string ||
  || BANK_ORDER_ID | bankOrderId | Information about funds/Payment order number | string ||
  || SALE_COMMISSION | saleCommission | Service information/Product placement on the showcase | number ||
  || WAREHOUSE_PROCESSING | warehouseProcessing | Service information/Warehouse processing | number ||
  || LOYALTY_PROGRAM | loyaltyProgram | Service information/Loyalty program and reviews | number ||
  || BOOST | boost | Service information/Sales boosts | number ||
  || INSTALLMENT | installment | Service information/Installment plan | number ||
  || BUYER_DELIVERY | buyerDelivery | Service information/Delivery to buyer | number ||
  || CROSSREGIONAL_DELIVERY | crossregionalDelivery | Service information/Delivery (average mile) | number ||
  || BUYER_EXPRESS_DELIVERY | buyerExpressDelivery | Service information/Express delivery | number ||
  || CROSSBORDER_DELIVERY | crossborderDelivery | Service information/Delivery from abroad | number ||
  || BUYER_PAYMENT_ACCEPT | buyerPaymentAccept | Service information/Acceptance of buyer payment | number ||
  || BUYER_PAYMENT_TRANSFER | buyerPaymentTransfer | Service information/Transfer of buyer payment | number ||
  || ORDER_INTAKE | orderIntake | Service information/Order pickup arrangement | number ||
  || ORDER_PROCESSING | orderProcessing | Service information/Order processing in SC or pvz | number ||
  || RESUPPLY_HANDLING | resupplyHandling | Service information/Storage of unpurchased goods and returns | number ||
  || RETURN_RESUPPLY | returnResupply | Service information/Processing orders in stock | number ||
  || EXPROPRIATION_RESALE | expropriationResale | Service information/Expropriated goods sale commission | number ||
  |#

  {% endcut %}

  {% cut "Sheet **Orders with smart pricing** (file **services_with_decoupling**)" %}

  #|
  || **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 ||
  || ORDER_ID | orderId | Information about orders/Order number | integer ||
  || SHOP_ORDER_ID | shopOrderId | Information about orders/Your order number | string ||
  || ORDER_STATUS | orderStatus | Information about orders/Order status | string ||
  || CREATION_DATE | creationDate | Information about orders/Creation date | string ||
  || ORDER_TYPE | orderType | Information about orders/Order type | string ||
  || SHOP_SKU | shopSku | Information about orders/Your SKU | string ||
  || OFFER_NAME | offerName | Information about orders/Product name | string ||
  || COUNT | count | Information about orders/Quantity | integer ||
  || SHOP_PRICE | shopPrice | Information about funds/Your price (per item) | number ||
  || SELLING_PRICE | sellingPrice | Information about funds/Sale price (per item) | number ||
  ||
  BUYER_PAYMENT
  |
  buyerPayment
  |
  Information about funds/Buyer payment, excluding Yandex Market discounts and Plus points
  |
  number
  ||
  || EXTRA_INCOME | extraIncome | Information about funds/Difference between your price and sale price | number ||
  ||
  SUMMARY_COMMISSION
  |
  summaryCommission
  |
  Information about funds/All Yandex Market services for orders
  |
  number
  ||
  ||
  INCOME_WITHOUT_SERVICES
  |
  incomeWithoutServices
  |
  Information about funds/Revenue after deducting Yandex Market services
  |
  number
  ||
  ||
  EXTRA_DECOUPLING_MARGIN
  |
  extraDecouplingMargin
  |
  Information about funds/Additional turnover from smart offer
  |
  number
  ||
  ||
  NET_DECOUPLING_GAIN
  |
  netDecouplingGain
  |
  Information about funds/Additional revenue from smart offer
  |
  number
  ||
  || SALE_COMMISSION | saleCommission | Service information/Product placement on the showcase | number ||
  ||
  EXTRA_DECOUPLING_SALE_COMMISSION
  |
  extraDecouplingSaleCommission
  |
  Service information/Smart offer (additional rate for placement)
  |
  number
  ||
  || WAREHOUSE_HANDLING | warehouseHandling | Service information/Warehouse processing | number ||
  || LOYALTY_PROGRAM | loyaltyProgram | Service information/Loyalty program and reviews | number ||
  || BOOST | boost | Service information/Sales boosts | number ||
  || INSTALLMENT | installment | Service information/Installment plan | number ||
  || DELIVERY | delivery | Service information/Delivery to buyer | number ||
  || EXPRESS_DELIVERY | expressDelivery | Service information/Express delivery | number ||
  || PAYMENT_ACCEPTING | paymentAccepting | Service information/Acceptance of buyer payment | number ||
  || PAYMENT_TRANSFER | paymentTransfer | Service information/Transfer of buyer payment | number ||
  || ORDER_PROCESSING | orderProcessing | Service information/Order processing in SC or pvz | number ||
  || RESUPPLY_STORAGE | resupplyStorage | Service information/Storage of unpurchased goods and returns | number ||
  || RESUPPLY_RETURN | resupplyReturn | Service information/Processing orders in stock | number ||
  || ORDER_INTAKE | orderIntake | Service information/Order pickup arrangement | number ||
  |#

  {% endcut %}
  <!-- endsource: en/_auto/reports/united/orders/generator/united_orders.md -->
  
  
  
  <!-- source: en/_includes/common/report-data-period-unchanged.md -->
  {% note warning "Ограничения по тарифному плану" %}


  The data upload period and the number of reports generated at the same time depend on your data plan:
  * **Without subscription or the "Light" tariff** — data for the last 90 days is available, and 1 report can be generated at a time
  * **The "Medium" tariff** — Up to 10 reports can be generated simultaneously.

  Read more about the subscription for sellers [in the Help of the Market for sellers](https://yandex.ru/support/marketplace/ru/marketing/subscription).


  {% endnote %}
  <!-- endsource: en/_includes/common/report-data-period-unchanged.md -->
  
  
  
  <!-- source: en/_auto/method_limits/generateUnitedOrdersReport.md -->
  |<div style="text-align: left;">**⚙️ Limit without subscription:** 1 request per 2 minutes<br>**⭐️ [Limit with Medium subscription](https://yandex.ru/support/marketplace/ru/marketing/subscription):** 1 request per minute</div>|
  |-|
  <!-- endsource: en/_auto/method_limits/generateUnitedOrdersReport.md -->
  
  
  
  ## Request
  
  <div class="openapi__requests">
  
  <div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">
  
  <div class="openapi__request">
  
  POST {.openapi__method}
  ```text translate=no
  https://api.partner.market.yandex.ru/v2/reports/united-orders/generate
  ```
  
  </div>
  
  </div>
  
  </div>
  
  ### Query parameters
  
  #|
  || **Name** | **Description** ||
  ||
  
  _format_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  The format of the report or document.
  Report format:
  
  * `FILE` — the spreadsheet file (XLSX).
  * `CSV` — A ZIP archive with CSV files for each report sheet.
  * `JSON` — A ZIP archive with JSON files for each report sheet.
  
  
  _Default:_{.json-schema-reset .json-schema-value} `FILE`
  
  _Enum:_{.json-schema-reset .json-schema-value} `FILE`, `CSV`, `JSON`
  {.table-cell}
  ||
  ||
  
  _language_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  The language of the report or document.
  Language of the report:
  
  * `RU` — Russian language.
  * `EN` — English language.
  
  
  _Enum:_{.json-schema-reset .json-schema-value} `RU`, `EN`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "businessId": 1,
    "dateFrom": "2025-08-22",
    "dateTo": "2025-01-01",
    "campaignIds": [
      1
    ],
    "promoId": "example"
  }
  ```
  
  {% endcut %}
  
  #|
  || **Name** | **Description** ||
  ||
  
  _businessId_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: integer
  
  Cabinet ID.   To find out, use the request [GET v2/campaigns](https://yandex.com/dev/market/partner-api/doc/en/reference/campaigns/getCampaigns.md).
  
  ℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)
  
  
  
  
  _Min value:_{.json-schema-reset .json-schema-assertion} `1`
  {.table-cell}
  ||
  ||
  
  _dateFrom_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: string&lt;date&gt;
  
  The beginning of the period, inclusive.
  
  Date format: `YYYY-MM-DD`.
  
  
  _Example:_{.json-schema-reset .json-schema-example} `2025-08-22`
  {.table-cell}
  ||
  ||
  
  _dateTo_{.json-schema-reset .json-schema-property .json-schema-required}
  {.table-cell}|
  **Type**: string&lt;date&gt;
  
  End of the period, inclusive. Maximum period — 1 year.
  
  Date format: `YYYY-MM-DD`.
  
  
  _Example:_{.json-schema-reset .json-schema-example} `2025-01-01`
  {.table-cell}
  ||
  ||
  
  _campaignIds_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: integer[] &#124; null
  
  The list of campaign IDs of those stores that are needed in the report.
  
  
  _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
  _Unique items:_{.json-schema-reset .json-schema-assertion} `true`
  
  {% cut "**Example**" %}{.json-schema-example}
  
  ```json translate=no
  [
    1
  ]
  ```
  
  {% endcut %}
  {.table-cell}
  ||
  ||
  
  _promoId_{.json-schema-reset .json-schema-property}
  {.table-cell}|
  **Type**: string
  
  The ID of the promotion that the products from are needed in the report.
  
  _Example:_{.json-schema-reset .json-schema-example} `example`
  {.table-cell}
  ||
  |#{.json-schema-properties}
  
  </div>
  
  ## Responses
  
  <div class="openapi__response__code__200">
  
  ## 200 OK
  
  In response, you receive an identifier that allows you to find out the generation status and download the finished report.
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "result": {
      "reportId": "example",
      "estimatedGenerationTime": 0
    }
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _status_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    The type of response.
    Possible values:
    * `OK` — There are no errors.
    * `ERROR` — an error occurred while processing the request.
  
  
    _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The standard wrapper for server responses.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK"
    }
    ```
  
    {% endcut %}
  
  - {% cut "**Type**: object" %}
  
    #|
    ||
  
    _result_{.json-schema-reset .json-schema-property}
    {.table-cell}|
    {% cut "**Type**: object" %}
  
    #|
    ||
  
    _estimatedGenerationTime_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: integer
  
    Expected generation time in milliseconds.
    {.table-cell}
    ||
    ||
  
    _reportId_{.json-schema-reset .json-schema-property .json-schema-required}
    {.table-cell}|
    **Type**: string
  
    The ID that will be needed to track the generation status and receive the finished report or document.
  
    _Example:_{.json-schema-reset .json-schema-example} `example`
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    The ID that will be needed to track the generation status and receive the finished report or document.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "reportId": "example",
      "estimatedGenerationTime": 0
    }
    ```
  
    {% endcut %}
    {.table-cell}
    ||
    |#{.json-schema-properties}
  
    {% endcut %}
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "result": {
        "reportId": "example",
        "estimatedGenerationTime": 0
      }
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__400">
  
  ## 400 Bad Request
  
  The request contains incorrect data. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#400)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__401">
  
  ## 401 Unauthorized
  
  The authorization data is not specified in the request. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#401)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__403">
  
  ## 403 Forbidden
  
  The authorization data is incorrect or access to the resource is prohibited. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#403)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__404">
  
  ## 404 Not Found
  
  The requested resource was not found. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#404)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__420">
  
  ## 420 Method Failure
  
  The resource access limit has been exceeded. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#420)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
  
  <div class="openapi__response__code__500">
  
  ## 500 Internal Server Error
  
  Internal error of Yandex. Market. [More information about the error](https://yandex.com/dev/market/partner-api/doc/en/concepts/error-codes.md#500)
  
  <div class="openapi-entity">
  
  ### Body
  
  {% cut "application/json" %}
  
  ```json translate=no
  {
    "status": "OK",
    "errors": [
      {
        "code": "example",
        "message": "example"
      }
    ]
  }
  ```
  
  {% endcut %}
  
  **Type**: object
  
  {% cut "**All of 1 type**" %}{.json-schema-combinators data-marker=and}
  
  - **Type**: object
  
    {% cut "**All of 2 types**" %}{.json-schema-combinators data-marker=and}
  
    - **Type**: object
  
      #|
      ||
  
      _status_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The type of response.
      Possible values:
      * `OK` — There are no errors.
      * `ERROR` — an error occurred while processing the request.
  
  
      _Enum:_{.json-schema-reset .json-schema-value} `OK`, `ERROR`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      The standard wrapper for server responses.
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "status": "OK"
      }
      ```
  
      {% endcut %}
  
    - **Type**: object
  
      #|
      ||
  
      _errors_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      {% cut "**Type**: object[]" %}
  
      #|
      ||
  
      _code_{.json-schema-reset .json-schema-property .json-schema-required}
      {.table-cell}|
      **Type**: string
  
      The error code.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      ||
  
      _message_{.json-schema-reset .json-schema-property}
      {.table-cell}|
      **Type**: string
  
      Description of the error.
  
      _Example:_{.json-schema-reset .json-schema-example} `example`
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% endcut %}
  
      A list of errors.
  
      _Min items:_{.json-schema-reset .json-schema-assertion} `1`
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      ```
  
      {% endcut %}
      {.table-cell}
      ||
      |#{.json-schema-properties}
  
      {% cut "**Example**" %}{.json-schema-example}
  
      ```json translate=no
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      ```
  
      {% endcut %}
  
    {% endcut %}
  
    A standard wrapper for server errors.
  
    {% cut "**Example**" %}{.json-schema-example}
  
    ```json translate=no
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    ```
  
    {% endcut %}
  
  {% endcut %}
  
  </div>
  
  </div>
        

- Console

  ```openapi-sandbox translate=no
  pathParams: []
  searchParams:
    - description: The format of the report or document.
      name: format
      in: query
      required: false
      schema:
        description: >
          Report format:
  
  
          * `FILE` — the spreadsheet file
          (XLSX).
  
          * `CSV` — A ZIP archive with CSV files for
          each report sheet.
  
          * `JSON` — A ZIP archive with JSON files
          for each report sheet.
        type: string
        enum:
          - FILE
          - CSV
          - JSON
        default: FILE
    - description: The language of the report or document.
      name: language
      in: query
      required: false
      schema:
        description: |
          Language of the report:
  
          * `RU` — Russian language.
          * `EN` — English language.
        type: string
        enum:
          - RU
          - EN
  headers: []
  body: |-
    {
      "businessId": 1,
      "dateFrom": "2025-08-22",
      "dateTo": "2025-01-01",
      "campaignIds": [
        1
      ],
      "promoId": "example"
    }
  schema:
    description: |
      The data required to generate the report.
    type: object
    required:
      - businessId
      - dateFrom
      - dateTo
    properties:
      businessId:
        description: "Cabinet ID.  {% if audience == \"partner\" %} To find out, use the request [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [What is a cabinet and a store on the Market?](https://yandex.ru/support/marketplace/account/introduction.html)\n\n:::no-translate\n{% endif %}\n:::\n\n"
        type: integer
        format: int64
        minimum: 1
      dateFrom:
        type: string
        format: date
        description: |
          The beginning of the period, inclusive.
  
          Date format: `YYYY-MM-DD`.
        example: '2025-08-22'
      dateTo:
        description: |
          End of the period, inclusive. Maximum period — 1 year.
  
          Date format: `YYYY-MM-DD`.
        format: date
        type: string
      campaignIds:
        description: |
          The list of campaign IDs of those stores that are needed in the report.
        type: array
        nullable: true
        minItems: 1
        uniqueItems: true
        items:
          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
      promoId:
        description: The ID of the promotion that the products from are needed in the report.
        type: string
  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/united-orders/generate
  host: https://api.partner.market.yandex.ru
  
  ```
        

{% endlist %}


</div>
<!-- endsource: en/api/reports/generateUnitedOrdersReport.md -->


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