Hepsiburada'da ürün özelliklerini toplu doldurma: şablon, sık hatalar, kontrol listesi

Muhammet Çay · Yayın 10 Eylül 2026 · Güncelleme 10 Eylül 2026 · 7 dk okuma

Hepsiburada'da ürün özelliklerini toplu doldurmanın yolu kategori şablonudur: satıcı panelinde ürünün yaprak kategorisine ait Excel şablonunu indirir, zorunlu ve listeli alanları şablondaki geçerli değerlerle doldurur, dosyayı aynı ekrandan yükler ve sonucu yükleme geçmişinden okursunuz. Talep katalog seviyesinde işlenir, onayı Hepsiburada verir. Bu yazı özellik alanının nasıl çalıştığını, iki güncelleme yolunu, en sık alınan hataları ve 542 üründe uyguladığımız kontrol listesini anlatır.

Özellik alanı Hepsiburada'da nasıl çalışır?

Hepsiburada'nın katalog dokümanı üç kuralı net söyler. Birincisi, kategori bilgisi ürünün veri modelini belirler ve "yaratılacak ürünün özellikleri tamamen kategori bilgisi ile ilişkilidir." İkincisi, özellik listesi yalnızca uç kategorilerde vardır; doküman bunu leaf ve available değerleri true olan kategoriler olarak tanımlar. Üçüncüsü, her özelliğin üç niteliği vardır:

• mandatory: true ise özellik zorunludur, boş bırakılamaz.
• type: string ise serbest metin girilebilir; enum ise Hepsiburada'nın listesinde karşılığı olan değer girilmelidir.
• multiValue: true ise özellik birden fazla değer alabilir, false ise tek değer.

Doküman ayrıca enum değerlerin kategoriye bağlı olduğunu örnekle anlatır: bir kategoride renk listesi sarı, kırmızı, mavi gelirken başka kategoride aynı özellik mavi, mor, yeşil gelebilir. Yani "renk" sütununu bir kategoriden diğerine kopyalayamazsınız.

Kategori seçimi için de kural var: ürün mutlaka doğru kategoriye, en alt hiyerarşiden girilmeli; kararsız kalırsanız benzer ürünlerin girildiği kategoriler incelenmelidir. Yanlış kategori yanlış özellik listesi demektir; şablonu indirmeden önce kategoriyi kesinleştirin.

Neden önemli: filtre ve "Ürün bilgileri eksik"

Özellik alanı müşteri tarafında filtre ve karşılaştırma tablosudur. Malzeme, ölçü, kullanım alanı gibi alanlar boşsa ürün o filtrelerde görünmez. Satıcı tarafında ise ürün statüsüne yansır: Hepsiburada dokümanı "Ürün bilgileri eksik" statüsünü, gönderilen ürünün bilgilerinde eksik bulunması durumu olarak tanımlar ve eksik bilgilerin revize edilip yeniden gönderilmesini ister. API'de bu statü MISSING_INFO olarak görünür.

Kendi mağazamızın ölçümü şöyleydi. 806 ürünlük Hepsiburada mağazamızda kategori özellikleri yüzde 0'dı; hiçbir üründe malzeme, ölçü veya kullanım alanı yoktu. Ürünlerin yüzde 70'i de tek fotoğraflıydı. 542 üründe özellikleri toplu şablonla doldurduk, 667 üründe galeriyi ortalama 2,8 kareden 7,8 kareye çıkardık. Aynı hafta görüntülenmeden satışa dönüşüm yüzde 2,47 oldu, yüzde 81 artış. Ayrıntılar 806 ürünlük mağaza vakası yazısında.

Yol 1: Satıcı panelinden Excel şablonu

Hepsi Akademi'de "Toplu Ürün Güncelleme Nasıl Yapılır?" ve "Toplu Ürün Ekleme" eğitimleri vardır; ikisi de satıcı girişi ister. Aşağıdaki sıra kendi mağazamızda uyguladığımız ve sonucu ürün sayfasında doğruladığımız sıradır. Panel ekranları zaman içinde değişebilir; menü adları farklıysa yardım merkezindeki güncel adımı esas alın.

1. Kategoriyi belirleyin. Envanterdeki ürünün yaprak kategorisini not edin. Aynı kategorideki ürünleri tek partide toplayın; şablon kategoriye özeldir.
2. Şablonu indirin. Ürünler > Toplu işlemler ekranından kategori ağacında yaprağa inin ve kategori şablonunu indirin. Şablonu her seferinde yeniden indirin; eski şablonun sütunları değişmiş olabilir ve başlıkları değiştirmemelisiniz.
3. Zorunlu alanları doldurun. Şablonda kırmızı yazılan başlıklar zorunludur. Bizim kategorimizde (biblo) ürün adı, satıcı stok kodu, barkod, marka, KDV, birinci görsel ve kategori özellikleri (boy, en, karakter/tema, paket içeriği, malzeme) zorunluydu.
4. Listeli değerleri şablondan alın. Açılır liste alanlarının geçerli değerleri şablonun gizli liste sayfasında durur. Malzeme için "PLA", menşei için "TR - (Türkiye)" gibi değerleri oradan birebir kopyalayın. Kendi yazımınızla girilen değer listeyle eşleşmez.
5. Ürün adını marka ile başlatın. Hepsiburada katalog kuralı ürün adının mutlaka marka ismiyle başlamasını, her kelimenin ilk harfinin büyük olmasını, model numaralarının büyük harfle yazılmasını, sayıların rakamla ve adet bilgisinin (24'lü gibi) yazılmasını ister; kampanya ifadesi ve satıcı adı yasaktır.
6. Dosyayı yükleyin. Aynı ekranda önce yükleme tipini seçin, sonra dosyayı ekleyin, sonra Yükle düğmesinin aktif olduğunu görün. Yükleme tipi seçilmeden eklenen dosya sessizce kaybolur; bize iki dosya böyle kayboldu.
7. Sonucu okuyun. Yükleme geçmişi sekmesinde "tamamlandı" ya da "hata" görürsünüz. Hata mesajı genel olabilir; satır ayrıntısı vermiyorsa dosyayı 100 satırlık parçalara bölüp hangi parçanın düştüğünü bulun.

Parti büyüklüğünü küçük tutun. Biz 806 ürünü kategori kategori ayırıp her kategoriyi 100 satırlık dosyalar halinde yükledik; bir dosya hata verdiğinde yalnızca o 100 satırı incelemek gerekti. Tek dosyada 800 satır göndermek hata ayıklamayı imkansız hale getirir, çünkü panelin genel hata mesajı hangi satırın düştüğünü söylemez.

Canlı ürünlerde ad, açıklama ve görsel için ayrı bir şablon vardır: Envanter > Toplu güncelleme > yükleme tipi "Ürün bilgisi güncelleme". Bu şablonda sütunlar Hepsiburada ürün kodu, ürün adı, ürün açıklaması ve görsel 1 ile 7 arasıdır; boş bırakılan görsel sütunu için talep açılmaz, yani mevcut ana görseli koruyup yalnızca 2 ile 7 arası kareleri ekleyebilirsiniz.

Yol 2: API ile ürün güncelleme

Entegratör kullanıyorsanız ya da kendi yazılımınız varsa Hepsiburada'nın ürün güncelleme servisi aynı işi JSON dosyasıyla yapar. Doküman istek alanlarını sıralar: merchantId, hbSku (değiştirilemez), productName, productDescription, image1 ile image10 arası görseller, video, attributes nesnesi, kdv, warrantyPeriod, desi, isCustomizable ve barcode. Görsel değiştirirken aynı URL üzerinden güncelleme yapılmaz; yeni görsel yeni bir adresle gönderilir.

Gönderim bir trackingId döndürür; ürün durumu bu kodla sorgulanır. Doküman istek limitini IP başına dakikada 180 istek olarak verir. Hata kodları arasında "Hb Sku bulunamadı", "Geçersiz json dosyası" ve "Maksimum ürün sayısı aşıldı" vardır; bu üçü toplu dosyalarda en sık görülenlerdir. Katalog tarafında ise ürün gönderilirken görsel adresinin erişilebilir olması gerekir; doküman erişilemeyen görselin 5 kez denendiğini ve yüklenmediğini, formatın png veya jpg olması gerektiğini, GIF kabul edilmediğini belirtir.

Trendyol'da aynı iş için Ürün > Toplu Ürün İşlemleri altında "Ürün Özellik Bilgisi Güncelleme" şablonu kullanılır; iki pazaryerinde de mantık aynıdır, kategori başına ayrı şablon. Trendyol tarafı için Trendyol İçerik Doluluk Skoru yazısındaki üçüncü adıma bakın.

Sık yapılan 8 hata

1. Eski şablonla çalışmak. Sütunlar değişir; her partide şablonu yeniden indirin ve başlıklara dokunmayın.
2. Listeli alana serbest metin yazmak. Enum özellikte listede olmayan değer doğrulama hatası verir. Değeri gizli liste sayfasından kopyalayın.
3. Aynı listeyi başka kategoriye taşımak. Renk listesi bile kategoriye göre değişir. Kategori değiştiyse şablon da değişir.
4. Zorunlu alanı "boş" değil "-" ile geçmek. Tire bir değerdir ve listeyle eşleşmez; hata verir ya da müşteriye "-" olarak görünür.
5. Birim tutarsızlığı. Boy alanına bir satırda 12, diğerinde 12 cm yazmak filtreyi bozar. Şablon birim istiyorsa sadece sayı, istemiyorsa her satırda aynı biçim.
6. Yükleme tipini seçmeden dosya eklemek. Yükle düğmesi pasif kalır, dosya kaybolur. Sıra: tip, dosya, düğme aktif mi, tıkla.
7. Excel'i başka programda kaydetmek. Şablonu Excel dışı bir araçla kaydettiğimizde Hepsiburada dosyayı satır ayrıntısı vermeden reddetti; Excel'de ya da Excel uyumlu kayıtla ilk denemede geçti. Dosya reddedilirse önce kayıt biçiminden şüphelenin.
8. Ürün adını klasör veya dosya adından türetmek. Fotoğrafa bakmadan yazılan ad ürünü yanlış tanımlar ve düzeltme talebi gerektirir. Adı yazmadan önce görseli açın.

Onay ve doğrulama

Yükleme "tamamlandı" demek özelliğin yayında olduğu anlamına gelmez. Talep katalog seviyesinde işlenir; Hepsiburada onaylar ya da reddeder. Bizim taleplerimiz çoğu zaman aynı saat içinde yansıdı; ama zamanı Hepsiburada belirler, sizin görevi tamamladıktan bir süre sonra kontrol etmektir. Reddedilenler panelde düzeltilmesi gerekenler listesinde gerekçesiyle çıkar.

Doğrulamayı panelde değil vitrinde yapın. Ürün sayfasını açın ve özellik tablosundaki satır sayısını sayın; şablonda doldurduğunuz alanlar orada görünüyorsa iş bitmiştir. Panelin bazı listeleri yalnızca varyant özelliğini (renk gibi) gösterir ve kategori özelliklerini göstermez; biz bu yüzden bir hafta boyunca 542 ürünün talebini "uygulanmadı" sandık, oysa ürün sayfasında hepsi duruyordu.

Kontrol listesi

• [ ] Her ürünün yaprak kategorisi doğru; şüpheli olanlar benzer ürünlerin kategorisiyle karşılaştırıldı
• [ ] Şablon bu parti için yeniden indirildi; başlıklar değiştirilmedi
• [ ] Kırmızı başlıklı zorunlu alanların tamamı dolu
• [ ] Listeli (enum) alanlar gizli liste sayfasındaki değerlerle birebir
• [ ] Serbest metin alanlarda birim ve yazım her satırda aynı
• [ ] Ürün adı marka ile başlıyor, baş harfler büyük, kampanya ifadesi ve satıcı adı yok
• [ ] Barkodlar 13 haneli ve tekil; stok kodları büyük harf ve boşluksuz
• [ ] Varyantlar aynı grup koduyla; tek ürün, tek sayfa
• [ ] Görsel adresleri https ve doğrudan dosyaya gidiyor; png veya jpg
• [ ] Yükleme tipi seçildi, dosya eklendi, Yükle düğmesi aktifken tıklandı
• [ ] Yükleme geçmişinde sonuç okundu; hata veren parça 100 satırlık bloklara bölündü
• [ ] Ürün sayfasındaki özellik tablosu sayıldı; "Ürün bilgileri eksik" statüsünde ürün kalmadı

Kaç ürününüzde özellik boş?

Hepsiburada mağaza linkinizi bırakın; herkese açık ürün sayfalarınızdan özellik satırı sayısını, tek görselli ürün yüzdesini ve en zayıf 10 ürün kartını çıkaralım. Skor ücretsiz. Doldurmayı isterseniz kategori şablonlarını biz hazırlar, sizin hesabınızda 48 saatte yükleriz: 100 ürüne kadar 4.900 ₺, 500 ürüne kadar 9.900 ₺, ilk 10 mağazaya yarı fiyat; sonrasında aylık 990 ₺ ile yeni ürünleri ve bozulan kartları izleriz. Ücretsiz skor için vitrinskoru.com/#skor.