Trendyol’da satış yapan ve aynı zamanda kendi e-ticaret sitesi olan işletmelerin çoğu bir noktada aynı sorunu yaşıyor: stok iki ayrı yerde tutuluyor, biri güncellenince diğeri unutuluyor ve elde kalan son ürün iki kanaldan birden satılıyor. Bunun çözümü, Trendyol’u sitenize API üzerinden bağlamak.
Hazır bir entegratör kullanmak da bir yol. Ama hangisini seçerseniz seçin, işin arka planda nasıl yürüdüğünü bilmek size doğru soruları sordurur.
API bilgilerini nereden alırsınız?
Trendyol satıcı panelinde sağ üstteki mağaza adınıza tıklayıp Hesap Bilgilerim > Entegrasyon Bilgileri bölümüne gidiyorsunuz. Burada üç bilgi var: Satıcı ID, API Key ve API Secret. Bu bölümü yalnızca ana (admin yetkili) kullanıcı görebiliyor. Panele sonradan eklediğiniz bir çalışan “bende böyle bir menü yok” diyorsa sebep bu.
Bu bilgiler mağazanızın anahtarı. E-postayla ortalıkta dolaştırmayın, kodun içine yazmayın. Birlikte çalıştığınız bir firmayla işiniz bittiğinde de anahtarları yenileyin.
Kimlik doğrulama ve ilk hata
İstekler Basic Auth ile yapılıyor: API Key ve Secret birleştirilip base64 ile kodlanıyor. Buraya kadar standart. İlk denemede en çok takılınan şey User-Agent başlığı. Trendyol bu başlığı zorunlu tutuyor ve belli bir formatta istiyor: önce satıcı ID, sonra entegrasyonu yapanın adı. Kendi entegrasyonunuzu yazıyorsanız “1234 – SelfIntegration” gibi. Bu başlık olmadan gelen istekler 403 ile geri dönüyor ve hata mesajı sebebi pek açık söylemiyor.
Test ortamı
Trendyol’un ayrı bir test (stage) ortamı var ve oradaki hesap bilgileri canlıdakilerden tamamen farklı. Test ortamına bağlanabilmek için sunucunuzun IP adresinin Trendyol tarafında yetkilendirilmesi gerekiyor; bunun için satıcı destek hattından talep açılıyor. Test ortamından 503 alıyorsanız büyük ihtimalle IP’niz henüz tanımlanmamış.
Bu adım birkaç gün sürebildiği için projenin en başında başlatmakta fayda var. Test ortamında deneme siparişi oluşturup sipariş akışını baştan sona deneyebiliyorsunuz. Canlı mağazada deneme yanılma yapmaktan çok daha güvenli.
Ürün aktarımı: asıl iş burada
Ürünü Trendyol’a göndermek kâğıt üzerinde tek bir istek. Pratikte en çok zaman alan kısım kategori ve özellik eşleştirmesi.
Her ürün bir alt kategoriye bağlanıyor ve her kategorinin kendi zorunlu özellikleri var: renk, beden, materyal, cinsiyet gibi. Bu özelliklerin değerleri de çoğu zaman serbest metin değil, Trendyol’un listesinden seçilmesi gereken değerler. Sitenizde “Lacivert” yazan rengin Trendyol’daki karşılığını bulmanız gerekiyor. Marka da aynı şekilde Trendyol’un marka listesinden eşleştiriliyor.
Bir de şu var: ürün oluşturma ve güncelleme istekleri anında sonuç dönmüyor. Size bir işlem numarası veriliyor ve ürünün kabul edilip edilmediğini bu numarayla ayrıca sorguluyorsunuz. Bu kontrolü yapmayan entegrasyonlar “ürünleri gönderdik” deyip reddedilen ürünleri haftalarca fark etmiyor.
Bizim önerimiz şu: kategori ağacını ve özellik listelerini bir kez çekip saklayın, ürünü göndermeden önce zorunlu alanların dolu olduğunu kendi tarafınızda kontrol edin. Reddedilen ürünleri de birinin gerçekten bakacağı bir listede toplayın.
Stok ve fiyat güncelleme
Stok ve fiyat barkod üzerinden güncelleniyor. Bu yüzden barkodların sitenizle Trendyol arasında birebir aynı olması şart. Aynı barkodu iki farklı varyantta kullanmak, stok karmaşasının en yaygın sebebi.
Bilinmesi gereken birkaç kural:
- Tek istekte en fazla 1.000 ürün gönderilebiliyor.
- Aynı içerikteki bir isteği 15 dakika içinde tekrar gönderirseniz hata alıyorsunuz. Her seferinde bütün kataloğu göndermek yerine yalnızca değişenleri gönderin.
- Aynı barkod için dakikada yapılabilecek fiyat güncellemesi sınırlı.
Stok senkronunu yalnızca belli aralıklarla çalışan bir zamanlayıcıya bırakmak riskli. Sitenize sipariş geldiği anda Trendyol stoğunu düşürmek, Trendyol’a sipariş geldiğinde de siteyi güncellemek gerekiyor. Çok satan ürünlerde son bir iki adedi tampon olarak ayırmak, iki kanaldan aynı anda satışı ciddi ölçüde azaltıyor.
Siparişler
Siparişler Trendyol’da paket olarak geliyor. Paketleri belirli aralıklarla çekebilir ya da webhook tanımlayıp Trendyol’un size haber vermesini sağlayabilirsiniz. Webhook daha hızlı. Yine de bir bildirimin ulaşmama ihtimaline karşı arada bir sipariş listesini çekip karşılaştıran bir kontrol eklemek iyi bir alışkanlık.
Sipariş akışında paket durumunu güncelleme, fatura linkini Trendyol’a iletme ve kargo bilgileri gibi adımlar da var. Fatura tarafında e-arşiv entegratörünüzle bağlantıyı kurmak ayrı bir iş; e-arşiv ve e-fatura yazımızda bu konuya değindik.
İstek limitleri
Trendyol API’de istek limitleri var ve aşıldığında 429 hatası dönüyor. Eylül 2026’dan itibaren limitler servis gruplarına ve mağazanızın ürün listeleme limitine göre belirleniyor. En sık gördüğümüz hata, bu 429 cevaplarının hiçbir yere kaydedilmemesi: entegrasyon sessizce sipariş kaçırıyor ve kimse fark etmiyor. Her isteğin sonucunu kaydedin, limit hatası geldiğinde bir süre bekleyip yeniden deneyin.
Hazır entegratör mü, özel entegrasyon mu?
Ürün sayınız az, kategori yapınız basitse ve kullandığınız altyapının hazır bir Trendyol bağlantısı varsa, onu doğru ayarlamak çoğu zaman yeterli. Birden fazla depo, karmaşık varyantlar, stoğu ERP’de tutan bir yapı ya da birden fazla pazaryeri varsa özel entegrasyon daha mantıklı hale geliyor.
Hangisinin size uygun olduğundan emin değilseniz pazaryeri entegrasyonu sayfamıza bakın ya da bize yazın. Kullandığınız altyapıya göre neyin yeteceğini söyleyelim.