WILDBERRIES Импорт товаров

ВСЕ ВОПРОСЫ ПО ПРИЛОЖЕНИЮ ЕГО ВНЕДРЕНИЮ И ТЕХНИЧЕСКОЙ ПОДДЕРЖКЕ ПРИНИМАЮТСЯ ПО EMAIL: SUP@PRIMELABS.RU И В ТЕЛЕГРАММ БОТЕ @primelabs_bot

Техподдержка работает пн-пт с 9:00 до 18:00, с перерывом на обед с 13:00 до 14:00.
Все запросы обрабатываются в порядке очереди

Установка и настройка WILDBERRIES Импорт товаров

WILDBERRIES Импорт товаров загружает товары, торговые предложения, характеристики, фотографии, цены и остатки из личного кабинета Wildberries в товарный каталог Битрикс24. Приложение не изменяет данные в Wildberries.

1. Установите приложение в Битрикс24

Установите WILDBERRIES Импорт товаров из Маркетплейс Битрикс24 и предоставьте приложению запрошенные права доступа.

После установки откройте приложение. На вкладке «Настройки» выберите существующий личный кабинет Wildberries или нажмите кнопку "+", чтобы добавить новый.

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

2. Получите API-токен Wildberries

В личном кабинете WB Партнёры откройте раздел Интеграции по API и нажмите Создать токен.

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

- Контент — получение карточек товаров, категорий и характеристик;
- Цены и скидки — получение цен товаров;
- Маркетплейс — получение складов продавца и остатков.

Для импорта достаточно уровня доступа Только чтение. Скопируйте токен и сохраните его в надёжном месте. Порядок создания и типы токенов описаны в официальной документации Wildberries.

3. Подключите личный кабинет Wildberries

В приложении откройте вкладку Настройки и в блоке Seller API введите API-токен Wildberries.

Сохраните настройки. Приложение проверит доступ к сведениям о продавце, категориям, ценам и складам. Название магазина определяется автоматически — вводить его отдельно не нужно.

Если используется несколько личных кабинетов, добавьте каждый кабинет кнопкой "+" и укажите собственный токен.

При повторном сохранении оставьте поле токена пустым, если не хотите менять уже сохранённый токен.

4. Выберите каталог и категории

В блоке Каталог и категории:

1. Выберите товарный каталог Битрикс24, в который будут загружаться товары.
2. При необходимости выберите корневой раздел.
3. Отметьте категории Wildberries, участвующие в импорте, либо включите Импортировать все категории.
4. Включите Создавать дерево категорий Wildberries, если нужно повторить структуру категорий в разделах Битрикс24.
5. При необходимости включите Загружать и деактивировать архивные товары. Карточки из корзины Wildberries будут импортироваться как неактивные.

Выберите режим создания товаров:

- Автоматически по свойству объединения — используется поле Объединить на одной карточке (skuCode, значение imtID Wildberries), сопоставленное со свойством основного товара. Первая позиция создаётся простым товаром; при появлении другой позиции с тем же значением формируется основной товар с торговыми предложениями.
- Все как торговые предложения — все импортируемые позиции создаются как торговые предложения.
- Все как простые товары — каждая позиция создаётся отдельным простым товаром.

Для автоматического объединения сопоставьте skuCode со свойством основного товара на вкладке Сопоставления. При включённом автосоздании свойств приложение может создать это свойство и сопоставление автоматически.

5. Настройте поля и характеристики

На вкладке Сопоставления укажите, в какие поля и свойства Битрикс24 должны записываться данные Wildberries.

Доступны артикул продавца (vendorCode), артикул Wildberries (nmID), название, описание, бренд, фотографии, штрихкоды, габариты, вес и характеристики.

- Общие сопоставления действуют для всего каталога.
- Настройки конкретного раздела переопределяют общие.
- Для характеристик используется код `attribute.ID`.
- Параметр «Стандартные сопоставления» позволяет применять штатные соответствия, если ручные не заданы.
- При включённом автосоздании свойств приложение создаёт недостающие свойства для несопоставленных характеристик Wildberries.
- Для товаров с торговыми предложениями можно выбрать создание таких свойств в основном товаре.

На вкладке «Значения» настройте соответствия значений Битрикс24 и Wildberries. Поиск работает по мере набора. При выборе значения Битрикс24 справа отображается сохранённое соответствие. Для строкового свойства новое значение можно ввести и добавить кнопкой "+".

6. Настройте цены и остатки

В блоке Поля, цены и остатки:

1. Включите Обновлять цены.
2. Выберите тип цены Битрикс24 и валюту.
3. Включите Обновлять остатки по складам, если нужно импортировать остатки.

Для цен доступны два источника:

- price — цена Wildberries до скидки;
- discountedPrice — цена после скидки.

При стандартном сопоставлении в выбранный тип цены Битрикс24 записывается price. Для использования другого источника задайте явное сопоставление.

В блоке Склады отметьте используемые склады продавца Wildberries и сопоставьте каждый со складом Битрикс24.

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

7. Настройте исключения

На вкладке «Исключения» можно запретить импорт отдельных позиций:

- укажите артикулы продавца vendorCode, по одному в строке;
- укажите исключаемые бренды, по одному в строке.

8. Включите импорт

Вернитесь на вкладку Настройки, включите параметр Импорт товаров и сохраните изменения.

При необходимости настройте количество товаров за запрос, шаг импорта и интервал повторного запуска.

Обработка выполняется фоновыми задачами сервиса. Приложение последовательно:

1. получает карточки, характеристики, цены и остатки из Wildberries;
2. сравнивает данные с последним сохранённым состоянием;
3. ставит новые и изменившиеся позиции в очередь;
4. создаёт или обновляет товары и торговые предложения в Битрикс24.

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

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