Публикация на Wildberries через Content API

Cardix публикует карточки на Wildberries через Content API — сохранение с публикацией сразу отправляет карточку в WB, а Cardix в фоне опрашивает статус, пока площадка не присвоит карточке номенклатурный номер (nmID).

Что нужно в кабинете Wildberries

  1. Войдите в личный кабинет продавца Wildberries.
  2. Откройте Настройки → Доступ к API → Создать новый токен.
  3. Скопируйте токен — он показывается один раз.

Подключение в Cardix

На странице Настройки → Маркетплейсы карточка «Wildberries» (wildberries.ru — синхронизация товаров, статистика) показывает кнопку «Подключить WB». В отличие от Авито и Ozon, для Wildberries нужен только один секрет — поля Client ID в форме нет, только API-токен.

Кнопка «↻ Синхронизировать» проверяет токен без сохранения; «Подключить» сохраняет его и сразу синхронизирует существующие товары.

Подключение Wildberries

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

Публикация карточки по шагам

На карточке товара, в блоке «Маркетплейсы», у плитки «Wildberries» нажмите «Создать объявление» (или «Связать с существующим», если карточка на WB уже есть) — откроется страница «Листинг Wildberries», собранная из тех же компонентов формы, что и публикация на Ozon/Авито. Черновик открывается сразу этой формой оформления — без промежуточного экрана.

  1. Заполните Название (до 100 символов), Бренд и Описание (от 1000 до 5000 символов — счётчик под полем меняет цвет с красного на зелёный по мере набора нужной длины); по умолчанию описание подставляется из обзора Cardix или из описания, уже засинканного с WB (если карточка ранее синхронизировалась).
  2. В блоке «Фото» выберите до 30 изображений из галереи товара (клик переключает выбор, порядок клика = порядок фото на WB); на плитках доступны AI-кнопки «✨» (замена фона) и «⚡» (инфографика из этого фото). Выбранные фото загружаются в WB отдельным запросом сразу после того, как площадка присвоит карточке nmID.
  3. Раскрывающийся блок «Цены с рынка» показывает диапазон и медиану найденных цен конкурентов — клик по столбцу гистограммы или по медиане подставляет значение в поле цены.
  4. В поле «Предмет» введите название категории товара (например, «Смартфоны») — Cardix ищет совпадения в номенклатуре WB по мере ввода (от двух символов) и покажет список вариантов. Выбор предмета подгружает его характеристики и определяет, нужна ли товару таблица размеров.
  5. Нажмите «✨ Заполнить через AI» — модель заполнит бренд, название, описание и характеристики предмета. Если предмет ещё не выбран, AI подберёт его сама.
  6. Заполните обязательные характеристики предмета — для многозначных полей подсказка «Через запятую».
  7. Если у предмета есть размеры (одежда, обувь), появится таблица «Размеры»: размер продавца, российский размер и цена по каждой строке; кнопка «+ Добавить размер» добавляет новую строку.
  8. Нажмите «Сохранить черновик» или «Опубликовать» — публикация загружает карточку в WB Content API, а Cardix ставит фоновую задачу проверки статуса.

Форма публикации на WB

Статусы и ошибки

Статус показан плашкой рядом с заголовком страницы: Черновик, ⏳ Ожидаем WB…, ✓ Опубликовано, ✗ Ошибка. Обновление приходит в реальном времени без перезагрузки страницы — как только WB подтверждает карточку и присваивает ей nmID, он появляется рядом со статусом. Держать вкладку открытой не обязательно — прогресс сохраняется и восстановится при следующем визите.

Если WB отклонил карточку, под заголовком появляется точный текст ошибки от площадки («WB вернул ошибку: …»).

Черновик можно удалить через меню «⋯» в шапке формы → «Удалить черновик»; если публикация уже отправлена (статус «⏳ Ожидаем WB…»), Cardix предупредит, что карточка всё равно может появиться на площадке при следующей синхронизации.

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

Что такое «предмет» и почему он обязателен? Это категория товара в номенклатуре Wildberries — от неё зависят доступные характеристики и наличие таблицы размеров, без предмета карточку сохранить нельзя.

Почему кнопка «Опубликовать» неактивна? Проверьте, что выбран предмет и заполнены обязательные поля — в частности, описание должно быть не короче 1000 символов.

Что такое nmID? Внутренний номенклатурный номер карточки в Wildberries, который площадка присваивает после успешной публикации — до этого момента карточка числится в статусе ожидания.

Нужно ли создавать карточку в Cardix, если товар уже есть на WB? Нет, используйте «Связать с существующим» в блоке «Маркетплейсы» или «↻ Синхронизировать» в настройках интеграции.

Смотрите также