Trendyol Connector для WooCommerce — ціни, залишки й замовлення Trendyol у вашому магазині

Trendyol Connector для WooCommerce — інтеграція вашого магазину з Trendyol, найбільшим маркетплейсом Туреччини. Ви продаєте і в себе, і на Trendyol — плагін стежить, щоб ціна й залишок на Trendyol відповідали WooCommerce, а з Pro приносить замовлення Trendyol у ваш магазин і повертає в Trendyol статуси пакетів. Усе — через офіційний Trendyol Marketplace API, без парсингу й без ручних експортів. Магазин на OpenCart — є Trendyol Connector для OpenCart.

Що потрібно від вас. Акаунт продавця Trendyol і ключі API з кабінету (Hesap Bilgilerim → Entegrasyon Bilgileri). Чесно про перевірку: публічної пісочниці Trendyol не дає — тестове середовище відкривається лише продавцю після внесення IP у білий список через підтримку Trendyol. Плагін зроблено за офіційною документацією developers.trendyol.com і перевірено наскрізно на симуляції цього API (зв’язка товарів, ціни й залишки з результатами пакетів, замовлення через webhook і опитування, скасування, статуси, рахунки, етикетки, публікація, Buybox) на PHP 7.4 і 8.3, з HPOS і без. На бойовому акаунті продавця плагін ще не запускали — перевірте на своєму в 7-денному тріалі Pro. Журнал показує кожен запит і відповідь Trendyol, і якщо Trendyol відповість інакше, ніж у документації, виправимо оперативно.

Що отримує магазин

• Підключення за три поля: Seller ID, API key і API secret з кабінету продавця, бойове або тестове середовище. Заголовок User-Agent «<Seller ID> – SelfIntegration», якого вимагає Trendyol, плагін ставить сам.
• «Check the connection» показує, скільки схвалених товарів у вашому магазині Trendyol. Помилку Trendyol (невірний ключ, немає доступу) плагін показує людською мовою разом з текстом Trendyol.
• Ключі API зберігаються в базі зашифрованими (AES-256 з HMAC), не показуються на сторінці і не потрапляють у журнал.

• Імпорт і зв’язка: плагін читає всі схвалені товари вашого магазину Trendyol і зв’язує кожен варіант з товаром чи варіацією WooCommerce за штрихкодом (поле GTIN/EAN або SKU) чи за SKU, рівним коду складу Trendyol. Пробіли в штрихкоді прибираються так само, як це робить Trendyol. Товари Trendyol без пари в магазині — окремим звітом. Сам імпорт нічого на Trendyol не надсилає.
• Синхронізація: продаж у магазині чи зміна ціни — і за кілька хвилин нова ціна й залишок ідуть на Trendyol. Надсилається лише змінене; той самий запит Trendyol не дозволяє повторювати 15 хвилин, і плагін цього правила дотримується сам.
• Результат по кожному штрихкоду: Trendyol обробляє оновлення пакетом, і плагін читає відповідь — «прийнято» або текст відмови Trendyol прямо в товарі й таблиці. Мережевий збій або перевантаження Trendyol лишають товар у черзі, а не гублять його.

• Ціни на Trendyol — з KDV: якщо ціни WooCommerce без податку, плагін додає KDV товару (з імпорту Trendyol або ставку за замовчуванням).
• Націнка у % і фіксована надбавка в TRY — наприклад, під комісію й доставку; курс, якщо магазин продає в іншій валюті; округлення до куруша, ,90, ,99 або цілої ліри.
• Перекреслена ціна: під час акції звичайна ціна WooCommerce іде в Trendyol як listPrice — Trendyol не приймає її нижчою за ціну продажу.
• Залишок: резерв для свого магазину, кількість для товарів без обліку; неопублікований, вимкнений чи видалений товар отримує на Trendyol нуль.

У кожному товарі й варіації — вкладка Trendyol: продавати чи ні, штрихкод Trendyol, власна ставка KDV, стан на Trendyol з результатом останньої синхронізації і кнопка «Send to Trendyol now». У списку товарів — масові дії «продавати / не продавати на Trendyol».

Pro: замовлення, рахунки, етикетки, публікація

• Замовлення Trendyol у WooCommerce — за секунди через webhook, який плагін реєструє в Trendyol кнопкою з секретним ключем, а перевірка кожні 5 хвилин підбирає пропущене, як радить сам Trendyol. Один пакет Trendyol — одне замовлення WooCommerce.
• Дані замовлення: покупець, адреса доставки й рахунку (провінція, район, mahalle), корпоративні дані (назва, VKN, податкова, e-Fatura), TCKN, товари з KDV рядка, знижки продавця й Trendyol — сума збігається з сумою пакета Trendyol. Перевізник — у назві доставки, залишок списується.
• Без дублів: повторний webhook чи старіша копія пакета не створюють друге замовлення і не списують залишок двічі. Листи WooCommerce покупцю за замовчуванням вимкнені — його інформує Trendyol.
• Статуси з Trendyol: скасований пакет скасовує замовлення з поверненням залишку; розділений пакет закриває старе замовлення з приміткою, а нові пакети приходять новими замовленнями; «Delivered» за бажанням ставить «Виконано».

• Статус назад у Trendyol: обраний статус WooCommerce стає «Picking» чи «Invoiced» з номером рахунку — або кнопками в блоці Trendyol картки замовлення.
• Скасування — з попередженням: скасування в WooCommerce іде в Trendyol як «tedarik edememe» з причиною 500–506, а це знижує рейтинг магазину на Trendyol. Тому екран замовлення попереджає про це й питає підтвердження перед збереженням статусу «Скасовано»; передачу скасування можна вимкнути.
• Рахунок: посилання на e-Arşiv або e-Fatura йде в Trendyol кнопкою, номер рахунку плагін перевіряє за форматом Trendyol.
• Етикетка: спільна етикетка Trendyol у ZPL для TEX і Aras Kargo, які оплачує Trendyol; для інших перевізників — слип A6 зі штрихкодом трек-номера.

• Публікація товарів з редактора WooCommerce: категорія Trendyol (лише кінцеві), атрибути категорії — автоматично за назвою атрибута WooCommerce, за мапою або фіксованим значенням, бренд зі списку Trendyol, варіації як варіанти однієї картки, до 8 фото, desi з габаритів, адреси відвантаження й повернення з вашого кабінету. Результат перевірки Trendyol — у товарі.
• Монітор Buybox: раз на 6 годин ваше місце, ціна Buybox і чи є інші продавці — у таблиці товарів, і лист, коли ви втратили перше місце.

Інтерфейс плагіна — англійською і турецькою: якщо мова сайту чи вашого профілю Türkçe, усі вкладки, блок замовлення й попередження виглядають так.

Як це працює — крок за кроком

1. Підключення. WooCommerce → Trendyol → Connection: Seller ID, API key, API secret, «Check the connection».
2. Правила ціни. Вкладка Listings: ціни з KDV чи без, націнка, курс, округлення, резерв залишку.
3. Зв’язка. «Import and link products» — товари Trendyol зв’язуються з товарами за штрихкодом; незв’язані видно у звіті.
4. Перша відправка. «Resend all linked products» надсилає поточні ціни й залишки, «Read results from Trendyol» показує відповідь по кожному товару. Далі кожен продаж і кожна зміна йдуть на Trendyol самі.
5. Замовлення (Pro). Вкладка Connection → Order webhook: одна кнопка реєструє webhook у Trendyol, вкладка Orders — статуси, скасування, листи.
6. Публікація (Pro). Вкладка Publishing: завантажте категорії Trendyol, зіставте їх з категоріями магазину — і публікуйте нові товари з редактора.

Що під капотом

• Актуальні методи Trendyol: схвалені товари v2 з nextPageToken для великих каталогів, потік пакетів (stream) і /v2/orders, який Trendyol робить обов’язковим з 15.10.2026, createProducts v2.
• Ліміти Trendyol плагін витримує сам: пакети до 200 товарів, не більше 20 000 штук у рядку, пауза між сторінками потоку, повтор після 429 і 5xx без втрати черги.
• Черга синхронізації — у мета товарів з хешем: незмінений товар не надсилається повторно, а пакет, який Trendyol відхилив цілком, плагін розбирає поштучно, щоб знайти поганий товар.
• Замовлення без дублів: замок у базі на кожен пакет — паралельні webhook і опитування дають одне замовлення і одне списання залишку.
• Webhook захищено ключем (x-api-key), чужий запит отримує 401. Якщо Trendyol вимкне webhook після серії невдалих доставок, замовлення далі підбирає перевірка кожні 5 хвилин.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції, синхронізація працює далі.
• Видалення плагіна прибирає налаштування, поля Trendyol у товарах, журнал і завдання крону; дані Trendyol у замовленнях лишаються як історія.

Як встановити

1. Плагіни → Додати новий → Завантажити плагін: оберіть trendyol-connector-for-woocommerce-1.0.0.zip і активуйте.
2. WooCommerce → Trendyol → Connection: Seller ID, API key і API secret, збережіть і натисніть «Check the connection».
3. Listings: перевірте правила ціни, натисніть «Import and link products», потім «Resend all linked products».
4. Для Pro: вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал у вкладці Licence, далі — webhook у Connection і вкладки Orders та Publishing.