Hangi servis neyi günceller?
| Servis | Yol (sellers/{sellerId} sonrası) | Anahtar alan | Güncellenebilenler |
|---|---|---|---|
| Onaysız ürün | /products/unapproved-bulk-update | barkod bazlı kalem | Ürün bilgileri |
| Onaylı içerik | /products/content-bulk-update | contentId | title, description, images, attributes |
| Onaylı varyant | /products/variant-bulk-update | barcode | stockCode, vatRate, shipmentAddressId, returningAddressId, dimensionalWeight, lotNumber, locationBasedDelivery, channels |
| Teslimat bilgisi | /products/delivery-info-bulk-update | barcode | deliveryOptions (deliveryDuration) |
Tüm yollar /integration/product/sellers/{sellerId} ile başlar ve POST yöntemiyle çağrılır.
Onaylı ürünlerde değişmeyen alanlar
Onaylı bir üründe barcode, productMainId, brandId ve categoryId değiştirilemez. Slicer ya da varianter olan özelliklerin (renk, beden gibi) değerleri de güncellenemez. Bu alanlarda yanlışlık varsa çözüm çoğunlukla ürünü arşivleyip doğru bilgilerle yeniden açmaktır.
İçerik servisinde özellikler dışında kısmi güncelleme desteklenir. Yalnız açıklamayı değiştirmek için contentId ve description göndermek yeterlidir. Ancak özelliklerden biri bile değişecekse ürünün bütün özellikleri ve değerleri birlikte gönderilmelidir.
null tuzağı ve kısmi istek
Doküman açık bir uyarı yapar: bir alanı null göndermek, o alanın mevcut değerini üründen tamamen siler. Örneğin title: null başlığı, vatRate: null KDV bilgisini kaldırır. Değişmesini istemediğiniz alanı gövdeye hiç koymayın.
Varyant servisinde rehber sayfası, barkod ve değişen alanın gönderilmesiyle kısmi güncelleme yapılabileceğini söyler. API referansının özeti ise kısmi güncellemenin desteklenmediğini yazar. Bu çelişki giderilene kadar güvenli yol, varyantın güncel bütün alanlarını okuyup değiştirdiğiniz alanla birlikte göndermektir.
channels alanı CORE ve LUXE değerlerini alır. Yalnız ürünü bir kanalda yayına açmak ya da kapatmak için gönderilmesi önerilir. Boş dizi olarak gönderilirse hata döner.
Teslimat süresi
Ağustos 2026'dan beri hızlı teslimat yalnız deliveryDuration ile yönetilir. Bugün kargoda için 0, en geç yarın kargoda için 1 gönderilir. fastDeliveryType alanı artık işlenmez; gönderilse bile dikkate alınmaz. Teslimat süresi gönderilmezse barkoda varsayılan termin süreniz uygulanır.
Sonucu kontrol etmek
Her güncelleme bir batchRequestId döner. Önce toplu işlem kontrolü ile kalemlerin kabul edildiğini görün. Onaylı ürün güncellemeleri ardından ayrıca bir kontrol adımından geçer.
| Adım | Servis | Ne öğrenirsiniz |
|---|---|---|
| 1 | GET .../products/batch-requests/{batchRequestId} | İstek kabul edildi mi, hangi kalem FAILED |
| 2 | GET .../products/{contentId}/update-audits | Ürün kontrol adımının sonucu: SUCCESS, FAIL ya da RUNNING |
| 3 | Ret varsa rejectReasons alanı | Güncellemenin neden reddedildiği |
Stok ve fiyat bu servislerin kapsamında değildir; onlar için stok ve fiyat güncelleme servisini kullanın.
Sık sorulanlar
Onaylı ürünün kategorisini değiştirebilir miyim?
Hayır. Onaylı ürünlerde barcode, productMainId, brandId ve categoryId güncellenemez. Kategori yanlışsa ürünü yeniden açmanız gerekir.
Sadece açıklamayı güncellemek için ne göndermeliyim?
content-bulk-update servisine contentId ve description göndermeniz yeterlidir. Özellikler hariç kısmi güncelleme desteklenir.
Bir alanı null gönderirsem ne olur?
Alanın mevcut değeri üründen tamamen silinir. Değişmesini istemediğiniz alanları gövdeye hiç eklemeyin.
Ürün güncellemesinin reddedilip reddedilmediğini nasıl anlarım?
Batch sonucu başarılı olduktan sonra update-audits servisini contentId ile çağırın. Durum FAIL ise rejectReasons alanında red sebepleri yazar.
Reddedilen onaysız ürünü nasıl yeniden onaya gönderirim?
Onaysız ürün listesinden ret nedenini okuyun, ilgili alanları unapproved-bulk-update servisiyle düzeltin. Güncellenen ürün yeniden onay sürecine girer.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı