Trendyol Connector для OpenCart 3.x и 4.x — цены, остатки и заказы Trendyol в вашем магазине

Trendyol Connector для OpenCart — интеграция вашего магазина на OpenCart 3.x или 4.x с Trendyol, крупнейшим маркетплейсом Турции. Вы продаёте и у себя, и на Trendyol — модуль следит, чтобы цена и остаток на Trendyol соответствовали OpenCart, включая варианты из опций товара, а с Pro приносит заказы Trendyol в ваш магазин и возвращает в Trendyol статусы пакетов. Всё — через официальный Trendyol Marketplace API, без парсинга и без ручных экспортов. Магазин на WooCommerce — есть Trendyol Connector для WooCommerce.

Что нужно от вас. Аккаунт продавца Trendyol и ключи API из кабинета (Hesap Bilgilerim → Entegrasyon Bilgileri). Честно о проверке: публичной песочницы Trendyol не даёт — тестовое окружение открывается только продавцу после внесения IP в белый список через поддержку Trendyol. Модуль сделан по официальной документации developers.trendyol.com и проверен сквозным сценарием на симуляции этого API (связка товаров и опций, цены и остатки с результатами пакетов, покупка на витрине, заказы через webhook и опрос, отмена, статусы, счета, этикетки, публикация, Buybox, удаление модуля) на OpenCart 4.1.0.3, 4.0.2.3 и 3.0.5.0. На боевом аккаунте продавца модуль ещё не запускали — проверьте на своём в 7-дневном триале Pro. Журнал показывает каждый запрос и ответ Trendyol, и если Trendyol ответит иначе, чем в документации, исправим оперативно.

Что получает магазин

• Восемь вкладок в одном модуле: Connection, Products, Prices & stock, Orders, Publishing, Buybox, Licence, Log.
• Подключение за три поля: Seller ID, API Key и API Secret из кабинета продавца, боевое или тестовое окружение. Заголовок User-Agent «<Seller ID> — SelfIntegration», которого требует Trendyol, модуль ставит сам. Ключи хранятся зашифрованными (AES-256 с HMAC) и больше не показываются.
• «Check the connection» сразу говорит, пускает ли Trendyol, а ошибку показывает вместе с текстом Trendyol.

• Импорт и связка: модуль читает все одобренные товары вашего магазина Trendyol и связывает их с товарами OpenCart по штрихкоду (поле товара на выбор), коду склада или штрихкоду значения опции. Ненайденные — отдельным отчётом.
• Варианты из опций: размер или цвет, заведённые опцией товара, становятся отдельными вариантами Trendyol — со своим штрихкодом на вкладке Trendyol товара, остатком значения опции и ценой товара ± цена опции.
• Синхронизация: покупка на витрине или изменение товара в админке ставит товар в очередь, а крон ежеминутно отправляет новые цены и остатки; раз в час — полная сверка. Отправляется только изменённое; тот же запрос Trendyol не разрешает повторять 15 минут, и модуль этого правила придерживается сам.
• Результат по каждому штрихкоду: Trendyol обрабатывает обновления пакетом, модуль читает ответ и показывает отказ Trendyol прямо в товаре.
• Правила цены: цены с KDV или без (KDV — по классу налога или из товара: 0, 1, 10, 20%), курс валюты магазина в TRY, наценка % и фиксированная надбавка, округление до ,90 или целой лиры, спеццена как цена продажи с обычной как зачёркнутой. Резерв остатка для своего магазина и количество для товаров без учёта.
• Таблица «Products on Trendyol» в настройках: штрихкод, что отправлено, статус на Trendyol, а также массовые действия «продавать всё, у чего есть штрихкод» и «остановить продажу (остаток 0)».

Pro: заказы, счета, этикетки, публикация

• Заказы Trendyol в OpenCart — за секунды через webhook, который модуль регистрирует в Trendyol кнопкой с секретным ключом, а проверка каждые 5 минут подбирает пропущенное. Один пакет Trendyol — один заказ OpenCart.
• Поля заказа: зона — провинция покупателя (не первая зона страны), город — район, mahalle — во второй строке адреса; корпоративные данные (VKN, налоговая), KDV по строкам, «Итого» равно сумме пакета, способ доставки и оплаты «Trendyol». Товар с вариантом получает опцию заказа, и ядро OpenCart списывает остаток именно этого значения опции.
• Без дублей: повторный webhook не создаёт второй заказ — замок и уникальный номер пакета в базе.
• Статусы из Trendyol: отменённый, непоставленный или разделённый пакет отменяет заказ с возвратом остатка; «Shipped», «Delivered», «Returned» ставят статусы, которые вы выбрали в настройках.

• Статус обратно в Trendyol: «Picking» и «Invoiced» с номером счёта — автоматически по статусу заказа или кнопками в панели Trendyol.
• Отмена — с предупреждением: отмена в OpenCart уходит в Trendyol как «tedarik edememe» с причиной 500–506, а это снижает рейтинг магазина на Trendyol. Модуль предупреждает об этом в настройках, красной строкой в панели заказа и в штатной форме истории — перед добавлением статуса отмены она спрашивает подтверждение.
• Счёт: ссылка на e-Arşiv или e-Fatura с номером и датой уходит в Trendyol кнопкой, номер проверяется по формату Trendyol.
• Этикетка: общая этикетка Trendyol в ZPL для TEX и Aras, которые оплачивает Trendyol, и слип A6 со штрихкодом CODE128 трек-номера для любого перевозчика.
• Публикация товаров: дерево категорий Trendyol, карта категорий магазина, атрибуты категории — автоматически по названию, из опции товара (со своим переводом значений, например Small → S) или фиксированным значением, бренд из списка Trendyol, варианты одной карточки, desi из габаритов, адреса отгрузки и возврата из кабинета.
• Монитор Buybox: раз в 6 часов ваше место и цена Buybox, письмо, когда вы потеряли первое место.

Интерфейс модуля — на английском и турецком: если язык админки турецкий, вкладки, панель заказа и предупреждения выглядят так.

Как это работает — шаг за шагом

1. Подключение. Расширения → Модули → Trendyol Connector → Connection: Seller ID, API Key, API Secret, «Check the connection».
2. Правила цены. Вкладка Prices & stock: цены с KDV или без, курс, наценка, округление, резерв.
3. Связка. Вкладка Products: импорт из Trendyol связывает товары и значения опций по штрихкоду; ненайденные видно в отчёте. Штрихкод можно вписать и на вкладке Trendyol товара.
4. Синхронизация. Дальше каждая покупка и каждое изменение товара уходят на Trendyol сами; «Send queue» отправляет очередь сразу.
5. Заказы (Pro). Вкладка Orders: регистрация webhook одной кнопкой, статусы для каждого состояния пакета, передача отмены.
6. Публикация (Pro). Вкладка Publishing: загрузите категории Trendyol, сопоставьте категории и атрибуты — и публикуйте новые товары.

Что под капотом

• Без правок ядра: события OpenCart и собственные таблицы cc_tyconnect_*; общая библиотека одинакова для OpenCart 3 и 4.
• Актуальные методы Trendyol: одобренные товары v2 с nextPageToken, поток пакетов (stream) и /v2/orders, который Trendyol делает обязательным с 15.10.2026, createProducts v2.
• Лимиты Trendyol: до 500 штрихкодов за запрос, только изменённое, повтор после 429 с паузой без потери очереди.
• Webhook защищён ключом (x-api-key), чужой запрос получает 401. Если Trendyol отключит webhook после серии неудачных доставок, заказы дальше подбирает проверка каждые 5 минут.
• Pro-гейт без «кирпича»: когда триал закончился, останавливаются только Pro-функции, синхронизация работает дальше.
• Обновление без потерь: OpenCart обновляет модуль через удаление, поэтому таблицы со связками и настройками по умолчанию остаются. Опция «Remove all module data» на вкладке Log убирает при удалении всё — таблицы, настройки, события, крон и лог; заказы OpenCart остаются.

Как установить

1. Расширения → Установщик: загрузите cc_tyconnect.ocmod.zip (OpenCart 4) или cc_tyconnect-oc3.ocmod.zip (OpenCart 3). Не переименовывайте архив — OpenCart 4 берёт из имени файла код расширения. В OpenCart 4 нажмите «Установить» у расширения в списке; в OpenCart 3 обновите модификации.
2. Расширения → Модули → Trendyol Connector: установите и откройте.
3. Connection: Seller ID, API Key и API Secret, «Module on», сохраните и нажмите «Check the connection».
4. Prices & stock → Products: правила цены и импорт товаров из Trendyol.
5. Для Pro: вставьте лицензионный ключ из письма после оплаты или запустите 7-дневный триал на вкладке «Licence», дальше — вкладки Orders и Publishing.