Турция Интеграция с маркетплейсамиТурция Пакеты для e-commerceТурция Корпоративный сайтТурция Регистрация компанииТурция Фулфилмент-центр
Вход / Регистрация
Турция · Маркетплейсы

Полный разбор документации Trendyol API: авторизация, эндпоинты товаров, заказов и остатков, XML-фиды и примеры кода для подключения магазина.

🇹🇷 Полное руководство по Trendyol API — издание 2026

Турция — руководство по интеграции Trendyol 2026: REST API, XML-подключение и централизованное управление магазинами

Trendyol — маркетплейс №1 в Турции и одна из самых быстрорастущих платформ региона EMEA: более 30 млн активных пользователей, более 230 тыс. активных продавцов, годовой GMV свыше $10 млрд и инвестиции Alibaba Group в размере $750 млн в 2018 году, которые сделали его первым «декакорном» Турции. В 2026 году существует три легитимных способа интеграции с Trendyol: официальный REST API (рекомендуется для серьёзных продавцов), массовые фиды XML / CSV (подходят для простых каталогов) и независимый интегратор в качестве промежуточного слоя, например Zunapro. В этом руководстве разобраны архитектура API, пошаговое REST-подключение, потоки товаров, заказов, остатков и цен, Trendyol Express FBA, интеграция электронных счетов GİB, а также типичные ошибки и способы их избежать — всё актуально на 2026 год.

✓ Гибрид REST API + XML ✓ OAuth + Trendyol Express ✓ Совместимость с FBA Trendyol ✓ Автоматизация остатков и цен
zunapro.com/panel/trendyol
Хаб Trendyol API подключён
Рейтинг продавца 9.6 / 10
Товары
5,128
↑ 84 новых
В пути
312
↑ 12%
Сегодня
₺94.2K
↑ 27%
Последние 7 дней · Trendyol REST API ₺612.4K↑ 36%
ПнВтСрЧтПтСбСег
Заказы через вебхук Онлайн
#TY-91284 Apple iPhone 16 Pro 256GB Комплектация
#TY-91283 Mavi Jeans Erkek Slim Fit TY Express
#TY-91282 Karaca Çay Makinesi 1.7L Доставлен
Синхронизация API активна · последняя отправка 1 с назад · GİB e-Fatura готов
30M+
Активных пользователей Trendyol (2026)
230K+
Активных продавцов Trendyol
$10B+
Годовой GMV Trendyol
50K+
Постаматов Trendyol Express

Интеграция с Trendyol 2026 — коротко о главном

Trendyol — платформа электронной коммерции №1 в Турции: более 30 млн активных покупателей, более 230 тыс. активных продавцов, годовой GMV свыше $10 млрд и главный вход на рынок с более чем 85 млн потребителей. Есть три легитимных пути интеграции: официальный REST API на api.trendyol.com с HTTP Basic Auth (рекомендуется для серьёзных операций), массовые фиды XML / CSV, загружаемые ежечасно (приемлемо для небольших, медленно меняющихся каталогов), и независимый интегратор (Zunapro) в роли промежуточного слоя, который нормализует ваш мастер-каталог и отправляет данные в Trendyol и во все остальные маркетплейсы. Trendyol Express (более 50 тыс. постаматов самообслуживания и собственный курьерский парк) — фактический стандарт логистики, соблюдение требований GİB e-Fatura / e-Arşiv обязательно на уровне каждого заказа, а шкала комиссий Trendyol на 2026 год составляет 8–22% в зависимости от категории без фиксированной платы.

1. Архитектура Trendyol API в 2026 году

Marketplace API Trendyol — это RESTful-интерфейс JSON поверх HTTPS, опубликованный на едином production-адресе https://api.trendyol.com, с отдельной тестовой средой https://stageapi.trendyol.com. Каждый вызов API аутентифицируется через HTTP Basic Auth: заголовок Authorization содержит пару ApiKey:ApiSecret в кодировке base64, а Supplier ID передаётся как параметр пути в каждом эндпоинте уровня поставщика. Для собственных интеграций продавца нет отдельного обмена токеном доступа — Basic Auth проверяется при каждом запросе. Это упрощает интеграцию, но означает, что утёкшие учётные данные нужно немедленно сменить через панель Partner.

Базовый URL, аутентификация, заголовки

POST https://api.trendyol.com/sapigw/suppliers/{supplierId}/v2/products Authorization: Basic BASE64(ApiKey:ApiSecret) User-Agent: {supplierId} - SelfIntegration Content-Type: application/json Accept: application/json

Заголовок User-Agent не косметический: на нём основаны управление трафиком и учёт лимитов запросов в Trendyol. Интеграторы (например, Zunapro) отправляют {supplierId} - Zunapro; продавцы с собственной интеграцией — {supplierId} - SelfIntegration. Неверно заполненный заголовок User-Agent может вызывать ответы 401/403 даже при действительных учётных данных.

Лимиты запросов и квоты

Trendyol устанавливает лимиты запросов для каждого эндпоинта и каждого поставщика. Опубликованные лимиты на 2026 год:

  • Эндпоинты товаров — обычно 60 запросов в минуту на Supplier ID, с допуском всплеска до 90/мин в течение 30 секунд
  • Эндпоинты заказов — обычно 600 запросов в минуту (заказы по своей природе — высоконагруженный эндпоинт с низкой задержкой)
  • Эндпоинты обновления цен и остатков — обычно 100 запросов в минуту, при этом каждый запрос может содержать до 1000 SKU в одном пакете
  • Справочники категорий и атрибутов — обычно 30 запросов в минуту (эти данные меняются редко, поэтому предполагается активное кэширование)

Каждый ответ содержит заголовки X-RateLimit-Limit, X-RateLimit-Remaining, а при ответах 429 — Retry-After. Грамотно построенная интеграция использует очередь token bucket для каждого Supplier ID и снижает нагрузку при ответе 429 с экспоненциальной задержкой; Zunapro реализует это по умолчанию, чтобы даже массовые отправки на тысячи SKU укладывались в лимиты.

OAuth 2.0 для независимых интеграторов

Для независимых интеграторов промежуточного уровня (Zunapro и аналогичных SaaS-платформ, действующих от имени многих поставщиков) Trendyol предлагает поток OAuth 2.0 authorization code вместо прямого Basic Auth. Интегратор регистрирует client_id / client_secret в команде Trendyol по работе с разработчиками, поставщик авторизует интегратора в панели Partner, а интегратор получает токен доступа на 1 час и refresh token для повторного выпуска. Так интегратору никогда не приходится работать с исходными ApiKey / ApiSecret поставщика — это удобный для аудита путь для корпоративных клиентов, управляющих многими магазинами Trendyol.

Вебхуки

Trendyol отправляет события жизненного цикла заказа на зарегистрированный URL вебхука: Created, Picking, Invoiced, Shipped, Delivered, Cancelled, Returned, UnDelivered. Полезная нагрузка вебхука — JSON-конверт с ID заказа и новым статусом; ваш эндпоинт должен ответить HTTP 200 в течение 3 секунд. При ошибке Trendyol повторяет отправку 5 раз с экспоненциальной задержкой, а затем откладывает событие — поэтому сверочная выгрузка каждые 5 минут по /sapigw/suppliers/{id}/orders является обязательной страховкой.

Не тратьте время на API-обвязку — подключите Trendyol через Zunapro

Zunapro из коробки поддерживает все четыре режима авторизации Trendyol, очередь с учётом лимитов, сверочную выгрузку для вебхуков и подключение GİB e-Fatura. Одна панель — все ваши магазины Trendyol.

🚀 Подключить Trendyol

2. Подключение через REST API — пошагово

Официальный путь подключения к REST API Trendyol в 2026 году короткий и хорошо задокументирован, но порядок действий важен, потому что часть юридических требований предшествует работе с самим API.

2.1 Откройте аккаунт продавца Trendyol

Перейдите на partner.trendyol.com и подайте заявку «Открыть аккаунт Trendyol». Вам понадобятся:

  • VKN (Vergi Kimlik Numarası) — турецкий налоговый номер (или иностранный эквивалент регистрации бизнеса для Trendyol International)
  • Торговый реестровый вестник (Ticaret Sicil Gazetesi) для обществ с ограниченной ответственностью или акционерных обществ
  • Образцы подписей (imza sirküleri)
  • Квитанция о регистрации в ETBİS (Elektronik Ticaret Bilgi Sistemi) — обязательна для любого турецкого оператора электронной коммерции с 2018 года
  • Банковский счёт (IBAN TR) на имя юридического лица для выплат маркетплейса

Одобрение обычно занимает 2–5 рабочих дней. После одобрения продавец получает Supplier ID и доступ к панели Trendyol Partner.

2.2 Сгенерируйте API Key и Secret

В панели Partner откройте «Настройки аккаунта → Информация об интеграции» и нажмите «Создать API-ключ». Trendyol генерирует 40-символьный API Key и 40-символьный API Secret. Оба значения показываются один раз — получить их позже невозможно. Сохраните их в менеджере паролей или, что лучше, вставьте сразу в плитку интеграции Zunapro, где они хранятся как замаскированные секреты с шифрованием AES-256.

2.3 Первый проверочный запрос

Убедитесь, что учётные данные активны, обратившись к эндпоинту информации о поставщике:

curl -X GET "https://api.trendyol.com/sapigw/suppliers/{supplierId}/addresses" \ -H "Authorization: Basic $(echo -n 'API_KEY:API_SECRET' | base64)" \ -H "User-Agent: {supplierId} - SelfIntegration" \ -H "Accept: application/json"

Успешный ответ возвращает в JSON зарегистрированные адреса склада и возвратов поставщика. Ответ 401 означает, что заголовок Basic Auth неверен; 403 — что Supplier ID не соответствует учётным данным; 404 — что путь эндпоинта сформирован неправильно.

2.4 Вариант с OAuth (для интеграторов нескольких поставщиков)

Для независимых интеграторов поток OAuth 2.0 выглядит так:

1. Integrator redirects supplier to: https://partner.trendyol.com/oauth/authorize ?client_id={integratorClientId} &response_type=code &redirect_uri={integratorRedirectUri} 2. Supplier approves access; Trendyol redirects back with ?code={authCode} 3. Integrator exchanges code for tokens: POST https://api.trendyol.com/oauth/token grant_type=authorization_code code={authCode} client_id={integratorClientId} client_secret={integratorClientSecret} 4. Response: { access_token, refresh_token, expires_in: 3600 }

Токены доступа действуют 1 час и могут обновляться в течение 30 дней. Zunapro выполняет все четыре шага прозрачно, поэтому поставщик видит только одну кнопку «Подключить Trendyol».

2.5 Разместите первый товар

Используйте POST /sapigw/suppliers/{supplierId}/v2/products с JSON-массивом товаров. Минимальный объект товара требует полей barcode, title, productMainId, brandId, categoryId, quantity, stockCode, dimensionalWeight, description, currencyType (обычно TRY), listPrice, salePrice, vatRate, cargoCompanyId, массива images (1–8 URL) и массива attributes с ID атрибутов, специфичных для категории.

⚡

Совет: создание товаров асинхронно. POST возвращает batchRequestId; затем вы опрашиваете GET /sapigw/suppliers/{supplierId}/products/batch-requests/{batchRequestId}, чтобы увидеть результат или причины отклонения по каждому SKU. Zunapro опрашивает статус автоматически и показывает только отклонённые SKU с понятными сообщениями об ошибках и исправлением в один клик.

3. Синхронизация товаров в масштабе

Массовая загрузка — 1000 SKU в пакете

Эндпоинт Trendyol POST /v2/products принимает до 1000 SKU в одном JSON-запросе. Для продавцов с каталогами от 10 000 SKU это разница между часовым и многодневным подключением. Каждый вызов возвращает batchRequestId; Trendyol обрабатывает каждый пакет асинхронно и показывает успех / ошибку по каждому SKU после завершения обработки (обычно в течение 1–15 минут в зависимости от глубины очереди валидации).

Сопоставление категорий — самый сложный шаг

Дерево категорий Trendyol глубокое и строгое. По состоянию на 2026 год в нём около 12 000 конечных категорий, у каждой — собственный набор обязательных и необязательных атрибутов. Джинсы в категории «Мужчинам → Брюки → Повседневные» требуют атрибутов gender, size, color, material и fit-type; смартфон в категории «Электроника → Мобильные → Телефоны» — brand, model, memory, guaranteeType и warrantyPeriod. Размещение товара в неверной конечной категории или в верной, но без обязательного атрибута, приводит к «тихому» отклонению в результате пакета.

Рекомендуемый подход:

  1. Загрузите актуальное дерево категорий через GET /sapigw/product-categories (кэшируйте на 24 ч)
  2. Для каждой конечной категории загрузите обязательные и необязательные атрибуты через GET /sapigw/product-categories/{categoryId}/attributes
  3. Сопоставьте SKU мастер-каталога с конечными категориями Trendyol — Zunapro использует ML-сопоставитель, который предлагает категории по названию + бренду + вашей таксономии
  4. Проверяйте каждый SKU на наличие обязательных атрибутов до обращения к POST-эндпоинту, чтобы не тратить лимит запросов на заведомо неудачные запросы

Белый список брендов и brandId

Каждый товар должен ссылаться на brandId, существующий в реестре брендов Trendyol. Новые бренды нельзя создать «на лету» — они проходят ручное одобрение через панель Partner (обычно 1–3 рабочих дня). Используйте GET /sapigw/brands?name={brandName}, чтобы найти существующий brandId перед созданием товаров.

Правила загрузки изображений

  • 1–8 изображений на товар
  • Публичные HTTPS-адреса (Trendyol скачивает изображения и размещает их на своём CDN)
  • Минимум 1200×1800 px, белый фон для категорий одежды
  • JPG или PNG, не более ~10 МБ на изображение
  • Первое изображение становится миниатюрой в результатах поиска — уделите ему внимание

Опрос статуса пакета

GET https://api.trendyol.com/sapigw/suppliers/{supplierId}/products/batch-requests/{batchRequestId} Response: { "batchRequestId": "abc-def-...", "status": "COMPLETED", "itemCount": 1000, "items": [ { "requestItem": {...}, "status": "SUCCESS" }, { "requestItem": {...}, "status": "INVALID", "failureReasons": ["INVALID_BARCODE"] } ] }

📦 Не сопоставляйте 12 000 категорий вручную — доверьте это ML

Сопоставитель категорий Trendyol в Zunapro подбирает для вашего мастер-каталога подходящие конечные категории Trendyol, а вам остаётся лишь подтвердить предложения.

Начать сопоставление категорий →

4. Управление заказами — вебхуки и поток статусов

Жизненный цикл заказа в 2026 году

Заказ Trendyol проходит фиксированную последовательность статусов:

Created → Picking → Invoiced → Shipped → Delivered Branch flows: Cancelled (any time before Shipped) Returned (after Delivered, within 14-day window) UnDelivered (carrier exception)

Каждый переход одновременно порождает событие вебхука (push) и отражается в следующей выгрузке GET /orders (poll). За переходы Picking → Invoiced → Shipped отвечает продавец; переход Shipped → Delivered контролируют логистические партнёры Trendyol.

Приём вебхуков и идемпотентность

Каждый вебхук содержит уникальный shipmentPackageId. Обрабатывайте его идемпотентно — Trendyol повторяет события при ответе, отличном от 200, и двойная обработка на вашей стороне (двойной счёт, двойная комплектация) — реальный риск. Практичный шаблон:

POST /webhook/trendyol { "supplierId": 123456, "shipmentPackageId": 987654321, "status": "Picking", "timestamp": 1717930000000 } Handler: 1. Acquire lock on shipmentPackageId 2. Check stored status; if already >= "Picking", return 200 (no-op) 3. Persist new status, schedule downstream actions (e-invoice, picking task) 4. Return HTTP 200 within 3 seconds

Отмена и возврат средств

Отмены по инициативе покупателя приходят как вебхуки Cancelled; отмены по инициативе продавца отправляются через POST /sapigw/suppliers/{id}/orders/{orderId}/cancel с кодом причины отмены (OUT_OF_STOCK, OTHER и т. д.). Возвраты средств за доставленные и возвращённые товары Trendyol обрабатывает автоматически; единственная обязанность продавца — подтвердить получение возвращённого товара в течение 48 часов после сканирования перевозчиком.

Транспортная этикетка Trendyol Express

Когда отправление переведено в статус Picking, запросите транспортную этикетку через GET /sapigw/suppliers/{id}/orders/{orderId}/labels — Trendyol возвращает PDF (и при необходимости ZPL для термопринтеров) со штрихкодом Trendyol Express, адресом покупателя и номером отслеживания. Штрихкод — единственный артефакт маршрутизации перевозчика: распечатайте, наклейте, отсканируйте в WMS и сдайте в пункт приёма Trendyol Express (или закажите курьерский забор, если у вас большой объём).

5. Остатки и цены в реальном времени

Шаблон отправки остатков и цен

Trendyol предоставляет отдельный эндпоинт для обновления остатков и цен: POST /sapigw/suppliers/{id}/products/price-and-inventory. Каждый вызов принимает до 1000 позиций с полями barcode, quantity, salePrice и необязательным listPrice. Обновления остатков применяются в течение секунд, цен — в течение 2–5 минут (Trendyol кэширует цены для согласованности торговых фидов).

POST /sapigw/suppliers/{id}/products/price-and-inventory { "items": [ { "barcode": "8690123456789", "quantity": 42, "salePrice": 549.90, "listPrice": 699.90 }, { "barcode": "8690987654321", "quantity": 0, "salePrice": 199.00 } ] }

Архитектура синхронизации «Мастер → Локально → Цели»

Для продавцов, работающих в нескольких каналах продаж (Trendyol + Hepsiburada + Çiçeksepeti + собственный магазин), единственная разумная архитектура — мастер-остатки в Zunapro, которые отправляются во все целевые маркетплейсы. Zunapro сочетает периодическую задачу (cron) с событийной отправкой: любое изменение остатка в мастере сразу запускает отправку price-and-inventory в Trendyol, а cron обеспечивает итоговую согласованность для отправок, которые могли потеряться. SKU сопоставляются по штрихкоду (основной способ) или stockCode (резервный) — никогда по внутреннему ID товара Trendyol, который может меняться при пересопоставлении категорий.

Правила НДС и отображения цен

Цены на Trendyol указываются с учётом НДС. Режим НДС Турции (KDV) в 2026 году: 20% — стандартная ставка, 10% — пониженная (продукты питания, книги, лекарства, товары первой необходимости) и 1% — специальная (основные продукты питания, отдельные сельхозпродукты). Продавец указывает vatRate для каждого товара и отвечает за выбор правильной ставки; ошибки выявляются задним числом в виде отклонения электронного счёта GİB, и их исправление обходится дорого.

Trendyol Fast Sale и синхронизация кампаний

Флагманские кампании Trendyol — Trendyol Fast Sale (Hızlı Satış), Trendyol Week, Çarşamba Pazarı («Рынок среды») — повышают видимость товаров, но предполагают дополнительную комиссию кампании 1–3%. Продавцы включают SKU в кампании через POST /sapigw/suppliers/{id}/products/campaigns со сниженными ценами; Zunapro автоматически проверяет минимальные цены кампании по вашим правилам маржи в мастере, чтобы не допустить обязательств ниже себестоимости.

6. Альтернатива XML / CSV — когда её использовать (и когда нет)

Модель загрузки XML (pull)

Trendyol поддерживает модель XML-фида как альтернативу REST POST. Продавец размещает XML-файл с описанием каталога по публичному HTTPS-адресу; Trendyol забирает его с настраиваемой периодичностью (обычно каждые 1–4 часа). XML-схема опубликована в панели Partner и повторяет структуру объекта товара REST-эндпоинта — barcode, title, brandId, categoryId, атрибуты, изображения, цена, остаток.

Та же схема поддерживается в формате CSV (одна строка на SKU) для продавцов, чья ERP естественнее выгружает CSV, чем XML.

Сравнение: REST API и XML / CSV

REST API
Реальное время
Мгновенная отправка остатков, заказы через вебхуки, полный двусторонний обмен, пакеты по 1000 SKU
XML-фид
Загрузка раз в 1–4 ч
Ежечасное обновление каталога, без вебхуков и массовых пакетов — подходит для <500 стабильных SKU
CSV-выгрузка
Ежедневно
Разовое массовое обновление без потока событий — полезно только для архивов или однократного импорта

Когда XML / CSV действительно оправданы

  • Устаревшая ERP без возможности HTTP-клиента, которая уже выгружает XML / CSV каждую ночь
  • Медленно меняющиеся каталоги (менее 500 SKU, еженедельное изменение цен, ежемесячное пополнение каталога)
  • Первичная миграция с другого маркетплейса, когда разовая CSV-выгрузка ускоряет первую синхронизацию

Во всех остальных случаях — вебхуки заказов, остатки в реальном времени, участие в кампаниях, многоканальная синхронизация — REST в 2026 году остаётся единственным жизнеспособным путём. Zunapro поддерживает оба режима, но по умолчанию использует REST, а XML / CSV — строго как ETL-источник данных из устаревших ERP.

7. Trendyol Express и FBA Trendyol

Trendyol Express — логистический слой

Trendyol Express — полностью принадлежащее Trendyol логистическое подразделение, запущенное в 2018 году и сегодня управляющее самой плотной в Турции посылочной сетью, созданной для электронной коммерции. К 2026 году она охватывает более 50 000 постаматов самообслуживания и пунктов выдачи наряду с собственным курьерским парком, работает во всех 81 провинции с доставкой в тот же день в Стамбуле, Анкаре, Измире, Бурсе и Анталье и доставкой на следующий день по остальной материковой Турции. Покупатели видят значки «Hızlı Teslimat» (быстрая доставка) на подходящих товарах, и поисковое ранжирование Trendyol придаёт им большой вес.

FBA Trendyol — логистический склад Trendyol

FBA Trendyol (иногда называемый «Trendyol Lojistik Deposu» или «Trendyol Mağaza Plus») — аналог Amazon FBA: продавцы отправляют товар в фулфилмент-центры Trendyol в Чорлу (флагманский объект площадью 250 000 м² под Стамбулом), Санджактепе и Анкаре, а Trendyol берёт на себя хранение, комплектацию, упаковку, доставку последней мили через Trendyol Express и возвраты. Товары FBA получают отдельный значок «Trendyol'dan Gönderim» и приоритетный вес в поиске.

Тарифы и требования FBA Trendyol

  • Подключение — заявка через панель Partner; коммерческая команда Trendyol оценивает месячный объём, габариты SKU и соответствие категории
  • Плата за хранение — ежемесячно за кубический метр занимаемого складского пространства; зависит от сезона (хранение в Q4 дороже)
  • Плата за комплектацию и упаковку — фиксированная ставка за заказ в зависимости от весовой категории отправления (до 500 г, 500 г–2 кг, 2–5 кг, 5–10 кг, 10 кг+)
  • Обработка возвратов — для стандартных возвратов входит в плату за комплектацию и упаковку; особые случаи оплачиваются отдельно

Когда FBA Trendyol имеет смысл

Точка безубыточности FBA Trendyol по сравнению с самостоятельным фулфилментом — примерно 800–1200 единиц в месяц на складской SKU для быстрооборачиваемых расходных товаров, электроники или одежды в размерных рядах. Ниже этого порога самостоятельный фулфилмент через сдачу отправлений в Trendyol Express плюс собственный договор с Aras / Yurtiçi / DHL обычно дешевле. Выше — рост конверсии благодаря значку «Trendyol'dan Gönderim» и обещанию доставки в тот же день почти всегда перевешивает стоимость фулфилмента за единицу.

📦 Читайте полное руководство по Trendyol Express и FBA

Плата за хранение по сезонам, тарифные диапазоны комплектации и упаковки, процесс подключения к складу в Чорлу и расчёт точки безубыточности при переходе с самостоятельного фулфилмента на FBA Trendyol.

Читать руководство по FBA Trendyol →

8. Интеграция электронных счетов GİB (e-Fatura / e-Arşiv)

Требование GİB

Gelir İdaresi Başkanlığı (GİB — Управление доходов Турции) сделало e-Fatura обязательной для любого бизнеса с годовым оборотом выше опубликованного GİB порога (пересматривается ежегодно; ~TRY 3M по состоянию на 2026 год), а e-Arşiv Fatura — обязательной для всех B2C-счетов свыше ~TRY 30,000 (пересматривается ежегодно). Для активных продавцов Trendyol в 2026 году охват e-Fatura / e-Arşiv фактически всеобщий — практически каждый заказ на маркетплейсе должен сопровождаться электронным счётом со штампом GİB в пределах окна статуса заказа, иначе грозят штрафы.

Пять сертифицированных GİB интеграторов

Продавцы могут либо напрямую использовать портал GİB (непрактично при объёмах маркетплейса), либо заключить договор с сертифицированным GİB Özel Entegratör (специальным интегратором). Пять ведущих игроков в 2026 году:

  • Logo Yazılım — крупнейший турецкий разработчик ERP; e-Logo для выставления счетов
  • Mikro Yazılım — провайдер ERP и электронных счетов для среднего бизнеса, силён в сегменте МСБ
  • Uyumsoft — независимый интегратор с надёжным REST API и крупнейшей базой продавцов маркетплейсов
  • Foriba — провайдер корпоративного уровня (приобретён Sovos в 2019 году), силён в регулируемых отраслях
  • Veriban — быстрорастущая альтернатива с конкурентными ценами и удобным для разработчиков API

Поток электронных счетов на маркетплейсе

1. Trendyol webhook: order status -> "Picking" 2. Zunapro pulls order detail (buyer name, VKN/TCKN, address, items) 3. Zunapro POSTs invoice draft to integrator (Logo/Mikro/Uyumsoft/Foriba/Veriban) 4. Integrator signs with e-Signature certificate, submits to GİB 5. GİB returns ETTN (Electronic Document Unique Number) 6. Zunapro stores ETTN, attaches PDF to Trendyol order 7. Zunapro transitions Trendyol order Picking -> Invoiced via API

Практичный выбор в 2026 году

Новым продавцам проще всего подключить Uyumsoft и Veriban (регистрация онлайн, REST API, без локальной инфраструктуры). Продавцам, уже работающим с ERP Logo или Mikro, стоит остаться на продукте электронных счетов того же вендора ради сверки в бухгалтерии. Foriba — выбор крупных предприятий со сложными налоговыми процессами. Zunapro поставляется со всеми пятью интеграциями на одном экране настройки — выберите интегратора, вставьте учётные данные API, и каждый заказ Trendyol будет получать счёт автоматически.

9. Типичные ошибки и как их избежать

Несоответствие категории

Симптом: результат пакета показывает INVALID_CATEGORY или CATEGORY_NOT_LEAF. Причина: размещение в неконечной категории или в конечной категории, набору атрибутов которой SKU не соответствует. Решение: всегда размещайте товары только в конечных категориях (API отклоняет неконечные) и заранее проверяйте атрибуты по набору required: true категории перед POST.

Отсутствуют обязательные атрибуты

Симптом: MANDATORY_ATTRIBUTE_MISSING для в остальном корректных SKU. Причина: Trendyol помечает ~30% атрибутов обязательными в зависимости от категории (пол для одежды, гарантия для электроники и т. д.). Решение: кэшируйте карту обязательных атрибутов по категориям и пропускайте POST только для полных данных; Zunapro по возможности автоматически заполняет их из вашей мастер-таксономии.

Задержки синхронизации остатков

Симптом: распроданный SKU ещё несколько минут отображается на Trendyol как имеющийся в наличии, что приводит к перепродажам. Причина: отправки price-and-inventory согласуются в конечном счёте с медианной задержкой ~5–8 секунд, а в пиковые периоды (Black Friday, Trendyol Week) очередь может растягиваться до 30–60 секунд. Решение: используйте локальный страховой буфер (резервируйте последние 1–2 единицы как буфер «нет в наличии» для каждого быстро продающегося SKU) и отправляйте изменения остатков синхронно по событию подтверждения заказа, а не только по cron.

Пропуски вебхуков

Симптом: вебхук заказа не приходит вовсе или приходит с опозданием на часы. Причина: обычно изменение файрвола на стороне продавца, продление TLS-сертификата, сломавшее URL вебхука, или кратковременный сбой, превысивший лимит Trendyol в 5 повторов. Решение: всегда запускайте параллельную сверочную выгрузку каждые 5 минут по /sapigw/suppliers/{id}/orders?status=Created&startDate=...; Zunapro делает это по умолчанию и идемпотентно объединяет любой выгруженный заказ, который также пришёл через вебхук.

Несколько карточек с одним штрихкодом (Mükerrer Listing)

Симптом: один SKU отображается как несколько карточек Trendyol, и остаток на каждой уменьшается по-разному. Причина: исторические слияния, дублирующиеся штрихкоды или размещение одного товара в нескольких магазинах. Решение: политика дедупликации по минимальному остатку (MIN-stock) в Zunapro (введена в нашем production-обновлении от 2026-06-06) объединяет все дублирующиеся карточки под одним штрихкодом и отслеживает минимальное значение остатка среди них, предотвращая классическую ситуацию «продано дважды на двух карточках, а доставить можно один».

10. Комиссии и сборы Trendyol в 2026 году

Шкала комиссий Trendyol на 2026 год разбита по категориям на три широких диапазона без фиксированной платы за единицу. Участие в кампаниях (Trendyol Fast Sale, Trendyol Week, Çarşamba Pazarı) добавляет к ставке категории ещё 1–3%.

Низкий диапазон
8% – 12%
Электроника, крупная бытовая техника, компьютеры, смартфоны, книги, канцтовары
Средний диапазон
13% – 18%
Дом и интерьер, кухня, сад, спорт, товары для животных, детские товары, игрушки, автозапчасти
Высокий диапазон
18% – 22%
Одежда, обувь, красота, косметика, ювелирные изделия, аксессуары, лайфстайл
📋
Официальная шкала комиссий Trendyol: Trendyol публикует комиссии по каждой категории в своём Partner Help Center в разделе «Komisyon Oranları». Таблица обновляется ежеквартально. Zunapro синхронизирует актуальную таблицу комиссий со своим модулем маржи, чтобы расчёт чистой маржи оставался точным даже при переклассификации категорий Trendyol. Комиссии кампаний отображаются отдельно, чтобы решения об участии принимались с полным пониманием маржи.

Абонентская плата и сборы

Trendyol не взимает ежемесячную абонентскую плату. Уровня «Professional Seller», как у Amazon, нет. Продавцы платят:

  • Комиссию категории с каждой продажи (8–22%)
  • Комиссию кампании при участии в Trendyol Fast Sale / Week (+1–3%)
  • Trendyol Express — плату за каждое отправление (оплачивает покупатель, но она проходит через P&L продавца)
  • Хранение и комплектацию FBA Trendyol (только при подключении)
  • Trendyol Ads CPC (по желанию, под контролем продавца)

Цикл выплат

Стандартные продавцы получают выплаты по циклу T+14 (через 14 дней после доставки заказа); для продавцов с наивысшим рейтингом срок сокращается до T+7. Спорные заказы, возвраты в пределах 14-дневного окна и чарджбэки удерживаются из выплаты. Выплаты поступают на зарегистрированный турецкий IBAN.

KDV (НДС) и диапазоны ставок

НДС Турции — KDV (Katma Değer Vergisi) — в 2026 году имеет три ставки: 20% — стандартная, 10% — пониженная (продукты питания, книги, лекарства, гостиничные услуги), 1% — специальная (основные продукты питания, сельхозпродукция). Продавцы маркетплейсов, зарегистрированные в Турции, встают на учёт по KDV в местной налоговой инспекции; трансграничные продавцы, превышающие порог для цифровых услуг, используют режим KDV для нерезидентов. Поле vatRate в каждом POST-запросе товара в Trendyol должно соответствовать юридически правильной ставке — ошибки переходят в электронные счета и могут потребовать корректирующих деклараций.

e-Fatura / e-Arşiv (обязательно по требованию GİB)

Подробно описано в разделе 8. Главное на 2026 год: каждый заказ на маркетплейсе сопровождается электронным счётом со штампом GİB (e-Fatura для B2B / зарегистрированных получателей e-Fatura, e-Arşiv для B2C). Продавец отвечает за выставление счёта в пределах окна статуса заказа. Ручное выставление при объёмах маркетплейса непрактично — выберите одного из пяти интеграторов GİB и автоматизируйте процесс.

KVKK — турецкий аналог GDPR

KVKK (Kişisel Verilerin Korunması Kanunu — Закон № 6698) — турецкий режим защиты персональных данных, по структуре схожий с GDPR; за его соблюдением следит KVKK Kurumu (Управление по защите персональных данных). Маркетплейсы отвечают за согласие и обработку данных покупателей, но продавцы остаются совместными операторами при любом прямом контакте службы поддержки, маркетинге или коммуникации после покупки. Штрафы за нарушения составляют от TRY 60K до TRY 3M+ в зависимости от категории нарушения.

ETBİS — обязательный реестр электронной коммерции

ETBİS (Elektronik Ticaret Bilgi Sistemi) — обязательный реестр Министерства торговли для любого оператора электронной коммерции в Турции, действующий с 2018 года. Продавцы должны зарегистрироваться до размещения товаров на Trendyol и ежегодно сообщать объёмы транзакций. Данные ETBİS используются для защиты прав потребителей, противодействия мошенничеству и анализа конкуренции.

Защита прав потребителей — 14 дней на отказ, 2 года гарантии

  • 14-дневное право на отказ — турецкие потребители могут вернуть любой товар, купленный дистанционно, в течение 14 дней без объяснения причин (Tüketicinin Korunması Hakkında Kanun, Закон № 6502)
  • 2-летняя установленная законом гарантия — обязательна при B2C-продажах, независимо от гарантии производителя
  • Обязательная информация о товаре на турецком языке — название, описание, гарантия, условия возврата — всё на турецком

Логистика и доставка в Турции — прежде всего Trendyol Express

Trendyol Express — доминирующий слой

Trendyol Express — перевозчик по умолчанию примерно для 70%+ заказов Trendyol в 2026 году. Покупатель видит бесплатную или недорогую доставку в тот же или на следующий день в крупных городах, а также более 50 000 постаматов самообслуживания (Trendyol Hızlı Teslimat Noktaları), где посылки можно забрать 24/7. Продавцы либо сдают отправления в пункт приёма Trendyol Express, либо заказывают курьерский забор; маршрутный лист содержит штрихкод Trendyol Express, полученный через API этикеток заказа.

Другие интегрированные перевозчики

  • Yurtiçi Kargo — давно работающая турецкая курьерская служба с сильной сетью B2C и B2B, интегрирована для заказов Trendyol
  • Aras Kargo — конкурент с сильным покрытием Анатолии, часто используется для заказов Trendyol с самостоятельным фулфилментом
  • DHL Kargo — третья крупная турецкая курьерская служба, частый резервный вариант для продавцов с большим объёмом
  • PTT Kargo — государственный почтовый оператор, самый широкий охват сельских районов, более длительные сроки
  • Sürat Kargo — региональный игрок, конкурентоспособный в Мраморноморском и Эгейском регионах

Практичный набор доставки в 2026 году

Прагматичный набор для продавца Trendyol в 2026 году: Trendyol Express по умолчанию (этого ожидают покупатели), Yurtiçi или Aras как резерв со стороны продавца для заказов с самостоятельным фулфилментом, не успевших к окну забора Trendyol Express, PTT Kargo для сельских почтовых индексов, где другие перевозчики невыгодны, и FBA Trendyol для быстро продающихся SKU, когда объём оправдывает расходы на хранение.

Как начать продавать на Trendyol — подключение в 5 шагов

1. Аккаунт продавца Trendyol

Подайте заявку на partner.trendyol.com. Предоставьте VKN, Торговый реестровый вестник, образцы подписей, квитанцию о регистрации в ETBİS и турецкий IBAN. Одобрение — за 2–5 рабочих дней.

2. ETBİS и налоговая регистрация

Зарегистрируйте юридическое лицо в ETBİS через портал Министерства торговли (etbis.gtb.gov.tr) и подтвердите регистрацию по KDV в местной налоговой инспекции. Иностранные продавцы, работающие через Trendyol International, либо назначают турецкого представителя, либо используют программу Trendyol, в которой площадка выступает импортёром.

3. Сгенерируйте API Key и Secret

В панели Partner → «Настройки аккаунта» → «Информация об интеграции» нажмите «Создать API-ключ». Скопируйте API Key (40 символов) и API Secret (40 символов) сразу — они показываются только один раз. Вставьте их в плитку Trendyol в Zunapro, где они хранятся в зашифрованном (AES-256) и замаскированном виде.

4. Подключение через панель Zunapro

  1. Войдите в Zunapro и откройте модуль «Турция»
  2. Вставьте Supplier ID + API Key + API Secret в плитку интеграции Trendyol
  3. Запустите автоматическую проверку (учётные данные, эндпоинт адресов, информация о поставщике)
  4. Подтвердите предложенные ML сопоставления категорий для ваших топ-100 SKU
  5. Выберите интегратора электронных счетов (Logo, Mikro, Uyumsoft, Foriba или Veriban) и вставьте его учётные данные
  6. Включите «Trendyol Express» + «FBA Trendyol» (если подключены)

5. Проведите тестовый заказ

Разместите 3–5 тестовых заказов через stageapi.trendyol.com, чтобы проверить от начала до конца комплектацию и упаковку, печать этикеток, смену статусов и возврат средств. Когда всё в порядке, переключите интеграцию в рабочий режим одним переключателем. Скорость первой рабочей синхронизации каталога зависит от лимитов запросов Trendyol.

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

Trendyol REST API + Trendyol Express + FBA Trendyol + GİB e-Fatura (Logo / Mikro / Uyumsoft / Foriba / Veriban) — всё в одной плитке Zunapro. ML-сопоставление категорий, событийная отправка остатков, дедупликация дублирующихся карточек (mükerrer listing) и сводка по нескольким магазинам — из коробки.

🇹🇷 Подключить Trendyol →

Три пути интеграции с Trendyol — сравнение

Прежде чем выбрать архитектуру интеграции, полезно сравнить три легитимных пути бок о бок.

1. Официальный REST API (напрямую)

Собственный клиент для api.trendyol.com · полный контроль в реальном времени · самые высокие затраты на разработку · поддержка силами вашей команды

Реальное времяНужна команда разработчиков

2. Массовый фид XML / CSV

XML- или CSV-каталог по публичному URL · Trendyol забирает его каждые 1–4 ч · без вебхуков и остатков в реальном времени · просто, но ограниченно

Раз в 1–4 чЛучше всего для <500 SKU

3. Независимый интегратор (Zunapro)

Подключение через промежуточный слой Zunapro · REST + XML + OAuth под ключ · сводка по нескольким маркетплейсам · GİB + KVKK + ETBİS в одной панели

Одна панельREST + XML + OAuth

Вопросы и ответы по интеграции с Trendyol 2026

Как получить API-ключ Trendyol в 2026 году?

Войдите в панель Trendyol Partner (partner.trendyol.com), откройте «Настройки аккаунта → Информация об интеграции» и нажмите «Создать API-ключ». Trendyol сгенерирует тройку Supplier ID + 40-символьный API Key + 40-символьный API Secret. Значения показываются один раз — скопируйте их сразу.

Учётные данные сразу активны на api.trendyol.com. Zunapro хранит их как замаскированные секреты с шифрованием AES-256 и подписывает каждый REST-запрос через HTTP Basic Auth от вашего имени. Смена ключей — один клик в панели Partner и один клик в Zunapro.

Как работает поток OAuth 2.0 в Trendyol?

Для продавцов с собственной интеграцией Marketplace API Trendyol напрямую использует HTTP Basic Auth — Supplier ID + API Key + API Secret в каждом запросе, без обмена токенами. Это самый простой и распространённый шаблон.

Для независимых интеграторов, подключающихся от имени нескольких поставщиков, Trendyol предлагает полноценный поток OAuth 2.0 authorization code: интегратор регистрирует client_id / client_secret, поставщик авторизует интегратора в панели Partner, интегратор получает токен доступа на 1 час и refresh token на 30 дней. Zunapro использует этот путь для корпоративных клиентов, управляющих многими магазинами Trendyol.

XML или REST API — какую интеграцию с Trendyol выбрать?

Используйте REST API для любой активной, событийной интеграции — отправки остатков и цен в реальном времени, приёма заказов через вебхуки, мгновенного отображения изменений запасов, многоканальной синхронизации. Это правильный выбор почти для любого современного продавца Trendyol.

Используйте XML или CSV только для простых, медленно меняющихся каталогов (менее 500 SKU, еженедельные или ежемесячные обновления, без двустороннего обмена по заказам). Это также удобный разовый путь для первичной миграции с другого маркетплейса. Zunapro по умолчанию использует REST, а XML/CSV — строго как ETL-источник данных из устаревших ERP.

Как работать с лимитами запросов Trendyol API?

Trendyol устанавливает лимиты запросов для каждого эндпоинта и каждого Supplier ID — обычно 60 запросов/мин для эндпоинтов товаров, 600 запросов/мин для эндпоинтов заказов, 100 запросов/мин для эндпоинтов остатков и цен (до 1000 SKU в одном вызове). Каждый ответ содержит заголовок X-RateLimit-Remaining, а при ответах 429 — Retry-After.

Правильный шаблон — очередь token bucket для каждого Supplier ID, экспоненциальная задержка при HTTP 429 и активное объединение в пакеты для максимальной пропускной способности на запрос. Zunapro реализует все три механизма по умолчанию, чтобы даже массовые отправки на тысячи SKU укладывались в лимиты.

Подходит ли Trendyol Express FBA для моего бизнеса?

FBA Trendyol (Trendyol Lojistik Deposu) имеет смысл, если у вас стабильный объём (>800–1200 единиц в месяц на складской SKU), устойчивый ассортимент SKU, которому выгодны значки «Trendyol'dan Gönderim» с доставкой в тот же или на следующий день, и работа в Стамбуле, Анкаре, Измире, Бурсе или Анталье, где действует обещание доставки в тот же день.

При меньшем объёме самостоятельный фулфилмент через сдачу отправлений в Trendyol Express плюс собственный договор с Aras / Yurtiçi / DHL обычно дешевле. Точка безубыточности зависит от категории — быстро оборачиваемая одежда и расходные товары выходят на положительную экономику FBA быстрее, чем медленно продающаяся электроника.

Как рассчитываются комиссии Trendyol в 2026 году?

Шкала комиссий Trendyol на 2026 год составляет от 8% до 22% в зависимости от категории, без фиксированной платы за единицу. Электроника и крупная бытовая техника находятся в диапазоне 8–12%; дом и интерьер, спорт и товары для животных — 13–18%; мода, красота и аксессуары — 18–22%.

Участие в кампаниях (Trendyol Fast Sale, Trendyol Week, Çarşamba Pazarı) добавляет к ставке категории дополнительную комиссию 1–3%. Комиссии удерживаются до выплаты по циклу T+14 (T+7 для продавцов с наивысшим рейтингом). Zunapro синхронизирует актуальную таблицу комиссий и показывает чистую маржу по каждому SKU в реальном времени.

Как провести тестовые заказы на Trendyol перед запуском?

Trendyol предоставляет тестовую среду stageapi.trendyol.com, повторяющую production-схему REST. Запросите тестовые учётные данные у своего менеджера Trendyol или в разделе для разработчиков панели Partner.

Zunapro переключает интеграцию между тестовой и рабочей средой одним переключателем. Стандартный процесс подключения включает 3–5 тестовых заказов, охватывающих комплектацию и упаковку, создание транспортной этикетки, смену статусов (Created → Picking → Invoiced → Shipped → Delivered) и как минимум один сценарий отмены с возвратом средств — всё до активации рабочих учётных данных.

Мой вебхук заказов пропускает события — что проверить?

Во-первых, проверьте URL вебхука в панели Partner и убедитесь, что он возвращает HTTP 200 в течение 3 секунд — Trendyol повторяет неудачные вебхуки 5 раз с экспоненциальной задержкой, после чего откладывает событие.

Во-вторых, убедитесь, что ваш файрвол пропускает исходящий диапазон IP-адресов Trendyol, опубликованный в документации для разработчиков. В-третьих, проверьте срок действия TLS-сертификата — незаметно истёкший сертификат является самой частой причиной ситуации «вебхуки внезапно перестали работать».

В-четвёртых и в главных: запускайте параллельную сверочную выгрузку каждые 5 минут по GET /sapigw/suppliers/{id}/orders?status=Created как страховку. Zunapro делает это по умолчанию и идемпотентно объединяет выгруженные заказы с полученными через вебхук.

Можно ли управлять несколькими магазинами Trendyol из одной панели?

Да. Trendyol поддерживает несколько Supplier ID в рамках одного юридического лица — разные бренды, разные склады, разные настройки НДС. Zunapro подключает каждый Supplier ID как независимую интеграцию, но сводит заказы, остатки и аналитику в единую панель.

Правила распределения остатков позволяют делить мастер-SKU между магазинами по проценту (например, 70% — флагманскому магазину, 30% — аутлету), по географии или по приоритету маркетплейса. Политика дедупликации по минимальному остатку (production-обновление от 2026-06-06) не допускает перепродаж из-за дублирующихся карточек в разных магазинах.

Насколько сложно сопоставление категорий Trendyol?

Trendyol использует глубокое и строгое дерево категорий — около 12 000 конечных категорий в 2026 году — с обязательными наборами атрибутов для каждой категории. Размещение в неверной конечной категории или в верной, но без обязательного атрибута, приводит к «тихому» отклонению товара в результате пакета.

Ручное сопоставление для каталога из 5000 SKU реально занимает 40–80 человеко-часов. ML-сопоставитель категорий Zunapro предлагает нужную конечную категорию по названию + бренду + вашей существующей таксономии, а вам остаётся проверить и подтвердить предложения.

Могут ли иностранные продавцы (из Германии, России, ОАЭ) продавать на Trendyol?

Да. Trendyol International Seller Center принимает продавцов из ЕС, региона MENA и СНГ. У нетурецких компаний есть два пути:

(1) получить турецкий налоговый номер (VKN) через местный филиал или назначенного представителя и продавать через обычный турецкий аккаунт поставщика; (2) продавать через трансграничную программу Trendyol International, в которой Trendyol выступает импортёром и берёт на себя таможенное оформление и доставку последней мили. Требования KVKK (защита данных) и ETBİS (реестр электронной коммерции) по-прежнему применяются к любому продавцу, ориентированному на турецких потребителей, независимо от места регистрации юридического лица.

Как проходит подключение Trendyol к Zunapro?

Первичное подключение: вставьте Supplier ID + API Key + Secret, запустите проверку учётных данных и подтвердите предложенные ML сопоставления категорий для ваших топ-100 SKU.

Скорость полной синхронизации каталога зависит от его размера, а также от лимитов запросов и размеров пакетов Trendyol. Если KVKK-согласие, подтверждение регистрации в ETBİS и подключение провайдера электронных счетов GİB (Logo, Mikro, Uyumsoft, Foriba или Veriban) ещё не настроены, их нужно выполнить дополнительно, после чего новый продавец Trendyol работает с автоматическим выставлением счетов.

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

Trendyol · Hepsiburada · Çiçeksepeti · N11 · Amazon TR — один мастер-каталог, единые остатки, единый поток GİB e-Fatura. ML-сопоставление категорий, событийная отправка остатков, интеграция Trendyol Express + FBA Trendyol, готовность к KVKK + ETBİS.

🇹🇷 Начать продавать на Trendyol →
Поделиться:

Нужна помощь?

Связанная услуга: Маркетплейсы

Свяжитесь с нами

Получите бесплатную консультацию по вашему проекту электронной коммерции.

Написать в WhatsApp