Trendyol Entegrasyonu: API, XML, Fulfillment ve Tek Panelden Mağaza Yönetimi

Trendyol Hakkında: Kuruluş, Yatırımcılar ve Pazar Konumu

Kuruluş ve Tarihçe (2010 – Bugün)

Trendyol, Harvard Business School mezunu Demet Mutlu tarafından 2010'da İstanbul'da, moda odaklı bir indirim/üye-kulübü modeli olarak kuruldu. İlk yatırımcısı Tiger Global Management'tır. 2011–2017 arasında Türkiye'deki online giyim satışının en büyük oyuncusu haline geldi. 2018'de Alibaba Group, Trendyol'un çoğunluk hissesini yaklaşık 750 milyon dolara satın aldı; bu Türk teknoloji tarihinin en büyük yatırımlarından biriydi.

2021'de SoftBank Vision Fund 2, General Atlantic ve Princeville Capital liderliğindeki 1.5 milyar dolarlık yatırım turunda Trendyol 16.5 milyar dolar değerleme ile Türkiye'nin ilk "decacorn"u oldu. Bugün Trendyol; pazaryeri (3P), kendi markası (1P), Trendyol Express kargo, Trendyol Yemek, Trendyol Tickets, Dolap (ikinci el) ve Hizmet dikeylerine yayılmış multi-vertical bir teknoloji ekosistemidir.

Trendyol Sahiplik Yapısı (2025)

• Alibaba Group — Çoğunluk hissedarı (≈%87, 2018 satın alma + 2021 ek alım)
• General Atlantic — Azınlık (2021 turundan)
• SoftBank Vision Fund 2 — Azınlık
• Princeville Capital, Qatar Investment Authority — Diğer kurumsal yatırımcılar
• Demet Mutlu — Kurucu ortak, stratejik danışman

Türkiye E-Ticaretindeki Konumu

Trendyol, 2024 itibarıyla Türkiye e-ticaret pazarının yaklaşık %35-40'ını elinde tutarak Hepsiburada, N11 ve Amazon.com.tr'nin önündedir. Türkiye'nin online alışveriş yapan her 10 kişisinden 6'sı Trendyol kullanıcısıdır. Mobil uygulaması Türkiye'nin en çok indirilen alışveriş uygulamasıdır.

Trendyol Satış Hacmi ve Büyüklük (2024–2025 Verileri)

Trendyol, son 5 yılda Türkiye e-ticaretinin lokomotifi haline geldi. Gross Merchandise Value (GMV) ve sipariş hacmi her yıl %40–60 büyüme gösterdi.

Yıl	GMV (USD)	Sipariş	Aktif Müşteri	Aktif Satıcı
2020	~$3 milyar	220 milyon	18M	100K
2022	~$6 milyar	600 milyon	26M	170K
2024	~$10 milyar	1.5 milyar	30M+	230K+
2025 (öngörü)	~$13 milyar	2 milyar	35M	280K

Bu büyüme; Trendyol Express'in Türkiye genelinde aynı/ertesi gün teslimat altyapısı, mobil uygulamadaki kişiselleştirme algoritması ve Trendyol Yıldız Mağaza programı sayesinde gerçekleşti. Trendyol pazaryerine satıcı olarak girmek, Türkiye'deki en hızlı online büyüme rotasıdır.

Trendyol'da Mağaza Açma Süreci (2026 Güncel Kurallar)

1. Yasal ve Mali Gereksinimler

Trendyol'da satıcı olmak için Türkiye'de aktif vergi mükellefiyetiniz olmalıdır. Şahıs şirketi, limited veya anonim şirket farketmez; ancak e-Fatura mükellefi olmak ve e-Arşiv fatura kesebilmek zorunludur.

• Vergi levhası (güncel yıl)
• Vergi numarası ve TC kimlik no (şahıs şirketi için)
• Ticaret sicil gazetesi (ltd/A.Ş. için)
• İmza sirküleri
• Banka hesap (IBAN) — ödemeler bu hesaba aktarılır
• e-Fatura/e-Arşiv özel entegratörü veya GİB portalı
• Marka tescil belgesi (kozmetik, gıda, oyuncak gibi koruyuculu kategorilerde)

2. Trendyol Satıcı Paneline Başvuru

partner.trendyol.com üzerinden başvurunuzu yaparsınız. Onay süresi genellikle 3–7 iş günüdür. Onay sonrası size mağaza ID (Supplier ID), API anahtarı (apiKey) ve API secret (apiSecret) verilir — bunlar entegrasyon için kritiktir.

📥 Resmi Trendyol Mağaza Başvuru Sayfası partner.trendyol.com — ücretsiz başvuru, 3–7 iş günü onay süresi →

3. Ürün Yükleme ve İçerik Kuralları

Trendyol, ürün listelemelerinde sıkı içerik kuralları uygular:

• Başlık: 50–150 karakter, marka + ürün adı + temel özellik
• Görsel: Beyaz arkaplan, minimum 1000×1000px, maks. 8 fotoğraf, watermark/yazı yasak
• Açıklama: HTML destekli, minimum 200 karakter
• Kategori eşleştirme: Trendyol kategori ID + nitelikler (renk, beden, malzeme)
• Barkod (GTIN/EAN): Mümkünse, eşleme hızını ciddi artırır
• İçerik skoru: 80+ olmalı; aksi halde ürün vitrine düşmez

Trendyol Komisyon Oranları (2026)

Trendyol 2026 komisyon oranları kategoriye göre %5 ile %22,5 arasında değişir. Komisyona %20 KDV ile hizmet bedeli ve kargo maliyeti eklenir. Brüt-net hesabı yapmadan fiyatlama yapmak en sık görülen satıcı hatasıdır. Aşağıda kolay anlaşılır 3 ana komisyon bandını özetledik:

Net kazanç hesabı: Satış fiyatı − Komisyon − KDV − Hizmet bedeli − Kargo bedeli − Ürün maliyeti = Net kâr. Zunapro fiyatlama modülü bu hesabı her ürün ve kategori için otomatik yapar; minimum kâr eşiğinizin altında satış yapmamanızı sağlar.

Trendyol API Entegrasyonu — Teknik Detaylar

Trendyol API, satıcıların ürün, stok, sipariş, fiyat, kargo ve iade verilerini Trendyol sistemiyle programatik olarak senkronize etmesine olanak veren RESTful bir arayüzdür. API base URL: https://api.trendyol.com/sapigw/suppliers/{supplierId}/

API Yetkilendirme

Trendyol API, HTTP Basic Authentication kullanır. apiKey:apiSecret Base64 encoded olarak Authorization başlığında gönderilir. Token expiry yoktur; ancak güvenlik için 6–12 ayda bir yenilemek önerilir.

Ana Endpoint Kategorileri

• Products API — Ürün oluşturma, güncelleme, kategori eşleme, içerik skoru sorgulama
• Inventory API — Stok ve fiyat senkronizasyonu (bulk endpoint maks. 100 ürün/istek)
• Orders API — Sipariş listeleme, durum güncelleme, paket oluşturma
• Shipment API — Kargo etiketi oluşturma, takip numarası senkron
• Claims API — İade taleplerini sorgulama, kabul/red
• Settlements API — Hakediş, fatura ve mutabakat
• Webhooks — Sipariş ve stok değişikliklerinde anlık callback

Rate Limit ve Hata Yönetimi

Trendyol API hız limiti satıcı başına saniyede 10 istektir. Aşıldığında 429 Too Many Requests döner. Yaygın hata kodları: 400 (geçersiz ürün verisi), 401 (kimlik doğrulama hatası), 404 (kategori/barkod bulunamadı), 500 (Trendyol sistem hatası — yeniden dene). Zunapro entegratörü exponential backoff retry ve dead-letter queue ile bu hataları otomatik yönetir.

Trendyol XML Entegrasyonu — Toplu Ürün Aktarımı

Trendyol XML entegrasyonu, tedarikçi veya kendi e-ticaret sitenizdeki ürün kataloğunu XML formatında otomatik okuyup Trendyol satıcı paneline aktaran sistemdir. Manuel ürün eklemenin alternatifi olarak binlerce ürünü dakikalar içinde yüklemenizi sağlar.

XML Şema Yapısı (Trendyol Uyumlu)

Trendyol'a yüklenecek XML'in temel alanları:

• productMainId — Ana ürün kodu (varyantları gruplar)
• brand, title, productCode, stockCode, barcode
• categoryId (Trendyol kategorisi), attributes (renk, beden, malzeme)
• quantity (stok), listPrice, salePrice, vatRate
• cargoCompanyId, shipmentAddressId
• images (1–8 URL), description (HTML)

Tedarikçi XML'inden Trendyol'a Aktarım

Türkiye'deki çoğu toptancı/tedarikçi (özellikle Bursa, Konya, İstanbul Laleli/Merter bölgeleri) ürün kataloglarını XML olarak paylaşır. Zunapro XML modülü:

1. Tedarikçi XML URL'ini okur (saatlik/günlük cron)
2. Kategori eşleştirmesini öğrenir (ilk eşleme manuel, sonra otomatik)
3. Marka, materyal, beden gibi attribute'ları normalize eder
4. Fiyata kâr marjı + komisyon ekler
5. Stok takibi yapar — tedarikçide kalmayan ürünleri otomatik pasifleştirir
6. Trendyol'a API ile yükler

Trendyol Fulfillment (TGF / FBT) — Lojistik Çözümü

Trendyol Global Fulfillment (TGF), satıcıların ürünlerini Trendyol depolarına teslim ettikten sonra depolama, paketleme, kargolama ve iade yönetiminin tamamen Trendyol tarafından yapıldığı hizmettir. Amazon FBA'in Trendyol versiyonu olarak düşünülebilir.

TGF Avantajları

• Aynı gün / ertesi gün kargo — Trendyol Express önceliği
• Yüksek Buy Box şansı — TGF rozetli ürünler vitrine daha çok düşer
• Müşteri hizmetlerini Trendyol yönetir — iade, değişim, şikayet
• "Bugün siparişle, yarın al" etiketi — dönüşüm oranını %15–25 artırır
• Operasyon yükü sıfır — paketleme/kargolama yapmazsınız

TGF Maliyetleri (2025 yaklaşık)

• Depolama: m³/ay başına 80–150 ₺
• Sipariş işleme: ürün başına 6–12 ₺
• İade işleme: 8–15 ₺/iade
• Komisyon: Normal Trendyol komisyonu + %1–2 TGF ücreti

TGF, aylık 500+ siparişi olan satıcılar için maliyet-verimli olur. Düşük hacimli satıcılar kendi deposundan kargolamayı tercih etmelidir.

Trendyol Mağaza Performans Skoru ve İptal Oranları

Trendyol her satıcıya 1–10 arası mağaza puanı verir; bu puan vitrinde görünürlüğü doğrudan etkiler. Puanı düşüren ana faktörler:

• İptal oranı — Stoksuz iptaller en büyük cezalandırıcı; %2 üstü uyarı, %5 üstü mağaza kapatma riski
• Geç kargo — Hazırlama süresi içinde kargolanmayan siparişler
• İade oranı — Beklenenin üstündeki iadeler (moda kategorisinde %30+ doğal kabul)
• Müşteri yorumu — 4.0 yıldız altı kalmamalı
• Yanıt süresi — Mesajlara 24 saat içinde dönülmeli

Zunapro otomatik stok senkronizasyonu ile iptal riskinizi %90 azaltırsınız; sitenizde, depoda veya başka pazaryerinde satılan ürünler Trendyol'da anında pasifleşir.

Trendyol Reklam, Promosyon ve Akıllı Fiyatlandırma

Trendyol Reklam Platformları

• Sponsored Products — Arama sonuçlarında üst sıralar (CPC bazlı, TL/tıklama)
• Trendyol Akıllı Reklamlar — Algoritmik bütçe optimizasyonu
• Marka mağazası reklamı — Banner ve display
• Trendyol Express promosyon — TGF rozetli ürünler için indirim kampanyası

Akıllı Fiyatlandırma (Repricer)

Trendyol'da Buy Box savaşı çok yoğundur. Aynı ürünü 10+ satıcı satıyorsa, en düşük fiyatlı (veya en yüksek mağaza puanlı) Buy Box alır. Zunapro repricer modülü fiyatları rakiplerinize göre saniyeler içinde otomatik ayarlar — minimum kâr eşiğinizin altına düşmez.

Trendyol E-Fatura ve E-Arşiv Entegrasyonu (GİB Uyumu)

Trendyol'dan satış yapan tüm satıcılar, B2C müşterilerine e-Arşiv fatura, B2B müşterilerine e-Fatura kesmek zorundadır (GİB regülasyonu). Manuel fatura kesmek; günde 100+ siparişte mümkün değildir.

Zunapro e-Fatura modülü:

• Trendyol sipariş datası geldiği anda otomatik e-Arşiv/e-Fatura kesme
• GİB onaylı özel entegratörler ile (Logo, Mikro, Uyumsoft, Foriba, Veriban vb.)
• İade durumunda otomatik iade faturası
• Aylık KDV1, KDV2 raporlama
• Müşteriye PDF e-Arşiv otomatik e-posta + SMS

Trendyol Kargo Entegrasyonu — Trendyol Express + Diğerleri

Trendyol siparişleri varsayılan olarak Trendyol Express ile gönderilir (Trendyol'un kendi kargosu, Türkiye genelinde 81 il aynı/ertesi gün teslimat). Ek olarak: Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo, PTT Kargo entegre edilebilir.

Zunapro multi-kargo modülü, sipariş ağırlığı, hedef şehir ve müşteri tercihine göre en uygun kargo şirketini otomatik seçer; etiket basar, takip numarasını Trendyol'a otomatik gönderir.

Trendyol İade ve Müşteri Hizmetleri Yönetimi

Türkiye e-ticaretinde iade oranı moda kategorisinde %30–40, elektronikte %5–10, ev-yaşamda %10–15'tir. İade süreci doğru yönetilmezse mağaza puanı düşer.

Trendyol Standart İade Süreci:

1. Müşteri Trendyol panelinden iade talebi açar (teslim sonrası 14 gün içinde)
2. Trendyol Express ürünü ücretsiz alır (1–3 iş günü)
3. Trendyol deposu inceler, satıcıya yönlendirir veya iade onayı verir
4. Satıcı 1–3 iş günü içinde iade onayı/reddi verir
5. Onay verilirse müşteri parası Trendyol cüzdana iade edilir

Zunapro iade modülü tüm bu adımları otomatik takip eder; satıcıya panel bildirimi atar, müşteri iadeleri için otomatik iade faturası keser.

Zunapro ile Trendyol Entegrasyonu — 4 Adımda Kurulum (10 Dakika)

1. Trendyol Mağaza Bilgilerinizi Girin — Zunapro panelde Marketplace → Trendyol sekmesinden Supplier ID, API key ve API secret bilgilerini girersiniz.
2. Mevcut Sitenizi Bağlayın — Shopify, WooCommerce, OpenCart, İkas, Ticimax, PrestaShop ve Magento için hazır konnektörler. API URL + access key girilir.
3. Kategori Eşleme Sihirbazı — Sitenizdeki kategorileri Trendyol kategorilerine sürükle-bırak ile eşlersiniz. Yapay zeka önerileri dakikalar içinde tamamlar.
4. İlk Senkronizasyon — Ürün, stok, fiyat, sipariş, kargo — hepsi otomatik senkron başlar. 10 dakika içinde Trendyol mağazanız Zunapro panelinden yönetilebilir.

Trendyol Entegrasyonu Hakkında Sıkça Sorulan Sorular (SSS)