İptal listesini okumak
| Alan | Yön | Anlamı |
|---|---|---|
| limit | İstek | Sayfa boyutu |
| offset | İstek | Kaçıncı kayıttan başlanacağı |
| totalCount | Yanıt | Toplam iptal sayısı |
| items | Yanıt | İptal kayıtları; boşken null gelebilir |
Kayıtlarda sipariş numarası tekil ya da çoğul alanla gelebilir. Paket durum uçlarındaki gibi her iki yazımı da okuyun. Müşteri ve ürün bilgisi için sipariş detayı ucunu çağırın.
İptalde stok nasıl geri eklenir?
Sipariş geldiğinde stok düşürüldüyse iptalde geri eklenmelidir. Burada iki incelik vardır:
- Yalnız düşülen adedi ekleyin. Stok yetmediği için düşüm kırpıldıysa (stok 1, sipariş 3 gibi), iptalde 3 değil 1 eklenmelidir. Aksi hâlde hayalet stok oluşur.
- İptali bir kez işleyin. Aynı iptal her okumada yeniden işlenirse stok her seferinde artar. İşlenen iptalleri kaydedin.
Kargolanmadan iptal edilen siparişte ürün depodan çıkmamıştır; stoğu otomatik geri eklemek güvenlidir. İade ise farklıdır: para iadesi ürünün depoya döndüğü anlamına gelmez. Stok tarafı stok senkronu mimarisi sayfasında.
Satıcı tarafından iptal bildirimi
Stokta olmayan bir ürün satıldığında satıcı siparişi iptal etmek zorunda kalabilir. Hepsiburada bu işlemi kalem bazında ve bir iptal nedeni koduyla ister. Saystok'un kodunda bu işlem için kalem kimliği ve cancelReasonCode alanını gönderen bir çağrı tanımlıdır; ancak bu çağrı müşteri panelinde sunulmaz ve yolu canlıda doğrulanmadı. Güncel yol ve geçerli neden kodları için resmî dokümana bakın.
Satıcı kaynaklı iptaller satıcı performansında dikkate alınır. Bu yüzden asıl hedef iptali kolaylaştırmak değil, stok tutarlılığıyla iptal ihtiyacını ortadan kaldırmaktır. Yasal yükümlülükler ve müşteriye bildirim için stok bitmiş ürün satışı rehberine bakın.
İptal durumları ve bildirimler
İptali öğrenmenin iki yolu vardır: iptal listesini düzenli okumak ya da webhook bildirimini beklemek. Hepsiburada iptal için OrderCancel adlı bir bildirim gönderir. Bildirim geldiğinde iptal listesini hemen okumak, stoğun dakikalar içinde geri gelmesini sağlar. Ayrıntı webhook bildirimleri sayfasında.
Teslim edilemeyen paketler de bir tür kapanıştır. Bu paketler iptal listesinde değil, teslim edilemeyenler listesinde görünür. Stok kurallarınızı iki liste için ayrı ayrı belirleyin.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| İptalde stok fazla arttı | Kırpılan düşümün tamamı geri eklendi | Gerçekten düşülen adedi kaydedin |
| Stok her okumada artıyor | İptal tekrar tekrar işleniyor | İşlenen iptalleri işaretleyin |
| İptaller geç fark ediliyor | Liste seyrek okunuyor | OrderCancel bildirimini kullanın |
| İptal listesi boşken kod hata veriyor | items null geldi | null değeri boş dizi gibi işleyin |
Sık sorulanlar
Hepsiburada iptal siparişleri hangi uçtan gelir?
OMS servisinde GET /orders/merchantid/SATICI_ID/cancelled ucundan.
İptal edilen siparişte stok otomatik geri gelir mi?
Entegrasyonunuz bunu yapmalıdır. Yalnız düşülen adedi ve her iptali bir kez ekleyin.
Satıcı olarak API ile sipariş iptal edebilir miyim?
Hepsiburada kalem bazında iptal bildirimine izin verir ve iptal nedeni kodu ister. Güncel yol ve kodlar için resmî dokümana bakın.
İptali anında nasıl öğrenirim?
Webhook ile. Hepsiburada iptal için OrderCancel bildirimi gönderir.
İptal listesi tarih filtresi alır mı?
Canlıda kullanılan çağrıda yalnız limit ve offset gönderilir. Tarih filtresi olup olmadığını resmî dokümanda kontrol edin; yoksa listeyi sayfa sayfa gezin ve işlenmiş iptalleri atlayın.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı