Структура и содержание отчетов могут изменяться без предварительного уведомления

Например, может добавиться новая колонка или поменяться название листа.

Отчет по заказам

Info

Console

Метод доступен для всех моделей.

Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке

inventory-and-order-processing — Обработка заказов и учёт товаров
promotion — Продвижение товаров
finance-and-accounting — Просмотр финансовой информации и отчётности
all-methods — Полное управление кабинетом

Запускает генерацию отчета по заказам за заданный период. Что это за отчет

Узнать статус генерации и получить ссылку на готовый отчет можно с помощью запроса GET v2/reports/info/{reportId}.

Пояснение к колонкам отчета:

Лист Транзакции по заказам и товарам (файл orders_and_offers_transactions)

Название колонки в CSV	Название колонки в JSON	Название колонки в XLSX	Тип значения
BUSINESS_ID	businessId	Информация о бизнесе/ID бизнес-аккаунта	integer
MODEL	model	Информация о бизнесе/Модели работы	string
PARTNER_ID	partnerId	Информация о бизнесе/ID магазинов	integer
SHOP_NAME	shopName	Информация о бизнесе/Названия магазинов	string
INN	inn	Информация о бизнесе/ИНН	string
PLACEMENT_CONTRACT	placementContract	Информация о бизнесе/Номера договоров на размещение	string
PROMOTION_CONTRACT	promotionContract	Информация о бизнесе/Номера договоров на продвижение	string
ORDER_ID	orderId	Информация о заказах/Номер заказа	integer
PARTNER_ORDER_ID	partnerOrderId	Информация о заказах/Ваш номер заказа	string
CREATION_DATE	creationDate	Информация о заказах/Дата оформления	string
ORDER_TYPE	orderType	Информация о заказах/Тип заказа	string
SHOP_SKU	shopSku	Информация о заказах/Ваш SKU	string
OFFER_NAME	offerName	Информация о заказах/Название товара	string
PARTNER_PRICE_FOR_DELIVERY	partnerPriceForDelivery	Информация о заказах/Ваша цена (за шт.)	number
BILLING_PRICE	billingPrice	Информация о заказах/Цена продажи (за шт.)	number
COFINANCE_TRESHOLD	cofinanceTreshold	Информация о заказах/Ваш порог снижения цены для участия в софинансировании на момент оформления заказа (за шт.)	number
COFINANCE_VALUE	cofinanceValue	Информация о заказах/Ваша скидка, если товар участвовал в софинансировании (за шт.)	number
COFINANCE_SUBSIDY	cofinanceSubsidy	Информация о заказах/Скидка Маркета, если товар участвовал в софинансировании	number
MARKETPLACE_SUBSIDY	marketplaceSubsidy	Информация о заказах/Другие скидки Маркета (за шт.)	number
SPASIBO	spasibo	Информация о заказах/Оплата бонусами СберСпасибо (за шт.)	number
YANDEX_PLUS	yandexPlus	Информация о заказах/Оплата баллами Яндекс Плюса (за шт.)	number
TRANSFERRED_FOR_DELIVERY	transferredForDelivery	Информация о заказах/Передано в доставку	integer
DELIVERED_OR_RETURNED	deliveredOrReturned	Информация о заказах/Доставлено или возвращено	integer
DELIVERY_DATE	deliveryDate	Информация о заказах/Дата доставки заказа	string
OFFER_STATUS	offerStatus	Информация о заказах/Статус товара	string
STATUS_CHANGED	statusChanged	Информация о заказах/Статус изменен	string
PAYMENT_TYPE	paymentType	Информация о заказах/Способ оплаты	string
SHIPMENT_WAREHOUSE	shipmentWarehouse	Информация о заказах/Склад отгрузки	string
SHIPMENT_DATE	shipmentDate	Информация о заказах/Дата отгрузки	string
DELIVERY_REGION	deliveryRegion	Информация о заказах/Регион доставки	string
BUYER_PAYMENT_AMOUNT	buyerPaymentAmount	Платёж покупателя/Сумма платежа	number
BUYER_PAYMENT_BANK_ORDER_ID	buyerPaymentBankOrderId	Платёж покупателя/Номер платежного поручения	string
BUYER_PAYMENT_BANK_ORDER_DATE	buyerPaymentBankOrderDate	Платёж покупателя/Дата платежного поручения	string
BUYER_PAYMENT_ID	buyerPaymentId	Платёж покупателя/Идентификатор платежа	string
BUYER_PAYMENT_HANDLING_TIME	buyerPaymentHandlingTime	Платёж покупателя/Дата реестра платежей	string
MARKETPLACE_DISCOUNT_PAYMENT_AMOUNT	marketplaceDiscountPaymentAmount	Платёж за скидку Маркета/Сумма платежа	number
MARKETPLACE_DISCOUNT_PAYMENT_BANK_ORDER_ID	marketplaceDiscountPaymentBankOrderId	Платёж за скидку Маркета/Номер платежного поручения	string
MARKETPLACE_DISCOUNT_PAYMENT_BANK_ORDER_DATE	marketplaceDiscountPaymentBankOrderDate	Платёж за скидку Маркета/Дата платежного поручения	string
MARKETPLACE_DISCOUNT_PAYMENT_ID	marketplaceDiscountPaymentId	Платёж за скидку Маркета/Идентификатор платежа	string
MARKETPLACE_DISCOUNT_PAYMENT_HANDLING_TIME	marketplaceDiscountPaymentHandlingTime	Платёж за скидку Маркета/Дата реестра платежей	string
SPASIBO_PAYMENT_AMOUNT	spasiboPaymentAmount	Платёж за скидку по бонусам СберСпасибо/Сумма платежа	number
SPASIBO_PAYMENT_BANK_ORDER_ID	spasiboPaymentBankOrderId	Платёж за скидку по бонусам СберСпасибо/Номер платежного поручения	string
SPASIBO_PAYMENT_BANK_ORDER_DATE	spasiboPaymentBankOrderDate	Платёж за скидку по бонусам СберСпасибо/Дата платежного поручения	string
SPASIBO_PAYMENT_ID	spasiboPaymentId	Платёж за скидку по бонусам СберСпасибо/Идентификатор платежа	string
SPASIBO_PAYMENT_HANDLING_TIME	spasiboPaymentHandlingTime	Платёж за скидку по бонусам СберСпасибо/Дата реестра платежей	string
YANDEX_PLUS_PAYMENT_AMOUNT	yandexPlusPaymentAmount	Платёж за скидку Яндекс Плюс/Сумма платежа	number
YANDEX_PLUS_PAYMENT_BANK_ORDER_ID	yandexPlusPaymentBankOrderId	Платёж за скидку Яндекс Плюс/Номер платежного поручения	string
YANDEX_PLUS_PAYMENT_BANK_ORDER_DATE	yandexPlusPaymentBankOrderDate	Платёж за скидку Яндекс Плюс/Дата платежного поручения	string
YANDEX_PLUS_PAYMENT_ID	yandexPlusPaymentId	Платёж за скидку Яндекс Плюс/Идентификатор платежа	string
YANDEX_PLUS_PAYMENT_HANDLING_TIME	yandexPlusPaymentHandlingTime	Платёж за скидку Яндекс Плюс/Дата реестра платежей	string
REFUND_BUYER_PAYMENT_AMOUNT	refundBuyerPaymentAmount	Возврат платежа покупателя/Сумма возврата	number
REFUND_BUYER_PAYMENT_BANK_ORDER_ID	refundBuyerPaymentBankOrderId	Возврат платежа покупателя/Номер платежного поручения	string
REFUND_BUYER_PAYMENT_BANK_ORDER_DATE	refundBuyerPaymentBankOrderDate	Возврат платежа покупателя/Дата платежного поручения	string
REFUND_BUYER_PAYMENT_ID	refundBuyerPaymentId	Возврат платежа покупателя/Идентификатор платежа	string
REFUND_BUYER_PAYMENT_HANDLING_TIME	refundBuyerPaymentHandlingTime	Возврат платежа покупателя/Дата реестра платежей	string
REFUND_MARKETPLACE_DISCOUNT_PAYMENT_AMOUNT	refundMarketplaceDiscountPaymentAmount	Возврат платежа за скидку Маркета/Сумма возврата	number
REFUND_MARKETPLACE_DISCOUNT_PAYMENT_BANK_ORDER_ID	refundMarketplaceDiscountPaymentBankOrderId	Возврат платежа за скидку Маркета/Номер платежного поручения	string
REFUND_MARKETPLACE_DISCOUNT_PAYMENT_BANK_ORDER_DATE	refundMarketplaceDiscountPaymentBankOrderDate	Возврат платежа за скидку Маркета/Дата платежного поручения	string
REFUND_MARKETPLACE_DISCOUNT_PAYMENT_ID	refundMarketplaceDiscountPaymentId	Возврат платежа за скидку Маркета/Идентификатор платежа	string
REFUND_MARKETPLACE_DISCOUNT_PAYMENT_HANDLING_TIME	refundMarketplaceDiscountPaymentHandlingTime	Возврат платежа за скидку Маркета/Дата реестра платежей	string
REFUND_SPASIBO_PAYMENT_AMOUNT	refundSpasiboPaymentAmount	Возврат платежа за скидку по бонусам СберСпасибо/Сумма возврата	number
REFUND_SPASIBO_PAYMENT_BANK_ORDER_ID	refundSpasiboPaymentBankOrderId	Возврат платежа за скидку по бонусам СберСпасибо/Номер платежного поручения	string
REFUND_SPASIBO_PAYMENT_BANK_ORDER_DATE	refundSpasiboPaymentBankOrderDate	Возврат платежа за скидку по бонусам СберСпасибо/Дата платежного поручения	string
REFUND_SPASIBO_PAYMENT_ID	refundSpasiboPaymentId	Возврат платежа за скидку по бонусам СберСпасибо/Идентификатор платежа	string
REFUND_SPASIBO_PAYMENT_HANDLING_TIME	refundSpasiboPaymentHandlingTime	Возврат платежа за скидку по бонусам СберСпасибо/Дата реестра платежей	string
REFUND_YANDEX_PLUS_PAYMENT_AMOUNT	refundYandexPlusPaymentAmount	Возврат платежа за скидку Яндекс Плюс/Сумма возврата	number
REFUND_YANDEX_PLUS_PAYMENT_BANK_ORDER_ID	refundYandexPlusPaymentBankOrderId	Возврат платежа за скидку Яндекс Плюс/Номер платежного поручения	string
REFUND_YANDEX_PLUS_PAYMENT_BANK_ORDER_DATE	refundYandexPlusPaymentBankOrderDate	Возврат платежа за скидку Яндекс Плюс/Дата платежного поручения	string
REFUND_YANDEX_PLUS_PAYMENT_ID	refundYandexPlusPaymentId	Возврат платежа за скидку Яндекс Плюс/Идентификатор платежа	string
REFUND_YANDEX_PLUS_PAYMENT_HANDLING_TIME	refundYandexPlusPaymentHandlingTime	Возврат платежа за скидку Яндекс Плюс/Дата реестра платежей	string
DEFECT_REFUND_PAYMENT_AMOUNT	defectRefundPaymentAmount	Выплата расходов покупателю при возврате товара ненадлежащего качества/Удержанная сумма	number
DEFECT_REFUND_PAYMENT_BANK_ORDER_ID	defectRefundPaymentBankOrderId	Выплата расходов покупателю при возврате товара ненадлежащего качества/Номер платежного поручения	string
DEFECT_REFUND_PAYMENT_BANK_ORDER_DATE	defectRefundPaymentBankOrderDate	Выплата расходов покупателю при возврате товара ненадлежащего качества/Дата платежного поручения	string
DEFECT_REFUND_PAYMENT_ID	defectRefundPaymentId	Выплата расходов покупателю при возврате товара ненадлежащего качества/Идентификатор платежа	string
DEFECT_REFUND_PAYMENT_HANDLING_TIME	defectRefundPaymentHandlingTime	Выплата расходов покупателю при возврате товара ненадлежащего качества/Дата реестра платежей	string
NETTING_AMOUNT	nettingAmount	Баллы за скидки Маркета и скидки Яндекс Плюс/Сумма баллов	number
NETTING_TRANSACTION_STATUS	nettingTransactionStatus	Баллы за скидки Маркета и скидки Яндекс Плюс/Статус (справочно)	string

Лист Услуги и маржа по заказам (файл services_and_orders_margin)

Название колонки в CSV	Название колонки в JSON	Название колонки в XLSX	Тип значения
BUSINESS_ID	businessId	Информация о бизнесе/ID бизнес-аккаунта	integer
MODEL	model	Информация о бизнесе/Модели работы	string
PARTNER_ID	partnerId	Информация о бизнесе/ID магазинов	integer
SHOP_NAME	shopName	Информация о бизнесе/Названия магазинов	string
INN	inn	Информация о бизнесе/ИНН	string
PLACEMENT_CONTRACT	placementContract	Информация о бизнесе/Номера договоров на размещение	string
PROMOTION_CONTRACT	promotionContract	Информация о бизнесе/Номера договоров на продвижение	string
ORDER_ID	orderId	Информация о заказах/Номер заказа	integer
PARTNER_ORDER_ID	partnerOrderId	Информация о заказах/Ваш номер заказа	string
ORDER_STATUS	orderStatus	Информация о заказах/Статус заказа	string
CREATION_DATE	creationDate	Информация о заказах/Дата оформления	string
ORDER_TYPE	orderType	Информация о заказах/Тип заказа	string
SUMMARY_COMMISSION	summaryCommission	Информация по денежным средствам/Все услуги Маркета за заказы	number
SUM_BILLING_PRICE_OF_ITEMS	sumBillingPriceOfItems	Информация по денежным средствам/Цена продажи (за шт.)	number
INCOME_WITHOUT_SERVICES	incomeWithoutServices	Информация по денежным средствам/Доход за вычетом услуг Маркета	number
BUYER_PAYMENT	buyerPayment	Информация по денежным средствам/Платёж покупателя, не включает скидки Маркета и баллы Плюса	number
BUYER_PAYMENT_STATUS	buyerPaymentStatus	Информация по денежным средствам/Статус платежа покупателя	string
BANK_ORDER_ID	bankOrderId	Информация по денежным средствам/Номер платежного поручения	string
SALE_COMMISSION	saleCommission	Информация по услугам/Размещение товаров на витрине	number
WAREHOUSE_PROCESSING	warehouseProcessing	Информация по услугам/Складская обработка	number
LOYALTY_PROGRAM	loyaltyProgram	Информация по услугам/Участие в программе лояльности	number
BOOST	boost	Информация по услугам/Буст продаж	number
INSTALLMENT	installment	Информация по услугам/Рассрочка	number
BUYER_DELIVERY	buyerDelivery	Информация по услугам/Доставка покупателю	number
BUYER_EXPRESS_DELIVERY	buyerExpressDelivery	Информация по услугам/Экспресс-доставка покупателю	number
BUYER_PAYMENT_ACCEPT	buyerPaymentAccept	Информация по услугам/Приём платежа покупателя	number
BUYER_PAYMENT_TRANSFER	buyerPaymentTransfer	Информация по услугам/Перевод платежа покупателя	number
ORDER_PROCESSING	orderProcessing	Информация по услугам/Обработка заказа	number
RESUPPLY_HANDLING	resupplyHandling	Информация по услугам/Хранение невыкупов и возвратов	number
RETURN_RESUPPLY	returnResupply	Информация по услугам/Возврат невыкупленных товаров	number
ORDER_INTAKE	orderIntake	Информация по услугам/Организация забора заказов	number
EXPROPRIATION_RESALE	expropriationResale	Информация по услугам/Вознаграждение за продажу товара	number

Лист Заказы с умн.ценообразованием (файл services_with_decoupling)

Название колонки в CSV	Название колонки в JSON	Название колонки в XLSX	Тип значения
BUSINESS_ID	businessId	Информация о бизнесе/ID бизнес-аккаунта	integer
MODEL	model	Информация о бизнесе/Модели работы	string
PARTNER_ID	partnerId	Информация о бизнесе/ID магазинов	integer
SHOP_NAME	shopName	Информация о бизнесе/Названия магазинов	string
INN	inn	Информация о бизнесе/ИНН	string
PLACEMENT_CONTRACT	placementContract	Информация о бизнесе/Номера договоров на размещение	string
PROMOTION_CONTRACT	promotionContract	Информация о бизнесе/Номера договоров на продвижение	string
ORDER_ID	orderId	Информация о заказах/Номер заказа	integer
SHOP_ORDER_ID	shopOrderId	Информация о заказах/Ваш номер заказа	string
ORDER_STATUS	orderStatus	Информация о заказах/Статус заказа	string
CREATION_DATE	creationDate	Информация о заказах/Дата оформления	string
ORDER_TYPE	orderType	Информация о заказах/Тип заказа	string
SHOP_SKU	shopSku	Информация о заказах/Ваш SKU	string
OFFER_NAME	offerName	Информация о заказах/Название товара	string
COUNT	count	Информация о заказах/Количество	integer
SHOP_PRICE	shopPrice	Информация по денежным средствам/Ваша цена (за шт.)	number
SELLING_PRICE	sellingPrice	Информация по денежным средствам/Цена продажи (за шт.)	number
BUYER_PAYMENT	buyerPayment	Информация по денежным средствам/Платёж покупателя, не включает скидки Маркета и баллы Плюса	number
EXTRA_INCOME	extraIncome	Информация по денежным средствам/Разница между вашей ценой и ценой продажи	number
SUMMARY_COMMISSION	summaryCommission	Информация по денежным средствам/Все услуги Маркета за заказы	number
INCOME_WITHOUT_SERVICES	incomeWithoutServices	Информация по денежным средствам/Доход за вычетом услуг Маркета	number
EXTRA_DECOUPLING_MARGIN	extraDecouplingMargin	Информация по денежным средствам/Доп.выручка от умного предложения	number
NET_DECOUPLING_GAIN	netDecouplingGain	Информация по денежным средствам/Доп. доход от умного предложения	number
SALE_COMMISSION	saleCommission	Информация по услугам/Размещение товаров на витрине	number
EXTRA_DECOUPLING_SALE_COMMISSION	extraDecouplingSaleCommission	Информация по услугам/Умное предложение (доп.тариф на размещение)	number
WAREHOUSE_HANDLING	warehouseHandling	Информация по услугам/Складская обработка	number
LOYALTY_PROGRAM	loyaltyProgram	Информация по услугам/Участие в программе лояльности	number
BOOST	boost	Информация по услугам/Буст продаж	number
INSTALLMENT	installment	Информация по услугам/Рассрочка	number
DELIVERY	delivery	Информация по услугам/Доставка покупателю	number
EXPRESS_DELIVERY	expressDelivery	Информация по услугам/Экспресс-доставка покупателю	number
PAYMENT_ACCEPTING	paymentAccepting	Информация по услугам/Приём платежа покупателя	number
PAYMENT_TRANSFER	paymentTransfer	Информация по услугам/Перевод платежа покупателя	number
ORDER_PROCESSING	orderProcessing	Информация по услугам/Обработка заказа	number
RESUPPLY_STORAGE	resupplyStorage	Информация по услугам/Хранение невыкупов и возвратов	number
RESUPPLY_RETURN	resupplyReturn	Информация по услугам/Возврат невыкупленных товаров	number
ORDER_INTAKE	orderIntake	Информация по услугам/Организация забора заказов	number

⚙️ Лимит: 100 запросов в час

Request

POST

https://api.partner.market.yandex.ru/v2/reports/united-orders/generate

Query parameters

Name

Description

format

Type: ReportFormatType

Формат отчета или документа.

Формат отчета:

FILE — файл с электронной таблицей (XLSX).
CSV — ZIP-архив с CSV-файлами на каждый лист отчета.
JSON — ZIP-архив с JSON-файлами на каждый лист отчета.

Default: FILE

Enum: FILE, CSV, JSON

language

Type: ReportLanguageType

Язык отчета или документа.

Язык отчета:

RU — русский язык.
EN — английский язык.

Enum: RU, EN

ReportFormatType

Формат отчета:

FILE — файл с электронной таблицей (XLSX).
CSV — ZIP-архив с CSV-файлами на каждый лист отчета.
JSON — ZIP-архив с JSON-файлами на каждый лист отчета.

Type: string

Default: FILE

Enum: FILE, CSV, JSON

ReportLanguageType

Язык отчета:

RU — русский язык.
EN — английский язык.

Type: string

Enum: RU, EN

Body

application/json

{
  "businessId": 1,
  "dateFrom": "2025-08-22",
  "dateTo": "2025-01-01",
  "campaignIds": [
    1
  ],
  "promoId": "example"
}

Name	Description
businessId	Type: BusinessId Идентификатор кабинета. Чтобы его узнать, воспользуйтесь запросом GET v2/campaigns. ℹ️ Что такое кабинет и магазин на Маркете Min value: `1` Example: `1`
dateFrom	Type: PeriodDateFrom Начало периода, включительно. Формат даты: `ГГГГ-ММ-ДД`. Example: `2025-08-22`
dateTo	Type: string<date> Конец периода, включительно. Максимальный период — 1 год. Формат даты: `ГГГГ-ММ-ДД`. Example: `2025-01-01`
campaignIds	Type: CampaignId[] \| null Список идентификаторов кампании тех магазинов, которые нужны в отчете. Min items: `1` Unique items: `true` Example `[ 1 ]`
promoId	Type: string Идентификатор акции, товары из которой нужны в отчете. Example: `example`

BusinessId

Идентификатор кабинета. Чтобы его узнать, воспользуйтесь запросом GET v2/campaigns.

ℹ️ Что такое кабинет и магазин на Маркете

Type: integer

Min value: 1

PeriodDateFrom

Начало периода, включительно.

Формат даты: ГГГГ-ММ-ДД.

Type: string<date>

Example: 2025-08-22

CampaignId

Идентификатор кампании (магазина) — технический идентификатор, который представляет ваш магазин в системе Яндекс Маркета при работе через API. Он однозначно связывается с вашим магазином, но предназначен только для автоматизированного взаимодействия.

Его можно узнать с помощью запроса GET v2/campaigns или найти в кабинете продавца на Маркете. Нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули:

блок Идентификатор кампании;
вкладка Лог запросов → выпадающий список в блоке Показывать логи.

⚠️ Не путайте его с:

идентификатором магазина, который отображается в личном кабинете продавца;
рекламными кампаниями.

Type: integer

Min value: 1

Responses

200 OK

В ответ приходит идентификатор, который позволяет узнавать статус генерации и скачать готовый отчет.

Body

application/json

{
  "status": "OK"
}

Type: object

ApiResponseStatusType

Тип ответа. Возможные значения:

OK — ошибок нет.
ERROR — при обработке запроса произошла ошибка.

Type: string

Enum: OK, ERROR

ApiResponse

Стандартная обертка для ответов сервера.

Name

Description

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

OK — ошибок нет.
ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR

Example

{
  "status": "OK"
}

GenerateReportDTO

Идентификатор, который понадобится для отслеживания статуса генерации и получения готового отчета или документа.

Name

Description

estimatedGenerationTime

Type: integer

Ожидаемая продолжительность генерации в миллисекундах.

reportId

Type: string

Example: example

Example

{
  "reportId": "example",
  "estimatedGenerationTime": 0
}

400 Bad Request

Запрос содержит неправильные данные. Подробнее об ошибке

Body

application/json

{
  "status": "OK"
}

Type: object

ApiErrorDTO

Общий формат ошибки.

Name

Description

code

Type: string

Код ошибки.

Example: example

message

Type: string

Описание ошибки.

Example: example

Example

{
  "code": "example",
  "message": "example"
}

ApiErrorResponse

Стандартная обертка для ошибок сервера.

Type: object

All of 2 types

Type: ApiResponse

Стандартная обертка для ответов сервера.
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: ApiErrorDTO[] | null

Список ошибок.

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Example

{
  "status": "OK"
}

401 Unauthorized

В запросе не указаны данные для авторизации. Подробнее об ошибке

Body

application/json

{
  "status": "OK"
}

Type: object

403 Forbidden

Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке

Body

application/json

{
  "status": "OK"
}

Type: object

420 Method Failure

Превышено ограничение на доступ к ресурсу. Подробнее об ошибке

Body

application/json

{
  "status": "OK"
}

Type: object

500 Internal Server Error

Внутренняя ошибка Маркета. Подробнее об ошибке

Body

application/json

{
  "status": "OK"
}

Type: object

pathParams: []
searchParams:
  - description: Формат отчета или документа.
    name: format
    in: query
    required: false
    schema:
      $ref: >-
        /home/sandbox/.ya/build/build_root/l6go/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/reports/schemas.yaml#/ReportFormatType
  - description: Язык отчета или документа.
    name: language
    in: query
    required: false
    schema:
      $ref: >-
        /home/sandbox/.ya/build/build_root/l6go/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/reports/schemas.yaml#/ReportLanguageType
headers: []
body: |-
  {
    "businessId": 1,
    "dateFrom": "2025-08-22",
    "dateTo": "2025-01-01",
    "campaignIds": [
      1
    ],
    "promoId": "example"
  }
schema:
  description: |
    Данные, необходимые для генерации отчета.
  type: object
  required:
    - businessId
    - dateFrom
    - dateTo
  properties:
    businessId:
      description: "Идентификатор кабинета. Чтобы его узнать, воспользуйтесь запросом [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md).\n\nℹ️ [Что такое кабинет и магазин на Маркете](https://yandex.ru/support/marketplace/account/introduction.html)\n"
      type: integer
      format: int64
      minimum: 1
    dateFrom:
      type: string
      format: date
      description: |
        Начало периода, включительно.

        Формат даты: `ГГГГ-ММ-ДД`.
      example: '2025-08-22'
    dateTo:
      description: |
        Конец периода, включительно. Максимальный период — 1 год.

        Формат даты: `ГГГГ-ММ-ДД`.
      format: date
      type: string
    campaignIds:
      description: |
        Список идентификаторов кампании тех магазинов, которые нужны в отчете.
      type: array
      nullable: true
      minItems: 1
      uniqueItems: true
      items:
        description: "Идентификатор кампании (магазина) — технический идентификатор, который представляет ваш магазин в системе Яндекс Маркета при работе через API. Он однозначно связывается с вашим магазином, но предназначен только для автоматизированного взаимодействия.\n\nЕго можно узнать с помощью запроса [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) или найти в кабинете продавца на Маркете. Нажмите на иконку вашего аккаунта → **Настройки** и в меню слева выберите **API и модули**:\n\n* блок **Идентификатор кампании**;\n* вкладка **Лог запросов** → выпадающий список в блоке **Показывать логи**.\n\n⚠️ Не путайте его с:\n- идентификатором магазина, который отображается в личном кабинете продавца;\n- рекламными кампаниями.\n"
        type: integer
        format: int64
        minimum: 1
    promoId:
      description: Идентификатор акции, товары из которой нужны в отчете.
      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

Была ли статья полезна?

Детальная информация по заказам

Отчет по невыкупам и возвратам