Yüklemeden önce toplanacak bilgiler
Ürün gövdesindeki kimliklerin çoğu Trendyol'un kendi listelerinden gelir. Sırayla şu servisleri çağırın:
- Marka arama ile brandId.
- Kategori ağacı ile en alt seviyedeki categoryId. Alt kategorisi olan bir kategoriyle ürün açılamaz.
- Kategori özellikleri ile zorunlu özellikler ve değer kimlikleri.
- Gerekirse adres servisi ile shipmentAddressId ve returningAddressId, kargo sağlayıcı listesi ile cargoProviders kodu.
İstek alanları
| Alan | Zorunlu | Tip ve sınır | Açıklama |
|---|---|---|---|
| barcode | Evet | metin, 40 | Özel karakter olarak yalnız nokta, tire ve alt tire; aradaki boşluklar birleştirilir |
| title | Evet | metin, 100 | Ürün adı |
| productMainId | Evet | metin, 40 | Model kodu; varyantlar aynı değeri taşır |
| brandId / categoryId | Evet | sayı | Trendyol marka ve en alt kategori kimliği |
| quantity | Evet | sayı | Stok adedi |
| stockCode | API referansında zorunlu | metin, 100 | Kendi sisteminizdeki benzersiz stok kodu |
| dimensionalWeight | API referansında zorunlu | sayı | Desi |
| description | Evet | HTML metin, 30.000 | Ürün açıklaması |
| listPrice / salePrice | Evet | sayı | Liste fiyatı satış fiyatından küçük olamaz |
| vatRate | Evet | sayı | KDV oranı: 0, 1, 10, 20 |
| images | Evet | liste, en fazla 8 | https adresleri |
| attributes | Evet | liste | attributeId ile attributeValueIds ya da attributeValue |
| deliveryOption.deliveryDuration | Hayır | sayı | 0 bugün kargoda, 1 en geç yarın kargoda |
| origin, lotNumber, shipmentAddressId, returningAddressId, cargoProviders | Hayır | çeşitli | Menşei, parti/lot bilgisi, depo adresleri, barkod bazlı kargo |
Kılavuz sayfası stockCode ve dimensionalWeight için "Hayır" yazar; API referansındaki şema ise ikisini zorunlu listeler. Güvenli yol ikisini de göndermektir.
Varyantlı ürün nasıl açılır?
Varyantlama productMainId ile yapılır. Aynı ürünün L ve XL bedenleri aynı productMainId, farklı barkod ve farklı stok koduyla gönderilir; yalnız ilgili özellik değeri değişir.
Kategori özelliğindeki iki bayrak sonucu belirler. slicer true olan özellik (çoğunlukla renk, elektronikte hafıza) ürünü ayrı içerik kartlarında açar. varianter true olan özellik (çoğunlukla beden) aynı kartta seçenek oluşturur. Her kategoride en fazla bir varianter seçilebilir.
Gönderim sonrası
Yanıt yalnız batchRequestId içerir. Toplu işlem kontrolü servisinde batchRequestType ProductV2OnBoarding olarak görünür. Kalem SUCCESS ise ürün onay sürecindedir. Onay süren ve reddedilen ürünler yayına çıkmaz; durumlarını onaysız ürün listesinden izleyin ve ret nedenine göre ürünü güncelleyin.
| Hata | Neden | Çözüm |
|---|---|---|
| FAILED, kategori hatası | Üst seviye kategori ya da eski kategori kimliği | En güncel ağaçtan yaprak kategoriyi seçin |
| FAILED, zorunlu özellik | required true olan özellik eksik | Özellik listesini required filtresiyle kontrol edin |
| FAILED, fiyat | listPrice, salePrice'tan küçük | Liste fiyatını satış fiyatına eşit ya da büyük yapın |
| 400 | Alan adı ya da tip hatası | V1 alan adlarını (attributeValueId gibi) v2 karşılıklarıyla değiştirin |
Sık sorulanlar
Trendyol'a tek istekte kaç ürün yükleyebilirim?
createProducts v2 servisine bir istekte en fazla 1000 kalem gönderilebilir. İstekler Product Integration Write grubu limitine sayılır.
Ürün yükledim ama sitede görünmüyor, neden?
Başarılı yükleme ürünü onay sürecine sokar. Onay süren ya da reddedilen ürün yayına çıkmaz. Durumu onaysız ürün filtresinden kontrol edin; reddedildiyse nedeni orada yazar.
Varyantları nasıl gruplarım?
Aynı ürünün varyantlarını aynı productMainId ile, farklı barkod ve stok koduyla gönderin. Yalnız varyant özelliği (örneğin beden) farklı olmalıdır.
Barkodda hangi karakterler kullanılabilir?
Harf, rakam ve Türkçe karakterlere ek olarak yalnız nokta, tire ve alt tire kullanılabilir. Barkod en fazla 40 karakterdir; ortadaki boşluklar birleştirilir.
Kaynaklar
İlgili Trendyol API konuları
Son güncelleme: 27.10.2026 · Trendyol API rehberinin tamamı