Tekstil & Konfeksiyon
Web TasarımıE-TicaretE-İhracatGoogle AdsSosyal Medya Blog Birlikler
← designodin.com.tr
← Tüm yazılar E-Ticaret

Trendyol Entegrasyonu: Tekstil Markası

Kısa cevap: Tekstil markasında Trendyol entegrasyonu, ürünleri pazaryerine göndermekten ibaret değildir. Renk, beden, stok, sipariş, fatura ve iade verisi tek bir ana kaynaktan yönetilmeli, Trendyol bu kaynağa bağlı bir satış kanalı olmalıdır. Trendyol’un ürün modelinde renk ürünü ayrı içeriklere böler, beden ise aynı içeriğin varyantıdır; her renk-beden kombinasyonu kendi barkodu ve stok koduyla izlenir. Stok ve fiyat güncellemeleri Trendyol’un dakikalık ortak limitlerine göre kuyruklanmalı, siparişler webhook’la alınıp periyodik sorguyla eşitlenmelidir. İade edilen ürün kalite kontrolden geçmeden satılabilir stoğa dönmemelidir.

Varsayımsal bir örnek düşünelim: Kampanya yapan bir erkek giyim işletmesi. Ekip, kendi sitesinde lacivert L beden gömleğin stoğunu 14 olarak günceller. Trendyol’da eski kayıt 19 olarak kalır. Gün içinde fiziksel mağazada üç adet daha satılır. Akşam paketleme başladığında sistem 19 satış gösterir, depoda ise yalnızca 11 ürün vardır. Sonuç sekiz iptal ve müşterilere açıklama yazılan bir vardiyadır. Bu hata Trendyol’dan kaynaklanmaz. Aynı stoğun üç farklı yerde “doğru” kabul edilmesinden doğar.

Bu yazı, Trendyol’a özgü tarafı ele alıyor: ana veri kaynağı, renk-beden modeli, barkod eşleşmesi, API limitleri, sipariş ve iade akışı, bakım ve entegratör seçimi. Kanaldan bağımsız stok mimarisini stok entegrasyonu rehberinde, iadenin yasal ve depo tarafını iade süreci yönetimi yazısında anlattık. Trendyol geliştirici dokümantasyonundaki ürün yaratma, stok-fiyat güncelleme, servis limitleri ve webhook sayfaları ile değişiklik kayıtları Ekim 2026’da birincil kaynaklardan kontrol edildi.

Öne Çıkanlar

  • Her satılabilir renk-beden kombinasyonu ayrı barkod ve iç stok koduyla izlenir; model düzeyinde stok tutmak iptal üretir.
  • Trendyol, kendi siteniz ve fiziksel mağazanız aynı stoğu kullanıyorsa ana stok kaynağı Trendyol paneli değil, tek bir iç sistem olmalıdır.
  • Renk Trendyol’da ürünü ayrı içeriklere böler ve kendi görsel setini ister; beden aynı içeriğin varyantıdır.
  • 14 Eylül 2026’dan bu yana stok ve fiyat güncellemeleri servis grubu bazında, dakikalık ortak bir limiti paylaşır.
  • Webhook hızlı tepki verir ama Trendyol periyodik eşitlemeyi de önerir. İade edilen ürün kalite kontrolden sonra stoğa döner.

Trendyol entegrasyonu tekstil markasında neyi bağlar?

Trendyol entegrasyonu ürün, varyant, stok, fiyat, sipariş, fatura ve iade verisini ana sisteminize bağlar. Doğru kurulum manuel işi azaltır; hatalı kurulum operasyon sorunlarını hızla büyütür. Trendyol’un geliştirici dokümantasyonu bu işin servislerini ayrı ayrı tanımlar:

Trendyol servisiNe taşırTekstilde dikkat edilecek nokta
Ürün entegrasyonuÜrün içeriği, kategori, özellikler, görsellerRenk ve bedenin doğru özellik tipiyle gönderilmesi
Stok ve fiyat güncellemeBarkod bazında adet ve fiyatHer beden ayrı barkod, ayrı adet
Sipariş entegrasyonuSipariş paketleri, iptal, kargo bilgisiPaket durumu ana sisteme geri yazılmalı
İade entegrasyonuİade talepleri, onay ve retİade, stok artışı değil kontrol süreci başlatır
Fatura entegrasyonuFatura bağlantısı veya dosyasıFaturanın hangi sistemden kesildiği belli olmalı
Soru-cevap entegrasyonuMüşteri soruları ve yanıtlarıKalıp ve kumaş soruları ürün bilgisindeki eksiği gösterir

İşletme tarafındaki asıl soru şudur: Hangi sistemdeki veri doğru kabul edilecek? Tekstil bu soruyu zorlaştırır. Elektronikte bir SKU çoğu zaman tek satılabilir ürünü ifade eder. Tekstilde aynı model renk, beden, kalıp, sezon ve koleksiyonla çoğalır. Varsayımsal bir örnek: 80 modeli olan, her modelde 12 renk ve her renkte ortalama dört beden bulunan bir kadın giyim işletmesi yaklaşık 3.840 satılabilir varyant yönetir. Stok model düzeyinde tutulursa siyah M bittiğinde sistem bütün siyah ürünün tükendiğini varsayabilir. Daha kötüsü, son adet kendi sitenizde ve Trendyol’da aynı anda satılabilir.

Ana veri kaynağı hangi sistem olmalı?

Entegrasyondan önce ürün, stok ve sipariş verisinin sahibi belirlenmelidir. Bu karar iptal oranını ve paketleme hızını doğrudan etkiler.

Ana kaynak çoğu işletmede şu sistemlerden biridir: kendi e-ticaret altyapısı, ERP veya stok yönetim sistemi, depo yönetim sistemi (WMS), özel bir yönetim paneli ya da küçük kataloglarda kontrollü bir ürün yönetim sistemi.

Çok kanallı satışta Trendyol genellikle ana stok sistemi olmamalıdır. Pazaryeri bir satış kanalıdır. Kendi siteniz, fiziksel mağazanız ve diğer pazaryerleri aynı ürünü satıyorsa, bütün stok hareketi tek bir kaynağa yazılır. Diğer kanalların görevi de böylece netleşir: veriyi kullanır, siparişi geri bildirir, stok hareketini başlatır. Aynı ürünün stoğunu Trendyol panelinden, Shopify’dan ve elle tutulan bir tablodan değiştirmek ilk kampanya döneminde sorun çıkarır.

VeriAna kaynakTrendyol’un rolü
Satılabilir stokERP, WMS veya e-ticaret altyapısıAna kaynaktan gelen adedi gösterir, satışı geri bildirir
Ürün içeriği (ad, kumaş, kalıp, bakım)Ürün yönetim sistemi veya e-ticaret altyapısıKategoriye göre eşlenmiş kopyayı yayınlar
FiyatAna sistemdeki kanal bazlı fiyat kuralıKanal fiyatını alır; elle değiştirilmez
Sipariş durumuAna sistemDurumu webhook ve sorguyla bildirir
İade durumuDepo süreciTalebi iletir; stok kararını depo verir

Stok kadar ürün bilgisinin kaynağı da yazılı olmalıdır: ürün adı ve açıklaması, kumaş, kalıp ve bakım bilgisi, sezon ve koleksiyon verisi, kategori eşleştirmesi, zorunlu özellikler, renk bazlı görseller, iç stok kodu ve Trendyol barkodu, kampanya veya kanal bazlı fiyatlar. Açıklamanın kendi sitenizde güncel, Trendyol’da eski kalması sadece içerik sorunu değildir. Eksik kalıp veya kumaş bilgisi müşterinin beklentisini yanlış kurar ve iade riskini artırır.

Renk ve beden Trendyol’da nasıl modellenir?

Tekstilde renk ve beden aynı veri türü değildir. Trendyol entegrasyonunda bu ayrım ürün modelinin merkezindedir.

Trendyol ürün yaratma dokümantasyonuna göre renk gibi “slicer” özellikler ürünü ayrı içeriklerde açar. Beden gibi “varianter” özellikler ise aynı içerikteki ürünün farklı bedenleridir; bir kategoride yalnızca bir varianter bulunur. Varyantlama productMainId değerine göre yapılır: aynı modelin ürünleri aynı productMainId ile gönderilir, yalnızca özellikleri farklıdır. Hangi özelliğin zorunlu olduğu kategoriden kategoriye değişir; bunu kategori özellik servisi söyler. Nihai yapı, ilgili kategori ve kendi katalog modelinizle test edilmelidir.

Renk neden ayrı ürün içeriği gibi ele alınır?

Renk yalnızca bir seçenek değildir. Siyah keten elbise ile nar çiçeği keten elbisenin ana görselleri farklıdır, detay çekimleri farklı olabilir, kumaşın ışık altındaki görünümü değişir ve stokları ayrı yönetilir. “Tek ana ürün, tüm renkler tek görsel seti” yaklaşımı bu yüzden giyimde hata üretir. Müşteri beyaz ürünü seçtiğinde siyahın detay fotoğrafını görüyorsa, entegrasyon çalışsa bile katalog doğru çalışmıyordur.

Beden neden ayrı barkod ister?

S, M, L ve XL aynı rengin satılabilir varyantlarıdır ve her birinin stoğu ayrıdır. “Siyah ürün stoğu 42” bilgisi tek başına operasyonel bir anlam taşımaz. Her renk-beden kombinasyonuna benzersiz bir iç stok kodu verin ve Trendyol barkoduyla eşleşmesini kalıcı, denetlenebilir tutun. Trendyol’da barkod zorunludur, en fazla 40 karakterdir ve özel karakter olarak yalnızca nokta, tire ve alt çizgi kabul edilir.

Örnek bir eşleşme tablosu (kodlar temsilîdir):

ModelRenkBedenİç stok koduTrendyol barkoduSatılabilir stok
Basic TişörtSiyahSBTS-SY-S86900000000118
Basic TişörtSiyahMBTS-SY-M869000000001211
Basic TişörtBeyazSBTS-BY-S86900000000136
Basic TişörtBeyazMBTS-BY-M86900000000149

Ürün sayısı arttığında barkod, SKU ve varyant ilişkisi en önemli kontrol noktasına dönüşür. Yanlış barkoda bağlanan bir ürün, stok doğru düşse bile yanlış ürünün satılmasına yol açar.

Stok senkronizasyonu Trendyol limitlerine nasıl uydurulur?

En sık hata stoğu model düzeyinde yönetmektir. İkincisi, güncellemeleri satıştan sonra toplu ve gecikmeli yapmaktır. Kampanya döneminde “gün sonunda eşitleriz” yaklaşımı yetmez.

Güvenli bir stok akışı şöyle kurulur:

  1. Kendi siteniz, Trendyol ve varsa fiziksel mağaza aynı stok kaynağına bağlanır.
  2. Her satılabilir renk-beden varyantı için ayrı stok kodu tanımlanır.
  3. Sipariş geldiğinde ilgili varyantın stoğu rezerve edilir.
  4. Sipariş iptal edilirse rezervasyon kurala bağlı olarak kaldırılır.
  5. İade edilen ürün satılabilir stok yerine kalite kontrol durumuna alınır.
  6. Kontrolden geçen ürün ana stoğa döner.
  7. Gün sonunda ana kaynak ile satış kanalları arasında mutabakat yapılır.

Bu akışta “anında” kontrolsüz bir vaat olmamalıdır. Limitler, kuyruk yapısı ve tekrar denemeler mimariyi belirler:

Trendyol kuralıNe demekEntegrasyondaki karşılığı
Limitler servis grubuna, dakika bazında ortak uygulanır (14 Eylül 2026’dan itibaren)Stok ve fiyat güncellemeleri aynı grubun limitini paylaşırKampanya fiyatı ve stok aynı kuyruktan, önceliğe göre gider
Limitin büyüklüğü mağazanın ürün listeleme limitine göre değişirStok-fiyat yazma limiti en düşük kademede dakikada 350, en yüksekte 2.000 istekKendi kademenizi bilin, toplu işlemi buna göre bölün
Aynı barkoda dakikada 30’dan fazla fiyat güncellemesi hata alırFiyatı sık oynatan otomasyon o barkodu kilitlerFiyat değişikliği barkod başına seyreltilir
Tek istekte en fazla 1.000 ürünBüyük katalog tek seferde gitmezGüncellemeler parçalara bölünür
Aynı istek 15 dakika boyunca tekrar gönderilemezDeğişmeyen veriyi yeniden göndermek reddedilirYalnızca değişen stok ve fiyat gönderilir
Yanıtta bir işlem numarası (batchRequestId) döner“Gönderildi” ile “işlendi” aynı şey değildirSonuç ayrıca sorgulanır, hata kaydı tutulur

Kaynaklar: servis limitleri ve stok ve fiyat güncelleme sayfaları. Limitler değişebilir; güncel değeri kurulum günü bu sayfalardan okuyun. Bir modelin bütün bedenleri kanallar arasında nasıl planlanır, yeniden sipariş nasıl hesaplanır, bunu stok ve envanter yönetimi yazısı ele alıyor.

Sipariş ve iade akışı nasıl kurulmalı?

Sipariş entegrasyonu ürün aktarımından ayrı bir süreçtir. Sipariş geldiğinde ürün bulunur, paket hazırlanır, kargo etiketi oluşturulur, fatura işlenir ve durumlar geri yazılır.

Trendyol webhook modelinde oluşturuldu, toplanıyor, faturalandı, kargolandı, teslim edildi, teslim edilemedi, iptal ve iade dahil 13 sipariş durumu tanımlıdır. Başarısız bildirimler başarılı olana kadar beş dakikada bir yeniden gönderilir; sürekli hata veren webhook ise otomatik olarak pasife alınır. Trendyol, webhook teslimatının her zaman garanti edilemeyeceğini belirtir ve sipariş paketi servisiyle periyodik eşitleme yapılmasını önerir. Sağlam akış bu yüzden iki katmanlıdır:

  • Webhook: Yeni sipariş ve durum değişikliğinde hızlı tepki verir.
  • Periyodik eşitleme: Kaçan, geciken veya hatalı işlenen olayı yakalar.

İade neden doğrudan stok değildir?

İade edilen tekstil ürünü depoya döndü diye satışa açılmamalıdır. Etiketi kopmuş, kumaşı lekelenmiş, yanlış ürün dönmüş ya da paket eksik olabilir. Pakette kusursuz görünen bir ferace, kontrolde etek ucundaki makyaj lekesiyle ayrılabilir. Ürün yeniden satışa açılırsa ikinci müşteriye kusurlu gider. İade akışını en az üç duruma ayırın: satılabilir, kontrol bekliyor, kusurlu. İade entegrasyonu yalnızca “stok artır” komutu değildir; depo durumlarını da taşımalıdır.

API değişikliklerini kim takip edecek?

Entegrasyon kurulumla bitmez. Trendyol API modelleri değişir, eski endpoint’ler kapanır, yeni alanlar eklenir. Trendyol değişiklik kayıtlarına göre:

  • 8 Nisan 2026’da ürün videoları için yükleme ve onay durumu takibi servisleri eklendi.
  • 30 Temmuz 2026’da eski sipariş endpoint’inin 15 Ekim 2026 itibarıyla kullanımdan kaldırılacağı duyuruldu; yerine V2 sipariş endpoint’i geldi.
  • 9 Eylül 2026’da sipariş paketi ve webhook yanıtlarına müşterinin ödeme yöntemini taşıyan paymentMethod alanı eklendi; Trendyol doğru faturalama için entegrasyonların bu alanı okumasını istedi.

Bu kayıtları kimse izlemiyorsa çalışan bir sistem bir tarihte sessizce veri kaybetmeye başlayabilir. Bakım sorumlusu ve kapsamı bu yüzden baştan yazılı olmalıdır.

Görsel ve ürün içeriği entegrasyonun neresinde?

Ürün aktarımı başlık ve fiyat göndermek değildir. Görsel, renk, beden, kumaş ve kalıp bilgisi birlikte doğru gitmelidir. İadeyi artıran tipik durumlar şunlardır: renk seçildiğinde başka rengin görselinin görünmesi, kumaş içeriğinin eksik olması, kalıbın dar mı oversize mı olduğunun yazılmaması, beden tablosunun ürünle eşleşmemesi ve kampanya görselinin ana ürün görselinin yerine geçmesi.

Hazır entegrasyon ne zaman yeter, ne zaman özel akış gerekir?

Hazır entegrasyon küçük ve standart kataloglarda hızlı başlangıç sağlar. Karar, katalogdan değil satış modelinden çıkar:

DurumHazır entegrasyonÖzel veri akışı
Tek veya iki satış kanalı, küçük katalogGenellikle yeterliGerekmez
Kendi site, Trendyol, mağaza ve başka pazaryeri aynı stoğu tüketiyorSınırdaGerekir
Yüksek varyant sayısı, sık kampanya fiyatıLimit ve kuyruk mantığı kontrol edilmeliGenellikle gerekir
Birden fazla depo veya fiziksel mağazaÇoğu zaman yetmezGerekir
İadede ayrı kalite kontrol durumuDestekliyorsa yeterliDesteklemiyorsa gerekir
ERP, muhasebe veya üretim sistemi bağlanacakYetmezGerekir

Trendyol, kendi mağazanız ve depo aynı ürün verisini farklı biçimde tutuyorsa mesele bir eklenti seçmek değildir; önce ürün ve stok modeli kurulur. Designodin’de e-ticaret sitesi kurulumu bu yüzden vitrinle sınırlı kalmaz: beden, varyant ve iade akışından ödeme altyapısına uzanır. Shopify veya WooCommerce kullanan işletmelerde de aynı ilke geçerlidir. Yüksek varyant, çoklu kanal veya özel depo mantığı varsa mağaza kurulumuyla birlikte uygulama seti ve veri akışı baştan değerlendirilmelidir.

Entegrasyon sağlayıcısına hangi 10 soruyu sormalısınız?

Teklif almadan önce yanıtları yazılı isteyin. “Tek panelden yönetirsiniz” yanıtı yeterli değildir.

  1. Ana stok kaynağı hangi sistem olacak?
  2. Her renk-beden kombinasyonu ayrı stok koduyla mı izlenecek?
  3. Trendyol barkodu iç stok koduyla nasıl eşleşecek?
  4. Renk ayrı içerik, beden varyant olarak nasıl modellenecek?
  5. Stok güncellemesi hata verirse veya limite takılırsa tekrar deneme mantığı ne?
  6. Webhook kaçarsa sipariş verisi nasıl eşitlenecek?
  7. İade edilen ürün doğrudan mı, kalite kontrolden sonra mı stoğa dönecek?
  8. Kargo, fatura, iptal ve iade durumları hangi sistemde izlenecek?
  9. Trendyol API değişikliklerini kim, hangi sıklıkla takip edecek?
  10. Entegrasyon sona ererse ürün, sipariş ve stok verisine erişim sizde kalacak mı?

Bu soruların yanıtı yoksa ortada sistem değil, yalnızca bir bağlantı satışı vardır.

Sık yapılan hatalar

  1. Stoğu model düzeyinde tutmak. Siyah M bitince bütün siyah ürün tükenmiş görünür ya da son adet iki kanalda birden satılır.
  2. Trendyol panelini ana kaynak yapmak. Kendi site ve mağaza ayrı sayım yapar, akşam paketlemede iptal çıkar.
  3. Bütün renkleri tek görsel setine bağlamak. Müşteri beyazı seçer, siyahın detay fotoğrafını görür.
  4. Limitleri hesaba katmadan toplu güncelleme. Kampanya sabahı stok ve fiyat aynı limiti tüketir, güncellemeler sıraya takılır.
  5. İşlem sonucunu kontrol etmemek. İstek gönderildi diye işlendi sayılır; hatalı barkod haftalarca fark edilmez.
  6. Yalnızca webhook’a güvenmek. Kaçan bir bildirim, sistemde hiç görünmeyen bir siparişe dönüşür.
  7. İadeyi doğrudan stoğa eklemek. Kusurlu ürün ikinci müşteriye gider.
  8. Bakımı sahipsiz bırakmak. Kaldırılan bir endpoint, çalıştığı sanılan entegrasyonu sessizce durdurur.

90 günlük plan

İlk 30 gün: Veriyi ve kaynağı netleştirin.

  • Ana stok, ürün ve fiyat kaynağını yazılı olarak belirleyin.
  • Her renk-beden kombinasyonuna iç stok kodu verin, Trendyol barkodlarıyla eşleştirme tablosunu çıkarın.
  • Kategori zorunlu özelliklerini ve renk bazlı görsel setlerini kontrol edin.
  • Mağazanızın ürün listeleme kademesini ve buna düşen API limitini öğrenin.

31–60. gün: Akışı kurun ve hata senaryolarını deneyin.

  • Stok rezervasyonu, kuyruk ve tekrar deneme mantığını kurun.
  • Webhook ile periyodik sipariş eşitlemesini birlikte devreye alın.
  • Test siparişi, kısmi iptal ve iade senaryolarını çalıştırın.
  • İade için satılabilir, kontrol bekliyor ve kusurlu durumlarını tanımlayın.

61–90. gün: Ölçün ve sahiplenin.

  • Günlük stok ve sipariş mutabakat raporunu izleyin; farkları kaynağına kadar izleyin.
  • API hata kayıtlarını ve limit aşımlarını haftalık okuyun.
  • Değişiklik kayıtlarını izleyecek kişiyi ve bakım kapsamını yazılı hale getirin.
  • İlk kampanyadan önce yoğun gün provası yapın.

Sık Sorulan Sorular

Trendyol’da renkler ve bedenler nasıl yönetilmelidir?

Trendyol’un ürün modelinde renk gibi slicer özellikler ürünü ayrı içeriklerde açar; beden ise aynı içeriğin varyantıdır. Aynı modelin ürünleri aynı productMainId ile gönderilir. Her renk-beden kombinasyonunun kendi barkodu ve stoğu olur. Nihai yapı ilgili kategorinin özellikleriyle test edilmelidir.

Trendyol stokları ne sıklıkla güncellenmelidir?

Sıklık satış hızına bağlıdır, ama sınırı Trendyol çizer. Stok ve fiyat güncellemeleri dakikalık ortak bir limiti paylaşır, tek istekte en fazla 1.000 ürün gider ve aynı istek 15 dakika tekrar gönderilemez. Bu yüzden yalnızca değişen veri gönderilir, sipariş anında rezervasyon yapılır ve gün sonunda mutabakat alınır.

Webhook varken ayrıca sipariş eşitlemesi gerekir mi?

Evet. Trendyol webhook teslimatının her zaman garanti edilemeyeceğini belirtir ve sipariş paketi servisiyle periyodik eşitleme önerir. Webhook hızlı tepki sağlar, periyodik eşitleme veri bütünlüğünü korur.

İade edilen tekstil ürünü doğrudan stoğa eklenmeli mi?

Hayır. Ürün önce kalite kontrolden geçer. Satılabilir durumdaki ürün ana stoğa döner. Kusurlu, eksik veya yeniden satışa uygun olmayan ürün ayrı bir depo durumunda tutulur.

Hazır Trendyol entegrasyonu yeterli olur mu?

Küçük ve standart kataloglarda, tek veya iki kanalla satışta çoğu zaman yeterlidir. Çok kanallı satış, yüksek varyant sayısı, ERP veya depo sistemi bağlantısı, fiziksel mağaza stoğu ya da ayrı iade kontrolü varsa özel veri akışı ve ek geliştirme gerekir.

Doğru entegrasyon satışı değil, operasyonu büyütür

Trendyol entegrasyonu satış kanalınızı büyütebilir. Ancak renk, beden, stok ve iade kuralları yanlış kurulursa operasyon hataları da aynı hızla büyür. Sağlam yapı tek panelle başlamaz: her varyant için açık barkod ve stok kodu, tek stok doğrusu, limitlere göre kurulmuş bir kuyruk, kontrollü iade akışı ve sahibi belli bir bakım gerekir. Bu temeli ilk kampanyadan önce kurun.

İlgili Yazılar

Trendyol’daki stok, kendi mağazanızdaki stokla aynı kaynaktan gelsin.

Mağazanızı beden, varyant ve iade akışından ödeme altyapısına kadar kurarız; her renk-beden kombinasyonunun benzersiz SKU’su ve doğru stok durumu olur. Kaç ürün, kaç varyant olduğunu ve pazaryeriyle çalışıp çalışmadığınızı yazmanız yeterli. Formu doldurursunuz; yazılı kapsam ve teklifle e-postayla döneriz.

Tekstil e-ticaret sitesi Yazılı teklif alın

  • #trendyol-entegrasyonu
  • #pazaryeri-entegrasyonu
  • #stok-yonetimi
  • #tekstil-e-ticaret
  • #woocommerce
  • #shopify

Bu işi sizin için de kuralım.

Sizi aramaz, kimseyi habersiz bir listeye eklemeyiz. Ne istediğinizi yazın; e-postayla, teklif ve teslim tarihiyle geri dönelim.