Импорт отзывов о товарах 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.

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

Array(
   'IBLOCK_ID' => $iBlockID, // Идентификатор инфоблока
   'ELEMENTS_ID' => $arElements // Массив идентификаторов созданных элементов
)

<? 
\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);
}
?>

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