Üç kimlik ve rolleri
| Kimlik | Kim verir | Nerede kullanılır | Not |
|---|---|---|---|
| Hepsiburada SKU | Hepsiburada | Stok ve fiyat yüklemesinde HepsiburadaSku | HBCV ile başlayan biçimde görülür; değişebilir |
| Satıcı stok kodu | Satıcı | Yüklemede MerchantSku, katalogda merchantSku | Kendi sisteminizle eşleştirmenin anahtarı |
| Barkod (GTIN) | Üretici, GS1 sistemi | Katalogda Barcode | Ürünü dünya genelinde tanımlar |
GS1 Türkiye'ye göre GTIN, eski adıyla EAN, barkodun altındaki numaradır ve farklı ürünleri dünya genelinde benzersiz biçimde tanımlar (GS1 Türkiye SSS). Aynı barkodu tüm kanallarda kullanmak, pazaryerleri arasında eşleştirmeyi kolaylaştırır.
Hepsiburada SKU değişirse ne olur?
Canlı bir mağazada bazı ürünlerin Hepsiburada SKU'sunun sessizce değiştiği görüldü: kontrol edilen on bir üründen onunda kayıtlı SKU ile API'nin döndürdüğü güncel SKU farklıydı. Bu durum iki soruna yol açar.
- Eski SKU ile gönderilen stok güncellemeleri ListingNotFound hatasıyla reddedilir.
- Eşleştirme yalnız SKU'ya dayanıyorsa ürün "eşleşmemiş" sanılır ve koruma kuralları devre dışı kalır.
Çözüm, SKU'yu her senkronda Listing listesinden satıcı stok koduyla tazelemek ve eşleşme kontrolünü barkod üzerinden de yapmaktır. Barkod platformun iç kimlik değişikliğinden etkilenmez.
Siparişlerde hangi kimlik gelir?
Sipariş kalemlerinde ürün bir sku alanıyla gelir. Canlı kullanımda yeni (Open) siparişlerde bu alanda satıcı stok kodu yerine Hepsiburada'nın kendi SKU'sunun geldiği görüldü. Sipariş detayında ise ayrıca merchantSKU ve productBarcode alanları bulunur.
Siparişi ürüne bağlarken tek bir alana güvenmeyin. Önce satıcı stok kodunu, sonra barkodu, en son Hepsiburada SKU'sunu deneyin. Hiçbir kalem bir ürüne bağlanamazsa siparişi "işlendi" saymayın; detay zenginleşince yeniden deneyin. Aksi hâlde stok hiç düşmez.
Barkod ve stok kodu kuralları
- Barkod alanına ürün adı ya da serbest metin yazmayın. Barkodu olmayan ürünlerde önce barkod tanımlayın.
- Aynı barkodu iki farklı ürüne vermeyin; eşleştirme yanlış ürüne gider.
- Varyantlı ürünlerde her beden ve rengin kendi stok kodu ve barkodu olsun.
- Stok kodlarını Excel'de düzenliyorsanız başındaki sıfırların silinmediğini kontrol edin.
Kanallar arası eşleştirme adımları ürün eşleştirme rehberinde.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| ListingNotFound | SKU eski ya da yerine stok kodu yazılmış | SKU'yu Listing listesinden tazeleyin |
| DuplicateHepsiburadaSkuSpecified | İki kayıt aynı SKU'ya eşlenmiş | Pakette SKU'yu tekilleştirin, çift eşleşmeyi düzeltin |
| Siparişte stok düşmüyor | Kalemdeki sku Hepsiburada SKU'su, arama stok koduyla yapılıyor | Aramada SKU ve barkodu da deneyin |
| Eşleşme koruması çalışmıyor | Koruma yalnız SKU'ya dayanıyor | Barkodla ikinci kontrol ekleyin |
Sık sorulanlar
Hepsiburada SKU ile merchant SKU farkı nedir?
Hepsiburada SKU'sunu Hepsiburada verir ve listelemeyi tanımlar. Merchant SKU sizin stok kodunuzdur ve kendi sisteminizle eşleştirmenin anahtarıdır.
Stok güncellemede hangi kimlik gönderilir?
İkisi birlikte: HepsiburadaSku ve MerchantSku. Doğru SKU'yu Listing listesinden alın.
Hepsiburada SKU değişebilir mi?
Canlı kullanımda bazı ürünlerde değiştiği görüldü. Bu yüzden SKU'yu her senkronda tazeleyin ve barkodla ikinci kontrol yapın.
Barkodum yoksa ürün yükleyebilir miyim?
Barkod alanı yükleme dosyasında yer alır. Gerçek bir GTIN kullanmak eşleştirmeyi kolaylaştırır; serbest metin yazmayın.
Siparişteki sku alanı neden stok koduma benzemiyor?
Yeni siparişlerde bu alanda Hepsiburada'nın kendi SKU'su gelebilir. Siparişi ürüne bağlarken satıcı stok kodu, barkod ve Hepsiburada SKU'sunu birlikte deneyin.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı