Bu rehberde ele alınan temel konular
  • Batch kabulü ile ürün onayını birbirinden ayırın.
  • Marka ID’sini metinle değil güncel marka listesinden eşleştirin.
  • Yalnızca en alt kategori ve o kategoriye ait güncel zorunlu özellikleri kullanın.
  • Reddedilen veya onay bekleyen ürünleri filtreleme ve batch sonuç servislerinden izleyin.

Trendyol ürünleri neden satışa açılmaz?

Ürün aktarımının API tarafından kabul edilmesi yalnızca isteğin işleme alındığını gösterir. Trendyol’un resmî Ürün Yaratma V2 dokümantasyonuna göre başarılı aktarılan ürünler onay sürecine girer; onay süreci devam eden veya reddedilen ürünler yayına çıkmaz. Satışa açılmayan üründe önce ürün durumunu ve batch sonucunu kontrol etmek gerekir.

En sık görülen sorunlar; yanlış marka ID’si, alt seviyede olmayan kategori, eksik zorunlu özellik, geçersiz özellik değeri, tekrar kullanılan barkod, uygun olmayan görsel ve onay sonrasında stok-fiyat bilgisinin bulunmamasıdır.

Aktarım kabul edildiği hâlde görülebilecek durumlar

Batch işleniyorToplu işlem henüz tamamlanmamıştır.
Onay bekliyorİçerik kontrol süreci devam eder.
ReddedildiÜrün bazlı hata mesajı düzeltilmelidir.
Onaylandı fakat satışa kapalıStok, fiyat veya listeleme koşulu eksik olabilir.

Marka eşleştirme hatası nasıl çözülür?

Ürün aktarımında marka adı yerine Trendyol’un marka servisinden alınan geçerli marka ID’si kullanılmalıdır. Merkez sistemde “Oto Aksesuarcım” yazması, pazaryerindeki kayıtla otomatik olarak aynı marka kabul edileceği anlamına gelmez. Noktalama, boşluk, ticari unvan veya benzer isimler yanlış eşleşmeye neden olabilir.

  1. Marka listesini güncel servisten alın.
  2. Merkez marka adını normalize ederek eşleşme adaylarını bulun.
  3. Kesin eşleşmeyen markayı otomatik bağlamayın.
  4. Doğrulanan marka ID’sini kalıcı eşleme tablosuna kaydedin.
  5. Marka mevcut değilse ilgili marka oluşturma veya destek sürecini izleyin.

Kategori seçiminde en alt seviye kullanılmalıdır

Trendyol’un kategori özellikleri dokümantasyonu, ürün oluştururken alt kategorisi olmayan en alt kategori ID’sinin kullanılmasını ister. “Giyim” veya “Elektronik” gibi üst kategori gönderildiğinde ürün oluşturulamaz ya da gerekli özellikler doğru belirlenemez.

Kategori ağacı zaman içinde güncellendiği için eski bir yerel kopyaya güvenmek de hata doğurabilir. Resmî dokümantasyon güncel kategori ağacının kullanılmasını ve kategori özellik listesinin düzenli aralıklarla yenilenmesini önerir.

Zorunlu kategori özellikleri eksik veya geçersiz olabilir

Her kategorinin zorunlu, isteğe bağlı ve varyant oluşturan özellikleri farklıdır. Bir ayakkabı kategorisinde numara ve renk gerekirken başka bir kategoride beden, materyal veya kullanım alanı zorunlu olabilir. Özellik adı doğru olsa bile serbest metin yerine Trendyol’un tanımlı değer ID’si beklenebilir.

  • Özellik listesi doğru categoryId ile alındı mı?
  • Zorunlu alanların tamamı gönderiliyor mu?
  • Özellik değeri güncel listeden seçildi mi?
  • Varyant özellikleri ürün grubu içinde tutarlı mı?
  • Sayısal alanlarda birim ve format doğru mu?
  • Menşei gibi bağımsız alana taşınan veriler güncel modele uygun mu?

Barkod, stok kodu ve varyant yapısını kontrol edin

Barkod ürünün temel kimliklerinden biridir. Aynı barkodun farklı ürün veya varyantta kullanılması, onaylı üründe değiştirilmek istenmesi veya boş/uygunsuz formatta gönderilmesi ürün akışını durdurabilir. Stok kodu ise merkez sistemle eşleşme için tutarlı kalmalıdır.

Renk ve beden varyantlarının aynı ürün grubu altında doğru bağlanması; her varyantın ayrı barkod ve stok koduna sahip olması gerekir. Ürün adıyla eşleştirme yapılmamalıdır.

Ürün onay süreci nasıl izlenir?

Aktarım sonrası dönen batch kimliği saklanmalı ve toplu işlem sonucu ürün bazında sorgulanmalıdır. Trendyol, stok ve ürün işlemlerinde item bazlı durumların kontrol edilmesini belirtir. Ardından ürün filtreleme servisiyle ürünün onaylı, reddedilmiş veya bekleyen durumu doğrulanmalıdır.

Yalnızca ilk API yanıtına bakmayın.İstek kabul edilmiş olsa bile ürün bazlı hata, onay bekleme veya içerik reddi bulunabilir.

Onaylanan ürün neden yine satışa açılmaz?

İçeriği onaylanan ürünün satışta görünmesi için geçerli fiyat ve satılabilir stok bilgisi gerekir. Stok ve fiyat güncellemesi ayrı servis üzerinden gönderilir. Ürün bilgisi güncelleme servisiyle stok-fiyat değiştirmeye çalışmak doğru sonuç vermez.

Fiyatın para birimi ve KDV yapısı, satış fiyatı ile liste fiyatı ilişkisi ve stok miktarı kontrol edilmelidir. Sıfır stok veya geçersiz fiyat ürünü satışa kapalı bırakabilir.

Product V2 geçişini gözden kaçırmayın

Trendyol dokümantasyonunda bazı Product V1 endpointlerinin 10 Ağustos 2026 itibarıyla kullanım dışı olacağı belirtilmektedir. 30 Temmuz 2026 itibarıyla eski endpoint kullanan entegrasyonların Product V2 servislerine geçiş planını tamamlaması gerekir. Eski kategori, özellik veya ürün akışında kalmak yakın tarihte yeni hatalar doğurabilir.

Geçiş sırasında yalnızca URL değiştirmek yeterli olmayabilir; alan adları, zorunlu bilgiler, kategori özellik yapısı, batch sonucu ve ürün filtreleme akışı birlikte kontrol edilmelidir.

Trendyol ürün hataları neden–çözüm tablosu

Hata veya belirtiMuhtemel nedenÇözüm
Marka bulunamadıYanlış veya eski brandIdGüncel marka listesinden ID eşleştirin
Kategori geçersizÜst kategori seçildiAlt kategorisi olmayan en alt categoryId kullanın
Zorunlu özellik eksikKategori özellikleri güncel değilGüncel özellik listesini çekip zorunlu alanları tamamlayın
Özellik değeri geçersizSerbest metin veya eski değer ID’siTanımlı özellik değerini kullanın
Barkod zaten mevcutAynı barkod başka üründe kayıtlıÜrün ve varyant kimliğini düzeltin
Onaylandı fakat görünmüyorStok sıfır veya fiyat geçersizStok-fiyat servisi ve batch sonucunu kontrol edin

Hangi durumda teknik destek gerekir?

  • Binlerce üründe kategori ve özellik eşlemeleri yeniden kurulacaksa
  • Eski Product V1 entegrasyonu V2’ye taşınacaksa
  • Batch sonuçları kaydedilmiyor veya hata kuyruğu oluşmuyorsa
  • Marka ve kategori eşleşmeleri her aktarımda yeniden bozuluyorsa
  • Onaylı ürünler stok-fiyat gönderimine rağmen satışa açılmıyorsa

Sık sorulan sorular

Ürün aktarımı başarılıysa ürün neden görünmez?

Başarılı ilk yanıt, ürünün işleme alındığını gösterir. Ürün daha sonra onay bekleyebilir veya ürün bazlı hata alabilir.

Ürün adını değiştirerek marka hatası çözülür mü?

Hayır. Marka eşleşmesi geçerli marka ID’si üzerinden yapılır.

Stok ve fiyat ürün güncelleme servisiyle değişir mi?

Trendyol stok ve fiyat için ayrı güncelleme servisi kullanır; içerik güncelleme akışından ayrılmalıdır.

Trendyol ürün hatalarını toplu olarak düzeltin

Marka, kategori, özellik, barkod ve batch sonuçlarını birlikte inceleyerek satışa açılmayan ürünlerin gerçek hata nedenlerini çıkaralım.

E-Ticaret ve Entegrasyon Paketlerini İnceleyin