# Импорт с Wildberries

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

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

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

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

* оценка, комментарий, достоинства и недостатки;
* имя покупателя и дата отзыва;
* фотографии;
* ссылка на видео и его обложку;
* ответ представителя магазина.

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

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

* название и описание;
* фотографии и ссылка на видео;
* бренд;
* габариты и вес;
* характеристики товара.

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

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

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

В кабинете продавца Wildberries откройте **Профиль → Интеграции по API** и нажмите **Создать токен**. Актуальная инструкция по работе с токенами опубликована в [базе знаний WB API](https://dev.wildberries.ru/knowledge-base/articles/019d49a0-f9f7-79a4-b5ee-df5dabe9cff4).

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


:::info
**Не передавайте токены посторонним.** Они открывают доступ к данным вашего кабинета продавца. Если токен стал известен третьим лицам, удалите его в кабинете Wildberries и создайте новый.

:::

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

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

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

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

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

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

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

Подробнее о проверке и публикации отзывов читайте в статье [Отзывы](/s/marketpro/doc/otzyvy-6O3Wco6CQI).

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

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

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

* **Создавать новые товары** — добавлять в каталог карточки Wildberries, для которых товар на сайте не найден;
* **Обновлять существующие товары** — переносить изменения в уже созданные товары.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 ![](https://docs.astdesign.ru/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzQ0Yjc4ZmY0LTFiMDYtNDFhOS04MmMyLWYzMjdmNDVhZWIwOS9jN2NiMDY4MC0xMDhjLTQ2MzctYjAzYi1lYzFiZDE3YTBhMjgvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTMyNjM1MDAsImV4cCI6MTc5MzM0OTkwMH0.4ERWpN0zcKxcrd2ORi4l6dy_f2aIjQDecITL1eeiji0 " =1376x1136")

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

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

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

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

 ![](https://docs.astdesign.ru/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzQ0Yjc4ZmY0LTFiMDYtNDFhOS04MmMyLWYzMjdmNDVhZWIwOS82YWQ4ZWI5My0wOWYwLTRjZTQtYjJkMC0yMzFhYzgyZWEwNzQvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTMyNjM1MDAsImV4cCI6MTc5MzM0OTkwMH0.h1j9YagIuGL_NiSwWEkGQnN2Dk_vRwJaIsZpfhvZmGo " =1143x596")

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

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

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

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

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

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

 ![](https://docs.astdesign.ru/api/files.get?sig=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJrZXkiOiJ1cGxvYWRzLzQ0Yjc4ZmY0LTFiMDYtNDFhOS04MmMyLWYzMjdmNDVhZWIwOS9jOWQ3OTc5ZC01YzcwLTRiYjYtYmZhYy0xY2VlMjg0ZTIyNjIvaW1hZ2UucG5nIiwidHlwZSI6ImF0dGFjaG1lbnQiLCJpYXQiOjE3OTMyNjM1MDAsImV4cCI6MTc5MzM0OTkwMH0.WmofAoxUSSCl7rh9kxAtaKqtq51drV7-thpIvJaNwXo " =799x477")

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

**Documents**

- [Установка решения](https://docs.astdesign.ru/s/marketpro/doc/ustanovka-resheniya-Z8Q6r79liU)
- [FAQ перед покупкой](https://docs.astdesign.ru/s/marketpro/doc/faq-pered-pokupkoj-HPgKP7mWDT)
- [Общая настройка](https://docs.astdesign.ru/s/marketpro/doc/obshaya-nastrojka-Io6HZQaGXf)
- [Шаблон](https://docs.astdesign.ru/s/marketpro/doc/shablon-ylLAFZV3o8)
- [Главная страница](https://docs.astdesign.ru/s/marketpro/doc/glavnaya-stranica-7PwYozaVVo)
- [Магазины (склады)](https://docs.astdesign.ru/s/marketpro/doc/magaziny-sklady-7rEEZJrA45)
- [Каталог](https://docs.astdesign.ru/s/marketpro/doc/katalog-FpnYzZr900)
- [Поиск](https://docs.astdesign.ru/s/marketpro/doc/poisk-xsDdFVh5h0)
- [Текстовые страницы](https://docs.astdesign.ru/s/marketpro/doc/tekstovye-stranicy-jVtNXZv3T5)
- [Реклама и маркетинг](https://docs.astdesign.ru/s/marketpro/doc/reklama-i-marketing-iZkaCoxr5b)
- [Региональность](https://docs.astdesign.ru/s/marketpro/doc/regionalnost-bCuM9AOBNO)
- [Корзина](https://docs.astdesign.ru/s/marketpro/doc/korzina-Mh27pZA7v9)
- [Оформление заказа](https://docs.astdesign.ru/s/marketpro/doc/oformlenie-zakaza-VyvQjOQxZo)
- [Авторизация](https://docs.astdesign.ru/s/marketpro/doc/avtorizaciya-5HwEb1oDJG)
- [SEO и аналитика](https://docs.astdesign.ru/s/marketpro/doc/seo-i-analitika-d1Hw6c4YAM)
- [Уведомления](https://docs.astdesign.ru/s/marketpro/doc/uvedomleniya-SKDyjYg14J)
- [Мобильное приложение](https://docs.astdesign.ru/s/marketpro/doc/mobilnoe-prilozhenie-F5E0hT7TnN)
- [Обновление решения](https://docs.astdesign.ru/s/marketpro/doc/obnovlenie-resheniya-RRRgtxV5uH)
- [Для разработчика](https://docs.astdesign.ru/s/marketpro/doc/dlya-razrabotchika-WJePeJCmpy)
- [Интеграции](https://docs.astdesign.ru/s/marketpro/doc/integracii-D3DqjYOZYm)
- [Что делать, если что-то не работает](https://docs.astdesign.ru/s/marketpro/doc/chto-delat-esli-chto-to-ne-rabotaet-Q8L8sTVJF8)