Что такое API-токен
API-токен - это длинная строка символов, которую Wildberries выдает продавцу в личном кабинете. Программа, у которой есть такой токен, может запрашивать данные магазина напрямую у Wildberries - без логина, пароля и СМС. Какие именно данные и что с ними можно делать - решаете вы при создании токена: для RefundMP нужен доступ уровня «Только чтение» к отчетам.
Токен «Только чтение» позволяет смотреть отчеты - и больше ничего. Изменить цены, товары или настройки магазина по нему нельзя: Wildberries не выполнит такие операции. Отозвать токен можно в любой момент в кабинете WB, а в RefundMP он хранится в зашифрованном виде и не попадает в логи. Подробнее - в вопросах про безопасность в конце статьи.
Откройте раздел «Доступ к API» в кабинете Wildberries
Войдите в кабинет продавца и откройте страницу seller.wildberries.ru/api-integrations - это самый короткий путь. Тот же раздел доступен через меню: Профиль → Настройки → Доступ к API. На странице виден список уже созданных токенов - у вас он может быть пустым. Нажмите «Создать токен».
Настройте токен: имя, категории, «Только чтение»
В форме создания токена три решения, и все простые:
- Вкладка - выберите «Для интеграции вручную».
- Название - любое, по нему вы потом узнаете токен в списке. Например, RefundMP.
- Категории доступа - отметьте девять: Статистика, Финансы, Аналитика, Возвраты, Поставки, Цены и скидки, Документы, Контент, Маркетплейс. Уровень доступа - «Только чтение».
Почему категорий так много: потери прячутся в разных отчетах. Штрафы и удержания - в финансах, подмены - в возвратах, недопоставки - в поставках, переплаты логистики - в статистике. Чем полнее доступ на чтение, тем больше типов потерь сервис сможет проверить. А категории Продвижение, Вопросы и отзывы, Чат с покупателем и Пользователи можно не отмечать - для поиска потерь они не нужны.
Пропущенная категория. Без «Финансов» сервис не увидит штрафы и удержания, без «Возвратов» - подмены. Если какой-то категории не хватит, RefundMP скажет об этом сразу при подключении - но надежнее отметить все девять с первого раза.
Скопируйте токен - он показывается один раз
После нажатия «Создать токен» Wildberries покажет строку токена. Скопируйте ее сразу: из соображений безопасности WB показывает токен только один раз - после закрытия окна увидеть его снова нельзя.
Не пересылайте токен в мессенджерах и не храните в общих документах: любой, у кого он окажется, сможет читать отчеты магазина. Вставьте его сразу в форму RefundMP - и все. Если токен куда-то «утек», просто удалите его в кабинете WB и создайте новый.
Вставьте токен в RefundMP
Вернитесь в RefundMP. Если вы только регистрируетесь, мастер подключения сам приведет вас к шагу «Токены»; если аккаунт уже есть - откройте раздел Магазины и нажмите «Подключить магазин». Вставьте токен в поле и нажмите «Подключить магазин».
Сервис тут же проверит токен: убедится, что он действующий, уровня «Только чтение» и с нужными категориями. Если все в порядке - магазин подключен, и проверка отчетов запускается автоматически. Что происходит дальше и как читать результат - в статье «Как работает RefundMP».
Если что-то пошло не так
Сервис проверяет токен в момент подключения и говорит, что именно не так. Вот частые сообщения и что с ними делать:
| Что вы видите | Что делать |
|---|---|
| «Wildberries отклонил токен»Не хватает категорий или уровень доступа не тот | Создайте новый токен по шагу 2: отметьте все девять категорий и уровень «Только чтение». Старый токен удалите в кабинете WB. |
| «Этот магазин уже подключен»Токен от магазина, который уже есть в аккаунте | Загляните в раздел «Магазины» - скорее всего, магазин уже там. Если хотите заменить токен, удалите старое подключение и подключите заново. |
| «Wildberries временно недоступен»Сбой на стороне площадки | Токен ни при чем. Подождите минуту и нажмите «Подключить магазин» еще раз. |
| «Слишком много попыток»Wildberries ограничил частоту запросов | Подождите минуту и повторите - ограничение снимется само. |
Не получилось разобраться - напишите в поддержку из кабинета: приложите текст ошибки, и мы поможем.
Вопросы про безопасность
Отчеты и справочники магазина в режиме просмотра: продажи, финансовые отчеты, поставки, возвраты, карточки товаров. Изменить что-либо - цены, остатки, настройки - по токену «Только чтение» невозможно технически: Wildberries не выполняет операции записи по такому ключу.
Двумя способами, оба мгновенные. Первый - удалите токен в кабинете Wildberries (Настройки → Доступ к API): он перестанет работать сразу. Второй - удалите магазин в RefundMP: токен стирается из хранилища сервиса.
На серверах в России, в зашифрованном виде; в логи и выгрузки токен не попадает. Рекомендуем создать для RefundMP отдельный токен, а не использовать общий с другими сервисами - тогда доступ каждого сервиса можно отзывать независимо.
Да. Токен привязан к конкретному кабинету продавца, поэтому для каждого магазина создается свой токен - по этой же инструкции. В RefundMP все магазины живут в одном аккаунте, и проверки идут по каждому отдельно.
Что дальше
Магазин подключен, проверка запущена. Пока она идет - самое время разобраться, что будет на выходе:
- Как работает RefundMP - обзор за 5 шагов
- API-токен Wildberries и подключение магазина
- Архивные отчеты до 2024 года
- Несколько магазинов и разные юрлица