Руководства

Подробные руководства по production-развертыванию и продвинутому использованию SDK.

Новое в v3.10.0

Модуль возвратов (sdk.returns) — Унифицированный агрегатор, объединяющий аналитику FBO, историю заказов FBS и финансовые отчёты в единый массив ReturnItem[]. Один вызов метода заменяет самостоятельное объединение трёх источников с разным расписанием обновлений. Включает classifyReturnReason(), прозрачность частичных сбоев и getReturnStats() для агрегации по SKU/категориям.

Руководства для Production

• NodeNext: ESM и CommonJS - Строгая настройка .mts и .cts с поддерживаемыми экспортами пакета
• Лучшие практики - Обработка ошибок, безопасность и паттерны тестирования
• Настройка производительности - Оптимизация лимитов запросов, кеширования и памяти
• Углублённая настройка производительности - Комплексное руководство: лимиты запросов, кэширование, мониторинг и бенчмаркинг
• Безопасность - Управление API ключами и безопасная интеграция
• Тестирование - Стратегии модульного и интеграционного тестирования
• Устранение неполадок - Распространенные проблемы и решения
• Конфигурация - Параметры конфигурации SDK

Руководства по модулям

Управление Товарами

• Склейка Карточек и Аналитика - Склейки карточек, распределение рекламного трафика и кросс-аналитика по вариантам
• Работа с карточками товаров - Создание, обновление, фильтрация и восстановление карточек товаров
• Обязательные характеристики товаров - Обязательные характеристики при создании карточек (дедлайн: 29 апреля 2026)

Заказы и Логистика

• Начало работы с DBS - Управление заказами DBS (курьерская доставка продавца)
• DBS рабочие процессы - Жизненный цикл заказов DBS и бизнес-процессы
• Миграция DBS с legacy на bulk - Переход на bulk-методы DBS API
• Начало работы с FBW - Управление поставками и складами FBW
• Самовывоз (In-Store Pickup) - Управление заказами самовывоза

Реклама и Маркетинг

• Реклама (Promotion) - Управление кампаниями, ставки, бюджет и аналитика
• Начало работы с Promotion - Полное руководство по модулю рекламы
• Рекламные кампании - Создание и управление рекламными кампаниями

Финансовые операции

• Комиссии и Сборы - Тарифы и расчёт комиссий
• Отчёты о реализации - Отчёты о продажах и реализации
• Модуль отчётов - Финансовая отчётность
• Продажи по регионам → Лента заказов - Миграция до 03.11.2026 с пагинацией одного snapshot и явными семантическими границами

Финансовая сверка

• Модуль возвратов - Унифицированный агрегатор 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)

---

← Назад к главной странице документации