Подключение магазина WB или Ozon

Что это

SmartStats подключается к вашему кабинету продавца по API-ключу — специальному ключу доступа, который вы создаёте в личном кабинете маркетплейса. По нему сервис сам загружает карточки товаров, продажи и заказы, остатки и цены, финансовые отчёты, отзывы. Логин и пароль от кабинета не нужны — окно подключения прямо просит не передавать их.

Подключение находится в разделе «Настройки» на вкладке «Магазины» — кнопка «Подключить магазин». Пока магазинов нет, такая же кнопка есть и на дашборде. Подключать, изменять и удалять магазины может только участник с ролью «Администратор» — владелец кабинета и приглашённые им администраторы. На вкладке «Магазины» у менеджера кнопок управления нет, он видит данные в режиме чтения. А вот на пустом дашборде кнопка «Подключить магазин» показывается и ему: если менеджеру не открыт ни один магазин, он её увидит, но подключить магазин не сможет — сервис ответит «Подключать магазины может только администратор».

Как подключить Wildberries

1. 1Откройте «Настройки» → вкладку «Магазины» и нажмите «Подключить магазин».
2. 2Выберите плитку «Wildberries» и нажмите «Далее».
3. 3Создайте токен (это и есть API-ключ) в личном кабинете продавца Wildberries — путь подсказывает само окно подключения: «ЛК продавца → Профиль → Настройки → Доступ к API → Создать новый токен». Сделайте отдельный токен специально для SmartStats.
4. 4Отметьте для токена категории доступа. В окне подключения их список называется «Необходимые доступы»: «Контент», «Статистика», «Аналитика», «Продвижение», «Отзывы и вопросы», «Поставки». Дополнительно включите категории «Финансы», «Цены и скидки» и «Маркетплейс» — доступ к ним сервис тоже проверяет при подключении и предупредит, если его не хватает.
5. 5Вставьте токен в поле «API-ключ Wildberries» и заполните «Название магазина» — так магазин будет называться внутри сервиса.
6. 6Отметьте галочку-подтверждение, что вы вправе предоставить доступ к API этого магазина (без неё кнопка не нажимается), и нажмите «Подключить».

Как подключить Ozon

1. 1Нажмите «Подключить магазин», выберите «Ozon» и нажмите «Далее».
2. 2Сгенерируйте ключи в кабинете Ozon Seller — путь подсказывает окно подключения: «Ozon Seller → Настройки → API-ключи → Сгенерировать».
3. 3Вставьте значения в поля «Client ID» (это номер вашего кабинета Ozon) и «API-ключ», заполните «Название магазина».
4. 4Если ведёте рекламу в Ozon, заполните блок «Реклама (Performance API)» — это ещё одна пара ключей, отдельная от основной и нужная только для рекламы. Поля «Performance Client ID» (рекламный номер) и «Performance Client Secret» (рекламный секретный ключ) создаются отдельно — окно подсказывает путь: «ЛК Ozon → Реклама → API → Ключи API». Заполняйте оба поля сразу: сервис сохраняет их только парой, одно поле без второго не сохранится.
5. 5Отметьте галочку-подтверждение и нажмите «Подключить».

Рекламные ключи необязательны — блок так и подписан: «опционально». Без них не загрузится только рекламная статистика: расходы по кампаниям и ДРР (доля рекламных расходов — сколько процентов выручки уходит на рекламу). Остальные данные загружаются как обычно, а ключи можно добавить позже через кнопку «Изменить» на карточке магазина.

Что происходит после подключения

Окно закроется сразу, сервис проверит ключи в фоне — на экране будет уведомление «Подключаем…», и магазин появится в списке в течение минуты. Затем начнётся первая синхронизация — автоматическая загрузка данных: карточки товаров, продажи и заказы, остатки и цены, финансовый отчёт, отзывы. Первые цифры видны уже через 3–5 минут, а полная финансовая картина собирается в течение суток.

На карточке магазина отображается общий статус, а под ним — список этапов загрузки с прогрессом (например, «3/9 этапов») и примерным оставшимся временем. Статусы:

• «Синхронизировано» — все ключевые данные загружены;
• «Идёт: …» — прямо сейчас загружается указанный этап;
• «Синхронизация в очереди» — загрузка запустится автоматически в ближайшие минуты;
• «Автоповтор …» — маркетплейс временно ограничил запросы, сервис сам повторит попытку в указанное время, делать ничего не нужно;
• «Ошибка синхронизации» — данные загрузить не удалось; причина видна в подсказке при наведении на статус. Первую загрузку сервис перезапускает сам примерно раз в 15 минут. Если ошибка держится, чаще всего дело в ключе — обновите его через «Изменить»: после смены ключей синхронизация запустится заново автоматически.

Как часто обновляются данные

Дальше данные обновляются автоматически, запускать ничего не нужно. Wildberries: новые отзывы сервис проверяет примерно раз в час, остатки — раз в несколько часов, а продажи, финансовый отчёт и отвеченные отзывы загружает ночью — к утру готова полная картина за вчерашний день. Ozon: заказы — примерно раз в час, остатки и карточки товаров — раз в несколько часов, финансовый отчёт, отзывы и вопросы — ночью.

Такое расписание связано с ограничениями маркетплейсов на частоту запросов. Если запросов оказывается слишком много, площадка временно ограничивает доступ — тогда магазин переходит в статус «Автоповтор …» с временем следующей попытки, и сервис повторит её сам.

Термины на экране

API-ключ (токен)

Ключ доступа, который вы создаёте в кабинете маркетплейса и вставляете в SmartStats. Это не логин и пароль; отозвать ключ можно в любой момент в кабинете маркетплейса.

Client ID

Номер вашего кабинета Ozon. Выдаётся вместе с API-ключом и вводится в соседнее поле.

Performance API

Отдельная рекламная система Ozon со своими ключами. Нужна только для рекламной статистики.

ДРР

Доля рекламных расходов — сколько процентов выручки уходит на рекламу.

Частые вопросы