что такое токен wildberries
API-ключ Wildberries: что такое, как подключить и интеграция с личным кабинетом
На сегодняшний день появилось много сервисов аналитики Wildberries и модель работы с маркетплейсом – FBS или продажа со склада поставщика. Большинство клиентов используют интеграцию посредством API с Wildberries специальным ключом.
В этой статье вы найдете инструкцию по получению api и последующему его использованию.
Что такое API для Wildberries и зачем он нужен?
Это уникальный цифровой идентификатор для поставщиков Wildberries, посредством которого осуществляется работа и обмен данными между сервером маркетплейса и вашим софтом.
Такая связь дает вам возможность получать информацию и статистику о заказах, движении товара, остатках на региональных складах. Но самое главное – получать и выводить аналитику по конкурентам.
Это удобный способ интеграции с сервисами аналитики или с такими программами, как 1С, Мойсклад при работе по модели FBS, которые призваны помочь поставщикам при ведении бизнеса на Wildberries.
Преимущества API
Как подключить API через личный кабинет поставщика WB
Мы подготовили для вас подробную инструкцию, где взять его. При этом возможны варианты. У вас уже есть api, но вы о нем просто не знаете и у вас нет ключа. Читайте описание возможных действий.
API-ключ есть
Откройте свой личный кабинет поставщика Wildberries.
Если идентификатор уже есть, то он будет доступен в разделе «Доступ к API». Если вы его не нашли, то его нужно запросить в службе поддержки. Как это сделать, смотрите ниже в пункте «Ключа нет».
Скачайте документ «API-ключ.txt». При этом в файле будут две строки «Ключ» и «Ключ Base64». Вам потребуется именно «Ключ Base64».
Как воспользоваться этим, покажем вам на примере сервиса Stat4market, но рекомендуемый сервис Moneyplace.io
После подключения начнется процесс вывода и получения информации о ваших товарах на Wildberries. Процесс подгрузки данных может занимать от нескольких секунд до десяти минут, в зависимости от объема продаваемых товаров.
Ключа нет
Вы провели проверку наличия идентификатора, как описано выше, и если у вас нет раздела «Доступ к API» и файла «API-ключ.txt», то следует запросить его в службе поддержки поставщиков Wildberries.
Перейдите в раздел Service Desk в личном кабинете:
В поле «Комментарий» написать:
«Здравствуйте! Можно мне предоставить API-ключ для интеграции? Спасибо!»
Нажать кнопку «Создать заявку».
После создания заявки выдача займет около 24 часов.
Служба поддержки WB создаст вам личный идентификатор. Он появится в разделе «Шаблоны документов». Далее нужно будет сделать то, что описано в пункте «API-ключ есть» выше.
Особенности работы
Как только вы получили и стали использовать идентификатор, все данные будут подгружены не сразу. Спецификация его работы такова, что если пользователь получил ключ 1 июня, то он может получить данные, только начиная с 1 июня.
Однако через некоторое время данные появятся за предыдущие 90 дней включительно.
Данные по API и в личном кабинете поставщика Wildberries обновляются по-разному. Наблюдается порой так, что в личном кабинете данные отобразились, а по ключу их нет, и наоборот. WB иногда обмен данными выводит с задержкой. Отсюда возникает такой диссонанс.
Этот метод обмена данными с WB на сей день нестабилен и не отображает 100% информации. Почему так происходит? Те потоки, которые вы получаете напрямую, зависят от самого Wildberries. Сам маркетплейс может в любой момент перестать обновлять данные, и это связано с их серверами.
По заявлениям самого WB, они занимаются улучшением и такого рода проблема будет в скором времени устранена.
Ответы на вопросы
Да, конечно. Чтобы осуществлялась выгрузка товаров на сайт Wildberries и дальнейший обмен по остаткам товаров у вас на складе, требуется интеграция через API. Это нужно, чтобы на витрине сайта отображалась оперативная информация.
К слову, такая модель появилась у WB не так давно. Для маркетплейсов типа Ozon или Lamoda это уже давно стандартная практика. В этой модели есть свои плюсы и минусы.
Запрос возможен 1 раз в 60 секунд.
Простой пример. Вы используете несколько сервисов. Если один из сервисов отправляет запрос, то следующее обращение строго через 60 секунд. Если в этот промежуток не прошло 60 секунд, сервис делает повторный запрос, а Wildberries отправляет назад ошибку. Снова начинается отсчет 1 минуты.
Поэтому пользователю следует смотреть, где он сохраняет свой API. Пользователь, разместивший свой API на нескольких сервисах, провоцирует вероятность «конфликта»: каждый сервис будет направлять запросы к WB, и если сервисов будет много, то вероятность пересечения этих запросов и выдачи ошибки многократно увеличивается.
В завершение
Идентификатор дает возможность автоматизировать сбор данных с маркетплейса Wildberries для последующего анализа. Использование его является безопасным способом интеграции. Кроме того, вы всегда можете заменить скомпрометированный ключ в любое время.
Модель FBS, которая сейчас приобретает популярность среди поставщиков, тоже нуждается в таком методе интеграции с программами складского учета. Но такая синхронизация с Вайлдберриз требует привлечения специалистов.
Спасибо, это полезно 7
Подписывайся на мой Instagram, там все что не входит в рамки этого сайта
Бот для поставщиков WildBerries по системе FBS
Бот для поставщиков, которые продают WildBerries по системе FBS. Чем полезен бот для поставщиком?
Как установить бот WB FBS+?
Перейдите в бот https://t.me/fbsWB_Bot и нажмите “Начать”.
Обратите внимание, что последняя ссылка из сообщения генерируется уникальная для каждого нового пользователя! Так например, вы можете передать эту сылку своему партнеру и он будет видеть активное количество заказов. Следующим этапом нужно перейти по последней ссылки и указать свой токен от WildBerries. Это обязательно, так как без него бот не сможет отслеживать новые заказы.
Как получить токен WildBerries?
На самом деле это быстрая и простоя операция:
1.В личном кабинете поставщика перейдите на “Мой профиль” => “Доступ к новому API”
2. Укажите название ключа (эта информация только для вас и указать можно все, что угодно. Например: 123) и нажмите на кнопку “Сгенерировать токен”.
3. После скопируйте полученный API токен. Его в любое время можно и в таком случае бот перестанет отслеживать новые заказы.
После получения токена перейдите по той ссылке, которую сгенерирован для вас бот. Перейдите в настройки и укажите свой API токен, выставьте чекбоксы по уведомлению (если баланс не пополнен, то сообщения покупателям отправляться не будет). Стоимость одного сообщения – 3 руб.
После завершения настроек нажмите на кнопку “Сохранить” и после этого бот начнет отслеживать новые заказы.
Какие сообщения отправляются покупателям и сколько стоит одно сообщение?
Стоимость одного сообщения – 3 руб. На данный момент, редактировать сообщение, которое отправляется покупателю – нет. Сообщение по умолчанию:
Когда заказ доставлен в ПВЗ:
Когда покупатель забрал заказ:
Когда покупатель сделал возврат по браку:
На данный момент менять сообщения, которые отправляются покупателю – нельзя!
Как приходят уведомления о новых заказах и выводятся все заказы?
В бот вам приходит уведомление о том, что у вас поступил новых заказ и краткая информация о нем: баркод, стоимость, адрес доставки.
На сайте же храниться вся информация о ваших заказах. Список заказов выглядит так:
Что такое API-ключ Wildberries
Каждый маркетплейс предлагает партнерам довольно ограниченный функционал по аналитике своих продаж, но при этом он совсем не против, чтобы вы делали это самостоятельно с помощью сервисов аналитики.
Поэтому он сохраняет все данные по заказам, остаткам, продажам и возвратам, чтобы вы могли экспортировать их в другую систему. Ключи Api WB — это способ получения данных или даже точнее — путь обмена данными от маркетплейса Wildberries к сервису статистики.
Интеграция с Api Wildberries довольно простая — достаточно ввести комбинацию цифр из личного кабинета продавца в раздел Api-кабинет на Moneyplace.
Посмотрим, какие данные можно получить с помощью Api, как получить Api от Wildberries и как подключить Api ключ в сервис аналитики.
Какие данные передает Wildberries по Api
Итак, по Api ключу вы получаете все необходимые данные для анализа. Теперь дело за сервисом аналитики, который проанализирует заказы клиентов, статусы заказов, выгрузку цен, оборачиваемость каждой позиции. Теперь вы видите не просто список товаров, как в личном кабинете Wildberries, но и детальную информацию по каждой позиции.
Как это происходит?
Как подключить Api ключ Wildberries
Для каждого магазина в системе есть свой апи ключ, то есть последовательность букв и цифр, которая позволяет идентифицировать каждый магазин. Поэтому в личном кабинете поставщика может быть несколько токенов Api. Даже если у вас модель FBS, вы сможете получить свой ключ, просто не получится сделать выгрузку остатков.
Для получения токенов в личном кабинете зах одим в раздел Настройки — “Доступ по API”. Здесь вы можете увидеть две последовательности — для аналитики подходит ключ х64. Копируем и вставляем в раздел Api-кабинет сервиса аналитики.
Как работает Api-ключ?
Данные по продажам, заказам и финансам подтягиваются за последние 90 дней. Данные по поставкам и остаткам подтягиваются на дату подключения, и здесь бывают проблемы. То есть Wildberries может “не отдать” часть поставок или остатков на конкретных складах. Как отвечают сотрудники поддержки, данную проблему планируют решить.
Еще один важный момент: есть лимит запросов к Api. Если говорить простым языком, то Api ключ стоит подключать только к одному аккаунту в сервисе, а для получения полной статистики — желательно только к одной программе. Только так можно получить максимум информации по своему магазину.
Когда вы подключаете свой токен в систему аналитики, несмотря на возможные неполадки со стороны WB, Moneyplace начнет накапливать ваши данные, и уже через пару недель вы сможете увидеть четкую картину по своему ассортименту, полностью проанализировать матрицу товаров и финансовую информацию.
На основе этих данных вы сможете в несколько раз увеличить свой доход на маркетплейсах: ликвидировать убыточные товары, изменить цену “средних товаров”, допоставить флагманы на конкретные склады.
А с помощью общей аналитики продаж от Moneyplace вы решите, какими именно товарами дополнить свой портфель, чтобы с успехом встретить новый сезон и заработать еще больше!
Как получить API Wildberries и что с ним делать?
Для начала небольшое вступление, что такое API и для чего он нужен? Краткий и простой обзор для начинающих.
Краткий экскурс:
Аббревиатура API расшифровывается как «Application Programming Interface» (интерфейс программирования приложений, программный интерфейс приложения) – это набор готовых классов, функций, процедур, структур и констант. Вся эта информация предоставляется самим приложением (или операционной системой). При этом пользователю не обязательно понимать, что это API технология обеспечивает взаимодействие модулей. Цель предоставленной информации – использование этих данных при взаимодействии с внешними программами.
Пример для обычного обывателя
Принцип работы API
Ну и наконец, постепенно мы дошли до таких сервисов как маркетплейсы. Собственно говоря из-за чего и написана данная статья. На сегодняшний день их становится всё больше, но гигантами на Российском рынке остаются Wildberries, Ozon, Янедекс.Маркет (Беру!), Goods и частично Aliexpress (представитель Tmall ). Все эти площадки предоставляют API в открытом доступе и совершенно бесплатно. Благодаря этому поставщики, пользуясь сторонними сервисами, могут свободно анализировать свои данные, будь то заказы, продажи, логистика и многие другие аспекты аналитики. К примеру сервис разработанный нами ECHelper и другими аналогичными программами или же прямым запросом в браузере (для этого требуются необходимые навыки).
Доступ к API в Wildberries
Несколько месяцев назад Wildberries перешли на новый личный кабинет поставщика, но оставив возможность использовать и старый кабинет, однако с минимальным функционалом. Сначала разберёмся как получить ключ в новом личном кабинете.
Новый портал
Если вы ранее не генерировали ключи, система вам предложит их сгенерировать.
После генерации, у вас появится 2 API ключа для работы с 32-разрядной и 64-разрядной системой.
Для тех, у кого уже были ранее сгенерированы API ключи, они сразу будут отображены на этой вкладке. Ключи вы можете удалить, если в них нет необходимости или они были скомпрометированы или перевыпустить, старый ключ естественно будет не рабочим.
Старый портал
Как правило, выдача API ключа занимает около суток, но учитывая, что площадка перешла на новый портал, есть вероятность большой задержки или вовсе не дождаться ответа.
Учтите, что после подключения ключа к нашему сервису, данные о товарах будут доступны только с момента получения первого API ключа. К примеру, если вы получили ключ 01 января, то в сервисе данные будут показываться, начиная с 01 января.
Подключение wildberries в ecomcom по API
4. В открывшемся окне вам нужно ввести ключ нового API и ключ API статистики. Новый API отвечает за синхронизацию товаров, обновление остатков, цен и статусов заказов. API статистики отвечает за данные по FBO заказам и остаткам на складах маркетплейса.
6. В левом меню портала поставщика выберите «Мой профиль» —> «Доступ к новому API»
7. Введите имя токена (лучше его назвать ecomcom, чтобы случайно не удалить), и нажмите «Сгенерировать». После этого вставьте токен на страницу настроек wildberries в ecomcom в поле «Новый токен API» (п.4) текущей инструкции
Генерация токена API в wildberries
8. Перейдите в кабинете wb на вкладку «Доступ к API» и скопируйте Ключ для работы с API статистики x64
9. После этого вставьте токен на страницу настроек wb в ecomcom в поле «Ключ API статистики» (п.4) текущей инструкции
10. Нажмите кнопку «Сохранить». Система предложит сразу импортировать существующие товары из wildberries
Готово! Желаем вам отличных продаж и приятного использования системы. Если у вас возникнут вопросы по подключению, менеджер с радостью поможет вам. Инструкция по подключению озон доступна по ссылке.