Как вам помочь ?
Настройка интеграции с Wildberries

В данной инструкции рассмотрим настройку интеграции между AdvantShop и Wildberries.
Данная интеграция позволит Вам получать и обрабатывать заказы из Wildberries из интернет-магазина, выгружать товары из интернет-магазина в Wildberries, обновлять цены и остатки на Wildberries, а также синхронизировать товары.
Внимание!
Актуальный модуль, поддерживающий работу с карточками товаров, доступен с версии 12.0.0 и выше. Если Ваш магазин версией ниже, обновите его до актуальной версии до настройки модуля.
На более низких версиях модуль поддерживает работу только по старому формату API (выгрузка заказов; остатков по уже имеющимся в модуле товарам), большая часть методов которого уже недоступны.
Подробнее о Wildberries
Wildberries - один из крупнейших маркетплейсов в России с самой широкой сетью ПВЗ. На этой площадке Вы можете заказать товары с доставкой.
Зарегистрироваться Вы можете по ссылке https://seller.wildberries.ru/
Подробнее информацию о регистрации можете посмотреть в видеоролике ниже, а также прочитать информацию в статье.
Настройки
Для настройки интеграции нужно перейти в административной панели интернет магазина в меню "Модули", вкладка "Магазин модулей", найти модуль "Wildberries Pro", нажать "Установить" (рис.1);

Рисунок 1.
После установки нажмите на кнопку "Wildberries Pro" (рис.2):

Рисунок 2.
После подключения нужно произвести настройку модуля. Для этого нужно перейдите к настройкам модуля "Wildberries Pro" и указать API-токен в соотвествующем в поле (рис.3):

Рисунок 3.
Получить API-токен нужно в личном кабинете продавца Wildberries. Перейдите в кабинет, откройте выпадающее меню профиля и выберите "Интеграции по API" (рис.4).

Рисунок 4.
На открывшейся странице, нажмите "Создать токен" (рис.5).

Рисунок 5.
Во всплывающем окне выберите токен для ручной интеграции типа "Персональный" (рис.6, п.2), категории: "Контент", "Маркетплейс", "Цены и скидки"(рис. 6, п.3). Убедитесь, что токен имеет возможность чтения и записи (рис.6, п.4).

Рисунок 6.
После завершения процесса создания необходимого токена, выбора категорий для него, вы получите сам токен. Скопируйте его (рис.7).

Рисунок 7.
Скопированный токен теперь мы можем указать в поле API-токен нашего модуля.
Работа с каталогом
Вы впервые будете выгружать каталог в Wildberries
Каталог товаров
Для начала работы с каталогом необходимо добавить категорию товаров из WB или загрузить полный список корневых категорий (рис.8):

Рисунок 8.
Загруженные категории появятся в виде списка в левой части страницы (рис.9)

Рисунок 9.
В случае с Wildberries, Вы не загружаете свою категорию на Wildberries, а привязываете товары к заранее подготовленным маркетплейсом категориям.
Товары можно добавлять только в категории нижнего уровня. Для этого нужно выбрать последнюю категорию во вложенности (рис.10):

Рисунок 10.
Чтобы отобрать товары из каталога магазина в категорию, нажмите на кнопку "Добавить товары" (рис.11)

Рисунок 11.
Далее откроется окно, где Вы сможете выбрать товары из интернет магазина, которые должны быть связаны с категорией из Wildberries (рис.12):

Рисунок 12.
- Выбираете категорию товаров магазина;
- Выбираете товары, которые нужно добавить в модуль.
После выделения всех товаров, которые нужно добавить в модуль, нажмите на кнопку "Выбрать".
После добавления товаров в модуль, они появятся в списке (рис.13) и у них отобразится цветной индикатор готовности к выгрузке на Wildberries.

Рисунок 13.
Если индикатор красный, то по клику на знак "?" Вы можете увидеть, что нужно исправить в карточке товара, чтобы он был готов к выгрузке (рис. 14).

Рисунок 14.
Подробная информация о статусах готовности выгрузки товара можете посмотреть на вкладке "Легенда" (рис.15):

Рисунок 15.
После наполнения категорий товарами можно переходить к настройкам характеристик.
Характеристики
При работе с Wildberries наибольший объем работы с модулем составляет работа с характеристиками. Сложность в том, чтобы связать характеристики товара из интернет магазина с характеристиками из Wildberries и задать им правильные значения.
Чтобы приступить к работе с характеристиками, переключитесь на вкладку модуля "Характеристики".
Для каждой категории набор доступных характеристик будет своим. В списке категорий найдите ту, в которую добавляли товары, нажмите на кнопку “Загрузить характеристики товаров” (рис.16, 17):

Рисунок 16.

Рисунок 17.
Загрузятся характеристики из Wildberries для выбранной ранее категории (рис.18):

Рисунок 18.
Обязательные характеристики для текущей категории выводятся первыми и выделены жирным шрифтом. Их необходимо привязать к соответствующим свойствам магазина. Чтобы это сделать необходимо нажать на знак карандаш "🖉", откроется дополнительное окно (рис. 19).

Рисунок 19.
Здесь можно связать свойство магазина и характеристику из маркетплейса.
Чтобы свойство было доступно в выпадающем списке, его нужно предварительно создать - Создание свойства и групп свойств.
Заметка
Если Вы столкнулись с необходимостью массово заполнить свойства у товаров для связки с характеристиками Wildberries, то сделать это массово можно через экспорт/импорт в формате CSV.
Необязательные характеристики также привязываются к свойствам, если планируется их выгрузка.
Часть характеристик требует указания значений строго из определенного списка. У таких характеристик после связки со свойством появляется кнопка для загрузки списка значений (рис.20):

Рисунок 20.
После выгрузки значений, у характеристики появится кнопка для просмотра списка допустимых значений (рис.21).

Рисунок 21.
Значения свойств на сайте для корректной выгрузки должны соответствовать справочнику WB.
Важно
Некоторые характеристики могут использоваться сразу в нескольких категориях. К таким относятся, например, "Бренд", "Пол" и другие. Их нужно сопоставить только в одной категории, в остальных сопоставление сохранится. Соответственно, для таких характеристик нужно использовать и единое свойство на сайте.
Важно
При импорте характеристик из справочника Wildberries некоторые характеристики уже имеют сопоставления по умолчанию. Если сопоставление по умолчанию не проставлено, рекомендуется использовать свойство. Массово загрузить свойства и другие параметры товаров можно через экспорт/импорт в формате CSV.
Далее рассмотрим сопоставление цветов и размеров в разделе "Характеристики". Напомним, что в AdvantShop вариации товаров задаются через цвет и размер. В связи с этим возникает необходимость связать между собой цвета и размеры со значениями из Wildberries.
Для сопоставления справочников AdvantShop и Wildberries в разделе "Характеристики" нужно переключиться на вкладку "Сопоставление цветов" и нажать на "Загрузить справочник цветов" (рис.22).

Рисунок 22.
После импорта справочника нужно нажать на значок карандаша у сопоставляемого цвета (рис.23).

Рисунок 23.
И выбрать подходящий для него цвет из справочника Wildberries (рис.24).

Рисунок 24.
Аналогичным образом сопоставляется справочник размеров AdvantShop и Wildberries.
На основе данного сопоставления будут выгружаться модификации товаров из AdvantShop в Wildberries.
На этом настройка данной вкладки завершена.
Цены и остатки
Для настройки выгрузки цен и остатков в модуле "Интеграция с Wildberries" необходимо перейти в раздел "Цены и остатки", секция "Обновление цен" (рис.25):

Рисунок 25.
Выгружать цены/остатки по расписанию - опция позволит обновлять цены и остатки автоматически. При активации появляется возможность установки Интеравла запуска и Времени запуска.
Прибавлять к цене комиссию WB - опция позволяет прибавлять комиссию Wildberries к стоимости товара, при активации отображаются дополнительные настройки "Часть комиссии" и "Модель отгрузки" (рис.26).

Рисунок 26.
Готово. Настройки данного раздела рассмотрены.
Выгрузка товаров
После связки обязательных и дополнительных (опционально) характеристик, настройки выгрузки цен и остатков, можно приступать к непосредственной выгрузке товаров на маркетплейс.
Выгрузить товары в Wildberries можно, нажав на кнопку "Выгрузить каталог товаров" (рис.27, п.1). Также, если у Ваших товаров в AdvantShop отсутствуют штрихкоды у модификаций, то модуль может их сгенерировать самостоятельно, используя функционал кабинета Wildberries. Для этого нужно нажать на кнопку "Сгенерировать штрих-коды для WB" (рис.27, п.2).

Рисунок 27.
Внимание!
После выгрузки товара, он проходит сначала автоматическую, потом ручную модерацию на стороне Wildberries. Скорость прохождения модерации не зависит от работы модуля и контролируется маркетплейсом. Статус прохождения модерации обозначается цветом в соответствии с легендой; у прошедших модерацию товаров цветовой индикатор отсутствует.
Увидеть наиболее актуальный статус товара, а также полное сообщение о выявленных при модерации ошибках можно в кабинете продавца.
Внимание!
Если у Вас обновление цен и остатков осуществляется вручную (рис. 23), то при прохождении модерации товара на стороне Wildberries Вам необходимо будет обновить цены и остатки вручную, так как остатки и цены обновляются по товарам, которые прошли модерацию.
Готово. Настройка каталога завершена.
Выгрузка заказов
Параметры выгрузки
Выгрузка заказов в модуле производится на вкладке "Заказы" (рис.28):

Рисунок 28.
Кнопка загрузки - доступны три варианта загрузки заказов: загрузка заказов статусов, загрузка новых заказов, загрузка доставок и отмен.
Загрузка заказов
Далее Вам нужно настроить опции загрузки заказов (рис.29):

Рисунок 29.
Источник заказа при загрузке - источник, который будет проставляться заказам из Wildberries.
Привязывать заказы к покупателю - опция позволяет выбрать пользователя, к которому будут привязываться заказы из Wildberries.
Создавать нового покупателя - если покупатель не выбран, можно включить опцию для создания нового покупателя с каждым заказом.
Загружать номер отправления - номер заказа из можно записывать в одно из полей: в номер заказа или в имя покупателя.
Записывать заказ с датой и временем - записать дату заказа из Wildberries можно в одном из вариантов: с датой и временем размещения заказа покупателем на Wildberries или с датой и временем загрузки в магазин (вручную или по расписанию).
Метод доставки по умолчанию - который будет присваиваться для заказов из Wildberries.
Метод оплаты по умолчанию - который будет присваиваться для заказов из Wildberries.
Заказы из других стран загружать в исходной валюте заказа - при загрузке международного заказа WB передает 2 суммы - в валюте заказа и в рублях. Опция позволяет записывать цены в исходной валюте.
Автоматически помечать заказы в ЛК WB как "На сборке" - автоматический перевод сборочных заданий в статус "На сборке".
Отправлять уведомление о загрузке заказов из WB - опция активирует возможность получения уведомлений о заказе из Wildberries.
Загружать штрихкод - опция позволяет выгружать в дополнительные поля заказа его штрихкод для печати.
Статус "На сборке" (если нет автопометки при загрузке), Статус "Подобран", Статус "Не подобран" - при переводе заказа в выбранный из списка статус, сборочное задание будет менять свой статус на соответствующий.
Процесс выгрузки статуса происходит следующим образом: при выгрузке заказа ищется активная поставка в кабинете продавца; при её отсутствии - создаётся новая поставка и заказ добавляется к ней. Это переводит отправление в статус "На сборке".
Статус отгрузки в WB - статус, в котором находятся заказы, которые были собраны и переданы в доставку. По заказам в этом статусе произодится опрос изменений в статусах заказов на стороне WB. Если не задан - изменения статусов не загружаются.
Статус "Клиент получил товар" - выгружается из WB, когда отправление переходит в статус "Доставлено".
Устанавливать признак оплаты при завершении заказа - при активации опции заказам, перешедшим в статус "Клиент получил товар", будет автоматически проставляться признак оплаты на сайте.
Статус "Отмена/возврат заказа" - выгружается из WB, когда отправление переходит в соответствующий статус.
Соответствие статусов проставляете в зависимости от Ваших бизнес-процессов. Для этого можно как использовать стандартные, так и создать отдельные статусы.
Отправлять уведомление о смене статуса в WB - опция активирует возможность получения уведомлений о смене статуса заказа на Wildberries.
Выгружать по расписанию - опция позволит обновлять цены и остатки автоматически.
Интервал запуска, Время запуска - вам необходимо будет указать интервал запуска в минутах, часах или днях.
Печать
В данном блоке нужно указать настройки, которые используются при печати материалов при сборке заказа (рис.30).

Рисунок 30.
Статус печати листа подбора - опция позволяет поставить в соответствие статус заказа со стороны интернет магазина. Этот статус используется на этапе, когда при сборке заказа нужно напечатать лист подбора товаров, по которому осуществляется сборка. Когда заказ переведен в данный статус, то распечатать информацию о нем в лист подбора можно через выпадающий список справа, нажав на кнопку "Печать листа подбора" (рис.31).

Рисунок 31.
Склад WB для печати листа подбора - указываете наименование склада Wildberries, в который будете сдавать собранный заказ.
Типовые ошибки при работе с WB и их решение
Не выгружаются цены и остатки
В личном кабинете продавца WB может фиксироваться подобная ошибка (рис.32).

Рисунок 32.
На Wildberries есть срок жизни у токена Api. При данной ошибке необходимо перевыпустить токен. При создании ключа должно быть возможно использовать все доступные методы. Если необходимоиспользовать ограниченный набор, то активируем для ключей методы разделов "Контент", "Маркетплейс", "Цены и скидки". Опция "Маркетплейс", как раз и отвечает за выгрузку остатков.
После перевыпуска токена необходимо повторно выгрузить товары.
Не выгружаются фотографии в WB
1. Фото товаров не подходят под требования WB. Согласно документации Wildberries фотографии должны быть с минимальным разрешением – 700x900 px (рис.33).

Рисунок 33.
Чтобы загрузить изображение нужного размера, можно попробовать в настройках модуля создать недостающие фотографии. Переходим в настройки модуля, вкладка "Каталог товаров", "Проверить и выгрузить каталог товаров", в выплывающем меню выбираем "Создать недостающие фото для WB" (рис.38).

Рисунок 38.
2. В модификациях, добавленных на сайт товаров, указаны цвета, но фотографии к цветам не привязаны. Из-за этого фотографии к модификации не выгружаются. Чтобы фотографии выгрузились, нужно к каждой модификации с цветом указать фото.
Все готово. На этом настройка модуля завершена.
Другие статьи по теме
Тэги: вайлдбериз, вайлд, вилдберрис, вайлдберриес, валдберриз, вб, wb, wildberries, цшдвиуккшуы, маркетплейс, интеграция, waldberris, вайлдберрис, вайлдберис, вайлберрис, вайлберис, вайлбериз, вайлдбериз, wildberies, вайлдберриз,валбериз,валдбериз