Импорт товаров с Wildberries в Addshop

Если ваш каталог уже заведён на Wildberries, его можно перенести на сайт Addshop за один запуск. Addshop забирает карточки через API Wildberries: названия, описания, артикулы, фотографии, размеры и цены. Размеры становятся вариантами товара, а связь с Wildberries сохраняется — повторный импорт обновит цены и размеры, а остатки сайта можно отправлять на ваш склад Wildberries.

Вы можете создать интернет магазин за 1 вечер. Просто выберите готовый шаблон интернет магазина и установите его. Останется только наполнить его своими товарами.

Что понадобится

Кабинет продавца Wildberries с правом создавать токены API.
API токен с доступом к карточкам товаров (контент) и к ценам и скидкам.
Запас по лимиту товаров вашего тарифа Addshop: каждая карточка Wildberries станет отдельным товаром.
Время: большой каталог с фото импортируется несколько минут, не закрывайте страницу до результата.

Шаг 1. Создайте токен в кабинете Wildberries

В кабинете продавца Wildberries откройте раздел доступа к API (обычно он находится в настройках профиля). Создайте новый токен и отметьте категории доступа:

Контент — чтобы читать карточки товаров.
Цены и скидки — чтобы читать цены размеров.
Маркетплейс — понадобится, если вы хотите отправлять остатки сайта на свой склад Wildberries (FBS).

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

Шаг 2. Настройка и импорт в Addshop

Откройте Настройки → Интеграции и нажмите плитку «WB» в блоке торговых площадок. Откроется страница Wildberries импорт товаров.

Блок «Подключение и импорт»

API токен — вставьте токен Wildberries.

После успешного подключения под полем появятся имя продавца и его SID. Справа показаны:

Товаров в магазине — сколько товаров уже есть на сайте (включая выключенные, но не удалённые).
Лимит тарифа — сколько товаров разрешает тариф, или «без ограничения».

Что делать при повторном импорте

Заменять ранее импортированные товары — режим по умолчанию. Импортированные ранее карточки обновляются, новые создаются. Кроме того, если на сайте есть ровно один товар с таким же названием, ещё не связанный с Wildberries, импорт свяжет карточку с ним и обновит его, а не создаст копию.
Добавлять все товары как новые — каждая карточка создаётся новым товаром, даже если уже импортировалась. Получатся копии.

Нажмите Импортировать из Wildberries. Addshop проверит токен, сохранит его и начнёт импорт. Дождитесь результата, не обновляя страницу.

Результат импорта

Появится сообщение «Импорт Wildberries завершён» и блок «Результат импорта» с полями «Обработано товаров», «Создано», «Обновлено», «Добавлено как новые», «Пропущено из-за конфликтов», «Пропущено из-за ошибок» и список «Предупреждения» (первые 20, дальше — «И ещё … предупреждений»).

Что переносится и что нет

Переносится

Каждая карточка Wildberries — отдельный товар на сайте, новые товары сразу включены.
Название. Если у карточки его нет, товар назовётся «WB товар» и номер карточки.
Описание и краткое описание (первые 500 символов).
Артикул — артикул продавца на Wildberries. Если он уже занят другим товаром магазина, не записывается, а в предупреждениях будет «Артикул … уже занят в магазине, поэтому не был записан в товар».
Размеры — отдельными вариантами. Название размера берётся из размера Wildberries. Если такого размера ещё нет в справочнике Размеры, он создаётся сам.
Цена каждого размера — цена со скидкой продавца, а если её нет — базовая цена. Основным вариантом становится самый дешёвый размер.
Фотографии карточки — скачиваются и сохраняются на сайте.

Не переносится

Категории. Импорт не создаёт категорий и не раскладывает по ним товары — распределите их сами в Каталоге.
Цвета и цветовые галереи. Разные цвета на Wildberries — это разные карточки, на сайте они станут разными товарами.
Характеристики карточки.
Остатки. Варианты создаются с отметкой «без ограничения». Если ведёте учёт количества, снимите отметку и укажите остатки.
Размеры без названия, без номера или без цены пропускаются — в предупреждениях будет «Товар … импортируется не полностью: пропущено предложений — N».
Скидки и акции Wildberries для покупателей, кроме цены со скидкой продавца.

Повторный импорт

Addshop запоминает связь товара сайта с карточкой Wildberries по номеру карточки (nmID), а связь каждого варианта — с размером Wildberries. В режиме «Заменять ранее импортированные товары» повторный импорт:

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

Категорию, видимость, SEO-поля и прочие настройки товара повторный импорт не меняет.

Когда товар пропускается

Импорт осторожен с товарами, которые вы правили вручную, чтобы ничего не испортить:

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

Лимит товаров тарифа

Перед записью Addshop считает, сколько новых товаров добавит импорт. Если вместе с уже имеющимися получится больше лимита тарифа, импорт не выполняется совсем — ничего не создаётся и не обновляется. Появится сообщение «Внимание! Импорт добавит N новых товаров, а текущий лимит вашего тарифа — M. Смените тарифный план на более высокий» со ссылкой на тарифы. Обновление уже связанных товаров лимит не расходует.

Остатки на склад Wildberries

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

Как проверить

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

Частые проблемы и решения

«Укажите API токен Wildberries»

Поле токена пустое. Вставьте токен.

«Срок действия токена Wildberries уже истёк»

Токен просрочен. Создайте новый в кабинете Wildberries и вставьте его.

«Wildberries вернул HTTP 401» или «Wildberries вернул HTTP 403»

Токен неверный или у него нет нужных категорий доступа (контент, цены и скидки). Создайте токен с нужными правами.

«Не удалось выполнить запрос к Wildberries», «Wildberries вернул неожиданный ответ» или «неполный курсор пагинации карточек»

Временный сбой на стороне Wildberries или связи. Повторите импорт через несколько минут.

«Товар … пропущен: в Wildberries пришли повторяющиеся названия размеров»

В карточке два размера с одинаковым названием. Исправьте размеры на Wildberries и повторите импорт.

«Товар … пропущен: Wildberries не вернул ни одного импортируемого предложения с ценой»

У размеров карточки нет цены. Установите цены на Wildberries.

«Внимание! Импорт добавит … новых товаров, а текущий лимит вашего тарифа — …»

Не хватает лимита тарифа. Смените тариф или удалите лишние товары.

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

Часть фото не скачалась. Повторите импорт позже — фото подтянутся.

Вопросы и ответы

Импорт удаляет товары, которых больше нет на Wildberries?

Нет, товары остаются на сайте. Удаляются только варианты размеров, пропавшие из карточки, которая по-прежнему есть на Wildberries.

Сохранятся ли остатки, которые я указал после первого импорта?

Да, у связанных вариантов повторный импорт меняет цену и размер, а количество не трогает.

Можно ли объединить разные цвета в один товар?

Импорт этого не делает. Объединить цвета можно только вручную, но тогда у товара появятся ручные варианты, и повторный импорт будет его пропускать.

Импорт работает по расписанию?

Нет, импорт запускается только кнопкой. По расписанию отправляются лишь остатки на склад Wildberries — когда на странице «Остатки на Wildberries» включена отметка «Выгружать остатки после каждого заказа на сайте».

Чем импорт с Wildberries отличается от импорта с Ozon?

С Wildberries переносятся размеры отдельными вариантами и работает сопоставление по названию. С Ozon каждая позиция — товар с одним вариантом, а сопоставления по названию нет. Подробнее — в статье Импорт товаров с Ozon.