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

Кому нужна эта статья

Селлеру, который продаёт со склада фулфилмента и хочет, чтобы заказы Wildberries попадали на склад без переписывания номеров руками. Сотруднику склада — чтобы понимать, о чём спросит селлер.

FBS — продажа со склада продавца: товар лежит у фулфилмента, маркетплейс только приводит покупателя. Обратная схема называется FBO: товар заранее увозят на склад маркетплейса.

Короткий ответ

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

Что можно делать уже сейчас:

• работать ручными заказами: селлер вписывает номер заказа Wildberries сам, склад собирает;
• подключить проверочный магазин Wildberries (песочницу с ненастоящими заказами), чтобы посмотреть путь;
• заранее подготовить номенклатуру и разобраться, какой токен понадобится.

После согласования путь будет такой: селлер выпускает токен в кабинете Wildberries, вставляет его в Fulfillment Lite и даёт согласие, а заказы начинают приходить при каждой проверке.

Статус

Зачем это нужно

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

Что подготовить

• [ ] Вы владелец кабинета селлера. Подключать магазин и менять ключ может только владелец. Менеджер кабинета видит состояние, но кнопок не увидит.
• [ ] Товар уже лежит на складе и принят. Иначе подключение остановится сообщением «У вас ещё нет учтённого товара на этом складе».
• [ ] Товар в номенклатуре совпадает с Wildberries. Система узнаёт товар из заказа по номеру характеристики Wildberries, штрихкоду, номеру карточки или артикулу продавца. Если товар не найдётся или найдётся несколько похожих, заказ не создастся: у склада появится запись для разбора, см. статью «Если кнопка неактивна или заказ не появился».
• [ ] Токен из кабинета Wildberries нужного типа и с нужными правами (разбор ниже).
• [ ] Название вашего магазина — как оно записано у вас в кабинете. Нужно, чтобы вы и склад не перепутали магазины.

Какой токен нужен и какие права

Токен — так Wildberries называет ключ доступа: длинную строку-пароль, с которой программа работает в вашем кабинете в пределах выданных прав.

Категория. Нужна категория «Маркетплейс» — раздел Wildberries, который отвечает за продажи со своего склада.

Уровень доступа. Нужно «Чтение и запись». Система передаёт в Wildberries коды маркировки, создаёт поставку и передаёт её в доставку — всё это запись. С токеном «только чтение» эти действия не сработают.

Тип токена:

Короткое правило: сервисный для Fulfillment Lite, если он есть в каталоге; иначе базовый с «Маркетплейс» и «Чтение и запись»; персональный — никогда.

Официальные источники Wildberries: - Общая информация об API Wildberries - Статья базы знаний Wildberries о токенах - Статья базы знаний Wildberries «Заказы FBS»

Сначала выпустите токен в кабинете Wildberries

Выпускайте настоящий токен только тогда, когда склад сообщит, что подключение Wildberries готово. До этого красная надпись на экране Fulfillment Lite прямо просит не вставлять боевой ключ.

На скриншотах ниже данные кабинета закрыты, значений токенов на них нет.

1. Войдите в WB Partners и откройте прямую страницу «Интеграции по API». Здесь API означает программный доступ, через который Fulfillment Lite сможет обмениваться данными с Wildberries. Нажмите «Создать токен».

Стрелка показывает кнопку создания токена.

1. В открывшемся окне сначала проверьте вкладку «Для сервиса из каталога». Если Fulfillment Lite есть в списке, выберите его и выпустите сервисный токен для этого сервиса. Если сервиса в списке нет, откройте «Для интеграции вручную», как показано ниже.

Запасной путь, когда сервиса Fulfillment Lite нет в каталоге.

1. Выберите «Базовый токен».
2. Введите понятное имя, например «Fulfillment Lite». Значение поля не влияет на права.
3. Отметьте категорию «Маркетплейс». Другие категории для этого подключения не нужны.
4. Оставьте уровень «Чтение и запись».
5. Ещё раз проверьте тип, категорию и уровень доступа. После этого нажмите «Создать токен».

Стрелки и рамка показывают настройки базового токена и кнопку создания.

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

Если названия или расположение элементов в WB Partners отличаются от скриншотов, не выбирайте похожие пункты наугад. Сделайте скриншот без значения токена и пришлите его письменно менеджеру склада.

Затем подключите магазин в Fulfillment Lite

1. Зайдите в свой кабинет Fulfillment Lite.
2. В блоке «FBS-заказы» нажмите «Мои FBS-заказы», затем «Мой магазин на маркетплейсе».
3. Посмотрите, нет ли над формой красной надписи «Обычное подключение Wildberries пока не готово на стороне склада». Если есть — настоящий токен не вставляйте. Можно подключить проверочный магазин (шаг 9) или работать ручными заказами.
4. В блоке «Подключить магазин» в поле «Склад, который будет собирать заказы» выберите склад.
5. В поле «Маркетплейс» выберите Wildberries. Под полем появится подсказка, какой ключ создать.
6. В поле «Название вашего магазина» напишите, как он называется у вас в кабинете.
7. В поле «Ключ доступа из кабинета магазина» вставьте токен целиком, от первого знака до последнего.
8. Поставьте обязательную галочку «Я разрешаю складу работать с моим магазином».
9. Для проверочного магазина поставьте галочку «Сначала проверочный режим» и вставьте тестовый токен.
10. Нажмите «Подключить магазин».

Токен сохраняется в закрытом виде. Показать его обратно не сможет никто: ни вам, ни складу.

Что произойдёт

Нажали «Подключить магазин» → система разбирает токен и отвергает негодный сразу → проверяет токен у Wildberries пробным чтением → в таблице «Подключённые магазины» состояние «магазин подключён» → при очередной проверке в списке FBS-заказов появляются заказы, номера которых вы не вводили.

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

Сколько ждать. Система проверяет площадку по расписанию, по стандартной настройке раз в 10 минут. Кнопка «Проверить сейчас» у склада ставит проверку в очередь; заказы придут после неё.

Как понять, что всё готово

Все четыре признака вместе:

1. В таблице «Подключённые магазины» в столбце «Состояние» стоит зелёное «магазин подключён».
2. В столбце «Ключ доступа» написано «годен до» и дата.
3. В списке FBS-заказов появился хотя бы один заказ, номер которого вы не вводили руками.
4. У этого заказа виден состав — что именно собрать.

Когда не сработает

• Подключение ещё на согласовании у Wildberries. Настоящий магазин не подключится ни с каким токеном. Работайте ручными заказами.
• У вас Ozon. Подключения нет, см. статью «Как работать с заказами Ozon сейчас». Для Яндекс Маркета — статья «Как подключить Яндекс Маркет».
• Вы вошли как менеджер кабинета. Кнопок подключения не будет.
• На складе нет вашего товара. Откладывать нечего, подключение остановится.
• У вас персональный токен. Не подойдёт никогда.
• У токена только чтение. Передача кодов маркировки, создание поставки и передача в доставку не сработают.
• Товар в номенклатуре не совпадает с Wildberries. Заказ не создастся, у склада появится запись для разбора.

Если появилась ошибка

Что приложить к письму в любом случае: название магазина, номер заказа Wildberries, если он есть, дословный текст с экрана, скриншот без значения токена, вашу роль и время. Сам токен не присылайте никогда.

Если нужно заменить токен или остановить обмен

• Заменить токен. Раскройте «Заменить ключ доступа», вставьте новый в поле «Новый ключ доступа» и нажмите «Сохранить новый ключ». Старый перестаёт работать в Fulfillment Lite сразу.
• Остановить приём заказов. Нажмите «Приостановить обмен». Новые заказы приходить не будут, начатые склад доделает. Вернуть — «Возобновить обмен».

Что уйдёт в Wildberries

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

Что система делает сама / что остаётся человеку

Система сама: разбирает вставленный токен и отвергает негодный ещё до записи; не отправляет запросов по настоящему магазину без согласования Wildberries; хранит токен в закрытом виде; проверяет токен у Wildberries пробным чтением; при каждой проверке спрашивает новые заказы; сопоставляет товар из заказа с номенклатурой; не создаёт заказ по непонятному товару, а отдаёт его складу на разбор; принимает отмены из магазина.

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

Остаётся Fulfillment Lite: завершить согласование с Wildberries и включить обмен для склада.

Склад может: нажать «Проверить сейчас», посмотреть «Что встало», приостановить связь.

Дальше

• Следующий шаг: Как собрать FBS-заказ сканированием для склада.
• Что умеет каждая площадка: Какие маркетплейсы и операции поддерживаются.
• Заказ не появился: Если кнопка неактивна или заказ не появился.