Üç adım ve kuralları
| Adım | Kaynak ya da uç | Kural |
|---|---|---|
| Okuma | Listing listesi | Eksik stok alanı "bilinmiyor" sayılır, sıfır sayılmaz |
| Yazma: sıfıra indirme | stock-uploads | Fiyat gerekmez |
| Yazma: pozitif stok | inventory-uploads | Fiyatla birlikte; fiyatsız ürün atlanır |
| Doğrulama | stock-uploads/id ya da inventory-uploads/id | Done ve boş hata görülmeden kayda yazılmaz |
Bu tabloyu senkronun sözleşmesi gibi düşünün. Her satırdaki kural, canlıda yaşanmış bir hatanın dersidir.
Kaynağı ve yönü belirleyin
Çok kanallı satışta önce tek bir doğru kaynak seçilir: bir mağaza ya da merkezi stok kaydınız. Diğer kanallar ona göre güncellenir. Hepsiburada bu düzende genelde "hedef" kanaldır; stok ona yazılır, ondan okunmaz.
Eşleşmiş bir ürünün stoğunu Hepsiburada'dan geri okuyup ana kayda yazmak döngüsel bir hata üretir. Bir mağazada bayat katalog stoğu geri okunduğu için gerçekte stokta olan ürünler sürekli "sıfıra düştü" diye işaretlendi; yüzlerce gereksiz sıfır stok onayı birikti. Kaynak seçimi için stok kaynağı seçimi rehberine bakın.
Siparişten stok düşümü
Stok yalnız elle değil, satışla da değişir. Hepsiburada'da bir sipariş geldiğinde aynı ürün diğer kanallarda da düşmelidir.
- Ödemesi alınmış ilk sipariş durumu (Open) geldiğinde stoğu düşürün; beklemek çift satış riskini büyütür.
- Kargolanmadan iptal edilen siparişte düşülen adedi geri ekleyin. Yalnız gerçekten düşülen adedi ekleyin; stok yetmediği için kırpılan bir düşümün tamamını geri eklemek hayalet stok yaratır.
- İadeyi otomatik stok artışına çevirmeyin. Para iadesi her zaman ürünün depoya döndüğü anlamına gelmez.
- Sipariş kalemi ürüne bağlanamazsa siparişi işlendi saymayın; bir sonraki turda yeniden deneyin.
Koruma kuralları
- Eşleşmiş ürün koruması: başka kanalla eşleşen ürünün stoğu Hepsiburada okumasıyla değiştirilmez.
- Barkod ile ikinci kontrol: Hepsiburada SKU'su değişebildiği için koruma barkod üzerinden de yapılır.
- Elle düzeltme koruması: kullanıcının yaptığı manuel düzeltme bir sonraki bayat okumayla ezilmez.
- Paket tekilleştirme: aynı SKU pakette iki kez geçmez; çakışmada düşük stok seçilir.
Çok kanallı satışta çift satışın genel nedenleri çift satış sorunu rehberinde.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Ürünler durup dururken sıfırlanıyor | Bayat katalog stoğu ana kayda yazılıyor | Eşleşmiş ürünlerde Hepsiburada stoğunu okumayın |
| Siparişte stok düşmüyor | Kalem ürüne bağlanamadı ama işlendi sayıldı | Çözülemeyen siparişi yeniden deneyin |
| İptalde stok fazla arttı | Kırpılan düşümün tamamı geri eklendi | Gerçekten düşülen adedi kaydedin |
| Sistemler arasında kalıcı fark | Doğrulanmayan güncellemeler kayda yazıldı | Takip sonucu olmadan kaydetmeyin |
Sık sorulanlar
Hepsiburada stoğunu hangi kaynaktan okumalıyım?
Listing listesinden. Katalog servisindeki stok alanı bayat ya da sıfır dönebilir.
Siparişte stok ne zaman düşmeli?
Ödemesi alınmış ilk durumda (Open). Beklemek, aynı ürünün başka kanalda da satılma riskini artırır.
İptal edilen siparişte stok geri eklenir mi?
Kargolanmadan iptal edilen siparişte düşülen adet geri eklenir. İadede ise ürün gerçekten dönmedikçe stok artırılmamalıdır.
Stok senkronu ne sıklıkla çalışmalı?
Siparişten düşüm dakikalar içinde olmalı; genel stok karşılaştırması daha seyrek yapılabilir. Webhook kullanmak gecikmeyi kısaltır.
Hepsiburada SKU değişirse senkron bozulur mu?
SKU'yu her turda Listing listesinden satıcı stok koduyla tazelerseniz bozulmaz. Koruma kurallarını barkodla da desteklemek, SKU değişse bile eşleşmenin tanınmasını sağlar.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı