Trendyol Ürün API V1 Kapanıyor: 15 Eylül 2026 Geçiş Kontrol Listesi

Trendyol’un resmî geliştirici dokümanı, Ürün V1 endpoint servislerinin 15 Eylül 2026 itibarıyla kullanım dışı olacağını duyuruyor. Bu, ürün aktarma ve güncelleme işini V1 üzerinden yapan her panelin, her ERP bağlantısının ve her özel entegrasyonun o tarihte durması anlamına geliyor. Bu yazı, “beni etkiliyor mu, etkiliyorsa ne yapacağım” sorusuna sırayla cevap veriyor.

Tam Olarak Ne Kapanıyor?

Dokümandaki V1 tablosunda 11 servis listeleniyor: satıcı adresleri, kargo şirketleri listesi, marka listesi, kategori listesi, kategori özellik listesi, ürün aktarma, ürün güncelleme, stok ve fiyat güncelleme, ürün silme, toplu işlem kontrolü ve ürün filtreleme.

Burada dikkat edilmesi gereken bir ayrıntı var. Bu 11 servisin bir kısmının adresi V2 tablosunda birebir aynı görünüyor — marka listesi, kategori listesi, stok ve fiyat güncelleme, ürün silme ve toplu işlem kontrolü bunlardan. Yani bu uçlar için dokümanın iki tablosu aynı URL’yi gösteriyor; bunların gerçekten kapanıp kapanmayacağını Trendyol entegrasyon ekibine sormadan varsaymayın.

Buna karşılık dört serviste adres açıkça değişmiş. Kesin olarak taşınması gerekenler bunlar:

İşlem	V1 (kapanıyor)	V2 (yeni)
Ürün aktarma	POST /integration/product/sellers/{sellerId}/products	POST /integration/product/sellers/{sellerId}/v2/products
Ürün güncelleme	PUT /integration/product/sellers/{sellerId}/products	Dörde ayrıldı (aşağıda)
Kategori özellikleri	GET /integration/product/product-categories/{categoryId}/attributes	GET /integration/product/categories/{categoryId}/attributes
Ürün filtreleme	GET /integration/product/sellers/{sellerId}/products	Üçe ayrıldı (aşağıda)

Hepsi https://apigw.trendyol.com alan adı altında; test ortamı https://stageapigw.trendyol.com.

Sizi Etkiliyor mu? 10 Dakikalık Kontrol

Entegrasyonu kimin yazdığını hatırlamıyor olabilirsiniz. Sorun değil — cevabı kodda değil, giden isteklerde aramak daha hızlı:

1. Sunucu loglarında trendyol geçen giden istekleri arayın. Son 30 günün erişim veya uygulama loglarını tarayın. Aradığınız şey URL listesi.
2. Şu üç desene bakın. İsteğin yolunda /v2/products yoksa ve düz /sellers/{id}/products varsa: V1. PUT ile ürün güncelliyorsanız: V1. product-categories/{id}/attributes çağırıyorsanız: V1.
3. Hazır bir entegrasyon kullanıyorsanız (pazaryeri entegratörü, e-ticaret altyapısının Trendyol modülü, ERP eklentisi), sağlayıcıya tek bir soru sorun: “Ürün servislerinde V2’ye geçtiniz mi, geçiş tarihiniz ne?” Yazılı cevap isteyin.
4. Hiç log tutmuyorsanız, panelinizde Trendyol’a ürün gönderen ekranı bir kez çalıştırıp giden isteği kaydedin. Tek bir istek bile hangi sürümde olduğunuzu söyler.

Entegrasyonunuz Trendyol’dan yalnızca sipariş çekiyor ve ürünleri panele elle giriyorsanız bu kapanış sizi doğrudan etkilemiyor. Yine de V1 listesinde satıcı adresleri ve kargo şirketleri servisleri de yer aldığı için, sevkiyat veya etiket akışınızın bu servisleri kullanıp kullanmadığını bir kez kontrol etmekte fayda var.

Kritik nokta şu: sipariş servisleri bu kapsamda değil. Siparişler akmaya devam edecek, panelinizde her şey normal görünecek. Kırılan tarafta ürün aktarımı ve güncellemesi olduğu için arıza günlerce, bazen haftalarca fark edilmez. Bu arada stok, satılan ürünler için düşmediğinden stok sayınız gerçeğin üstünde kalır; aşırı satış, iptal ve ceza puanı riski birikir. Sezon veya kampanya öncesine denk gelirse doğrudan ciro kaybıdır.

V2’de Ne Değişti?

Bu bir isim değişikliği değil, sürüm değişikliği; veri yapısı ve akış da farklı.

Kategori ve özellik yapısı. Adres product-categories/{id}/attributes yerine categories/{id}/attributes oldu. Ayrıca V2’de bir özelliğin alabileceği değerleri ayrı bir uçtan çekiyorsunuz: GET /integration/product/categories/{categoryId}/attributes/{attributeId}/values. Özellik değerlerini standart attributeValueId ile ya da kategori izin veriyorsa serbest metin customAttributeValue ile gönderebiliyorsunuz.

Güncelleme dörde ayrıldı. V1’de tek bir PUT her şeyi yapıyordu. V2’de neyi güncellediğinize göre ayrı uçlar var, hepsi POST:

• Onaysız ürün: /products/unapproved-bulk-update
• Onaylı ürün içeriği: /products/content-bulk-update
• Onaylı ürün varyantı: /products/variant-bulk-update
• Onaylı ürün teslimat bilgisi: /products/delivery-info-bulk-update

Bu, entegrasyonunuzda “ne değişti” ayrımını yapmanızı gerektiriyor: fiyat mı, görsel mi, varyant mı? V1’de her şeyi tek pakette yollayan kodun bölünmesi lazım.

Filtreleme üçe ayrıldı. Tek listeleme ucu yerine tek ürün için /product/{barcode}, onaysız ürünler için /products/unapproved, onaylı ürünler için /products/approved var. Ayrıca stok ve fiyatı ayrı çeken /products/approved/inventory-and-price ucu eklendi.

Toplu işlem akışı aynı mantıkta. Ürün aktarımı hâlâ eşzamansız: istek başına 1.000 kaleme kadar gönderiyorsunuz, yanıt olarak batchRequestId alıyorsunuz ve sonucu GET /integration/product/sellers/{sellerId}/products/batch-requests/{batchRequestId} ile sorguluyorsunuz. Yani “200 döndü, ürün geçti” demek değil; toplu işlem sonucunu ayrıca okumanız gerekiyor. V1’de bu kontrolü atlayan kodlar epey yaygın — geçişte düzeltilecek yerlerden biri.

Geçiş Planı

Sıra önemli, çünkü her adım bir sonrakinin girdisini üretiyor.

1. Envanter çıkarın. Trendyol’a giden tüm çağrıları listeleyin: hangi dosya, hangi URL, hangi metot. Kaç yerden çağrıldığını görmeden süre tahmini yapmayın.
2. Stage ortamında başlayın. stageapigw.trendyol.com üzerinde V2 uçlarını tek tek çalıştırın. Önce kategori ve özellik çekme, sonra tek ürünle aktarma.
3. Kategori eşleşmesini yeniden doğrulayın. Özellik listesi ucu değiştiği için, ürünlerinizin kategori-özellik eşlemesini kaydedilmiş eski çıktıya göre değil, yeni uçtan gelen veriye göre kurun.
4. Güncelleme kodunu bölün. Tek PUT yerine dört POST ucuna dağıtın; hangi alan değişince hangisinin çağrılacağını netleştirin.
5. Batch sonucu kontrolünü zorunlu hale getirin. Başarısız kalemleri loglayın ve görünür kılın.
6. Bir uyarı kurun. “Son 6 saatte Trendyol’a başarılı ürün/stok güncellemesi gitmediyse haber ver” kuralı, bu tür sessiz arızaları günler değil saatler içinde yakalar. Aynı mantığı pazaryeri yorum ve soru akışında da kullanıyoruz.
7. Canlıya alın, V1 kodunu bir süre silmeyin. Kapanışa kadar geri dönebilecek durumda kalın.

Zaman Çizelgesi

Bugün 11 Ağustos 2026; kapanışa yaklaşık beş hafta var. Gerçekçi bir takvim şöyle:

• Bu hafta: Envanter ve etki tespiti. Hazır entegrasyon kullanıyorsanız sağlayıcıdan yazılı tarih alın.
• Ağustos sonuna kadar: Stage’de V2 uçlarının tamamının çalışır hâle gelmesi.
• 1–7 Eylül: Canlıda kademeli geçiş ve gözlem.
• 8–15 Eylül: Tampon. Kampanya dönemine denk gelen bir geçişi son güne bırakmayın.

Eylül ortasına kadar V2’ye geçemeyeceğinizi görüyorsanız, bunu şimdi bilmek en kötü haber değil; en kötüsü 15 Eylül sabahı öğrenmek.

Kim Yapacak?

Bu iş, mevcut kodu okuyup hangi çağrının nereye gittiğini çıkarabilen ve eşzamansız toplu işlem akışını doğru kuran birini gerektiriyor. İçeride böyle bir kaynak varsa yukarıdaki plan yeterli. Yoksa dışarıdan destek almak, kapanış tarihine beş hafta kala makul bir tercih.

Trendyol ve diğer pazaryeri bağlantılarınızın V2 geçişini konuşmak isterseniz API geliştirme ve entegrasyon tarafında ne yaptığımıza bakabilir, iletişim sayfamızdan bize ulaşabilirsiniz.