Расширение для "1С:Управление торговлей, редакция 11". Для осуществления обменов данными товаров имеется отдельный раздел на Рис.1.
Основная сущность расширения - справочник "Карточки товаров Вайлдберрис" (далее по тексту возможен термин "Карточка НМ") создана "по образу и подобию" карточек номенклатуры на маркетплейсе "Wildberries.ru" (далее ВБ). Если точнее - то это структура, созданная по ответу серверов ВБ по запросу "content-api.wildberries.ru" с методом (в терминологии 1С) "/content/v2/get/cards/list". Именованным англоязычным полям поставлены русские синонимы (не могу поручиться за точность истолкования, поскольку имеются только аббревиатуры) Рис.2.
Четыре табличные части справочника "Карточки товаров Вайлберрис" содержат информацию:
1.sizes - Размеры ( как в традиции ("46","48","50" и пр., так и в традиции "XXL") штрих-коды,цены, цены со скидками). В этой-же таблице есть поле номенклатуры и характеристики из 1С. Поиск при заполнениииз ВБ сделан по штрих-коду (поле "skus"). Штрих кодов в данных ВБ может быть несколько, но загрузчик загружает только первое значение массива.
2."photos" - хранит все URL фото товаров всех разрешений. Поэтому их сильно больше,чем фактическое количество фото. Для хранения количества фото товаров имеется отдельный реквизит карточки.
3."characteristics" - хранит перечень всевозможных описаний товара типа "Ширина брюк", "Высота талии" и пр. Сохраняется id характеристики и ее значение. Если значение числовое - то оно при загрузке записывается в поле "valueNumber". Если строка или массив - в поле "value". Тип значения характеристики имеет большое значение при создании новых карточек и выгрузке из на ВБ. Неверное заполнение приводит к ошибкам, которые потребуется исправлять в личном кабинете поставщика на ВБ.
4."tags"- тэги (метки) товара.
Реквизиты справочника в основном соответствуют реквизитам ВБ. Поле "description" (описание) сделано как "description1". 1С не разрешила сделать поле с именем "description"... Поля размеров должны быть в сантиметрах ("width","height","length"). Поле "isValid"-признак рабочей (валидной) карточки. Поля "discount","price","discountedprice" используются тогда, когда поле "editableSizePrice" находится в положении "Нет". В противном случае цены используются из табличной части "sizes".
Форму элемента справочника платформа делает сама, никаких процедур,связанных с ее поведением, событиями не разработано, хотя потребность в этом высказывалась.
Функциональность расширения:
1.Загрузить карточки товаров с серверов ВБ с заполнением их содержимого. Старые данные карточки удаляются и в нее пишется новая информация по данным ВБ.Позиционирование на элементе справочника "Карточка товара ВБ" осуществляется по полю "nmID". Код (1С) платформа присваивает сама. Токен доступа к данным ВБ хранится в соответствующей константе и должен быть с правом на изменение информации ВБ (Рис.3)
2.Загрузить цены товаров по данным ВБ в 1с.
3.Заполнить цены в карточках ВБ по выбранному типу цен. Заполнение поддерживает две схемы ценообразования (11.5 и 11.0). Ведется в соответствие с реквизитом карточки НМ "editableSizePrice", т.е. заполняется цена с реквизитах "price" и "discountPrice" или в табличной части "sizes".
4.Выгрузить цены, установленные в карточках номенклатуры на сервера ВБ. Значение процента скидки выполняется при выгрузе по формуле (1-discountPrice/price) *100. Используется два способа выгрузки цен в зависимости от значения поля "editableSizePrice", т.е. цены или в шапке или в табличной части.
5.Можно создать несколько (количество вводится при создании) карточек товаров по образцу. При копирование очищаются поля идентификаторов и штрих коды. Но важные при создании на ВБ поля (родительская группа, состав таблицы характеристик) остаются. Пользователю остается только скорректировать необходимые поля ( н.п. код ТНВЭД, геометрические размеры, артикул поставщика) и можно выгрузить созданные карточки на ВБ. Обязательное требование - заполнение артикула поставщика ("vendorCode") и штрих кодов в табличной части "sizes". Для автоматического присваивания штрих кода служит общая команда "Новый штрих код". Процедура выгрузки двухстадийная. На первой происходит собственно выгрузка новых карточек на ВБ. Процесс их генерации на ВБ может занять некоторое время. Далее следует еще одно обращение в данным ВБ для заполнения полей "nmID", "imtID" и "nmUUID" созданных карточек. Можно попытаться получить их сразу, для этого разработана форма "Форма обновления данных выгруженных карточек НМ" или вызвать это мероприятие по команде "Обновить коды ВБ карточек" из формы списка справочника "Карточки товаров Вайлдберрис" (Рис.4 ).
После заполнения полей идентификаторов возможна полноценная работа с карточкой товара, н.п. отправка на ВБ ее фото.
6.Выгрузка фотографий товара на ВБ. Производится только по внешним присоединенным к номенклатуре файлам-картинкам. Т.е. в программе должна быть установлена настройка "Хранение файлов в томах на диске". Разрешение картинок должно быть не менее 900×1200 px. Выгрузка фото двухстадийная. На первой запрашивается количество фотографий, уже имеющихся на ВБ для определения номера фото для последующей выгрузки. Далее следует сама выгрузка.(Рис.5).
Проверено на следующих конфигурациях и релизах:
- Управление торговлей, редакция 11, релизы 11.5.17.117
