🎯 Назначение API
Analytics API предоставляет специализированные инструменты для анализа товарных остатков:
- Анализ оборачиваемости — расчёт оборачиваемости товаров и дней до конца остатка
- Мониторинг остатков — контроль товаров на складах с детализацией по типам
- Планирование закупок — данные для принятия решений о поставках
- Оптимизация склада — анализ эффективности управления остатками
⚠️ Внимание: Метод
getStockOnWarehouses будет отключён в будущем.
Рекомендуется использовать новый endpoint /v1/analytics/stocks.
📋 Методы Analytics API (7 endpoints)
📈 Анализ оборачиваемости
| Метод | Endpoint | Назначение |
|---|---|---|
getMostPopularSku | /v1/analytics/most-popular-sku | Самые популярные SKU товаров |
getStocksTurnover | /v1/analytics/turnover/stocks | Оборачиваемость товаров с прогнозом |
💰 Анализ цен
| Метод | Endpoint | Назначение |
|---|---|---|
getAveragePrice | /v1/analytics/average-price | Средние цены товаров по категориям |
📦 Анализ остатков (Deprecated)
| Метод | Endpoint | Статус |
|---|---|---|
getStockOnWarehouses | /v2/analytics/stock_on_warehouses | ⚠️ Будет отключён |
📊 Система оценки остатков
Analytics API использует систему градации остатков по уровням:
🔴 CRITICAL
Критический уровень
Критический уровень
🟠 RED
Низкий уровень
Низкий уровень
🟡 YELLOW
Средний уровень
Средний уровень
🟢 GREEN
Хороший уровень
Хороший уровень
⚫ NO_SALES
Нет продаж
Нет продаж
🚀 Быстрый пример
import { OzonSellerAPI } from 'daytona-ozon-seller-api';
// Инициализация
const client = new OzonSellerAPI({
clientId: 'your-client-id',
apiKey: 'your-api-key'
});
// Получить популярные товары
const popularSku = await client.analytics.getMostPopularSku({
limit: 10
});
// Анализ оборачиваемости
const turnover = await client.analytics.getStocksTurnover({
limit: 100,
offset: 0
});
// Подсчёт товаров по уровням остатка
const analysis = {
critical: 0,
red: 0,
yellow: 0,
green: 0,
noSales: 0
};
turnover.items?.forEach(item => {
switch (item.idc_grade) {
case 'GRADES_CRITICAL': analysis.critical++; break;
case 'GRADES_RED': analysis.red++; break;
case 'GRADES_YELLOW': analysis.yellow++; break;
case 'GRADES_GREEN': analysis.green++; break;
}
});
console.log('📊 Анализ остатков:', analysis);