Değişen Ne? Attribute’tan Bağımsız origin Alanına Geçiş

Bugüne kadar Trendyol’da bir ürünün menşei bilgisi (örneğin “Türkiye” veya “Çin”), ilgili kategori için zorunlu bir özellik (attribute) olarak tanımlanmışsa, diğer ürün özellikleriyle birlikte attributes dizisi altından gönderiliyordu. Trendyol, veri yapısını modernize etmek amacıyla bu bilgiyi artık ürün payload’unda ayrı, bağımsız bir alan olan origin üzerinden almaya geçiyor. Bu, teknik olarak küçük ama entegrasyon kodunuzda mutlaka karşılığı olması gereken bir değişiklik; çünkü origin alanı, attribute ID’lerine bağlı olmayan, standart bir metin/kod alanı olarak çalışıyor.

Geçiş Takvimi: Hibrit Dönem ve 23 Ekim 2026 Zorunluluğu

Trendyol bu geçişi iki aşamalı, “yumuşak geçiş” (soft transition) modeliyle kurguladı. Hibrit dönemde (şu an içinde bulunduğumuz dönem), ürün payload’una origin adında yeni bir alan eklenmiş durumda ve bu alan opsiyonel. Menşei bilgisi ilgili kategori için zorunlu bir özellikse, attribute altından gönderim hâlâ zorunlu kalmaya devam ediyor; origin alanı ise bu dönemde ek olarak, isteğe bağlı gönderilebiliyor. 23 Ekim 2026 tarihi itibarıyla origin alanı zorunlu hale gelecek ve aynı anda attribute altından menşei gönderimi opsiyonel olacak. İleride attribute altındaki menşei alanının tamamen kaldırılması planlanıyor; bu tarih ayrıca duyurulacak.

Geçmiş Ürünleriniz İçin Ne Olacak?

Zaten sisteme kayıtlı, mevcut ürünleriniz için manuel bir taşıma işlemi yapmanız gerekmiyor: Trendyol, 23 Ekim 2026 deadline’ı geldiğinde attributes içinde yer alan tüm mevcut menşei bilgilerini otomatik olarak yeni origin alanına taşıyacak. Buradaki asıl risk geçmiş veride değil, deadline’dan sonra göndereceğiniz yeni ürün ekleme ve güncelleme isteklerinde; entegrasyon kodunuz origin alanını doldurmuyorsa, menşeinin zorunlu olduğu kategorilerde bu istekler reddedilebilir.

Hangi Servisler Etkileniyor?

Değişiklik, ürün oluşturma ve güncelleme akışının geçtiği hemen hemen tüm uçları kapsıyor: Ürün Aktarma V1 (createProducts), Ürün Bilgisi Güncelleme V1 (updateProduct), Toplu İşlem Kontrolü (getBatchRequestResult), Ürün Filtreleme V1 (filterProducts), Ürün Yaratma V2, Ürün Güncelleme – Onaysız Ürün V2, Ürün Güncelleme – Onaylı Ürün V2 (Varyant) ve ilgili filtreleme uçları. Kendi altyapınızı bu servisler üzerinden Trendyol’a bağlıyorsanız, her birinde origin alanının okunup gönderildiğinden emin olmanız gerekiyor; Trendyol entegrasyonu üzerinden çalışan mağazalar için bu güncellemenin entegrasyon sağlayıcı tarafında yapılıp yapılmadığını kontrol etmek öncelikli adım olmalı.

Entegrasyonunuzu Nasıl Hazırlamalısınız?

Deadline’a kadar izlenebilecek pratik bir yol haritası şöyle: önce hangi ürün kategorilerinizde menşei bilgisinin zorunlu attribute olarak tanımlı olduğunu listeleyin; ardından entegrasyon kodunuzda (veya kullandığınız entegrasyon yazılımında) ürün gönderim isteklerine origin alanının eklenip eklenmediğini test ortamında doğrulayın. Menşei değerlerinin Trendyol’un beklediği kod/isim formatına uyup uymadığını kontrol edin — bu değerler entegrasyon dokümanındaki Menşei Değerleri Listesi’nde yer alıyor. Son olarak, düşük hacimli bir test güncellemesiyle origin alanının doğru şekilde işlendiğini canlıda teyit edin; bunu 23 Ekim’e yakın değil, mümkünse birkaç hafta önceden yapmak, olası bir uyumsuzluğu fark edip düzeltecek zaman bırakır.

Güncellemeyi Kaçırırsanız Ne Olur?

23 Ekim 2026’dan sonra origin alanı zorunlu hale geldiğinde, entegrasyon kodunuz hâlâ yalnızca eski attribute yapısına güveniyorsa ve bu alanı doldurmuyorsa, menşeinin zorunlu olduğu kategorilerdeki yeni ürün ekleme veya güncelleme istekleri reddedilme riski taşır. Bu, özellikle sık ürün/fiyat/stok güncellemesi yapan, çok sayıda SKU’yu aynı anda yöneten mağazalar için kritik: tek bir alan eksikliği, ilgili kategorideki toplu güncelleme isteklerinin tamamının hata dönmesine yol açabilir. Mikro ihracat veya Trendyol International üzerinden yurt dışına satış yapan mağazalar için menşei bilgisi zaten gümrük ve lojistik süreçlerinin ayrılmaz bir parçası olduğundan, bu değişikliği gözden kaçırmanın maliyeti yalnızca listeleme hatası değil, sevkiyat gecikmesi de olabilir.

Sık Yapılan Hatalar

Bu geçişte en sık karşılaşılan hatalar arasında şunlar öne çıkıyor: origin alanının yalnızca yeni oluşturulan ürünlere eklenip, düzenli güncellenen mevcut ürünlerin istek gövdesine dahil edilmemesi; menşei değerinin attribute’ta kullanılan serbest metin formatıyla origin alanının beklediği standart kod/isim arasında bire bir eşleşmemesi; test ortamında doğrulama yapmadan doğrudan canlıda deadline’a yakın bir tarihte güncelleme yapmaya çalışmak ve entegrasyon sağlayıcısına bu değişikliğin uygulanıp uygulanmadığını hiç sormadan sürecin “otomatik hallolacağını” varsaymak.

Pixa ile Bu Geçişi Sorunsuz Yönetmek

Pixa Lab, Trendyol’un ürün servislerindeki bu tür alan değişikliklerini entegrasyon katmanında takip eder ve gerekli güncellemeleri mağaza tarafında ek bir aksiyon gerektirmeden uygular; menşei bilgisi, ürün yönetimi panelinizde tanımladığınız değerler üzerinden hem attribute hem de yeni origin alanına doğru şekilde eşlenir. Bu sayede 23 Ekim 2026 deadline’ı geldiğinde ürün güncelleme isteklerinizin reddedilme riskini kendi ekibinizin API kodunu değiştirmesine gerek kalmadan yönetebilirsiniz.

Sık Sorulan Sorular

origin alanı ne zaman zorunlu hale geliyor?

23 Ekim 2026 tarihi itibarıyla origin alanı zorunlu olacak; aynı tarihte attribute altından menşei gönderimi opsiyonel hale gelecek.

Mevcut ürünlerimdeki menşei bilgisi kaybolur mu?

Hayır, deadline geldiğinde attributes içindeki tüm mevcut menşei bilgileri Trendyol tarafından otomatik olarak yeni origin alanına taşınacak; geçmiş veri için manuel işlem gerekmiyor.

Hem attribute hem origin alanını aynı anda göndermek gerekiyor mu?

Hibrit dönemde, menşei zorunlu bir attribute ise ikisini birlikte göndermek güvenli bir yaklaşımdır; 23 Ekim 2026’dan sonra ise yalnızca origin alanının doldurulması yeterli olacaktır.

Bu değişiklik hangi ürün işlemlerini etkiliyor?

Ürün ekleme, güncelleme, toplu işlem kontrolü ve ürün filtreleme servislerinin hem onaylı hem onaysız ürün akışlarını kapsayan sürümlerini etkiliyor.

Entegrasyon yazılımı kullanıyorsam bu güncellemeyi ben mi yapmalıyım?

Hayır, kullandığınız entegrasyon sağlayıcısının bu alan değişikliğini kendi tarafında uygulaması gerekir; yine de deadline’a yakın bir tarihte sağlayıcınıza durumu teyit ettirmeniz önerilir.