Marketplace Yandex

Получить показатели Яндекс Маркета по дням

Ряд «показатель × день» по одному артикулу или срезу магазинов Маркета — для дашборда, «Планёрки» и РНП. Сутки — по Москве. Заказы — позиции не в статусе «отменён» по дню создания; продажи и выкуп — «получен покупателем» по дню продажи: курьер — день доставки покупателю, самовывоз — день, когда покупатель забрал заказ. Сумма — оплата покупателя, баллы Плюса и субсидия Маркета (payment + cashback + subsidy), как в «Заказах» и P&L. Средний чек — заказы в рублях на штуку, выкуп — когорта созревших заказов. Просмотров, корзины, рекламы и услуг Маркета у сборщика нет: эти ряды приходят пустыми, экономика без услуг — null. Неизвестный или пустой sku заменяется первым артикулом по заказам.

get/api/v1/marketplace/yandex/funnel-daily

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/marketplace/yandex/funnel-daily
  • 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

Query parameters

storestring

Идентификаторы магазинов через запятую либо all; пусто — все активные магазины Маркета

skustring

Артикул продавца (offer_id); пустой заменяется первым артикулом по заказам

daysinteger

Глубина окна в днях по сегодня, 1–92; по умолчанию 14

fromstring date

Начало своего отрезка (вместе с to); длиннее 92 дней обрезается до последних 92

tostring date

Конец своего отрезка; будущее обрезается сегодняшним днём

scope'all'

all — весь каталог магазина; пусто — артикулы с остатком или заказом за окно

slice'article' | 'store' | 'model' | 'brand' | 'subject'

Срез вместо одного артикула: store, model, brand, subject; пусто — артикул

sliceValuestring

Значение среза model/brand/subject; пусто — самый крупный вариант

groupBy'subject' | 'model' | 'brand' | 'article'

Разложить срез по группам по дням: subject, model, brand или article; работает вместе с groupMetrics

groupMetricsstring

Ряды групп через запятую — ключи series, не больше 4; без них группы не считаются

summary'1'

Недели и месяцы (1): окно данных расширяется до начала прошлого месяца, ответ несёт summary

view'pulse'

РНП (pulse): с отбором slice ответ несёт блок pulse — итог набора и страницу товаров

pulseOffsetinteger

Начало страницы товаров РНП, по 20

pulseLimitinteger

Сколько товаров РНП за раз (по умолчанию 20, не больше 200)

pulseQuerystring

Поиск товаров РНП по артикулу и названию

pulseSort'orders' | 'alerts'

Порядок товаров РНП: orders — по заказам за 14 дней, alerts — сначала с красными клетками за 7 дней

fresh'1'

1 — посчитать заново мимо слепка ответа; в слепок результат попадает

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Response

Показатели Маркета по дням

slicestring

Срез ответа, когда запрошен slice

sliceValuestring
sliceLabelstring
slicesobject

Варианты срезов с числом артикулов

breakdownobject[]

Итоги каждого артикула среза за окно

articlesTruncatedboolean
summaryobject

Недели и месяцы всего среза (?summary=1 с groupBy): показатель → окно → значение; окно без дней — null

pulseobject

РНП (view=pulse): days — показанные полные дни (до 14, без сегодняшнего); total — строки итога набора; items — страница товаров (sku, name, photo, store_id, store, subject, brand, passport — в т.ч. storage: хранение WB в день, ₽; brief — итоги дней, в т.ч. drrSales: ДРР от продаж, %, drrLimit: предельный ДРР — маржа до рекламы к выручке продаж, %, drrState: over — реклама съела маржу (в т.ч. реклама без продаж), near — ДРР не ниже 80 % предела, ok, пусто — нет себестоимости или рекламы; rows); setCount — товаров в наборе, count — подошло под поиск, offset — начало страницы. Строка: key, days (значения по дням), windows (w3, w2, w1, prev_month, month), flags (good, bad или пусто — отклонение от обычного уровня товара за показанные дни).

groupBystring

Чем разложен срез, когда запрошен groupBy

groupsobject[]

Группы среза по дням: value (пусто — артикулы без значения группы), label, count артикулов, series и totals только по groupMetrics. Сумма групп по дню равна ряду среза. Порядок — по ordersSum за окно; сверх 200 групп хвост сложен в одну строку с rest: true.

platform'wb' | 'yandex' required
source'wb_orders_sales_and_finance' | 'ym_orders'
estimateModel'sales_and_orders_weekly' | 'orders_only'
skustring

Артикул поставщика выбранной строки

fromstring date
tostring date
daysstring[] required

Окно 14 дней по опорный включительно

seriesobject required

Ряды по дням окна той же длины, что days. Ключи traffic, views, cv2, cart, cv3, orders, adShare, ordersSum, buyouts, buyoutsSum, avgBuyer, spp, position, adSpend, drrOrders, drrSales, buyoutRate, expectedUnits, expectedRevenue, costUnit, acquiringRate, commissionRate, logisticsUnit, otherUnit, taxRate, margin, marginSheet, umd, roi, roiOrders, marginTot, marginSheetTot, sales, salesSum, costSales, romi и удержания в рублях: feesSum, commissionSum, acquiringSum, logisticsSum, otherSum, taxSum; payout — к перечислению за день по отчёту площадки (формула ОПиУ), день без отчёта — null. Отсутствующий источник даёт null, а не ложный ноль.

totalsobject

Итог по каждому ряду одним элементом массива

referencesobject
dataThroughobject
computedAtstring date-time

Когда сервер посчитал слепок ответа: экран мог получить его из слепка, пока идёт фоновый пересчёт

notestring
analyticsboolean

Присутствует и равно false, когда аналитическая база не подключена

Changes

No recorded changes to this operation across all 2 revisions of this API.