Trendyol entegrasyonu: bağlantıdan hakedişe resmî kurallarla rehber
Trendyol entegrasyonu, Trendyol mağazanızı satıcı panelinden aldığınız API bilgileriyle bir yönetim yazılımına bağlayıp ürün, stok, fiyat, sipariş, kargo, fatura ve hakediş verisini oradan yönetmektir. Bu rehber bağlantının teknik adımlarının yanında işin parasal tarafını da ele alıyor: Trendyol'un Ekim 2026 itibarıyla resmî sayfalarında yazan komisyon, platform hizmet bedeli, kargo baremi, stopaj ve ödeme günleri; bunların entegrasyonda nasıl izlendiği ve Yox İş Ortağım'da hangi pakette neyi kullanabildiğiniz.
Trendyol entegrasyonu ne işe yarar, hangi satıcıya gerekir?
Trendyol entegrasyonu, satıcı paneline girerek tek tek yaptığınız ürün yükleme, stok düşme, sipariş hazırlama ve fatura gönderme işlerini Trendyol'un Partner API'si üzerinden bir yazılıma devretmenizi sağlar. Trendyol'un Satıcı Bilgi Merkezi de bunu açıkça yazar: kendi yazılım ekibiniz yoksa bu servisleri entegratör firmalar sizin adınıza kullanır.
Elle yönetimin sınırına genellikle şu durumlardan birinde gelinir:
- Aynı stoğu Trendyol'un yanında Hepsiburada entegrasyonu gibi ikinci bir kanalda ya da kendi sitenizde satıyorsanız; bir kanaldaki satış diğerinde düşmezse aynı son ürün iki kez satılır.
- Beden ve renk gibi varyantlarınız çoksa ve her varyant ayrı barkod taşıyorsa.
- Günlük sipariş sayınız arttıkça her pakete ayrı fatura ve kargo kodu üretmek gününüzü alıyorsa.
- Hakediş ekranındaki tutarın komisyon, kargo ve hizmet bedeliyle tutup tutmadığını sipariş bazında görmek istiyorsanız.
Trendyol satıcısı olmanın resmî şartları
Entegrasyonun ön koşulu açık bir Trendyol mağazasıdır. Satıcı Bilgi Merkezi'ne göre anonim, limited, şahıs ya da başka türde bir şirketinizin olması, vergi mükellefi olmanız, online satılabilecek stoğa ve satış operasyonunu yürütecek kapasiteye sahip olmanız gerekir. Şahıs şirketleri TCKN, diğer şirketler vergi kimlik numarası bildirir; her başvuru Gelir İdaresi Başkanlığı üzerinden kontrol edilerek onaylanır.
Trendyol'da satış maliyeti: komisyon, hizmet bedeli ve stopaj (Ekim 2026)
Trendyol'da bir siparişten size kalan tutarı komisyon, platform hizmet bedeli, kargo, %1 e-ticaret stopajı ve varsa sizin karşıladığınız indirim ya da kupon belirler. Tablo, Satıcı Bilgi Merkezi'nde ve Resmî Gazete'de yazanları özetler; oranlar ve tutarlar değişebildiği için satıcı panelinizdeki Ticari Şartlar ekranı her zaman son sözdür.
| Kalem | Resmî kural | Nerede görünür |
|---|---|---|
| Komisyon | Kategoriye, markaya ve satıcının ticari seviyesine göre değişen yüzdesel bedel; oranlara KDV dahildir | Ticari Şartlar > Komisyon & Vade Tablosu |
| Komisyon faturası | Ayın 7, 14, 21, 28 ve 30/31. günlerinde kesilir; teslim edilen sipariş ilk faturaya girer, iadede ilk faturada mahsup edilir | Finans > Fatura Listeleme |
| Platform hizmet bedeli | Gönderi başına 10,99 TL + KDV; Bugün Kargoda şartını karşılayan gönderide 4,99 TL + KDV; iade paketinde ve dijital üründe yok | Ödeme günlerinde ayrı fatura |
| Kargo (Trendyol anlaşmalı) | Bedeli Trendyol faturalar; 350 TL altı siparişte barem fiyatı, üstünde desi fiyatı | Fatura Listeleme, sipariş bazlı desi |
| E-ticaret stopajı | Aracı hizmet sağlayıcının satıcıya ödemelerinden %1 (9284 sayılı Cumhurbaşkanı Kararı, 1 Ocak 2025'ten beri) | Cari hesap ekstresinde stopaj kalemi |
| Yeni satıcı oranı | İlk ürününü başvurudan sonra 15 gün içinde yükleyene Özelleşmiş Grup oranları 2 ay geçerli | Komisyon & Vade Tablosu |
Komisyon hangi fiyat üzerinden hesaplanır?
Trendyol komisyonu ürünün o anki satış tutarı üzerinden hesaplar. Resmî örnekte 100 TL'lik ürüne %20 oranla 20 TL komisyon çıkar; aynı ürün kampanyada 90 TL'ye satılırsa komisyon 18 TL olur. Aynı ürünün varyantlarında bile oran farklılaşabilir, çünkü komisyon tarifesindeki teklifler varyant bazında değişebilir. Kendi kategorinizin oranıyla deneme yapmak için komisyon hesaplama aracını kullanabilirsiniz.
Örnek hesap: 300 TL'lik bir Trendyol siparişinden size ne kalır?
Aşağıdaki hesapta komisyon oranı örnek olarak %20 alınmıştır; kargo için Trendyol anlaşmalı modelde, 1 günlük terminle gönderilen 200–349,99 TL bandındaki bir Aras Kargo paketinin 10 Ağustos 2026'dan beri geçerli barem fiyatı kullanıldı. Ürünün KDV oranı %20 varsayıldı.
| Kalem | Hesap | Tutar |
|---|---|---|
| Satış tutarı (KDV dahil) | Müşterinin ödediği | 300,00 TL |
| Komisyon (örnek %20, KDV dahil) | 300 × 0,20 | −60,00 TL |
| Platform hizmet bedeli | 10,99 TL + %20 KDV | −13,19 TL |
| Kargo (Aras, barem Tablo 1) | 79,16 TL + %20 KDV | −94,99 TL |
| E-ticaret stopajı | %1 × 250 TL (KDV hariç satış) | −2,50 TL |
| Hakedişe yansıyan tutar | Ürün maliyeti ve KDV mahsubu öncesi | 129,32 TL |
350 TL barem eşiğinin altındaki küçük sepetlerde kargo, satış tutarının üçte birine yaklaşabilir; eşiğin üzerindeki siparişlerde ise barem değil desi fiyat listesi uygulanır, bu yüzden fiyatınızı iki durum için ayrı ayrı hesaplayın. Tabloda ürün maliyetiniz ve satıştan doğan KDV yer almıyor. Net kârı görmek için kâr hesaplama aracına alış maliyetinizi ekleyin, KDV mahsubunu muhasebecinizle netleştirin.
Trendyol hakediş takvimi: ödemeniz hangi gün yatar?
Trendyol satıcılara haftada iki kez, Pazartesi ve Perşembe günleri ödeme yapar. Vade tarihi, sipariş teslim edildiği anda teslim tarihine ürünün vade süresi eklenerek belirlenir; ödeme gününde vadesi dolan kalemlerin toplamı hakedişinizi oluşturur.
- Pazartesi, Salı ve Çarşamba vadesi dolan siparişler Perşembe ödenir.
- Perşembe, Cuma, Cumartesi ve Pazar vadesi dolan siparişler Pazartesi ödenir.
- Toplam eksi çıkarsa ödeme oluşmaz, tutar bir sonraki ödemeye devreder.
- Ödemeden sonra gelen iade, iade onaylandıktan sonraki ilk ödemeden düşülür.
- Kargo faturaları, çalıştığınız kargo firmasına göre Pazartesi, Perşembe ya da Cuma kesilir.
Vade süresi kategoriye göre değişir ve Komisyon & Vade Tablosu'nda yazar; bu yüzden 'kaç günde param gelir' sorusunun tek bir cevabı yoktur.
Cari hesap ekstresiyle hakedişi sipariş bazında kontrol etmek
Trendyol'un muhasebe ve finans servisi her satış kaydında komisyon oranını, komisyon tutarını, satıcı hakediş tutarını, vade süresini ve ödeme numarasını ayrı alanlar olarak verir. Finansal kayıtlar sipariş teslim edildikten sonra oluşur; kargo faturasının detayı da sipariş numarası ve desiyle birlikte çekilebilir. Yox İş Ortağım'daki hakediş ve komisyon kontrolü de sipariş bazında çalışır: kesilen komisyon ve kargo bedeli her siparişin net kârıyla yan yana görünür, beklenenden fazla kesinti ve ödenmemiş görünen hakediş ayrı bir listede toplanır.
Trendyol kargo modelleri, barem desteği ve termin süresi
Trendyol'da kargo iki modelle gönderilir: Trendyol kargo koduyla çıkış yapılan ve bedeli Trendyol'un faturaladığı anlaşmalı model ya da kendi kargo sözleşmeniz. Her iki model için Aras, Yurtiçi, PTT, Sürat, DHL eCommerce, Kolay Gelsin, Horoz Lojistik ve Ceva listelenir; anlaşmalı modelde Trendyol Express (TEX) de vardır. Barem desteği yalnız Trendyol anlaşmalı kargo modelinde geçerlidir; kendi anlaşmanızla gönderdiğiniz pakete kendi fiyatınız uygulanır.
| Barem fiyatı, KDV hariç | Aras | PTT | TEX | Sürat | Yurtiçi |
|---|---|---|---|---|---|
| 0–199,99 TL, termin 1 gün | 48,33 TL | 38,74 TL | 38,74 TL | 54,58 TL | 83,33 TL |
| 200–349,99 TL, termin 1 gün | 79,16 TL | 70,41 TL | 70,41 TL | 85,41 TL | 113,33 TL |
| 0–199,99 TL, termin 1 günden uzun | 80,83 TL | 73,33 TL | 73,33 TL | 87,08 TL | 114,16 TL |
| 200–349,99 TL, termin 1 günden uzun | 86,24 TL | 78,74 TL | 78,74 TL | 92,49 TL | 119,16 TL |
- 350 TL ve üzerindeki siparişler, Trendyol anlaşmalı kargo fiyat listesindeki desi fiyatıyla ücretlendirilir.
- 10 desinin üzerindeki paketler ile Ceva ve Horoz gibi yüksek desili taşıma yapan firmalar barem dışındadır.
- Desi, en × boy × yükseklik (cm) / 3000 ile bulunur; ağırlık desiden fazlaysa ağırlık esas alınır. Paketinizi desi hesaplama aracıyla önceden ölçün.
- Barem altındaki bir sipariş bölünürse yalnız bir paket barem fiyatı alır, diğerleri desi fiyatıyla ücretlendirilir.
Termin süresi ve Bugün Kargoda etiketinin maliyete etkisi
Tablodaki düşük fiyatlar, termini 1 gün olan ya da Bugün Kargoda veya Hızlı Teslimat etiketini zamanında karşılayan gönderiler içindir. Bugün Kargoda şartını karşılayan gönderide platform hizmet bedeli de 4,99 TL + KDV'ye iner. Son Sipariş Saati'ne kadar gelen siparişler aynı gün kargoya verilmelidir; saat değişikliği ertesi sabah 07.00'de geçerli olur. Termini kısaltmak hem kargo hem hizmet bedeli tarafında doğrudan tasarruf sağlar, ama yalnız deponuz o hızı gerçekten karşılayabiliyorsa.
Trendyol API bilgileri ve servis yetkileri: bağlantıyı güvenle kurmak
Trendyol'a bağlantı üç bilgiyle kurulur: Satıcı ID, API Key ve API Secret. Bu bilgiler satıcı panelinde mağaza adınızın altındaki Hesap Bilgilerim > Entegrasyon Bilgileri sayfasındadır ve yalnız hesap sahibi (master) kullanıcıyla görünür. Sayfaya ilk kez giriyorsanız ekrandaki kaydırma düğmesini sağa çekmeniz gerekir.
Entegratör ekleme ve servis bazlı API anahtarı
Aynı sayfada 'Pazaryeri entegratörü ile çalışıyor musunuz?' sorusuna Evet dediğinizde entegratörün adını girersiniz. Birden fazla firmayla çalışıyorsanız 'Entegratör Firma Ekle' ile ikinci bir anahtar üretilir ve bu anahtarın hangi servislerde çalışacağını siz seçersiniz: ürün, satıcı bilgileri, sipariş, fatura, iade, webhook, teslimat, soru-cevap ile muhasebe ve finans. Seçmediğiniz serviste o anahtar çalışmaz. Ürün gönderimi, sipariş, fatura ve hakediş kontrolünü aynı yazılımdan yapacaksanız bu işlere karşılık gelen servislerin seçili olması gerekir.
API bilgilerini yenilemek bağlantıyı keser
Birincil API bilgileri silinemez. Bilgileri paylaştığınız birinin erişimini kesmek için 'API Bilgilerini Güncelle' kullanılır ve eski bilgilerle gelen bütün istekler hata almaya başlar; yeniledikten sonra bağlı yazılımlara yeni bilgileri girmeyi unutmayın. Trendyol ayrıca anahtarların açık platformlarda paylaşılmamasını ister. Ürün ve sipariş servislerinin V1 sürümleri 15 Ekim 2026'da kapandığı için eski bir eklenti kullanıyorsanız V2'ye geçişi de kontrol edin.
Trendyol entegrasyonu ile ürün gönderirken uyulması gereken veri kuralları
Ürün gönderimi Trendyol'da iki aşamalıdır: önce istek kabul edilir, sonra ürün onay sürecine girer. İsteğe dönen toplu işlem numarası, ürünün yayına çıktığı anlamına gelmez; Trendyol bu sonucun 4 saat içinde kontrol edilmesini, onaylanan ürünün yayında olup olmadığına da ayrıca bakılmasını ister. Reddedilen ilanların çoğu aşağıdaki kurallardan birine takılır:
| Alan | Trendyol'un kuralı (Ürün Yaratma v2) |
|---|---|
| Barkod | En fazla 40 karakter; özel karakter olarak yalnız nokta, tire ve alt tire; ortadaki boşluk birleştirilir |
| Ürün adı ve açıklama | Ad en fazla 100, HTML açıklama en fazla 30.000 karakter |
| Model kodu | Varyantlar aynı model koduyla, yalnız özellikleri farklı gönderilir |
| Görseller | Barkod başına en fazla 8 görsel, https adresli, 1200×1800 piksel ve 96 dpi |
| Fiyat | Liste fiyatı satış fiyatından küçük olamaz; liste fiyatı üstü çizili görünür |
| KDV oranı | 0, 1, 10 veya 20 |
| Stok | Ürün başına en fazla 20.000 adet; tek istekte en fazla 1.000 ürün |
| Kargo firması | Sözleşmede onaylanan firmadan farklı olamaz, aksi hâlde ürün yayına çıkmaz |
Yox İş Ortağım'da ürün kartınız Trendyol kategorisine ve özelliklerine eşleştirilir; beden ve renk gibi varyantlar tek karttan yönetilir. Stok tarafında da aynı kart esas alınır: başka bir kanalda satılan ürün Trendyol mağazanızda da düşer, fiyat kurallarınız kanal bazında uygulanır. Kategoriye özel zorunlu özellikleri ilk gönderimde eksiksiz doldurmak onay gecikmelerini azaltır.
Trendyol sipariş, paket ve fatura akışı entegrasyonda nasıl işler?
Trendyol siparişleri paket üzerinden yürür. Satıcı paketi önce hazırlanıyor (Picking), isterse faturalandı (Invoiced) durumuna alır, ardından kargoya verir. Kısmi iptal ya da paket bölme yapıldığında eski paket bozulur, aynı sipariş numarası altında yeni paket ve yeni kargo takip numarası oluşur. Bu yüzden entegrasyonun izlemesi gereken birim sipariş değil pakettir.
Faturayı Trendyol'a iletmenin üç yolu
- Faturanın PDF'ini siparişe özel üretilen şifreli (kriptolu) e-posta adresine göndermek; bu adres her siparişte farklıdır.
- Fatura linki servisiyle e-Arşiv ya da e-Fatura bağlantısını paket numarasıyla iletmek; bağlantının 10 yıl boyunca erişilebilir kalması yasal zorunluluktur.
- Fatura dosyasını pakete yüklemek: PDF, JPEG ya da PNG, en fazla 10 MB, ileri tarihli olamaz.
Trendyol Yurt Dışı Aracılığı siparişlerinde e-Arşiv değil e-Fatura kesilmesi gerekir; mikro ihracat paketlerinde fatura numarası ve tarihi zorunludur. Yox İş Ortağım'da Trendyol siparişleri diğer kanallarla aynı listeye düşer; hazırlanıyor, kargoda ve teslim edildi aşamaları tek ekranda izlenir. Siparişin e-Arşiv ya da e-Fatura belgesi bağlı muhasebe programınızdan kesilir ve fatura bilgisi Trendyol siparişine iletilir; e-Fatura bağlantısı Profesyonel paketle başlar. Bağlanabilen programlardan biri için Paraşüt entegrasyonu sayfasına bakabilirsiniz.
Kargo entegrasyonu bağlıysa etiket basıldığında takip numarası Trendyol siparişine işlenir ve alıcı kargosunu Trendyol üzerinden izler. Başlangıç paketinde kargo entegrasyonu yoktur, takip numarası elle girilir; Büyüme paketi 1 kargo firmasıyla başlar. Kendi sözleşmeniz için örnek: Yurtiçi Kargo entegrasyonu.
Trendyol'un entegratör seçim soruları ve Yox İş Ortağım paketleri
Trendyol Satıcı Bilgi Merkezi, entegratör seçerken sorulacak soruları kendisi listeler. Karşılıklarını yalnız panelde tanımlı yeteneklerle verdik.
| Trendyol'un sorusu | Yox İş Ortağım'da karşılığı |
|---|---|
| Ürün yükleme ve güncelleme yapılabiliyor mu? | Evet; kategori ve özellik eşleştirme, varyantlar tek karttan |
| Stok ve fiyat güncellemesi yapılabiliyor mu? | Evet; tek ürün kartı, kanal bazında fiyat kuralı |
| Sipariş entegrasyonu var mı? | Evet; Trendyol siparişleri diğer kanallarla tek listede |
| Fatura entegrasyonu var mı? | Profesyonel paketten itibaren; fatura bilgisi siparişe iletilir |
| Farklı platformlar için stok yönetimi yapılabiliyor mu? | Evet; bağlanabilen kanal sayısı pakete göre |
| Muhasebe ve mutabakat servisleri kullanılıyor mu? | Sipariş bazında komisyon, kargo bedeli ve net kâr; fazla kesinti ve ödenmeyen hakediş listesi |
| Soru-cevap ve iade entegrasyonu var mı? | Bu sayfanın kapsamında değil; ihtiyacınızı ön görüşmede sorun |
Trendyol hangi Yox İş Ortağım paketinde kullanılabilir?
| Paket | Aylık | Kanal | Ürün / aylık sipariş | Kargo ve e-Fatura |
|---|---|---|---|---|
| Başlangıç | ₺499 | 1 (Trendyol seçilebilir) | 500 / 100 | Kargo entegrasyonu ve e-Fatura yok |
| Büyüme | ₺999 | 3 | 5.000 / 500 | 1 kargo firması, e-Fatura yok |
| Profesyonel | ₺1.999 | 5 (28 kanallık listeden) | 10.000 / 2.000 | 2 kargo firması, 1 muhasebe programı |
| Kurumsal | ₺3.999 | Sınırsız | 25.000 / 5.000 | 5 kargo firması, 3 muhasebe programı |
| Enterprise | ₺7.999 | Sınırsız | Sınırsız | Sınırsız, çoklu şirket, özel SLA |
Trendyol her pakette bağladığınız kanallardan biri olarak sayılır ve yıllık ödemede %20 indirim uygulanır. Limitlerin tamamı paket karşılaştırmasında yer alır; 3 günlük ücretsiz denemeyle başlamak için Yox İş Ortağım'a başvurun.
Trendyol entegrasyonuna geçmeden önce kontrol listesi ve sık hatalar
Sorunların çoğu bağlantıdan önceki hazırlıktan kaynaklanır. Mağazanızı bağlamadan önce şu sırayı izleyin:
- Hesap sahibi kullanıcıyla Entegrasyon Bilgileri sayfasına girin.
- Trendyol'daki barkod ve stok kodlarınızı diğer kanallarınızla karşılaştırın; aynı ürünün iki kanalda farklı barkodla açılması eşleşmeyi bozar.
- Ticari Şartlar ekranından kategorilerinizin komisyon ve vade bilgisini not edin, kanal fiyat farkınızı bu orana göre belirleyin.
- Kargo modelinizi seçin: barem desteği olan Trendyol anlaşmalı kargo mu, kendi sözleşmeniz mi.
- Termin sürenizi deponuzun gerçek hazırlama hızına göre ayarlayın.
- Bilgileri Yox İş Ortağım'a girin; mevcut ilanlarınız panele gelir ve barkod ya da stok koduyla eşleşir. Siz onaylamadan hiçbir ilan değişmez.
En sık yapılan hatalar
- Entegrasyon açıkken stoğu Trendyol panelinden elle değiştirmek: bir sonraki güncelleme bu değerin üzerine yazar.
- Değişmeyen stok ve fiyatı tekrar tekrar göndermek: Trendyol aynı isteği 15 dakika içinde kabul etmez.
- API bilgilerini yenileyip bağlı yazılımı güncellememek.
- Barem eşiğini ve platform hizmet bedelini fiyata katmadan kampanyaya girmek.
Kurulumu birlikte yapmak için iletişim sayfasından ön görüşme isteyin; diğer kanallar için tüm entegrasyonlar listesine bakın.
Son kontrol: 13 Ekim 2026
