Руководства
Подробные руководства по production-развертыванию и продвинутому использованию SDK.
Новое в v3.10.0
Модуль возвратов (sdk.returns) — Унифицированный агрегатор, объединяющий аналитику FBO, историю заказов FBS и финансовые отчёты в единый массив ReturnItem[]. Один вызов метода заменяет самостоятельное объединение трёх источников с разным расписанием обновлений. Включает classifyReturnReason(), прозрачность частичных сбоев и getReturnStats() для агрегации по SKU/категориям.
Руководства для Production
- Лучшие практики - Обработка ошибок, безопасность и паттерны тестирования
- Настройка производительности - Оптимизация лимитов запросов, кеширования и памяти
- Углублённая настройка производительности - Комплексное руководство: лимиты запросов, кэширование, мониторинг и бенчмаркинг
- Безопасность - Управление API ключами и безопасная интеграция
- Тестирование - Стратегии модульного и интеграционного тестирования
- Устранение неполадок - Распространенные проблемы и решения
- Конфигурация - Параметры конфигурации SDK
Руководства по модулям
Управление Товарами
- Склейка Карточек и Аналитика - Склейки карточек, распределение рекламного трафика и кросс-аналитика по вариантам
- Работа с карточками товаров - Создание, обновление, фильтрация и восстановление карточек товаров
- Обязательные характеристики товаров - Обязательные характеристики при создании карточек (дедлайн: 29 апреля 2026)
Заказы и Логистика
- Начало работы с DBS - Управление заказами DBS (курьерская доставка продавца)
- DBS рабочие процессы - Жизненный цикл заказов DBS и бизнес-процессы
- Миграция DBS с legacy на bulk - Переход на bulk-методы DBS API
- Начало работы с FBW - Управление поставками и складами FBW
- Самовывоз (In-Store Pickup) - Управление заказами самовывоза
Реклама и Маркетинг
- Реклама (Promotion) - Управление кампаниями, ставки, бюджет и аналитика
- Начало работы с Promotion - Полное руководство по модулю рекламы
- Рекламные кампании - Создание и управление рекламными кампаниями
Финансовые операции
- Комиссии и Сборы - Тарифы и расчёт комиссий
- Отчёты о реализации - Отчёты о продажах и реализации
- Модуль отчётов - Финансовая отчётность
Финансовая сверка
- Модуль возвратов - Унифицированный агрегатор
sdk.returns, объединяющий источники FBO, FBS и Finance в единый массив ReturnItem с полной прозрачностью о состоянии источников и ограничениях. (Новое в v3.10.0) - Сверка выкупов и возвратов - Классификация причин возвратов FBO/FBS, обогащение возвратов полем
orderTypeи сверка с выкупами по nmId через три чистые вспомогательные функции. (Новое в v3.9.3) - Отслеживание каналов продвижения через подменные артикулы - Финансовая сверка по подменным артикулам
- Миграция финансовых отчётов v5 к v1 - Переход на новый API v1 (дедлайн: 2026-07-15)
Инвентарь и Логистика
- Управление остатками - Контроль и отслеживание запасов
- Сборы за хранение - Интеграция складских расходов
- Обработка возвратов - Работа с возвратами
- Планирование поставок - Коэффициенты приёмки, расчёт затрат, выбор FBW vs FBS
- Тарифы на поставки - Расчёт затрат на поставку, коэффициенты приёмки и сравнение тарифов
Работа с покупателями
- Коммуникации - Чат, вопросы-ответы и управление отзывами
- Начало работы с коммуникациями - Полное руководство по модулю коммуникаций
- Общение с покупателями - Вопросы, отзывы, чат и обработка обращений
Управление пользователями
- Управление пользователями - Управление доступом и пользователями аккаунта
Тарифы и Затраты
- Обзор тарифов - Различия между тарифами на остаток и поставку
Подписки
- Определение подписки Джем - Определение тарифа подписки Джем через пробные запросы
Аналитика и данные
- Статистика рекламы - Получение и анализ статистики рекламных кампаний
- Лучшие практики воронки продаж - Анализ воронок продаж, органическая конверсия и стратегии оптимизации
- Лучшие практики рекламных кампаний - Управление кампаниями, оптимизация бюджета, стратегии ставок и мониторинг
- Аналитика воронки продаж - Работа с воронкой продаж: стадии, метрики и практические сценарии
- Аналитика поисковых запросов - Иерархия отчётов, drill-down, влияние подписки Джем
- CSV-отчёты аналитики продавца - Асинхронный экспорт отчётов: создание, polling, скачивание
Руководства по миграции
- Миграция финансовых отчётов v5 к v1 - Переход на новый API v1 (дедлайн: 2026-07-15)
- Миграция v2.x к v3.0.0 - Полное руководство по миграции на v3.0.0
- Миграция v2.7 — Analytics v3 API - Переход на новый Analytics v3 API (воронка продаж)
- Миграция v2.4 — Deprecation Promotion - Переход с type 8 на type 9 кампаний
- Миграция v2.2 к v2.3 - Улучшение типобезопасности и соответствие контракту API
- Миграция Type 8 к Type 9 кампаний - Переход с Type 8 (unified bid) на Type 9 (manual bid)