Интеграция с Wildberries

У ShopScript (SC) карточка состоит из артикулов, каждый из которых представляет уникальную комбинацию характеристик одного товара. Варианты (артикулы) могут содержать одну, две или более характеристик, определяющих уникальность этого варианта. Таким образом, полная структура товров SC выглядит так: Карточка -> Артикул.

У WB карточка состоит из вариантов, каждый вариант имеет Баркоды (размеры). Вариант создается из всех характеристик артикула, которые определяют его уникальность, за исключением Размера (если он сопоставлен в настройках плагина). Далее, к каждому созданному варианту присваиваются баркоды, цена и размеры , если характеристика Размер сопоставлена в настройках плагина. В противном случае, а так же в случаях, когда артикул всего один или в данной категории нельзя указывать размеры, то баркод все-равно создается в единственном числе. Таким образом полная структура товаров на WB выглядит так: Карточка -> Вариант -> Баркод.

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

Обновление цен просиходит по Артикулу WB, который сопоставляется с товаром SS

Для формирования наценки нужно добавить одно или несколько правил. Правила можно перетаскивать, регулируя их приоритет. В каждое правило можно добавить несколько условий и объединить их при необходимости (сравнение И/ИЛИ).

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

Правила подмены наличия работают аналогичным образом

Нет. На WB можно передать только Цену до скидки и процент скидки.

Согласно документации WB, такая возможность зависит от категории товара. На практике, мне не встречалась ни одна категория, где это было бы доступно. Возможно, функционал новый и по нему еще ведется разработка, поэтому будем ждать и надеяться.

Для автоматического формирования поставок, необходимо в настройках плагина в разделе Заказы, выбрать в поле «Подтверждение заказа» статус заказа SC, при котором происходит Подтверждение заказа на WB. После смены заказа в этот статус, он автоматически добавится в поставку. Все заказы текущего дня попадают в одну поставку. Время формирования новой поставки устанавливается соответствующей настройкой.

Если вы не хотите, чтобы плагин автоматически создавал поставки и добавлял туда заказы, оставьте поле «Подтверждение заказа» пустым.

Формирование поставок так же доступно в ручном режиме внутри заказа или через меню «Сборочные задания» (доступно в Premium лицензии)

Можно, при условии ручного сопоставления карточек. В настройках плагина нужно выбрать в поле "Идентификация артикулов по" значение "Код артикула", "ID артикула" или Штрих-код артикула (при наличии такой характеристики). Далее в личном кабинете WB в карточки товаров добавить баркод и указать Код или ID артикула (в зависимости от выбранной настройки). Далее в разделе Экспорт нажать кнопку "Сопоставить товары" и дождаться завершения выполнения задачи.

Начиная с версии 1.5 стала доступна идентификация не по баркодам WB, а по Артикулу продавца, т.е. можно идентифицировать карточки, когда Артикул продавца равен, например, коду артикула SS.

На Wildberries действуют ограничения на количество создавамых карточек. Лимит, отображаемый в плагине, получается через API. Его так же можно увидеть в личном кабинете WB при создании новых карточек через интерфейс личного кабинета. При достижении оборота продаж определенных значений, этот лимит автоматически увеличивается. Вы можете так же увеличить лимит платно в личном кабинете WB. Карточки, находящиеся в корзине так же влияют на этот показатель. Плагин учитывает бесплатный и платный лимиты, а так же количество карточек, находящихся в корзине.

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

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

В версии 1.6 появились дополнительные настройки, где можно указать единицу измерения по-умолчанию, если значение вашей характеристики ее не содержит.

Например:

• строковая характеристика с названием "Длина, см" имеет значение "10", а в настройках плагина, у параметра "ед. изм по-умолчанию (длина)" установлено значение "см", тогда значение преобразуется в 10см; если же в параметре установлено значение "мм", тогда значение преобразуется в 10мм и конвертируется в 1 см; при значении параметра по-умолчанию "м", значение сконвертируется в 1000см (10м)
• строковая характеристика с названием "Длина" имеет значение "10 см", тогда она преобразуется в значение 10см и отправится на WB в том же виде
• все числовые (не величинные) характеристики автоматически преобразовываются в величины с ед.изм. по-умолчанию, установленные в настройках плагина, и могут привести к неожиданным результатам.

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

Настройте команду CRON «cli.php shop wildbExport» на ежеминутное выполнение. Плагин построен так, чтобы все важные процессы проходили в фоне и не занимали ресурсы браузера. Для этого используется CRON. Работа экспорта оптмизирована так, чтобы одновременно могла выполняться только одна задача, для исключения возможных ошибок и конкуренции за ресурсы.

Как правило, выгрузка карточек занимает не более нескольких минут. Выгрузка картинок происходит гораздо дольше из-за ограничений со стороны WB и может доходить до 1 часа.

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

При выгрузке карточек собирается и обрабатывается большое количество информации. Обработка информации может потребовать от сервера довольно больших ресурсов. Для того, чтобы сервер правильно и полноценно справлялся с такой нагрузкой, необходимо увеличить некоторые параметры сайта в php.ini:

• max_input_time = 120
• max_input_vars = 100000
• memory_limit = 4G
• post_max_size = 2G
• realpath_cache_size = 256M

Как показывает практика, установка данных параметров решает более 80% проблем с экспортом карточек.

На выгрузку карточек так же влияют следюущие моменты:

• Если не установлена настройка «Выгружать товары без картинок», карточка должна иметь хотябы одну картинку в разрешении не менее 700х900
• Если не установлена настройка «Выгружать товары которых нет в наличии», проверьте, что требуемые товары имеют остатки на складах
• По требованиям WB, артикул продавца должен быть уникальным. Проверьте, что в параметре «Шаблон артикула продавца», выбрано значение, которое однозначно будет формировать уникальные артикулы.
• Баркоды тоже должны быть уникальнымы. Если у вас в параметре «Идентифицировать артикулы WB по» выбрано значение «Код артикула ShopScript», убедитесь в том, что у вас уникальные коды артикулов у товаров
• Если ваши товары имеют размеры, нужно в разделе настроек «Характеристики» сопоставить характеристику «Размер»
• Товары не будут выгружаться, если категория выгружаемых товаров не сопоставлена с категорией WB. При этом, в расчет берется только основная категория товара. Настроить сопоставление можно в настройках, в разделе Экспорт -> Категории
• Так же ошибки создания карточек со стороны WB можно увидеть в логах, в файле shop/plugins/wildb/WBResponse.log

После удаления карточек нужно в настройках плагина в разделе Экспорт сопоставить товары. Все текущие связи карточек удалятся и создадутся заново актуальные связи. После этого будет корректно работать обновление цен, остатков, обновление и выгрузка новых карточек.

По требованиям WB, картинки должны быть более 700px по ширине и более 900px по высоте. Если у товара нет ни одной подходящей картинки, они не будут выгружены.

Для корректной выгрузки картинок рекомендую сделать следующие настройки:

• В бэкэнде Webasyst в приложении «Настройки» в разделе «Общие настройки» в поле «Адрес сайта» нужно вписать имя вашего домена и протокол, по которому работает сайт, например: https://testshop.ru/. Это поле используется плагином для формировании ссылок на изображение. Очень важно, чтобы протокол http:// или https:// был указан, WB не может скачать картинки по ссылке без указания протокола.
• В приложении «Shop-Script» в настройках, в разделе «Изображения» установите галочку «Разрешить создание эскизов произвольных размеров по требованиюв» и в поле «Максимальный размер эскиза» укажите 1200 или более, вплодь до 2000.

Так же ошибки выгрузки картинок со стороны WB можно увидеть в логах, в файле shop/plugins/wildb/WBResponse.log

Это информационное сообщение появляется при включенном режиме отладки в настройках плагина и не является ошибкой.