Ürün yükleme reddi için adım adım teşhis
Trendyol toplu ürün yüklemede neden reddediliyor?
Excel veya entegrasyon dosyasını yüklediniz; fakat bazı ürünler reddedildi, aktarım tamamlanmadı ya da gönderim başarılı göründüğü hâlde ürünler satışa çıkmadı. Bu üç belirti aynı hatanın kanıtı değildir. Bu rehber, ürün bazında gerçek ret nedenini bulmayı ve hatalı satırları güvenle düzeltmeyi anlatıyor.
İlk bakmanız gereken yer, hatanın dosya doğrulaması, Trendyol toplu işlem sonucu veya ürün içerik/onay süreci aşamalarından hangisinde oluştuğudur. Her biri için farklı düzeltme gerekir.
Dosya yüklenemedi: Şablon veya formatı inceleyin. İstek kabul edildi, satırlar FAILED: batch sonucu ve failureReasons inceleyin. İşlem SUCCESS, ürün yayında değil: onaysız ürün/inceleme durumuna bakın. “Başarılı yükleme”, otomatik ürün onayı değildir.
Önce reddin hangi aşamada oluştuğunu bulun
Trendyol ürün aktarımı, satıcı paneli üzerinden Excel/şablon yükleme veya API/entegrasyon sistemi ile yapılabilir. Bu yolların veri biçimi ve hata raporu aynı olmayabilir; bu yüzden API kodunu doğrudan Excel hata sütununa eşit kabul etmeyin. Trendyol’da satış yapmak sürecini anlatan genel rehberlerden farklı olarak burada hedef, ürün bazlı reddi düzeltecek kanıtı yakalamaktır.
| Belirti | İlk kontrol | Yanlış yorum |
|---|---|---|
| Excel dosyası yüklenirken hata | Şablon başlıkları, biçim ve zorunlu sütunlar | Her ürün reddedildi sanmak |
| API 200/202 ve batch ID döndü | getBatchRequestResult, item status, failureReasons | HTTP başarısını ürün onayı sanmak |
| Ürün satırı SUCCESS; mağazada yok | Onaysız ürün durumu, productFilter ve içerik onayı | Aynı ürünü tekrar tekrar açmak |
| Yalnız bazı ürünler başarısız | Başarısız satırdaki kategori/marka/özellik/barkod | Tüm dosyayı baştan oluşturmak |
Ürün oluşturma isteği kabul edildiyse batchRequestId değerini saklayın. Trendyol, Product V2 için işlemlerin kuyrukta işlendiğini ve sonuçtaki failureReasons alanıyla başarısız ürünlerin bulunabileceğini belgeliyor.
1. Güncel olmayan Excel şablonu veya yanlış sütun eşleşmesi
Belirti: hatayı nasıl tanırsınız?
Dosya satırları daha işleme alınmadan reddediliyor; aynı içerik eski şablonla yüklenirken yeni panelde hata veriyor.
Olası kök neden
Kategoriye özgü şablon değişmiş, alan başlıkları kaymış veya veriler yanlış sütuna yapışmış olabilir. Satıcı panelindeki Excel dosyalarıyla API şeması aynı format değildir.
Uygulanabilir çözüm
Satıcı panelinden işlem yapılacak kategoriye uygun güncel şablonu yeniden indirin. Başlık satırlarını düzenlemeyin; önceki dosyadan yalnız veri hücrelerini uygun alanlara taşıyın.
İlk 2–3 ürünü yeni dosyada deneyin. Eski şablondan makroları, gizli sütunları veya filtreli kopyalamayı otomatik aktarmayın.
2. Yanlış kategori ID veya eksik zorunlu kategori özellikleri
Belirti: hatayı nasıl tanırsınız?
Bazı satırlar kabul edilirken yalnız belirli ürün grupları reddediliyor; beden, materyal, renk veya diğer özellikler için hata görünüyor.
Olası kök neden
Trendyol Product V2’de en alt seviyedeki kategori kullanılmalı. Kategori özellikleri ve zorunluluklar değişebilir. Seçilen kategorinin güncel required, allowCustom ve değer ID bilgileriyle gönderilen veri uyumsuz olabilir.
Uygulanabilir çözüm
Kategori ağacının son seviyesini doğrulayın. Kategori özellik listesini güncel çekin; zorunlu özelliklerin kodlarını ve kabul edilen değer ID’lerini kontrol edin.
Örneğin metinle “Mavi” yazılması gereken değil, izin verilen özellik değer kimliği gereken alana serbest metin gönderirseniz ürün geçmeyebilir.
3. Marka ID, ürün kimliği veya marka kullanım şartı uyuşmazlığı
Belirti: hatayı nasıl tanırsınız?
Marka alanına isim yazılmış olmasına rağmen kabul edilmiyor; ürün aynı kategoride başka markayla geçerken bu markayla takılıyor.
Olası kök neden
API tarafında marka adı metni ile brandId aynı veri değildir. Yanlış marka kimliği, hesabın ürünle ilişkilendirilmesi veya marka kullanımına ilişkin inceleme sorun yaratabilir.
Uygulanabilir çözüm
Trendyol’un güncel marka listesinden doğru brandId alın. Satıcı panelindeki marka seçimi ile entegrasyon gönderimini eşleştirin.
Onaysız ürün raporunda marka/ürün uygunluğu uyarısı varsa kaynağını inceleyin. Sahip olmadığınız marka için rastgele başka marka ID’si göndermeyin.
4. Barkod, productMainId veya varyant eşlemesi hatalı
Belirti: hatayı nasıl tanırsınız?
Birden fazla satır aynı ürüne bağlanıyor; yeni ürün açılması beklenirken mevcut ürünle çakışıyor veya varyantlar yanlış birleştiriliyor.
Olası kök neden
barcode ürünü ayırt etmek için kullanılır; productMainId ise varyant/model gruplanmasında önemlidir. Başta sıfır silinmesi, gizli boşluklar, yinelenen barkodlar veya model kodunun gereksiz paylaşılması hataya yol açabilir.
Uygulanabilir çözüm
Barkod alanlarını metin olarak koruyun; kaybolan sıfırları kaynak sistemden yeniden alın. Her varyantın doğru ve tutarlı barkod/model kodu kullanımını kontrol edin.
Trendyol Product V2’de barkod özel karakterleri ve uzunluk sınırları tanımlıdır; özgün barkodu değiştirmek yerine veriyi bu sözleşmeyle karşılaştırın.
5. Fiyat, KDV ve stok alanları geçersiz
Belirti: hatayı nasıl tanırsınız?
Ürün ismi ve görseller doğru olduğu hâlde fiyat/stok verisi bulunan satırlar FAILED durumuna düşüyor.
Olası kök neden
listPrice satış fiyatından küçük olamaz. Sayısal değerlerin virgül/nokta, negatif stok, yanlış veri tipi veya geçersiz KDV oranıyla gönderilmesi doğrulamayı bozabilir.
Uygulanabilir çözüm
Fiyatları sayısal sütunlarda kontrol edin; liste fiyatı ve satış fiyatı ilişkisini doğrulayın. KDV oranını ürün ve API sözleşmesine uygun gönderin.
Excel’de 1.299,90 ile 1299.90 biçimlerinin entegrasyon tarafından nasıl ayrıştırıldığını canlı ortamdan bağımsız test edin. ürün fiyatlandırma stratejileri yazısındaki fiyatlandırma yaklaşımı teknik alan doğrulamasından farklıdır.
6. Görsellerin HTTPS erişimi, sayısı veya ürün içeriği uygun değil
Belirti: hatayı nasıl tanırsınız?
API veya satıcı paneli görsel alanında hata gösteriyor; görüntü bilgisinin olduğu ürünler aktarılmıyor ya da incelemede reddediliyor.
Olası kök neden
Product V2 görsel URL’lerinin HTTPS olması, erişilebilir olması ve ilgili teknik gereksinimlere uyması beklenir. Dosya adı, yönlendirme, hotlink koruması veya süreli URL kullanımında sağlayıcı resmi çekemeyebilir.
Uygulanabilir çözüm
Görsel URL’sini oturum açmadan, gizli pencerede ve mümkünse farklı ağdan test edin. Görselin doğrudan içerik döndürdüğünü, HTTPS sertifikasını ve belirtilen boyut kurallarını denetleyin.
Product V2 belgesi barkod başına en fazla 8 görsel ve 1200×1800 boyut bilgisi veriyor; yeni kısıtları yükleme kanalınıza göre yeniden doğrulayın. ürün fotoğrafçılığında ışık ve arka plan seçimi konusu fotoğrafın estetiğine, bu kontrol teknik erişime odaklanır.
7. CSV/Excel veri türleri, özel karakterler veya hücre bozulması
Belirti: hatayı nasıl tanırsınız?
Dosyada değerler doğru görünürken sisteme aktarıldığında barkod, açıklama, fiyat veya kategori hücreleri değişiyor.
Olası kök neden
Excel uzun sayıları bilimsel gösterime çevirebilir, baştaki sıfırları silebilir veya CSV açılışında veri türlerini kendisi tahmin edebilir. UTF-8 kodlaması, ayraç ve satır sonları da entegrasyonlarda önemlidir.
Uygulanabilir çözüm
Özgün veriyi yedekleyip kritik kimlik sütunlarını metin olarak içeri alın. Türkçe karakterlerin doğru kodlandığını ve gizli satır/sekme karakterlerini kontrol edin.
CSV’yi Excel’de çift tıklayıp kaydetmek yerine içeri aktarma aracıyla sütun türlerini seçin. Hata veren tek bir satırı düz metin editörüyle ve kaynak kayıtla karşılaştırın.
8. Yanlış API sürümü, kimlik doğrulama veya toplu işlem limitleri
Belirti: hatayı nasıl tanırsınız?
Entegrasyon ürünü hiç göndermiyor; 400, 401, 403, 429, 5xx ya da zaman aşımı yanıtları alınıyor.
Olası kök neden
İstek gövdesi doğru olsa bile yanlış endpoint, erişim anahtarı, sellerId, ürün API sürümü veya kapasite sınırı nedeni olabilir. Trendyol Product V2 belgelerinde tek istekte en fazla 1.000 ürün belirtiliyor; Product V1 servisleri için 15 Ekim 2026 kullanım sonu duyurulmuştu.
Uygulanabilir çözüm
Entegrasyonda kullanılan URL’nin Product V2 olup olmadığını kontrol edin; üretim/test ortamlarını, satıcı kimliğini ve HTTP yanıt kodunu ayrı kaydedin.
401/403’te yetki, 400’de gövde, 429’da oran sınırı, 5xx’te sağlayıcı durumu incelenir. Sürekli başarısız istekleri art arda tekrarlamak yerine kontrollü yeniden deneme uygulanır.
9. Batch sonuçları okunmuyor veya ürün onay reddi aktarım hatası sanılıyor
Belirti: hatayı nasıl tanırsınız?
Toplu yükleme başarılı mesajı görünüyor ama ürünler yayında değil; işlem kuyruğu sonlanmadan ürün tekrar gönderiliyor.
Olası kök neden
API isteğinin kabulü ile her satırın tamamlanması farklıdır. batchRequestId işlemin sonucunu sorgular; failureReasons ürün bazlı hataları verir. Başarılı aktarılan ürünler ayrıca onay sürecine girer.
Uygulanabilir çözüm
Önce getBatchRequestResult çağrısından işin tamamlanmasını ve her ürünün SUCCESS/FAILED durumunu kontrol edin. Ardından onaysız ürün filtresinden inceleme veya ret gerekçesini bulun.
Toplu işlem sonucunun sorgulanabilirliği belgelerde dört saate kadar belirtiliyor; sonuçları zamanında kaydedin. Onay sürecindeki ürünü durmadan yeniden göndermeyin.
Hata mesajına göre hızlı teşhis tablosu
Aşağıdaki ifadeler birebir her satıcı hesabında aynı biçimde görünmeyebilir. Özellikle Excel paneli ile API yanıtlarının alanları farklıdır; örnekler, hangi parametreyi incelemeniz gerektiğini açıklamak içindir.
| Görünüm / kod | Muhtemel kontrol | Aksiyon |
|---|---|---|
| Zorunlu özellik eksik | Kategori özellik listesi / required | Güncel kategori şablonunu ve özellik değerlerini çek |
| Barkod geçersiz / çakışıyor | barcode, ürün kimliği | Kaynak stok kaydıyla karşılaştır |
| Geçersiz marka veya marka reddi | brandId / ürün politikası | Marka ID ve uygunluk durumunu doğrula |
| Görsel alınamıyor | HTTPS, erişim, görsel ölçüsü | Anonim erişim ve görüntü yanıtını sınama |
| Liste fiyatı satış fiyatından küçük | listPrice, salePrice | Fiyatların ilişkisini düzelt |
| HTTP 400 | Şema ve zorunlu alan | API gövdesini alan bazında doğrula |
| HTTP 401 / 403 | Kimlik bilgisi, sellerId, endpoint | Yetki ve ortamı kontrol et |
| HTTP 429 | API istek oranı | Hız sınırı ve kontrollü yeniden deneme |
| Batch IN_PROGRESS | Henüz tamamlanmayan kuyruk | Yeni yükleme yapmadan sonucu izle |
| Batch FAILED item | failureReasons | Yalnız başarısız ürünleri düzelt |
| İşlem SUCCESS, ürün görünmüyor | Ürün onay/reddi | Onaysız ürün filtresini denetle |
Barkod, model ve kategori uyumunu çözdükten sonra ürün açıklamalarının anlaşılabilirliğini e-ticaret ürün açıklaması hazırlama yaklaşımıyla ayrı geliştirmek, içerik kalitesini artırabilir; ancak bu durum teknik ret nedenini tek başına ortadan kaldırmaz.
Entegrasyon kullananlar için örnek batch sonuç okuma
Aşağıdaki JSON parçası bir temsili örnektir; gerçek API yanıtı kullanılan ürün sürümüne ve işlem türüne göre değişir. Amaç yalnızca genel HTTP yanıtı yerine ürün satırının status ve failureReasons alanlarına bakmayı göstermek.
{
"batchRequestId": "ornek-batch-id",
"status": "COMPLETED",
"items": [
{"status": "SUCCESS", "failureReasons": []},
{"status": "FAILED", "failureReasons": ["Örnek: kategori özelliği eksik"]}
]
}Bu örnek gerçek bir Trendyol hatası çıktısı değildir. Kodlayan ekip, işlem kabul edildiğinde dönen ID’yi saklamalı; tamamlandığında ürün bazında hataları kayıt altına almalı ve yalnız başarısız satırları tekrar göndermelidir. Ürünler onay aşamasındaysa farklı bir durum akışı işletilmelidir.
- API isteği gönderildi ve batchRequestId döndü.
- Batch sorgusu tamamlanana kadar kontrollü aralıklarla yapıldı.
- Her ürün için durum, barkod ve failureReasons kaydedildi.
- Başarısız ürünler düzeltildi; başarılı ürünlerin içerik onay sonucu ayrıca kontrol edildi.
Bu süreç, e-ticaret operasyonu operasyonunun ürün kaydı kısmını güvenilir hâle getirir. Ürün yayınlandıktan sonraki görünürlüğü ve trafik performansını ise e-ticaret SEO rehberi gibi ayrı bir kapsamda değerlendirmek gerekir.
Satıcı panelinde karşılaşılan 5 örnek senaryo
Ürün dosyası kabul edildi ama 80 ürünün 12’si görünmüyor
Batch sonucunda 12 satırın FAILED olup olmadığını ayırın. SUCCESS olanlar için onaysız ürün durumunu inceleyin.
Giyim ürünlerinde beden seçeneği yüzünden ret var
En alt kategori ve özellik değerlerini güncelleyin. Varyant model kodu ile zorunlu beden özelliklerini eşleyin.
Eski entegrasyonla API hataları başladı
Product V1’den V2’ye geçişi, endpoint ve alan sözleşmesini karşılaştırın; 15 Ekim 2026 duyurusunu kontrol edin.
Görseller webde açılıyor ama Trendyol çekemiyor
HTTPS zincirini, resmin kimlik doğrulamasız sunulmasını ve CDN/hotlink korumasını kontrol edin.
Ürün aktarılmış fakat içerik onayında reddedilmiş
Tekrar dosya yüklemek yerine onaysız ürün filtresindeki ret gerekçesini ve içerik/marka uygunluğunu düzeltin.
Teknik hata düzeldikten sonra fiyatlama için e-ticaret kâr marjı hesaplama, ürün gruplandırma için e-ticaret ürün varyantları ve müşteri deneyimi için dönüşüm optimizasyonu farklı optimizasyon konularıdır; bu yazı yükleme reddinin kendisiyle sınırlıdır.
Toplu ürün reddini çözmek için 10 adımlık güvenli test planı
Binlerce satırı yeniden yüklemek yerine önce küçük test grupları kullanın. Yanlış barkod veya fiyatla tekrar gönderilen ürünler mevcut listelemeyi etkileyebilir. Bu nedenle orijinal dosyayı ve hata raporunu değiştirmeden saklayın.
- Yükleme kanalı belirleyin: satıcı paneli Excel mi, API/entegrasyon mu?
- Hata veren işlem ve en az üç örnek barkod için eski/yeni veriyi yedekleyin.
- Excel şablon sürümünü veya API Product V2 endpoint ve yetkisini kontrol edin.
- En alt kategori ID’sini ve güncel zorunlu özellik listesini doğrulayın.
- Marka ID, barkod, model kodu, fiyat ve stok alanlarını kaynakla karşılaştırın.
- Görsel URL’lerinin doğrudan HTTPS erişimini, sayısını ve teknik biçimini sınayın.
- Başarısız bir-iki satırla kontrollü test yüklemesi yapın.
- API ise batch ID, item status ve failureReasons kaydedin; paneldeyse satır bazlı raporu indirin.
- Başarılı aktarılan ancak yayında olmayan ürünlerde içerik onay durumunu inceleyin.
- Düzeltilmiş dosyayı küçük gruplar hâlinde yükleyin, sonuçları izleyin ve tekrar eden hatayı kuralla önleyin.
20 maddelik son kontrol listesi
- ☐ Doğru mağaza/satıcı hesabı seçildi
- ☐ Yükleme türü (Excel veya API) belirlendi
- ☐ Güncel Excel şablonu kullanılıyor
- ☐ Ürün API sürümü Product V2 ile uyumlu
- ☐ Kategori en alt seviye ID’ye ait
- ☐ Güncel kategori özellik listesi kontrol edildi
- ☐ Marka ID ve marka uygunluğu doğrulandı
- ☐ Barkodlar benzersiz ve metin olarak korundu
- ☐ productMainId varyant yapısıyla eşleşiyor
- ☐ Zorunlu alanlar boş değil
- ☐ Liste fiyatı satış fiyatından düşük değil
- ☐ Stok, KDV ve sayısal değerler geçerli
- ☐ Ürün açıklamaları uygun ve karakterler sağlam
- ☐ Görseller HTTPS ile herkese açık erişilebilir
- ☐ İstek/parti sınırları kontrol edildi
- ☐ Batch ID / satır hata raporu saklandı
- ☐ Onaysız ürün ve ret nedenleri ayrıca kontrol edildi
- ☐ Başarısız satırlarla tekrar yükleme yapıldı
- ☐ Başarılı ürünün yeniden işlenmesi engellendi
- ☐ Küçük testten sonra tam yükleme doğrulandı
Teknik yükleme kabulü sağlandıktan sonra yeni ürünlerin bulunabilirliğini e-ticaret SEO hizmetleri kapsamında, pazaryerinin sürdürülebilir maliyetlerini pazaryeri komisyon oranları kapsamında ayrıca değerlendirebilirsiniz.
Trendyol toplu ürün yükleme hataları hakkında sık sorulan sorular
Trendyol toplu ürün yükleme neden reddedilir?
En sık kontrol edilen alanlar şablon biçimi, kategori ve zorunlu özellikler, marka, barkod, fiyat, görseller ve API işlem durumudur. Kesin neden için ürün satırının hata raporunu okuyun.
Dosya başarıyla yüklendiyse ürün mutlaka yayına çıkar mı?
Hayır. Aktarımın teknik kabulü ve ürünün içerik/onay kontrolünden geçmesi ayrı aşamalardır.
Trendyol Excel yükleme hatalarını nereden görebilirim?
Satıcı panelinin ilgili ürün yükleme sonuçları ve satır bazlı hata raporları incelenir. Ekran adları zamanla değişebilir.
Trendyol API’de batchRequestId ne işe yarar?
Kuyruğa alınan toplu ürün işleminin sonucunu sorgulamak için kullanılır; item durumlarını ve failureReasons alanlarını kontrol etmenizi sağlar.
HTTP 200 veya 202 gelmesi tüm ürünlerin kabul edildiği anlamına mı gelir?
Hayır. İsteğin kabul edildiğini gösterebilir; her ürünün işleme veya onay sonucunu ayrıca doğrulayın.
Ürünler neden toplu aktarımda kategori hatası alıyor?
En alt kategori seçilmemiş, kategori ağacı güncellenmemiş veya zorunlu özellik/değer eşleşmeleri hatalı olabilir.
Barkodlar Excel’de bozulursa ne yapmalıyım?
Kaynak dosyadan yeniden alın; barkodları metin olarak içe aktarın ve baştaki sıfırlarla gizli boşlukları kontrol edin.
Ürün varyantlarının model kodu aynı olabilir mi?
Aynı modelin varyantları belirli bir model kodu altında gruplanabilir; ancak barkodlar ve kategoriye uygun varyant değerleri doğru tutulmalıdır.
Görsel bağlantısı tarayıcıda açılıyorsa yeterli mi?
Hayır. Trendyol sunucusunun kimlik doğrulamasız HTTPS erişimi, boyut ve dosya gereksinimleri ayrıca karşılanmalıdır.
Trendyol ürün API V1 hâlâ kullanılmalı mı?
Trendyol, Product V1 servislerinin 15 Ekim 2026 itibarıyla kullanım dışı olacağını duyurdu. Yeni entegrasyonlarda güncel Product V2 belgelerine bakılmalıdır.
Bir istekte en fazla kaç ürün gönderilebilir?
Product V2 ürün oluşturma belgelerinde tek istek için en fazla 1.000 ürün açıklanır. Entegrasyon türü ve güncel limitleri ayrıca doğrulayın.
Marka hatasında farklı marka seçip yüklemek çözüm mü?
Hayır. Doğru marka ID ve ürünün marka uygunluğu doğrulanmalıdır; yanlış marka kullanımı yeni ret sorunlarına yol açabilir.
Ürün onayda görünüyorsa toplu yüklemeyi tekrar yapmak gerekir mi?
Genellikle önce onay durumunu ve varsa ret gerekçesini incelemek gerekir. Tekrar yükleme yapmadan ürünün gerçekten başarısız olup olmadığını kontrol edin.
Reddedilen ürünler için tüm Excel dosyasını yeniden yüklemeli miyim?
Hayır. Mümkünse hatalı satırları ayıklayıp düzeltin; küçük test gruplarıyla doğrulayın ve mevcut başarılı ürünleri yanlışlıkla değiştirmeyin.
Resmî teknik kaynaklar
Bu rehberde satıcı paneli Excel akışı ile entegrasyon API’si arasındaki farklar gözetilmiştir. Ekran adları, şablon sütunları, kategori özellikleri ve API sözleşmesi değişebileceği için işlemlerden önce kullanılan kanalın güncel dokümanını doğrulayın.
- Trendyol — Ürün Yaratma v2
- Trendyol — Toplu İşlem Kontrolü V2
- Trendyol — Kategori Özellik Listesi v2
- Trendyol — Onaysız Ürün Filtreleme
- Trendyol — Entegrasyon Hata Kodları
- Trendyol — Product V1 Kategori Özellik Listesi ve kullanım sonu duyurusu
Pazaryeri ürün yükleme hatalarını çözdükten sonra genel organik trafik, katalog yapısı ve dönüşüm süreçlerini İstanbul merkezli reklam ajansı Zeymedya yayınlarında yer alan ilgili kaynaklarla birlikte değerlendirebilirsiniz.



