Импорт отзывов о товарах Wildberries (Вайлдберриз)

После установки модуля штатными средствами 1С-Битрикс, нужно настроить интеграцию с сайтом Wildberries. Для этого потребуется сгенерировать токен API с правами для доступа к категории «Вопросы и Отзывы». Обратите, пожалуйста, внимание, что токен может быть сгенерирован только владельцем личного кабинета, а его значение отображается только в момент создания!

Токен API необходимо внести в соответствующее поле на странице настройки модуля.

Если во время установки или настройки модуля будут найдены ошибки, мешающие запуску процедуры импорта, то на странице настройки они будут указаны в поле «Статус процедуры импорта».

Импорт отзывов о товарах Wildberries можно запустить двумя способами:

1. С помощью агента 1С-Битрикс.

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

2. С помощью утилиты Cron.

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

Если расписание запуска модуля настроено корректно, и процедура импорта была запущена, то на странице настройки поле «Последний запуск процедуры импорта» примет значение даты и времени запуска процедуры.

При первом запуске импорта отзывов, в структуре сайта будет создан инфоблок с необходимыми полями. Ссылка на него станет доступна на странице настройки модуля.

Структура инфоблока:

• Дата создания – дата создания отзыва на сайте Wildberries, используется временная зона, установленная на сайте.
  

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

• Название – названия отзыва сформировано из имени пользователя на сайте Wildberries и даты его создания в формате Wildberries.

• Идентификатор отзыва WB – уникальный идентификатор отзыва на сайте Wildberries. Обязательный параметр, используется для синхронизации модуля и сайта Wildberries.

• Идентификатор отзыва-предка WB – идентификатор родительского отзыва на сайте Wildberries.

• Идентификатор отзыва-потомка WB – идентификатор дочернего отзыва на сайте Wildberries.

• Имя пользователя WB – имя пользователя, создавшего отзыв, на сайте Wildberries.

• Оценка WB – оценка товара по 5-бальной шкале на сайте Wildberries.

• Артикул товара WB – уникальный идентификатор номенклатуры товара на сайте Wildberries.

• Артикул товара продавца – артикул продавца для номенклатуры товара на сайте Wildberries.

• Фото – список ссылок на фотографии, прикрепленных к отзыву.

• Видео – список ссылок на видео, прикрепленных к отзыву.

• Описание для анонса – ответ продавца на сайте Wildberries.

• Детальное описание – текст отзыва на сайте Wildberries.

• Достоинства – описание достоинств товара на сайте Wildberries.

• Недостатки – описание недостатков товара на сайте Wildberries.

Вся информации о ходе процедуры импорта отзывов доступна на вкладке «Лог».

После успешного завершения процедуры импорта модуль формирует событие «OnAfterWBFeedbacksImport», в качестве параметра которого передается массив вида

Array( 'IBLOCK_ID' => $iBlockID, // Идентификатор инфоблока 'ELEMENTS_ID' => $arElements // Массив идентификаторов созданных элементов )Для дальнейшей обработки данных параметров, необходимо сформировать функцию-обработчик события и зарегистрировать его штатными средствами 1С-Битрикс:

<? \Bitrix\Main\EventManager::getInstance()->addEventHandler( 'dobrosite.importwbfeedbacks', 'OnAfterWBFeedbacksImport', "MyFunction" ); function MyFunction (\Bitrix\Main\Event $event){ // Обработчик события OnAfterWBFeedbacksImport $arParam = $event->getParameters(); // Работа с массивом $arParam } ?>

В версии модуля 1.1.0 было добавлено еще одно событие – «OnBeforeWBFeedbacksAdd». Данное событие генерируется перед добавлением отзыва в инфоблок 1С-Битрикс и позволяет провести дополнительную фильтрацию отзывов по кастомным условиям и/или изменить поля отзыва произвольным образом. В качестве параметра событие передает массив, содержащий поля отзыва Wildberries:

Array( 'id' => $WB_ID, // Уникальный идентификатор отзыва 'parentID' => $parentWB_ID, // Идентификатор родительского отзыва 'childID' => $childWB_ID, // Идентификатор дочернего отзыва 'userName' => $userName, // Имя пользователя 'plus' => $plusText, // Описание достоинств товара 'minus' => $minusText, // Описание недостатков товара 'text' => $text, // Текст отзыва 'mark' => $mark, // Оценка отзыва по 5-бальной шкале 'createdDate' => $createdDate, // Дата создания отзыва в формате WB 'answer' => $answer, // Ответ продавца 'nmId' => $WB_productID, // Идентификатор номенклатуры на сайте WB 'supplierArticle' => $article, // Артикул номенклатуры продавца 'photo' => $arPhoto, // Массив фотографий 'video' => $arVideo, // Массив видео )

Дата создания отзыва возвращается в формате сайта Wildberries: «2024-09-25T10:31:40Z» по нулевому меридиану.

Как и для события «OnAfterWBFeedbacksImport» функцию-обработчик события «OnBeforeWBFeedbacksAdd» необходимо зарегистрировать в системе 1С-Битрикс:

<? \Bitrix\Main\EventManager::getInstance()->addEventHandler( 'dobrosite.importwbfeedbacks', 'OnBeforeWBFeedbacksAdd ', 'FilterFeedbacks' ); function FilterFeedbacks (\Bitrix\Main\Event $event){ // Обработчик события OnBeforeWBFeedbacksAdd $feedback = $event->getParameters(); // Работа с массивом $feedback return new \Bitrix\Main\EventResult($type, $feedback); } ?>

Функция обработчик должна возвращать объект EventResult, для создания которого требуется передать два аргумента: тип результата и массив полей отзыва. Тип результата $type может иметь только два значения:

• \Bitrix\Main\EventResult::SUCCESS – обработка отзыва успешно завершена и его необходимо добавить в инфоблок.
  
• \Bitrix\Main\EventResult::ERROR – обработка отзыва завершена, но добавлять его в инфоблок не требуется.