teeu импортирует товары из OpenCart через выгрузку в формате YML — том же, что используется для Яндекс.Маркета. Заводить карточки вручную не нужно: вы указываете ссылку на файл выгрузки, а площадка сама забирает товары и обновляет их 1–2 раза в день.

Что понадобится

• Магазин на teeu — регистрация и размещение товаров бесплатны.

• Ссылка на YML-выгрузку из InSales, доступная по HTTPS.

Как сформировать YML-фид на сайте OpenCart

В стандартной комплектации OpenCart нет универсальной выгрузки товаров в формате YML. Для создания фида необходимо установить дополнительный модуль экспорта товаров.

OpenCart официально поддерживает расширения типа Product Feeds, а в магазине расширений OpenCart доступны модули для генерации YML/XML-фидов.

Для подключения к teeu нужен модуль, который:

• формирует фид в формате YML;

• предоставляет постоянную ссылку на фид;

• автоматически получает актуальные товары из OpenCart;

• передаёт цены, остатки, описания и изображения;

• открывает фид без авторизации по HTTPS.

Модуль, который позволяет только скачать файл на компьютер, для подключения к teeu не подходит.

Что понадобится

• Сайт на OpenCart с заполненным каталогом товаров.

• Доступ администратора к панели управления.

• SSL-сертификат для работы ссылки по HTTPS.

• Модуль формирования YML-фида, совместимый с установленной версией OpenCart.

• Постоянная публичная ссылка на созданную выгрузку.

1. Проверьте версию OpenCart

Перед выбором модуля уточните версию системы.

Версия OpenCart обычно отображается в нижней части административной панели. Также её может проверить разработчик в файлах сайта.

Это важно, потому что модули для OpenCart 2, OpenCart 3 и OpenCart 4 могут быть несовместимы между собой. Перед установкой обязательно проверьте, поддерживает ли расширение вашу версию OpenCart и используемую версию PHP. Официальная документация OpenCart также рекомендует проверять совместимость всех расширений перед обновлением системы.

2. Выберите модуль YML-выгрузки

Откройте официальный магазин расширений OpenCart и найдите модуль по одному из запросов:

• YML Export;

• Yandex Market;

• YML Feed;

• Product Feed;

• XML Product Feed.

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

При выборе модуля проверьте:

• совместимость с вашей версией OpenCart;

• возможность сформировать именно YML, а не только Google XML;

• наличие постоянной ссылки;

• автоматическое обновление данных;

• поддержку категорий;

• передачу цен и остатков;

• передачу нескольких изображений;

• поддержку производителей и артикулов;

• передачу характеристик и опций;

• возможность выгружать варианты товаров;

• работу с большим количеством товаров.

Уточните у разработчика модуля, создаёт ли расширение динамический фид или регулярно обновляемый XML-файл. В обоих случаях ссылка должна оставаться постоянной.

3. Сделайте резервную копию сайта

Перед установкой стороннего модуля создайте резервную копию:

• файлов сайта;

• базы данных OpenCart.

Особенно важно сделать копию, если модуль использует OCMOD или вносит изменения в работу каталога.

4. Установите модуль

Для OpenCart 4 откройте:

Расширения → Установка расширений

или в английском интерфейсе:

Extensions → Installer

Загрузите установочный архив модуля. Обычно файл имеет расширение:

название-модуля.ocmod.zip

После загрузки нажмите кнопку установки рядом с расширением.

Затем перейдите:

Расширения → Расширения

Выберите тип расширения:

• Каналы продвижения;

• Каналы товаров;

• Feeds;

• Модули.

Точное название зависит от расширения и установленного перевода OpenCart.

Найдите загруженный модуль и нажмите «Установить». Официальная инструкция OpenCart 4 предусматривает загрузку архива через Extensions → Installer, последующую установку в списке расширений и настройку модуля.

В OpenCart 2 и OpenCart 3 расположение разделов может немного отличаться. Следуйте инструкции, приложенной разработчиком выбранного модуля.

5. Обновите модификаторы и кэш

Если модуль использует OCMOD, после установки откройте:

Расширения → Модификаторы

Нажмите кнопку «Обновить» в правом верхнем углу.

После этого очистите кэш OpenCart.

В OpenCart 4 кэш можно очистить через значок настроек на главной странице административной панели. Официальная документация рекомендует после установки OCMOD обновить модификаторы и очистить кэш системы.

6. Откройте настройки модуля

Перейдите в раздел, в котором появился установленный модуль.

Он может находиться по одному из путей:

• Расширения → Расширения → Каналы продвижения;

• Расширения → Расширения → Feeds;

• Расширения → Расширения → Модули;

• Каталог → Экспорт YML;

• Дополнения → YML Export.

Нажмите «Редактировать» напротив установленного модуля.

Названия разделов и кнопок зависят от конкретного расширения.

7. Включите модуль

В настройках установите:

Статус — Включено

Если модуль поддерживает несколько профилей, создайте отдельный профиль:

YML для teeu

Отдельный профиль позволит изменить настройки выгрузки для teeu, не затрагивая другие фиды магазина.

8. Заполните данные магазина

Укажите:

• название магазина;

• название компании или ИП;

• адрес сайта;

• основную валюту;

• язык выгрузки.

Адрес магазина должен использовать HTTPS:

https://shop.ru/

Также проверьте название магазина в разделе:

Система → Настройки

В OpenCart 4 основные параметры магазина, включая его название, находятся именно в разделе System → Settings.

9. Выберите товары и категории

Укажите, какие товары необходимо включить в фид:

• весь каталог;

• отдельные категории;

• товары выбранных производителей;

• только включённые товары;

• только товары с ценой;

• только товары в наличии.

Для teeu рекомендуется выгружать товары, которые:

• опубликованы на сайте;

• имеют название;

• имеют цену больше нуля;

• доступны для покупки;

• содержат хотя бы одну фотографию;

• находятся в активной категории.

Каталог товаров в OpenCart управляется через раздел Каталог → Товары, а производители — через Каталог → Производители.

10. Настройте цены

Выберите цену, которую модуль должен передавать в YML:

• основную цену;

• акционную цену;

• цену с учётом специальных предложений;

• цену с учётом группы покупателей.

Для большинства магазинов следует передавать текущую цену, которую покупатель видит на сайте.

Если товар участвует в акции, проверьте возможность передачи:

• текущей цены;

• старой цены;

• срока действия скидки.

11. Настройте остатки и доступность

Укажите, как определять наличие товара:

• по количеству на складе;

• по статусу товара;

• по возможности заказа при нулевом остатке.

Рекомендуется включить один из вариантов:

• не выгружать товары с нулевым остатком;

• передавать их с признаком available="false".

Главное, чтобы teeu получал корректную информацию о доступности товара.

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

12. Настройте названия и описания

Выберите поля OpenCart, из которых будут формироваться:

• название товара;

• описание;

• краткое описание — если оно используется;

• ссылка на карточку.

Рекомендуется передавать полное описание без служебных шорткодов, JavaScript и элементов оформления страницы.

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

13. Настройте артикулы и производителей

Сопоставьте поля:

• Артикул — SKU или Model;

• Производитель — Manufacturer;

• Штрихкод — EAN, UPC, JAN или другое используемое поле;

• Модель — Model.

В разных магазинах артикул может храниться в поле SKU или Model, поэтому перед запуском проверьте несколько карточек товаров.

Производители в OpenCart ведутся отдельно и назначаются товарам через каталог.

14. Настройте фотографии

Включите передачу:

• основной фотографии;

• дополнительных фотографий;

• абсолютных HTTPS-ссылок на изображения.

Проверьте, чтобы изображения:

• открывались без авторизации;

• не отдавали ошибку 403;

• имели достаточное разрешение;

• не содержали технических заглушек;

• соответствовали конкретному товару.

OpenCart позволяет хранить основное и дополнительные изображения в карточке товара.

15. Настройте характеристики

Включите передачу атрибутов товара в элементах param.

Например:

<param name="Материал">Хлопок</param>
<param name="Цвет">Чёрный</param>
<param name="Страна производства">Россия</param>

Желательно передавать:

• материал;

• цвет;

• размер;

• бренд;

• страну производства;

• вес;

• габариты;

• технические характеристики.

16. Настройте опции и варианты

Если товары имеют разные размеры, цвета или комплектации, проверьте, как модуль работает с опциями OpenCart.

Возможны два варианта:

• один товар со списком параметров;

• отдельное предложение offer для каждого варианта.

Для teeu предпочтительно передавать отдельный вариант товара, когда он имеет собственные:

• артикул;

• цену;

• остаток;

• фотографию;

• набор характеристик.

OpenCart поддерживает товарные опции, а OpenCart 4 также содержит отдельную систему вариантов с собственными ценами и остатками.

17. Настройте автоматическое обновление

Выберите способ обновления фида, который поддерживает модуль:

• динамическое формирование при открытии ссылки;

• автоматическое обновление по расписанию;

• обновление по cron;

• периодическая генерация через встроенный планировщик.

Рекомендуемая периодичность:

• каждый час — при частом изменении цен и остатков;

• каждые 2–4 часа — для обычного магазина;

• один раз в сутки — только если каталог меняется редко.

Для крупных каталогов предпочтительнее формирование файла по cron с последующей выдачей готового XML. Это снижает нагрузку на сайт при обращении teeu к ссылке.

18. Сформируйте фид

Нажмите кнопку:

• «Сформировать»;

• «Создать фид»;

• «Generate»;

• «Обновить файл»;

• «Сохранить и сформировать».

После формирования модуль должен показать постоянную ссылку.

Она может выглядеть так:

https://shop.ru/index.php?route=extension/feed/yml

или:

https://shop.ru/export/teeu.xml

или:

https://shop.ru/storage/feeds/catalog.yml

Точный адрес зависит от установленного модуля.

19. Проверьте ссылку

Откройте ссылку в режиме инкогнито.

Фид должен:

• открываться без входа в OpenCart;

• работать по HTTPS;

• не требовать логин и пароль;

• не скачивать страницу с ошибкой;

• содержать актуальные товары;

• использовать кодировку UTF-8;

• иметь постоянный адрес.

Начало файла должно выглядеть примерно так:

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="...">
  <shop>
    <name>Название магазина</name>
    <company>Название компании</company>
    <currencies>...</currencies>
    <categories>...</categories>
    <offers>...</offers>
  </shop>
</yml_catalog>

Расширение файла может быть .xml. Это нормально: YML является XML-форматом товарного фида.

Проверьте несколько товаров вручную:

• название;

• категорию;

• цену;

• остаток;

• артикул;

• производителя;

• описание;

• характеристики;

• ссылку на карточку;

• фотографии.

Как подключить

1. Скопируйте постоянную ссылку на файл выгрузки.

2. В кабинете продавца teeu откройте раздел «Выгрузки» и добавьте фид по этой ссылке.

3. Дождитесь первой синхронизации — товары появятся в каталоге.

Что обновляется автоматически

После подключения фида цены, остатки и описания подтягиваются из InSales без вашего участия. Категории товаров teeu определяет автоматически, а фотографии загружает и оптимизирует.