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.