Импорт переносит в МаркетПро накопленные отзывы покупателей и данные карточек товаров из кабинета продавца Wildberries. С его помощью можно наполнить новый каталог или поддерживать выбранные сведения о товарах в актуальном состоянии.

Управление импортом находится в ASTDESIGN → МаркетПро → Импорт с Wildberries. Для настройки нужны права на изменение настроек сайта и API-токены кабинета продавца Wildberries.

Что импортируется

Из отзывов переносятся:

• оценка, комментарий, достоинства и недостатки;

• имя покупателя и дата отзыва;

• фотографии;

• ссылка на видео и его обложку;

• ответ представителя магазина.

Отзывы сохраняются в том же инфоблоке, что и отзывы, оставленные на сайте. Опубликованные отзывы выводятся в карточке товара и участвуют в расчёте его рейтинга.

Из карточек товаров переносятся:

• название и описание;

• фотографии и ссылка на видео;

• бренд;

• габариты и вес;

• характеристики товара.

Импорт карточек не изменяет цены и остатки. Их можно загрузить отдельно из файла XLSX на вкладке Цены и остатки из файла.

Настройка импорта

Создать токены Wildberries

В кабинете продавца Wildberries откройте Профиль → Интеграции по API и нажмите Создать токен. Актуальная инструкция по работе с токенами опубликована в базе знаний WB API.

Создайте отдельный токен с категорией Вопросы и отзывы для импорта отзывов и отдельный токен с категорией Контент для импорта карточек товаров. Импорту достаточно доступа только на чтение.

Настроить импорт отзывов

Откройте ASTDESIGN → МаркетПро → Импорт с Wildberries, затем перейдите на вкладку Настройки.

В блоке Правила импорта отзывов вставьте токен в поле Токен раздела «Вопросы и отзывы» и включите Импортировать отзывы.

Задайте правила отбора и публикации:

• Публиковать отзывы сразу — новые отзывы становятся активными и появляются на сайте. По умолчанию настройка выключена: импортированные отзывы нужно проверить и опубликовать вручную в разделе Контент → astdesign.marketpro: Каталог → Отзывы о товарах → Элементы.

• Минимальная оценка — отзывы с меньшей оценкой не импортируются.

• Импортировать отзывы с даты — ограничивает начальную дату загрузки. Оставьте поле пустым, чтобы перенести все доступные отзывы.

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

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

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

Подробнее о проверке и публикации отзывов читайте в статье Отзывы.

Настроить импорт товаров

В блоке Правила импорта товаров вставьте токен в поле Токен раздела «Контент».

Выберите, что разрешено делать импорту:

• Создавать новые товары — добавлять в каталог карточки Wildberries, для которых товар на сайте не найден;

• Обновлять существующие товары — переносить изменения в уже созданные товары.

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

Если включено создание товаров, в поле Раздел для новых товаров начните вводить название и выберите раздел каталога. Все новые товары будут добавлены в него.

Публиковать новые товары сразу — новые товары становятся активными после создания. По умолчанию настройка выключена, поэтому перед публикацией можно проверить описание, цену, остаток и раздел товара.

В наборах Заполнять при создании товара и Обновлять при изменении карточки отметьте данные, которые разрешено переносить: название, описание, фотографии, габариты и вес, бренд, характеристики. Если снять отметку, импорт не будет заполнять или перезаписывать соответствующее поле.

Ссылка на видео сохраняется независимо от этих наборов. Сам видеофайл на сайт не загружается. Если у товара заполнено собственное свойство Видео со ссылкой на YouTube или RuTube, на витрине показывается оно. Видео Wildberries используется, только когда собственного видео нет; обложкой служит главное фото товара.

Настроить связь товаров по артикулу

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

Артикул продавца — это значение vendorCode из карточки Wildberries. Не путайте его с артикулом WB, или nmID: это разные значения.

Сначала решение ищет товар по артикулу продавца. После первой связи оно сохраняет nmID в служебном свойстве Номенклатура Wildberries и в дальнейшем может найти товар по нему. У существующего товара импорт не перезаписывает артикул продавца. У нового товара он записывается в свойство, код которого указан в настройках.

Настроить импорт характеристик

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

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

Сопоставление поддерживает строковые, числовые свойства и свойства типа «Список». Для списочного свойства импорт может создать новое значение. Файлы, привязки к элементам и разделам, свойства с пользовательским типом, а также служебные свойства AST_ и CML2_ не используются для сопоставления.

Если подходящего свойства нет, решение создаёт отдельное свойство WBIMP_.

После выбора всех правил нажмите Сохранить.

Проверка и запуск

Перейдите на вкладку Состояние и нажмите Проверить подключение отдельно в блоках отзывов и товаров. При правильном токене появится сообщение Подключение работает.

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

Нажмите Запустить импорт, чтобы начать загрузку. После ручного запуска импорт продолжит работать автоматически по расписанию.

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

Токены действуют ограниченное время. За две недели до окончания срока дата выделяется красным. Создайте новый токен с той же категорией, замените его на вкладке Настройки и снова нажмите Проверить подключение.

Вкладка Журнал содержит историю запусков, счётчики созданных, обновлённых и пропущенных записей, а также подробный лог.

Цены и остатки из файла

Цены и остатки не загружаются из API вместе с карточками товаров. Для них подготовьте отдельный файл XLSX.

Откройте вкладку Цены и остатки из файла.

Скачайте подходящий файл-пример по ссылке с ценами или с остатками. В первой колонке укажите артикул продавца, во второй — цену или остаток. Первая строка считается заголовком и не обрабатывается.

В поле Что загружаем выберите Цены или Остатки, приложите заполненный файл и нажмите Запустить.

Не закрывайте вкладку до завершения импорта. Ход обработки и найденные ошибки отображаются на странице.

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

Если импорт не работает

Wildberries не принял токен

Причина: токен истёк, был удалён или создан без нужной категории доступа.

Решение: создайте новый токен с категорией Вопросы и отзывы или Контент, замените его в настройках и нажмите Проверить подключение.

Импорт запущен, но товар или отзыв не появился

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

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

Следующий запуск отложен

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

Решение: посмотрите время следующей проверки и паузу на вкладке Состояние. Решение повторит запрос автоматически. Не запускайте импорт многократно во время указанной паузы.

После успешного запуска проверьте созданные товары в каталоге и импортированные отзывы в инфоблоке Отзывы о товарах. Если автоматическая публикация выключена, опубликуйте проверенные отзывы и товары — после этого они появятся на сайте.