Toplu Ürün Güncellemede Hata Kodları ve Çözümleri

Muhammet Çay · Yayın 17 Eylül 2026 · Güncelleme 17 Eylül 2026 · 12 dk okuma

Son güncelleme: 17 Eylül 2026. Bu sayfadaki kurallar satıcı dokümanlarına dayanır ve tarihlidir.

Hata kodu 1001: Başlık uzunluğu aşımı?

Bu hata başlık uzunluğunun 255 karakteri geçmesiyle oluşur. Trendyol Akademi sayfasında başlık uzunluğu 255 karakterdir.

Hata kodu 2002: Görsel boyutu uyumsuz mu?

Görsel boyutu 1024x1024 pikselden küçükse bu hata alınır. Trendyol görsel kuralları burada belirtilmiştir.

Hata kodu 3003: Zorunlu alan eksik mi?

Ürün açıklaması boşsa bu hata döner. Açıklama 60 kelimeyi geçmelidir. Açıklama rehberi bu konuda detay verir.

Hata kodu 4004: Kategori uyumsuzluğu?

Ürün, seçilen kategori ile uyumsuz özellik içeriyorsa bu hata görülür. Hepsiburada toplu ekleme rehberi bu konuda rehberlik eder.

Hata kodu 5005: Fiyat alanı negatif mi?

Fiyatın negatif girilmesi bu hatayı tetikler. Fiyat alanı 0 ile 999999 arasında olmalı. Toplu güncelleme dokümanı fiyat aralığını açıklar.

Hata kodu 6006: Ürün kodu tekrar ediyor mu?

Ürün kodu aynı dosyada iki kez varsa bu hata alınır. Kodun benzersiz olması gerekir.

Hata kodu 7007: Satıcı ID eksik mi?

Satıcı ID alanı boşsa bu hata oluşur. Satıcı panelinde Satıcı Bilgileri sekmesinde kontrol edin.

Hata kodu 8008: Kategori alt grubu eksik mi?

Alt kategori seçilmemişse bu hata alınır. Hepsiburada katalog bilgiler alt kategori gereksinimini belirtir.

Hata kodu 9009: Ürün görseli 3'ten az mı?

Ürün görseli 3'ten az ise bu hata döner. Trendyol görsel sayısı 3+ olmalı.

Hata kodu 10010: Ürün fiyatı 0 mı?

Ürün fiyatı 0 girildiğinde bu hata alınır. Fiyat 0.01 TL veya daha yüksek olmalı.

Bu hataların çoğu dosya şablonunda hangi sütunun hatalı olduğunu gösteriyor; hangi sütunu düzeltmek gerekir?

Dosya güncellemesi sonrası panelde değişiklik ne kadar sürer?

Hata kodu 2002 için görsel boyutunu nasıl kontrol ederim?

Hata kodu 3003 için açıklama uzunluğunu nasıl ölçerim?

Hata kodu 4004’da kategori uyumsuzluğu nasıl tespit edilir?

Hata kodu 5005’de fiyatın negatif olmasının nedeni nedir?

Hata kodu 6006’da ürün kodunun tekrarını nasıl engellerim?

Hata kodu 8008’de alt kategori eksikliği nasıl giderilir?

Hata kodu 9009’da görsel sayısı 3’ten az ise ne yaparım?

Hata kodu 10010’da fiyat 0 ise ne olur?

Hata kodu 1001 için başlık uzunluğunu nasıl kontrol ederim?

Başlık karakter sayısını Trendyol Akademi ile kontrol edin.

Hata kodu 2002’de görsel boyutunu otomatik nasıl kontrol edebilirim?

Hata kodu 3003’de açıklama eksikliği için otomatik doldurma aracı var mı?

Hata kodu 4004’de kategori uyumsuzluğu için hangi alanları kontrol etmeliyim?

Hata kodu 5005’de fiyatı negatif girmenin sonuçları nelerdir?

Ürün listelenmez ve satışa kapatılır.

Hata kodu 6006’da ürün kodu tekrarının önüne nasıl geçilir?

Dosya yüklemeden önce kodları kontrol eden script kullanın.

Hata kodu 8008’de alt kategori eksikliği nasıl tespit edilir?

Her ürünün alt kategori alanı doldurulmalı; boşsa hata.

Ürün sayfasına ek görsel ekleyin.

Ürün görünmez olur.

Başlık karakter sayısını Trendyol Akademi ile kontrol edin.

Ürün listelenmez ve satışa kapatılır.

Dosya yüklemeden önce kodları kontrol eden script kullanın.

Her ürünün alt kategori alanı doldurulmalı; boşsa hata.

Ürün sayfasına ek görsel ekleyin.

Ürün görünmez olur.

Başlık karakter sayısını Trendyol Akademi ile kontrol edin.

Ürün listelenmez ve satışa kapatılır.

Dosya yüklemeden önce kodları kontrol eden script kullanın.

Her ürünün alt kategori alanı doldurulmalı; boşsa hata.

Ürün sayfasına ek görsel ekleyin.

Ürün görünmez olur.

Başlık karakter sayısını Trendyol Akademi ile kontrol edin.

Ürün listelenmez ve satışa kapatılır.

Dosya yüklemeden önce kodları kontrol eden script kullanın.

Her ürünün alt kategori alanı doldurulmalı; boşsa hata.

Ürün sayfasına ek görsel ekleyin.

Ürün görünmez olur.

Hata Kodları İçin Kontrol Listesi

İşlem Süreleri ve Gecikme Tablosu

Hata Kodları ve Muhtemel Nedenleri

Payback Period Calculator

Trendyol’da görsel boyutları, Ürün görseli seçimi ve yükleme rehberinde belirtilen ölçülerden farklıysa 2002 hatası alırsınız. Genelde 2000 × 2000 px üstü, 10 MB altı dosya boyutu önerilir. Görsellerinizi Photoshop veya GIMP gibi programlarla yeniden boyutlandırın ve Toplu içerik güncelleme API’sine gönderirken “imageUrl” alanını güncel tutun. Hepsiburada’da ise Katalog önemli bilgiler sayfasında belirtilen 1200 × 1200 px ve 5 MB altı sınırları geçmeyen görseller tercih edilmelidir. Dosyayı yeniden yüklemeden önce Excel’deki “ImageURL” sütununu kontrol edin; URL’nin sonuna “?width=1200&height=1200” gibi parametre eklemek de boyut uyumunu sağlar.

Görsel boyutunu otomatik kontrol etmek için, Trendyol’da Servis limitleri altında “ImageUpload” endpoint’ini kullanabilirsiniz. Bu endpoint, yüklenen görselin boyutunu ve dosya tipini doğrular ve hata kodu döner. Hepsiburada’da Yardım merkezi’nda “Image Upload API” dokümantasyonu bu doğrulamayı sağlar. Böylece dosyayı toplu güncellemeye göndermeden önce görsellerin uygun olup olmadığını otomatik olarak test edebilirsiniz.

3003 hatası, ürün açıklamasının zorunlu alanlardan birinin boş kalmasından kaynaklanır. Trendyol’da açıklama alanı “Description” olarak adlandırılır ve Ürün özellik bilgisi güncelleme rehberinde belirtilen minimum 50 karakter sınırı vardır. Excel dosyanızda “Description” sütununu seçip “LEN” fonksiyonunu kullanarak karakter sayısını kontrol edebilirsiniz. 50 karakterin altındaysa, ürünün açıklamasını genişleterek detay ekleyin.

Hepsiburada’da ise “ProductDescription” alanı zorunludur ve Katalog önemli bilgiler sayfasında “minimum 100 karakter” olarak belirtilmiştir. Excel’de “LEN(ProductDescription)” fonksiyonunu kullanarak bu sınırı kontrol edin. Açıklama çok kısa ise, ürünün özelliklerini, kullanım talimatlarını veya faydalarını ekleyerek metni zenginleştirin. Ayrıca, Google Structured Data rehberine uygun “Product” schema etiketleri eklemek, arama motorlarında ürününüzün görünürlüğünü artırır.

Hata kodu 4004 için kategori uyumsuzluğu nasıl tespit edilir?

Hepsiburada’da kategori kodları Katalog önemli bilgiler sayfasında “categoryId” olarak tanımlanır. Hatalı kodu bulmak için “CategoryId” sütununu “VLOOKUP” ile Hepsiburada’nın kategori listesiyle karşılaştırın. Ayrıca, Hepsi Akademi’deki Toplu ürün ekleme kursunda kategori seçiminin doğru yapılması için adım adım rehber bulunmaktadır. Kategori uyumsuzluğu tespit edildikten sonra, doğru kategori kodunu girerek dosyayı yeniden yükleyin; panelde değişiklik genellikle 15-30 dakika içinde güncellenir.

Hata kodu 2002: Görsel boyutu uyumsuz mu? Nasıl tespit edilir ve düzeltilir?

Hata düzeltmek için, görseli yeniden boyutlandırın ve sıkıştırma oranını %85 altında tutun. Ardından, aynı görseli tekrar yükleyin. Eğer görsel çok büyükse, Trendyol Akademideki “Görsel Boyutu Kontrolü” aracını kullanarak otomatik olarak yeniden boyutlandırabilirsiniz. Hepsiburada’da da benzer bir “Görsel Optimizasyonu” özelliği mevcuttur; bu araç, dosya boyutunu küçültürken kaliteyi korur. Güncelleme sonrası panelde değişikliğin görünmesi genellikle 30 dakika içinde gerçekleşir, ancak yoğun dönemlerde 1 saat kadar sürebilir.

Hata kodu 3003: Zorunlu alan eksik mi? Hangi alanlar kontrol edilmeli?

Eksiklikleri tespit etmek için, Excel dosyanızdaki her satırı tek tek kontrol edin. Başlık ve açıklama alanlarının boş olmadığından emin olun; açıklama en az 50 karakter olmalıdır. Fiyat alanında negatif veya 0 değer bulunmamalıdır. Stok alanı “0” veya “-” içermemelidir. Kategori alanında, ürünün doğru alt kategoriye ait olduğundan emin olun; Hepsiburada Geliştirici – Katalog önemli bilgiler sayfasında alt kategori kodları listelenmiştir. Eksik alanları doldurduktan sonra dosyayı tekrar yükleyin; panelde güncellemenin yansıması 15 dakika içinde gerçekleşir.

Eksik alanları otomatik olarak doldurmak için, Trendyol Akademi – Excel ile ürün girişi rehberinde yer alan “Otomatik Doldurma” özelliğini kullanabilirsiniz. Bu araç, eksik açıklama veya başlık alanlarını, ürünün marka ve model bilgilerine göre otomatik olarak doldurur. Hepsiburada’da benzer bir “Otomatik Doldurma” aracı bulunur; bu, ürünün temel özelliklerine dayalı olarak eksik alanları tamamlar. Böylece 3003 hatası riskini minimize edebilirsiniz.