Durumlar ve anlamları
| Durum | Anlamı | Yönetici panelinde |
|---|---|---|
| available | Satılabilir, ayrılmamış adet | Mevcut |
| committed | Karşılanmamış sipariş, taslak sipariş rezervasyonu ya da gönderime hazır transfer için ayrılan adet | Taahhüt edildi |
| reserved | Bekletme ya da inceleme için geçici olarak ayrılan adet | Kullanılamaz |
| damaged | Hasarlı, satılamayan adet | Kullanılamaz |
| safety_stock | Fazla satışa karşı ayrılan güvenlik stoğu | Kullanılamaz |
| quality_control | Kalite kontrolde bekleyen adet | Kullanılamaz |
| incoming | Lokasyona yolda olan adet | Gelen |
| on_hand | Lokasyonda fiziksel olarak bulunan toplam | Eldeki |
Belgeye göre on_hand; available, committed, reserved, damaged, safety_stock ve quality_control toplamına eşittir. incoming fiziksel olarak lokasyonda olmayan tek durumdur.
Siparişte stok nasıl hareket eder?
| Olay | available | committed | on_hand |
|---|---|---|---|
| Sipariş verildi | Azalır | Artar | Değişmez |
| Sipariş karşılandı | Değişmez | Azalır | Azalır |
Bu yüzden pazaryerine on_hand göndermek, henüz kargolanmamış siparişlerin adetlerini ikinci kez satışa açar. Pazaryeri ile Shopify’ı aynı stokta tutmak için available kullanın.
Örnek: lokasyonda 10 adet var ve 3 adetlik iki sipariş henüz kargolanmadı. on_hand 10, committed 6, available 4 olur. Pazaryerine gönderilmesi gereken sayı 4’tür; 10 gönderirseniz 6 adet fazla satış riski doğar.
Güvenlik stoğu ve ayrılmış adetler
safety_stock ve reserved durumları, available’dan ayrılan ama lokasyonda duran adetlerdir. Pazaryerinde fazla satışa karşı birkaç adeti geride tutmak istiyorsanız iki yol vardır:
| Yol | Nasıl | Sonuç |
|---|---|---|
| Shopify’da ayırmak | inventoryMoveQuantities ile available’dan safety_stock’a taşımak | Hem vitrinde hem pazaryerinde satılabilir adet azalır |
| Entegrasyonda ayırmak | Pazaryerine available eksi tampon göndermek | Yalnız pazaryerinde satılabilir adet azalır |
Hangi yolu seçerseniz seçin, kuralı yazılı hâle getirin; aksi hâlde sayımda çıkan farkların kaynağını bulmak zorlaşır. Konu hakkında güvenlik stoğu yazısı yol gösterir.
Hangi durumu API ile değiştirebilirsiniz?
| Mutasyon | Ne yapar |
|---|---|
| inventorySetQuantities | on_hand ya da available değerini kesin olarak yazar |
| inventoryAdjustQuantities | Bir durumu verilen fark kadar değiştirir |
| inventoryMoveQuantities | available ile reserved, damaged, safety_stock, quality_control arasında taşır |
committed durumundaki adet Admin API ile ayarlanamaz ya da taşınamaz. Shopify onu sipariş oluşturma, karşılama, taslak sipariş rezervasyonu ve transferlerle kendisi yönetir. Her değişikliğe referenceDocumentUri ekleyerek hangi sistemin ve belgenin değişikliği başlattığını kayda geçirebilirsiniz.
Envanter webhook’ları ve takip
| Konu | Ne zaman |
|---|---|
| inventory_levels/update | Envanter seviyesi güncellendiğinde |
| inventory_levels/connect | Kalem bir lokasyona bağlandığında |
| inventory_levels/disconnect | Bağlantı kaldırıldığında |
| inventory_items/create, update, delete | Envanter kalemi değiştiğinde |
Belgeye göre committed, reserved, damaged, safety_stock ve quality_control durumlarındaki değişiklikler webhook tetiklemez. Envanter kaleminin tracked alanı false ise Shopify o kalemin adet değişikliklerini takip etmez; REST’te bu durumda available null döner.
Sık sorulanlar
Shopify’da available ile on_hand farkı nedir?
available satılabilir adettir. on_hand lokasyondaki fiziksel toplamdır ve karşılanmamış siparişlere ayrılan committed adetleri de içerir.
Pazaryerine hangi stok sayısını göndermeliyim?
available. on_hand göndermek, kargolanmamış siparişlerin adetlerini yeniden satışa açar.
committed miktarını API ile değiştirebilir miyim?
Hayır. Belgeye göre committed durumu yalnız Shopify tarafından, sipariş ve transfer işlemleriyle yönetilir.
Stok değişiminde hangi webhook gelir?
inventory_levels/update. Ama committed, reserved, damaged, safety_stock ve quality_control değişiklikleri webhook tetiklemez.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı