Модуль «Ссылки на товары Маркеплейсов» позволяет сформировать ссылки на карточки товаров из личного кабинета Маркетплейсов и сохранить их в каталоге 1С-Битрикс. В текущей версии доступны маркетплейсы Озон (OZON) и Wildberries (WB, ВБ, Вайлдберис).
Для интеграции Маркетплейсов требуется сгенерировать ключ (токен) для доступа к API в личном кабинете продавца.
Требования для работы модуля:
- PHP версии 8.1 или новее
- Библиотека cURL
<p>Модуль устанавливается штатными средствами 1С-Битрикс.</p><p>При корректной установке модуля в Административном разделе 1С-Битрикс станет доступен раздел «DOBROsite».</p><img src="https://dobro-site.ru/modules_images/saveLinkMP/1.png" border="0" width="300" height="325" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/1.png" data-bx-onload="Y" /><br /><br />Настройка модуля осуществляется в Административном разделе на странице <i>DOBROsite > Ссылки на товары Маркетплейсов</i>.<br /><br /><img src="https://dobro-site.ru/modules_images/saveLinkMP/2.png" border="0" width="400" height="218" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/2.png" data-bx-onload="Y" /><br /><br /><br /><p><b>Настройка интеграции с сервисом Озон (OZON)</b></p><p>Для интеграции модуля с сервисом Озон требуется «Client ID» и ключ для доступа к API с набором определенных прав.</p><p>Параметр «Client ID» указан в настройках личного кабинета OZON Seller в разделе <a href="https://seller.ozon.ru/app/settings/api-keys" target="_blank" >Seller API -> API ключи</a>.</p><p></p><p><img src="https://dobro-site.ru/modules_images/saveLinkMP/3.png" border="0" width="300" height="293" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/3.png" data-bx-onload="Y" /></p><p><img src="https://dobro-site.ru/modules_images/saveLinkMP/4.png" border="0" width="800" height="320" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/4.png" data-bx-onload="Y" /></p><p></p><p>Генерация ключа для доступа к API производится на этой же странице при клике на кнопку «Сгенерировать ключ».</p><p><img src="https://dobro-site.ru/modules_images/saveLinkMP/5.png" border="0" width="800" height="469" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/5.png" data-bx-onload="Y" /></p><p></p><p>Во всплывающем окне необходимо заполнить произвольное название, указать тип токена и нажать на кнопку «Сгенерировать». Для работы модуля необходима роль «<b><i>Product</i></b>» – предоставляет доступ к методам API для работы со списком товаров на сайте Озон, или «<b><i>Admin</i></b>» - позволяет использовать все методы API без ограничений.</p><p><img src="https://dobro-site.ru/modules_images/saveLinkMP/6.png" border="0" width="500" height="785" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/6.png" data-bx-onload="Y" /></p><p></p><p></p><p></p><p></p><p></p><p></p><p></p><p></p><p>Полученные данные для интеграции с сайтом Озон необходимо внести в соответствующие поля на странице настройки модуля «Настройка OZON».</p><p><img src="https://dobro-site.ru/modules_images/saveLinkMP/7.png" border="0" width="800" height="329" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/7.png" data-bx-onload="Y" /></p>После этого необходимо настроить каталог сайта 1С-Битрикс для хранения сформированной ссылки на товар Озон. Первым делом создадим свойство инфоблока типа «Строка». Сделать это можно на странице редактирования инфоблока <i>Контент > Инфоблоки > Типы инфоблоков > [Нужный_тип] > </i><i>[Каталог]</i> на вкладке «Свойства». Для простых товаров данное свойство должно принадлежать инфоблоку, являющемуся торговым каталогом, для торговых предложений - инфоблоку, содержащему торговые предложения каталога товаров.<br /><br /><img src="https://dobro-site.ru/modules_images/saveLinkMP/8.png" border="0" width="800" height="331" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/8.png" data-bx-onload="Y" /><br /><br />Для сопоставления товаров на сайте Озон и товаров/ТП в каталоге 1С-Битрикс модуль использует параметр Озон «Артикул». Необходимо, чтобы в инфоблоке было свойство, которое содержит данное значения для соответствующих товаров. Если его нет, то необходимо его создать и заполнить нужными значениями.<p></p><p></p><img src="https://dobro-site.ru/modules_images/saveLinkMP/9.png" border="0" width="800" height="573" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/9.png" data-bx-onload="Y" /><br />В настройках модуля необходимо выбрать из выпадающего списка:<ul><li><p>идентификатор каталога, </p><li><p>свойство, хранящие значение артикула товара на сайте Озон, </p><li><p>свойство для хранения сформированной ссылки на страницу товара на сайте Озон.<br /></p></ul><img src="https://dobro-site.ru/modules_images/saveLinkMP/10.png" border="0" width="800" height="395" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/10.png" data-bx-onload="Y" /><br /><br />Чтобы запустить процесс получения информации с сайта Озон, необходимо активировать и настроить агент системы 1С-Битрикс. Для этого установите флаг «Активировать агент», выберите дату и время запуска агента, а также укажите период запуска агента в секундах.<br /><br /><img src="https://dobro-site.ru/modules_images/saveLinkMP/11.png" border="0" width="500" height="306" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/11.png" data-bx-onload="Y" /><br /><p></p><p></p><p><b><i>Обратите, пожалуйста, внимание, что для корректной работы агентов системы 1С-Битрикс они должны быть переведены на Cron!</i></b></p><p></p><p>Если в системе агентов 1С-Битрикс нет сбоев и запуск агента модуля был выполнен корректно, то в разделе «Журнал» появиться файл с датой и временем запуска агента, содержащий информацию о ходе процесса получения информации с сайта Озон и формирования ссылок на товары.</p><p><img src="https://dobro-site.ru/modules_images/saveLinkMP/12.png" border="0" width="800" height="322" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/12.png" data-bx-onload="Y" /></p><p></p><p><b><br /></b></p><p><b>Настройка интеграции с сервисом Wildberries (WB)</b></p><p></p><p>Для интеграции модуля с сервисом WB требуется сгенерировать токен API для доступа к методам категории «Контент» в <a href="https://seller.wildberries.ru/supplier-settings/access-to-api" target="_blank" >личном кабинете «WB Партнеры»</a>. В настройках токена можно установить флаг «Только для чтения», это не помешает работе модуля, поскольку изменение данных на стороне WB не предполагается.</p><p></p><p><b><i>Важно! Сгенерировать токен API может только владелец личного кабинета Wildberries! Значение ключа отображается один раз – при его генерации!</i></b></p><p></p><p>Сгенерированный токен для доступа к API необходимо внести в соответствующие поля на странице настройки модуля «Настройка Wildberries».</p><p><img src="https://dobro-site.ru/modules_images/saveLinkMP/13.png" border="0" width="800" height="335" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/13.png" data-bx-onload="Y" /></p><p>После этого необходимо настроить каталог сайта 1С-Битрикс для хранения сформированной ссылки на товар WB. Первым делом создадим свойство инфоблока типа «Строка». Сделать это можно на странице редактирования инфоблока <i>Контент > Инфоблоки > Типы инфоблоков > [Нужный_тип] > [Каталог]</i> на вкладке «Свойства». Для простых товаров данное свойство должно принадлежать инфоблоку, являющемуся торговым каталогом, для торговых предложений - инфоблоку, содержащему торговые предложения каталога товаров.</p><img src="https://dobro-site.ru/modules_images/saveLinkMP/14.png" border="0" width="800" height="307" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/14.png" data-bx-onload="Y" /><br /><p>Для сопоставления товаров на сайте WB и товаров/ТП в каталоге 1С-Битрикс модуль использует параметр WB «Артикул продавца». Необходимо, чтобы в инфоблоке было свойство, которое содержит данное значения для соответствующих товаров. Если его нет, то необходимо его создать и заполнить нужными значениями.</p><p><img src="https://dobro-site.ru/modules_images/saveLinkMP/15.png" border="0" width="800" height="571" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/15.png" data-bx-onload="Y" /></p><p>В настройках модуля необходимо выбрать из выпадающего списка:</p><ul><li><p>идентификатор каталога, </p><li><p>свойство, хранящие значение артикула товара на сайте WB, </p><li><p>свойство для хранения сформированной ссылки на страницу товара на сайте WB.</p></ul><img src="https://dobro-site.ru/modules_images/saveLinkMP/16.png" border="0" width="800" height="416" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/16.png" data-bx-onload="Y" /><br /><br />Чтобы запустить процесс получения информации с сайта WB, необходимо активировать и настроить агент системы 1С-Битрикс. Для этого установите флаг «Активировать агент», выберите дату и время запуска агента, а также укажите период запуска агента в секундах.<br /><br /><img src="https://dobro-site.ru/modules_images/saveLinkMP/17.png" border="0" width="500" height="296" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/17.png" data-bx-onload="Y" /><br /><br /><i><b>Обратите, пожалуйста, внимание, что </b></i><i><b>для корректной работы агентов системы 1С-Битрикс они должны быть переведены на </b></i><i><b>Cron!</b></i><p></p><p></p><p>Если в системе агентов 1С-Битрикс нет сбоев и запуск агента модуля был выполнен корректно, то в разделе «Журнал» появиться файл с датой и временем запуска агента, содержащий информацию о ходе процесса получения информации с сайта WB и формирования ссылок на товары.</p><p> <img src="https://dobro-site.ru/modules_images/saveLinkMP/18.png" border="0" width="800" height="371" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/18.png" data-bx-onload="Y" /></p><p></p><p></p><p></p><p><b><br /></b></p><p><b>Публикация ссылок на странице сайта</b></p><p>После сохранения ссылок на страницы товаров в Маркетплейсе, вывести их в Публичный раздел можно разными способами, все зависит от структуры каталога и шаблона сайта.</p><p>Чаще всего товары каталога публикуются на сайте с помощью компонента 1С-Битрикс «Элемент каталога детально» в составе комплексного компонента «Каталог». В этом случае, чтобы отобразить ссылки необходимо настроить параметры компонента «Каталог» и отредактировать шаблон компонента «Элемент каталога детально». </p><p>Рассмотрим наиболее простой вариант, если каталог товаров простой, то есть, у товаров <i><u>нет </u></i>торговых предложений.</p><p>Перейдем на детальную страницу какого-либо товара в Публичной части сайта и включим «Режим правки».</p><p><img src="https://dobro-site.ru/modules_images/saveLinkMP/19.png" border="0" width="800" height="533" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/19.png" data-bx-onload="Y" /></p><p></p><p></p><p></p><p>Откроем параметры компонента «Каталог».</p><img src="https://dobro-site.ru/modules_images/saveLinkMP/20.png" border="0" width="510" height="356" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/20.png" data-bx-onload="Y" /><br /><br />В группе параметров «Настройки детального просмотра» добавим в значения параметра «Свойства» те свойства инфоблока, которые хранят значения ссылок на сайтах Маркетплейсов. Чтобы выбрать несколько свойств, необходимо зажать клавишу Ctrl, навести курсор на нужное значение и кликнуть левой кнопкой мышью. Таким же способом можно отменить выбор свойства. Не забудем сохранить изменения.<p></p><img src="https://dobro-site.ru/modules_images/saveLinkMP/21.png" border="0" width="800" height="513" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/21.png" data-bx-onload="Y" /><br /><br />Теперь отредактируем шаблон компонента «Элемент каталога детально».<p></p><img src="https://dobro-site.ru/modules_images/saveLinkMP/22.png" border="0" width="715" height="412" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/22.png" data-bx-onload="Y" /><br /><p></p>Если на сайте используется шаблон компонента «Элемент каталога детально» по умолчанию, то система 1С-Битрикс предложит создать копию этого шаблона и редактировать уже ее. Это необходимо для того, чтобы при установке обновлений системы 1С-Битрикс внесенные нами изменения в код шаблона не были затерты.<br /><br /><img src="https://dobro-site.ru/modules_images/saveLinkMP/23.png" border="0" width="700" height="511" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/23.png" data-bx-onload="Y" /><br /><br />Выберем место в коде, где мы хотим разместить ссылки, и добавим строки:<div class="blog-post-code" title="Код"><table class="blogcode"><tr><td><pre><? if($arResult["PROPERTIES"]["OZON_LINK"]["VALUE"] || $arResult["PROPERTIES"]["WILDBERRIES_LINK"]["VALUE"] ):?>
<div class="mp-links-container">
<?if($arResult["PROPERTIES"]["OZON_LINK"]["VALUE"]):?>
<a class="mp-links-block mp-link-ozon" href="<?=$arResult["PROPERTIES"]["OZON_LINK"]["VALUE"]?>" target="_blank">Купить на OZON</a>
<?endif;?>
<?if($arResult["PROPERTIES"]["WILDBERRIES_LINK"]["VALUE"]):?>
<a class="mp-links-block mp-link-wb" href="<?=$arResult["PROPERTIES"]["WILDBERRIES_LINK"]["VALUE"]?>" target="_blank">Купить на Wildberries</a>
<?endif;?>
</div>
<?endif;?></pre></td></tr></table></div><p></p><img src="https://dobro-site.ru/modules_images/saveLinkMP/24.png" border="0" width="800" height="475" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/24.png" data-bx-onload="Y" /><br /><br />Чтобы оформить ссылки в прямоугольники соответствующего цвета, добавим в шаблон компонента «Элемент каталога детально» CSS-стили.<br /><br /><img src="https://dobro-site.ru/modules_images/saveLinkMP/25.png" border="0" width="700" height="459" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/25.png" data-bx-onload="Y" /><br /><br /><p></p><p></p>В самый конец файла добавим описанные ниже стили и сохраним изменения.<br /><div class="blog-post-code" title="Код"><table class="blogcode"><tr><td><pre>.mp-links-container
{
display: flex;
gap: 10px;
justify-content: flex-start;
}
.mp-links-block
{
padding: 10px 20px;
text-align: center;
text-decoration: none;
border-radius: 5px;
font-weight: bold;
color: white;
}
.mp-link-ozon
{
background-color: #005bff;
}
.mp-link-wb
{
background-color: #a73afd;
}
.mp-links-block:hover
{
color: white;
filter: brightness(90%);
}
</pre></td></tr></table></div><img src="https://dobro-site.ru/modules_images/saveLinkMP/26.png" border="0" width="800" height="482" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/26.png" data-bx-onload="Y" /><br /><p>В итоге получим ссылки на страницы товара на Маркетплейсах, оформленные в виде кнопок соответствующих цветов.</p><img src="https://dobro-site.ru/modules_images/saveLinkMP/27.png" border="0" width="800" height="495" data-bx-image="https://dobro-site.ru/modules_images/saveLinkMP/27.png" data-bx-onload="Y" /><br /><br />
Запросы на техническую поддержку решения можно отправлять на <a href="mailto:support@dobrosite.com" target="_blank" >support@dobrosite.com</a> или через форму обратной связи на сайте <a href="https://dobrosite.com/" target="_blank" >dobrosite.com</a>