Настройка модуля интеграции с wildberries.ru
Содержание

Настройка базовых параметров

1. После установки модуля появится новый пункт меню Настройки - Настройки продукта - Настройки модулей - Интеграция с wildberries.ru - Общие настройки

2. Авторизация на wildberries.ru - 



  • для начала работ обязательно необходимо убедиться что Вы входили на https://seller.wildberries.ru/ в качестве поставщика и вводили свой номер телефона. 
  • введите идентификатор поставщика wildberries.ru (выдаётся при регистрации поставщика - необходимо пройти по ссылке: https://suppliers.wildberries.ru/specification/client/index) и нажать кнопку "Получить UUID". Если старый портал у Вас не доступен, то придется воспользоваться этой https://infostart.ru/1c/articles/1404430/ инструкцией, так как на получение идентификатора у WB могут уйти недели. 
  • введите Токен для работы с API - получить его можно здесь https://seller.wildberries.ru/supplier-settings/access-to-new-api
  • сохраните настройки модуля -  нажмите кнопку "Сохранить".
3. Далее необходимо настроить выгрузку остатков на склад - если списка складов нет, то необходимо то сначала ввести 'Токен для работы с API' и сохранить настройки. Если все равно ничего нет, то скорее всего нужно создать склады в личном кабинете wildberries.ru

4. Настройки интеграции


  • Тип инфоблока - выберите тип инфоблока.
  • Инфоблок - выберите инфоблок товаров  (должен быть торговым каталогом, должен быть основным инфоблоком, а не инфоблоком торговых предложений)
  • Откуда брать описание товара - описание товара, которое выгрузиться на wildberries.ru.
  • Откуда брать основную картинку - обязательно должна быть картинка товара, иначе товар не пройдет модерацию на wildberries.ru.
  • Откуда брать доп картинки - если есть доп картинки, можете указать здесь свойство в котором они хранятся.
  • Артикул (значение должно быть уникальным) - если на вашем сайте у товаров есть свойство с уникальным кодом, то укажите его в этом поле. Если такого свойства нет или оно заполнено не у всех товаров, то можете оставить это поле пустым - тогда в качестве уникального идентификатора на wildberries.ru выгрузиться ID элемента Битрикса. 
  • Штрихкод (обязательное поле, значение должно быть уникальным) - если на вашем сайте есть товары с торговыми предложениями, то символьный код этого свойства должен быть одинаковым у основного инфоблока и инфоблока торговых предложений. 
  • Свойство содержащее страну происхождения товара - выберите свойство (тип Строка) в котором храниться страна происхождения товара. Обратите внимание, что название страны должно полностью соответствовать названию на wildberries.ru.
  • Свойство для фильтрации товаров - если вы не хотите выгружать на wildberries.ru все товары, то настройка этого поля позволит вам уменьшить выборку по товарам и сократить общее время выгрузки всех элементов. Выберите здесь любое существующее свойство инфоблока и в выгрузку будут попадать только товары с этим свойством. Свойство должно быть типа Список. В элементах каталога планируемых к выгрузки на wildberries.ru необходимо установить значение свойства указанное здесь. Необязательное поле.
  • Тип цены - выберите здесь тип цены, который будет выгружаться на wildberries.ru. Также могут выгружаться все действующие на момент выгрузки скидки привязные к этому типу цен. Есть возможность выгружать цену из свойства - для этого отметьте галочку "Выгружать из свойства" и выберите соответствующее свойство инфоблока.
  • Выгружать остатки по событию - мгновенная выгрузка остатков по событию изменения доступного количества товара. Эта опция может замедлить работу скриптов массового изменения остатков товара (например при обмене с 1С).
5. Далее необходимо настроить соответствие основных справочников (цвета, размеры...). 


Сначала для основного инфоблока (только в случае, если простые товары имеют цвета и/или размеры) - слева находятся свойства инфоблока, справа справочники wildberries.ru. Выберите свойство инфоблока (например свойство содержащее цвет товара), затем справочник  wildberries.ru (Цвета  wildberries.ru), затем заполните появившиеся поля  - начните набирать подходящий по смыслу цвет. Если основной каталог содержит товары обладающие размерами произведите настройки еще двух справочников "Российские размеры  wildberries.ru" и "Размеры wildberries.ru". Чтобы добавить новый справочник нажмите "+".

Аналогичные действия необходимо произвести для инфоблока торговых предложений (если используются торговые предложения).

Сохраните настройки - нажмите кнопку "Сохранить".

После этого можно заполнять карточки товара и выгружать их на wildberries.ru.




Заполнение карточек товара

Данные для wildberries.ru заполняются в инфоблоке товаров. Если на Вашем сайте есть товары с торговыми предложениями, то основная информация для торговых предложений будет взята из карточки основного товара, а цвета и размеры - из карточек торговых предложений. Предварительно убедитесь в том, что  соответствие основных справочников настроено.

В форме редактирования элемента инфоблока найдите свойство "Атрибуты для wildberries.ru". 



1. Начните набирать тип товара в поле "Атрибуты для wildberries.ru" - например "Платья". Выберите из выпадающего списка нужный тип товара. Если все сделано правильно, то ниже появиться поля обязательные для заполнения.



Аналогичным образом заполните их и сохраните элемент инфоблока.

После сохранения здесь же появятся дополнительные элементы управления, позволяющие выгрузить товар на wildberries.ru, получить артикула присвоенные товару на wildberries.ru, удалить товар с wildberries.ru.
Порядок действий: сначала Выгрузить товар, затем Получить артикула (если в ответе возвращается ошибка, значит товар еще не прошел модерацию). Если вы хотите удалить товар с wildberries.ru воспользуйтесь соответствующей кнопкой.

Поля cardId, nmId_id, chrtId_id, nmId, chrtId являются служебными и осуществляют связь товара с карточкой на wildberries.ru - не рекомендуется изменять их.

После того, как были заполнены Атрибуты для wildberries.ru в карточках товара и товары выгружены, а также получены артикула с wildberries.ru можно вернуться к настройкам модуля и запустить выгрузку остатков. Для этого отметьте галочку "Агент активен" в разделе "Полная периодическая выгрузка остатков" и установите время в секундах, например 86400 (то есть раз в сутки). Чтобы остатки менялись в период между полными выгрузками, отметьте галочку "Выгружать остатки по событию" - в таком случае остаток по конкретному товару будет выгружаться в случае изменения его полного доступного количества.


Как пользоваться свойством "Выбрать похожие товары и скопировать атрибуты" - 




Как выгрузить несколько карточек:

Настройка загрузки заказов

Основные сведения


Заказы с wb.ru можно забирать если вы работаете по схеме "Продажи со склада поставщика".

API wb.ru не отдает данных о покупателе, а только номер отправления и состав заказа. Поэтому на сайте заказы можно создавать как под одного выбранного в настройках модуля пользователя, так и создавая на каждое отправление уникального пользователя.

Описание параметров


Загрузка заказов включена - активация этой галочки включает загрузку заказов

Выберите валюту, в которой будут создаваться заказы - выберите валюту

Выберите тип плательщика - тип плательщика на которого будут создаваться заказы (обычно физлицо)

Подставлять службу доставки - выберите службу доставки

Подставлять систему оплаты  - выберите систему оплаты

Создавать заказы на пользователя - если вы не хотите, чтобы каждый заказ создавал нового пользователя, введите в это поле ID существующего пользователя.

Соответствие статусов - настройте соответствие статусов заказов wb и БУСа

Периодичность проверки новых заказов -> Период, в секундах  - как часто проверять заказы на wb.

Сохранить - сохраняет сделанные изменения


Варианты синхронизации товаров

Если Ваши товары уже есть на WB Вы можете синхронизировать их с товарами в БУСе.


ВНИМАНИЕ! Если товары на WB и на Вашем сайте имеют одинаковые артикула можно просто нажать кнопку "получить артикула с WB" и модуль попытается найти товар на WB. Если это не сработает, то нужно выполнить действие описанное ниже.

Ручная синхронизация карточек
Скачайте перечень номенклатур здесь https://suppliers-portal.wildberries.ru/analytics/nomenclatures , Вам нужны поля картинка "Артикул WB" и "Код размера" и "Баркод", найдите в БУСе соответствующее торговое предложение и вставьте эти значения соответственно в поля chrtId и nmId - картинка  а Баркод в свойство выбранное в настройках модуля в качестве штрихкода картинка После этого по таким синхронизированным товарам будут загружаться заказы и выгружаться остатки и цены. Обратите внимание, что в новой версии API WB выгрузка остатков без штрихкодов невозможна.
Список синхронизированной номенклатуры Вы можете посмотреть на соответствующей странице модуля картинка

Для разработчиков

События

События, срабатывающие перед отправкой данных о ценах (OnPriceUpload) и остатках (OnUpdateStock) товара, перед выгрузкой нового товара (onUploadItem). События могут быть использованы, например, для применения наценки или изменения количества товара. 
 
Событие перед созданием заказа "OnOrderNew". Может быть использовано для изменения полей заказа перед сохранением.

С версии 2.2.0 добавлены события перед изменением статуса заказа OnStatusNew и перед изменение стикера OnStikerNew

Пример обработчика в init.php



	 
<?
AddEventHandler("maxyss.wb", "OnStockUpload", Array("MyClass", "OnUpdateStockMy"));
AddEventHandler("maxyss.wb", "OnUploadItem", Array("MyClass", "OnUploadItemMy"));



class MyClass
{
  
  function OnUpdateStockMy(&$items)

 {

  foreach ($items as &$item){

  $item['stock'] = '0';

 }

  return $items;

 }



function onUploadItemMy(&$item, $id_element, $auth){
    $ar_cards = CAddinMaxyssWB::GetCardForArticle($item['vendorCode'].$item['vendorCode'], $id_element , '', $auth);
    if(!empty($ar_cards['data'])){
        if( $ar_cards['data'][0]['vendorCode'] == $item['vendorCode'].$item['vendorCode']){
            $item['vendorCode'] = $ar_cards['data'][0]['vendorCode'];
        }
    }
    return $item;
}
 

 } ?>


 

 

 Пример для события создания заказа 

 

 
<?
AddEventHandler("maxyss.wb", "OnOrderNew", Array("MaxyssCustomClass", "OnOrderNewMy"));

class MaxyssCustomClass {

    function OnOrderNewMy(&$order_bitrix, $order_wb){

        // здесь что-то делаем с $order_bitrix - это объект заказа в БУСе   
        // в $order_wb находятся данные с Озона   

        return $order_bitrix;

    }
}?>



 Пример для OnStatusNew и OnStikerNew: 
 <? AddEventHandler("maxyss.wb", "OnStikerNew", "OnStikerNewWb");

function OnStikerNewWb(&$order_bitrix, $order_wb, $ar_stiker){
    $propertyCollection = $order_bitrix->getPropertyCollection();
    foreach ($propertyCollection as $prop) {
        $value = '';
        switch ($prop->getField('CODE')) {
            case 'WB_STICKER_ENCODED':
                $value = $ar_stiker['sticker']['wbStickerEncoded'];
                break;
        }

        if (!empty($value)) {
            $prop->setValue($value);
        }
    }

    return $order_bitrix;
}



Пример для изменения Артикула перед поиском карточки товара на wb.ru
AddEventHandler('maxyss.wb', 'OnGetCardWb', 'OnGetCardWbRal');

function OnGetCardWbRal(&$ar_cards, $a, $id_element, $UUID, $AUTHORIZATION){
    if(isset($ar_cards['data']) && empty($ar_cards['data'])) {
        $ar_cards = CAddinMaxyssWB::GetCardForArticle($a['code'].$a['code'], $id_element , $UUID, $AUTHORIZATION);
    }
    return $ar_cards;
}
 



 
 


 

 
				

			
		
Что делать если....

							Перестали выгружаться остатки и цены...

 

 1. Зайдите на страницу общих настроек  - https://ваш_сайт/bitrix/admin/maxyss.wb_wb_maxyss_general.php?lang=ru

 

 2. Снимите галочку "Агент активен". Нажмите "Сохранить". 

 

 3. Снова поставьте галочку "Агент активен". Нажмите "Сохранить".

 

 

 Перестали загружаться заказы...

 

 1. Зайдите на страницу настроек загрузки заказов - https://ваш_сайт/bitrix/admin/maxyss.wb_order_wb_maxyss.php?lang=ru

 

 2. Снимите галочку "Загрузка заказов включена". Нажмите "Сохранить".

 

 3. Снова поставьте галочку "Загрузка заказов включена". Нажмите "Сохранить". Подождите 2-3-минуты  - заказы должны начать загружаться.
				

			
		
Склейка карточек

							 как склеить карточки на wb.ru при выгрузке из Битрикса.