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.