Marketplace Ozon

Получить дневную воронку одного артикула Ozon

Матрица показателей по дням для одного артикула за 14 дней до последней даты финотчёта. Воронка берётся из живого Ozon Analytics API, экономика — из аналитической базы. Неизвестный или пустой sku заменяется первым артикулом списка articles, а не ошибкой. Строки без источника отдаются массивом null.

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

Request

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

UUID магазинов через запятую или all

groupstring

UUID срезов товаров через запятую

skustring

Артикул товара; при промахе берётся первый из articles

scopestring

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

daysinteger

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

fromstring date

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

tostring date

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

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

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

sliceValuestring

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

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

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

groupMetricsstring

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

summary'1'

Недели и месяцы (1): окно данных расширяется до начала прошлого месяца, ответ несёт summary и groups[].summary — показатель → окно (w3, w2, w1, prev_month, month) → значение

view'pulse'

РНП (pulse): с отбором slice ответ несёт блок pulse — итог набора и страницу товаров по убыванию заказов за 14 дней, недели, месяцы и оценку дней

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'ozon' required
source'ozon_orders_and_finance'
estimateModel'sales_and_orders_weekly'
skustring

Артикул за который построена матрица

fromstring date
tostring date
daysstring[] required

Четырнадцать дней от старого к новому

referencesobject
dataThroughobject
computedAtstring date-time

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

notestring

Пустая строка, когда сказать нечего

analyticsboolean

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

Changes

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