このガイドはロシア語で提供されています

Как подключить Wildberries к порталу: токен и заказы

Wildberries подключается по персональному токену. Портал ведёт цикл FBS: заказы в канбане, карточки товаров, цены, остатки, сборка в поставки, стикеры, отгрузки, заявки на возврат и финансы. Всё, что меняет данные в кабинете Wildberries, по умолчанию выключено и включается переключателями в настройках подключения.

1. Что умеет интеграция

2. Что нужно заранее

• Кабинет продавца на Wildberries.
• Схема работы FBS (Маркетплейс) и свой склад в кабинете Wildberries, если вы собираетесь выгружать остатки.
• Тариф Web Plus: раздел «Маркетплейсы» доступен на нём (сейчас в бете).
• Право «Подключения к площадкам» у вашей роли в мастерской.

3. Как получить токен

1. Откройте кабинет продавца Wildberries.

2. Перейдите в «Настройки» → «Доступ к API».

3. Создайте персональный токен и дайте ему понятное имя, например «Портал».

4. Отметьте категории под то, чем будете пользоваться:

   • «Контент» — карточки, предметы и характеристики, штрихкоды;
   • «Цены и скидки» — выгрузка цен и карантин;
   • «Маркетплейс» — заказы (сборочные задания), склады и остатки, поставки, стикеры, отмена;
   • «Финансы» — отчёт о реализации: удержания и прибыль;
   • «Возвраты покупателями» — заявки на возврат.

   Тарифы и комиссии доступны с токеном любой категории. Лишнего не отмечайте.

5. Скопируйте токен сразу. Wildberries показывает его один раз.

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

Токен «только на чтение» портал заранее не распознаёт. Если вы собираетесь записывать данные на Wildberries, создайте токен без ограничения «только чтение»: иначе при первой записи Wildberries вернёт ошибку.

4. Подключение у нас

1. Откройте раздел «Маркетплейсы» → «Подключения».
2. Нажмите «Подключить» у карточки Wildberries.
3. Вставьте токен.
4. Выберите режим:
   • боевой кабинет: настоящие данные;
   • песочница: тестовый токен Wildberries. В ней работают сборочные задания, карточки, цены и статистика. Финансов, возвратов и тарифов в песочнице нет.
5. Портал проверит связь и права. Токен сохранится только после успешной проверки.
6. В «Настройках подключения»:
   • выберите свой склад Wildberries (FBS) для остатков;
   • включите нужные виды записи: «Карточки товаров», «Цены», «Остатки», «Действия с заказами».

5. Уведомления площадки

Для персонального токена Wildberries не присылает уведомлений о заказах, поэтому вписывать URL нигде не нужно. Портал сам опрашивает Wildberries каждые 10 минут, и новый заказ появляется с небольшой задержкой.

Оповещения вам в Телеграм и браузер

Это другое, чем уведомления выше: те нужны порталу, а эти приходят вам. Портал сам пишет вам о важном, в Телеграм и в браузер (web-push). Присылаем:

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

Wildberries сам не присылает уведомлений о заказах, поэтому портал опрашивает его раз в 10 минут. Оповещение о новом заказе приходит после очередного опроса.

Как настроить. Откройте «Профиль» → «Уведомления» → «Маркетплейсы». У каждого события свой переключатель. По умолчанию включено всё, кроме «Карточка прошла модерацию». Для оповещений нужен привязанный Телеграм: его привязывают в профиле.

У каждого сотрудника мастерской свои настройки. Сотрудники получают оповещения, если у них есть доступ к заказам площадок, а у владельца действует тариф Web Team.

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

6. Товары

Вкладка «Маркетплейсы» → «Товары». Товар мастерской — одна карточка на изделие, общая для всех площадок.

Уже торгуете на Wildberries? Нажмите «Загрузить карточки с Wildberries». Портал заберёт карточки кабинета и свяжет их с вашими товарами по артикулу продавца. Остальные карточки заведёт новыми товарами. Уже заполненное в портале не перезаписывается. Карточки из корзины Wildberries получают статус «в архиве», карточки с ошибками создания — «отклонена» с текстом Wildberries. Главное фото для изделия склада копируется к нам. Что происходит со складом при загрузке, описано ниже в подразделе «Изделия на складе для новых карточек». Если вы сняли там галочку, свяжите загруженный товар с изделием склада в редакторе, иначе его остаток не выгружается.

Выставить новый товар:

1. Добавьте товар: из изделия склада, из модели или с нуля.
2. Нажмите «Выставить на Wildberries» и найдите предмет поиском.
3. Заполните характеристики предмета. Обязательные отмечены. Для части характеристик есть справочники: цвет, пол, страна производства, сезон, ставка НДС, ТН ВЭД.
4. Добавьте фото по ссылкам, до 30 штук. Новый набор фото заменяет старый.
5. Укажите габариты и вес, бренд и описание. Название — до 60 символов.
6. Штрихкод берётся из товара мастерской, а если его нет, его создаёт Wildberries.
7. Проверьте карточку и нажмите «Выставить».

Wildberries создаёт карточку не сразу. Портал ждёт, пока она появится, до нескольких минут, или покажет ошибку с текстом Wildberries.

Правка существующей карточки. Wildberries принимает карточку только целиком. Портал берёт текущую карточку с Wildberries и меняет в ней только те поля, которые вы изменили. Размеры и штрихкоды при этом сохраняются.

Поддерживаются карточки без размеров (с одним размером). Товары с несколькими размерами пока ведите в кабинете Wildberries.

Изделия на складе для новых карточек

При загрузке карточек («Загрузить карточки с Wildberries») есть галочка «Создать изделия на складе для новых карточек». Она включена по умолчанию. Для каждой новой карточки, у которой ещё нет связи со складом, портал создаёт изделие на складе готовой продукции. В него попадают:

• название и описание карточки;
• главное фото: оно скачивается к нам;
• цена;
• количество: столько, сколько осталось на Wildberries в момент загрузки.

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

Товар сразу связан с изделием, поэтому дальше остаток на Wildberries идёт со склада. Если тот же артикул есть на другой площадке, изделие будет тем же, дублей не появится. Если снять галочку, изделия не создаются, и товар нужно связать со складом в редакторе самому.

Выставить и следить за товаром со склада

На складе готовой продукции у изделия есть кнопка «Выставить на маркетплейс»: она открывает мастер выставления. Чтобы сделать товары для площадок сразу из нескольких изделий, нажмите «Создать товары для площадок». В колонке «Площадки» виден статус изделия по каждой площадке.

Панель «Подробнее» у изделия показывает:

• продажи по каналам;
• «хватит на N дней» или «пора допечатать»;
• где изделие выставлено;
• резерв;
• экономику одной штуки;
• кнопку «Допечатать».

7. Цены

У Wildberries цена задаётся парой: «цена до скидки» и «скидка в процентах». Портал сам переводит вашу цену (и «цену до скидки», если вы её задали) в такую пару. Скидка — целые проценты, округление в пользу продавца: итоговая цена может оказаться чуть выше желаемой, но не ниже.

У карточки на Wildberries видно:

• себестоимость (указанная у товара или из склада готовой продукции);
• комиссию Wildberries по предмету для модели FBS (Маркетплейс);
• логистику до покупателя: по тарифу коробов Wildberries в зависимости от объёма товара. Если склад не выбран, берётся самый дорогой тариф, чтобы цена-пол не вышла заниженной;
• логистику возврата (она показывается отдельно);
• налог, «к выплате» и прибыль с одной штуки;
• минимальную цену и рекомендованную (по наценке из настроек калькулятора).

Защита от ошибок:

• цену ниже минимальной выгрузить нельзя;
• изменение больше чем на 30% — только с подтверждением;
• без себестоимости защита не работает, портал об этом предупреждает.

«Пересчитать цены» меняет цены массово: по рекомендованной, на ±% или одной суммой. Сначала всегда показывается предпросмотр «было → станет».

Если цена резко снижена, Wildberries может поместить товар в ценовой карантин. Такой товар получит ошибку. Выйти из карантина можно только в кабинете Wildberries.

8. Остатки

Остатки уходят на ваш склад Wildberries (FBS), который вы выбрали в настройках подключения. У каждого товара выберите режим:

Если остаток не определён (товар не связан со складом, поле пустое), портал не трогает остаток на Wildberries. Ноль по ошибке не уйдёт. Если в ноль уходит сразу много товаров, портал попросит подтверждения.

Когда уходит остаток. Остаток выгружается по событию: примерно через 10–15 секунд после того, как изменилось количество изделия на складе (продажа, списание под заказ, правка, отмена). Если вы правите количество несколько раз подряд, всё уходит одной отправкой. Кроме того, раз в 5 минут и раз в сутки портал сверяет остатки на всякий случай. Защита от массового обнуления работает по-прежнему. У товаров с несколькими размерами остаток пока ведите в кабинете Wildberries.

9. Заказы

Заказы Wildberries — это сборочные задания. Они приходят в канбан. Статус заказа складывается из вашего этапа и этапа Wildberries.

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

Покупатель может сам отменить заказ в первый час: тогда заказ станет «Отменён».

Действия на Wildberries выполняются на странице заказа:

• сборка: портал добавляет задание в поставку. Он берёт открытую поставку «Портал ДД.ММ» (число и месяц) или создаёт новую;
• стикеры: PDF размером 58 на 40 мм;
• отмена заказа: указывается одна причина, комментарий Wildberries не принимает.

Все действия идут через очередь. Результат и понятная подсказка при ошибке видны в «Журнале».

Отгрузки. Во вкладке «Отгрузки» видны открытые поставки и переданные за последние 3 дня. Можно:

• создать поставку;
• передать поставку в доставку;
• скачать QR-код поставки (PDF);
• удалить пустую поставку.

Для продавцов из РФ Wildberries требует параметры отгрузки (пункт и способ). Если при передаче в доставку Wildberries вернёт ошибку, задайте эти параметры в кабинете Wildberries.

Таблицы с фильтрами и журнал

Вкладки раздела «Маркетплейсы» — «Товары», «Отгрузки», «Возвраты», «Финансы» и «Журнал» — теперь таблицы с фильтрами (площадка, статус, период, поиск) и сортировкой. В «Журнале» видно дату, время и того, кто внёс изменение. Нажмите на запись, и откроется, что именно изменилось.

10. Возвраты

Заявки покупателей на возврат видны в портале: статус и причина. Решение по заявке пока принимается в кабинете Wildberries.

Невыкупы приходят в портал статусом заказа «Отменён». Вернувшийся товар на склад автоматически не приходуется: сначала осмотрите его.

11. Финансы

Портал загружает еженедельный отчёт Wildberries о реализации. По каждому заданию видно:

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

Отдельно показываются хранение, штрафы и удержания, не привязанные к заказам. Эти данные попадают в прибыль заказа, и она считается по реальным цифрам.

Юнит-экономика. Во вкладке «Финансы» → «Юнит-экономика» по каждому товару за период видно: сколько продано и возвращено, выручку, удержания площадки по видам (комиссия, логистика, хранение, эквайринг, прочее), себестоимость, прибыль, маржу и прибыль на штуку. Убыточные товары подсвечены красным, таблицу можно скачать в CSV. Себестоимость берётся из карточки заказа, а если её нет — из товара мастерской или склада готовой продукции. Возврат товара возвращает его себестоимость. Начисления, которые площадка не относит ни к товару, ни к заказу, показаны отдельной строкой «Без привязки к товару» и входят в итог. Товар находится по артикулу продавца из отчёта, поэтому к нему попадает и хранение, если в строке отчёта указан артикул.

У Wildberries лимит: один запрос отчёта в минуту. Поэтому первая загрузка за 60 дней растягивается на несколько часов. Это нормально, данные подтягиваются по мере загрузки.

Рекламы в отчёте о реализации нет. Расходы на рекламу смотрите в кабинете Wildberries.

12. Что делается только в кабинете Wildberries

• Регистрация продавца и создание токена.
• Поставки на склад Wildberries (FBW).
• Акции и продвижение.
• Отзывы, вопросы и чаты (пока).
• Маркировка «Честный знак».
• Параметры отгрузки (пункт и способ).
• Карточки с размерами.
• Решение по заявкам на возврат.
• Выход из ценового карантина.

13. Частые ошибки

14. Безопасность

• Токен хранится в зашифрованном виде. В интерфейсе видны только его последние символы.
• Условия работы портала с кабинетом продавца — раздел 12 оферты: портал действует в кабинете только по вашей команде или по правилам, которые вы включили сами.
• Каждый вид записи на Wildberries выключен по умолчанию и включается отдельно в настройках подключения.
• Подключение можно поставить на паузу, и всё остановится.
• Права в мастерской: «Заказы площадок» — заказы и действия с ними; «Товары на площадках» — товары и карточки; «Финансы площадок» — выплаты и удержания.

15. Изменения

• 01.10.2026 — первая версия инструкции.
• 30.09.2026 — полный цикл: карточки, цены, остатки, сборка в поставки, стикеры, отгрузки, заявки на возврат, финансы. Работа сверена с официальными схемами API Wildberries, проверка на живом кабинете ещё впереди.
• 30.09.2026 — комиссия в калькуляторе («комиссия по категории») исправлена: теперь берётся комиссия модели FBS, а не модели «Витрина» или DBS.
• 30.09.2026 — связка склада и площадки, выгрузка остатков по событию, оповещения в Телеграм, таблицы с фильтрами.