Как создать токен на Вайлдберриз и в Яндекс Маркете и подключить аналитику за пять минут

Токен на Вайлдберриз создаёт владелец кабинета в профиле, в разделе «Интеграции по API». Для сервиса аналитики хватает базового токена «Только чтение» с категориями, где лежат продажи, финансы и остатки. В Яндекс Маркете ключ создаётся в «Настройки → API и модули → Токены авторизации», нужный доступ называется «Просмотр всех данных». Обе операции занимают пару минут, а ещё через пару минут сервис проверит ключ и начнёт загрузку.

Что такое API‑токен Вайлдберриз

Токен это длинная строка, по которой сервис получает данные вашего кабинета без логина и пароля. У токена WB есть:

• тип: персональный, базовый, тестовый или сервисный;
• категории: к каким разделам кабинета он открывает доступ;
• уровень: «только чтение» или «чтение и запись»;
• срок: 180 дней. Продлить нельзя, можно только создать новый.

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

Как создать токен на Вайлдберриз

1. Откройте кабинет WB и перейдите в профиль, раздел «Интеграции по API».
2. Нажмите «Создать токен» и выберите тип, который указал сервис. Для Плюсомера это вкладка «Для интеграции вручную», тип «Базовый».
3. Отметьте категории. Для аналитики обычно нужны «Статистика», «Аналитика», «Финансы», «Контент», «Цены и скидки», «Маркетплейс», «Продвижение», «Поставки», «Возвраты» и «Документы». «Вопросы и отзывы», «Чат с покупателем» и «Пользователи» для аналитики не нужны.
4. Выберите «Только чтение».
5. Скопируйте токен сразу: WB показывает его один раз.

Создавать токены может только владелец кабинета.

Какие права давать и почему хватает чтения

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

Самая частая ошибка подключения: забыли категорию. Тогда сервис работает, но один раздел пустой. Без «Финансов» или «Статистики» нет отчёта о реализации, а значит, и прибыли. Без «Продвижения» не видно рекламы. Пустой раздел легко принять за плохой месяц, хотя на деле это просто галочка.

Как создать ключ Яндекс Маркета

1. Откройте кабинет Маркета: «Настройки → API и модули → Токены авторизации».
2. Нажмите «Создать новый токен».
3. Выберите доступ «Просмотр всех данных». Если хотите минимум, нужны просмотр заказов, товаров и карточек, цен, финансовой информации и отчётности, информации о продвижении и FBY‑заявок.
4. Скопируйте токен: он показывается один раз.

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

Ozon: Client ID и API‑ключ

Для Ozon нужен ключ Seller API: «Настройки → API‑ключи» в кабинете продавца, там же Client ID. Хватит роли только для чтения, например «Admin read only». Некоторые сервисы, и Плюсомер тоже, умеют подключаться через вход в Ozon: тогда ключ копировать не придётся. Для рекламы отдельно ключ Performance из рекламного кабинета. Подробно о том, что должен уметь сервис для Ozon, в статье сервис аналитики Ozon.

Сколько истории подтянется после подключения

Площадки отдают историю по API не бесконечно. У WB лента заказов в статистике доступна за 90 дней, детализация отчёта о реализации глубже, но медленно: площадка ограничивает частоту запросов. Аналитика воронки глубже 90 дней у WB открывается платной подпиской площадки. Остатки и цены площадки отдают только текущие, историю остатков сервис копит сам с первого дня подключения.

Что из этого следует на практике:

• первые цифры появляются быстро, а полная история догружается в фоне, иногда часы;
• пока загрузка идёт, отчёты за ранние даты неполные, и хороший сервис об этом пишет;
• чем раньше подключитесь, тем длиннее будет своя история остатков.

Если ключ перестал работать

Ключи умирают тихо: данные просто перестают обновляться, а продажи в сервисе падают до нуля при живом кабинете. Причины обычно такие:

• закончился срок токена (у WB это 180 дней);
• владелец отозвал токен или удалил его;
• у владельца кабинета сменился телефон, и площадка отозвала старые токены;
• не хватает прав на какой-то раздел.

Хороший сервис предупреждает заранее и называет причину человеческими словами, а замена ключа не стирает историю.

Как это устроено в Плюсомере

Плюсомер работает со всеми тремя площадками, и подключение мы делали так, чтобы вы справились сами, без звонка менеджеру.

• «Где вы продаёте?» В мастере выбираете площадку, остальные подключаете потом в настройках магазинов.
• Ozon: кнопка «Войти через Ozon» или ключ Seller API с ролью только для чтения. Для рекламы отдельно ключ Performance.
• Wildberries: базовый токен с отметкой «Только чтение». В кабинете WB это «Создать токен» → «Для интеграции вручную» → «Базовый». Персональный токен Плюсомер не примет и объяснит почему, тестовый тоже: он работает только с выдуманными данными песочницы.
• Яндекс Маркет: токен с доступом «Просмотр всех данных». Один токен открывает весь кабинет, и FBS, и FBY.
• Разбор токена WB до сохранения. Пока вы вставляете токен, под полем уже видно его срок, «только чтение» он или нет и каких категорий не хватает. Без «Финансов» Плюсомер честно скажет, что прибыли не будет, и попросит новый токен.
• Лишние права. Если у токена есть права на запись, Плюсомер подключится, но посоветует при следующей замене взять токен только для чтения.
• Срок токена. Токен WB живёт 180 дней. Когда до конца срока останется меньше двух недель, Плюсомер напомнит, а замена ключа сохранит всю историю.

Учтите одну привычку WB: отчёт о реализации он выпускает раз в неделю, обычно в понедельник. Свежие дни Плюсомер считает по ежедневным отчётам, и цифры за них предварительные. Придёт недельный отчёт, и эти дни пересчитаются по нему без дублей.

Ключи хранятся зашифрованными, после ввода видна только маска. В тариф входит по одному магазину на каждой площадке, подробности на странице тарифов. Что делать с цифрами, когда подключены все три, разобрано в статье про прибыль на Ozon, WB и Яндекс Маркете.

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

Как создать токен на Вайлдберриз?

В кабинете WB: профиль, раздел «Интеграции по API», «Создать токен». Выберите тип, который указал сервис, нужные категории и «только чтение». Токен показывается один раз.

Где найти API‑токен Вайлдберриз?

Готовые токены видны в том же разделе «Интеграции по API», но само значение WB показывает только при создании. Потеряли строку, создайте новый токен.

Сколько действует токен Вайлдберриз?

180 дней. Продлить его нельзя, перед концом срока нужно создать новый и заменить в сервисе.

Можно ли отдать сервису персональный токен WB?

Нет. WB запрещает передавать персональный токен третьим лицам и использовать его в облачных сервисах.

Какой доступ дать ключу Яндекс Маркета?

«Просмотр всех данных». Полное управление кабинетом аналитике не нужно.