---
title: "Получить сводку заказов Яндекс Маркета"
method: GET
path: "/api/v1/marketplace/yandex/orders/overview"
tags: ["Marketplace Yandex"]
---

# Получить сводку заказов Яндекс Маркета

`GET /api/v1/marketplace/yandex/orders/overview`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/marketplace/yandex/orders/overview`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)
  - HTTP bearer

Показатели и до двухсот товаров считаются за период from–to, без параметров — за последний день с продажами или закупками. Сравнение идёт с предыдущим периодом той же длины целыми днями. График показывает не меньше четырнадцати дней, заканчивающихся последним днём периода.

## Query parameters

- `store` string
- `group` string
- `from` string, date
- `to` string, date
- `summary` '1'

## Headers

- `X-Tenant` string, required

## Response `200`

Сводка заказов

- MarketplaceYandexOrdersOverview
  - `day` string, date, required: Последний день периода; без параметров — последний день с продажами или закупками
  - `from` string, date, required: Первый день периода
  - `to` string, date, required: Последний день периода включительно
  - `chart_from` string, date, required: Первый день графика: не позже from и не меньше 14 дней до to
  - `updated` string, nullable, required: Момент последней синхронизации источника
  - `kpi` object, required
    - `orders` MarketplaceYandexOrdersKpi, required
      - `sum` string, required: Сумма decimal строкой
      - `qty` integer, required
      - `delta_sum` number, nullable, required: Изменение суммы ко вчерашнему дню в процентах; null когда вчера было пусто
      - `delta_qty` number, nullable, required: Изменение количества ко вчерашнему дню в процентах; null когда вчера было пусто
    - `sales` MarketplaceYandexOrdersKpi, required
      - `sum` string, required: Сумма decimal строкой
      - `qty` integer, required
      - `delta_sum` number, nullable, required: Изменение суммы ко вчерашнему дню в процентах; null когда вчера было пусто
      - `delta_qty` number, nullable, required: Изменение количества ко вчерашнему дню в процентах; null когда вчера было пусто
  - `daily` MarketplaceYandexOrdersDay[], required: Дни подряд от chart_from по to по возрастанию даты; дни без заказов заполнены нулями
    - `date` string, date, required
    - `orders_sum` string, required: Сумма продаж или закупок кроме отменённых; decimal строкой
    - `orders_qty` integer, required
    - `sales_sum` string, required: Сумма доставленных продаж или закупок; decimal строкой
    - `sales_qty` integer, required
  - `products` MarketplaceYandexOrdersProduct[], required: Товары периода по убыванию суммы
    - `store_id` integer, required: external_id магазина, а не его UUID
    - `store_name` string, required
    - `offer_id` string, required: Артикул продавца
    - `market_sku` string, nullable: Строкой, в отличие от целого market_sku витрины товаров; отсутствует в офлайн-ответе
    - `sku` integer: Только в офлайн-ответе без аналитической базы
    - `product_name` string, required
    - `units` integer, required
    - `avg_price` string, required: Средняя цена decimal строкой
    - `total` string, required: Сумма decimal строкой
    - `primary_image` string, required
    - `url` string, required
    - `by_day` object: Заказано штук по дням периода: день ГГГГ-ММ-ДД → шт
    - `summary` object: Недели и месяцы (?summary=1): окно (w3, w2, w1, prev_month, month) → заказано штук
  - `summary_total` object: Недели и месяцы всего магазина (?summary=1): окно → заказано штук
  - `demo` boolean: Присутствует и равно true только в офлайн-ответе без аналитической базы; цифры синтетические
  - `buyout` MarketplaceBuyoutCohort: Выкуп когорты заказов периода — тот же расчёт, что у воронки: доля выкупленных среди заказов, у которых успело решиться, выкуплены ли они (не позже сегодня−8), окно не короче 14 дней — короткий период добирает решённые дни раньше; у Ozon — FBO и FBS вместе
    - `from` string, date, required: Первый день заказов когорты
    - `to` string, date, required: Последний день заказов когорты включительно
    - `bought` number, required: Выкуплено, шт
    - `base` number, required: Заказано без отмен, шт
    - `pct` number, nullable, required: Выкуп, %; нет решённых заказов — null

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `503`: Внешний банк, справочник или контур подключений временно недоступен

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)