Stok alanları
| Alan | Değerler | Açıklama |
|---|---|---|
| manage_stock | true ya da false (varyasyonda parent da olabilir) | Adet tutulsun mu |
| stock_quantity | tam sayı | Stok adedi |
| stock_status | instock, outofstock, onbackorder | Stok durumu |
| backorders | no, notify, yes | Stok bitince sipariş alınsın mı |
| backorders_allowed | salt okunur | Ön siparişe izin var mı |
| backordered | salt okunur | Ürün ön siparişte mi |
manage_stock varsayılan olarak false’tur. Stok yönetimi kapalı üründe adet tutulmaz; stok durumu yalnız “stokta”, “stokta yok” ya da “ön siparişte” olarak elle seçilir. Stok yönetimi açıkken durum, mağaza ayarındaki “Stokta yok eşiği”ne göre belirlenir.
Tek ürün ve tek varyasyon
Aşağıdaki numaralar sahtedir.
- Basit ürün: PUT /wp-json/wc/v3/products/101 ve gövde: manage_stock true, stock_quantity 7
- Varyasyon: PUT /wp-json/wc/v3/products/200/variations/201 ve gövde: manage_stock true, stock_quantity 3
- Çok ürün: POST /wp-json/wc/v3/products/batch ve update listesi
manage_stock alanını her istekte göndermek zorunda değilsiniz; ürünün stok yönetimi zaten açıksa yalnız stock_quantity yeterlidir. Ama ilk kurulumda açık olduğundan emin olmak için bir kez göndermek güvenlidir.
Yanıt güncellenmiş ürün nesnesini döndürür. stock_quantity ve stock_status değerlerini yanıttan okuyup beklediğinizle karşılaştırın.
Mutlak değer yazmanın riski
stock_quantity bir artış ya da azalış değil, kesin adettir. Belgede bu uç nokta için “şu değer hâlâ buysa yaz” türünden bir eşzamanlılık kontrolü tanımlanmamıştır.
| Zaman | Olay | Sonuç |
|---|---|---|
| 10:00 | Entegrasyon stoğu 5 okur | - |
| 10:01 | Sitede 1 adet satılır | Sitede stok 4 |
| 10:02 | Entegrasyon pazaryeri satışı için 5 eksi 1 yazar | Stok 4 olur, site satışı kaybolur |
Bu yüzden yazmadan hemen önce güncel değeri okuyun, okuma ile yazma arasını kısa tutun ve aynı ürüne aynı anda iki kaynaktan yazmayın. Çoklu kanalda bu sorunun genel anlatımı çoklu pazaryeri çift satış sorunu rehberinde.
Geçici sıfır stok sorunu
Saystok’un canlı mağazalardaki gözlemine göre WooCommerce REST API ara sıra stokta olan ürünleri bir okumada 0 gösterebiliyor; sonraki okumada değer kendiliğinden düzeliyor. Nedeni çoğu zaman sitedeki önbellek ya da eklenti çakışmasıdır.
- Bir okumada çok sayıda ürün aynı anda 0’a düşüyorsa bunu önce hata kabul edin.
- Tek ürün 0’a düştüğünde önbelleği atlatan taze bir okumayla doğrulayın.
- Sıfırı diğer kanallara yaymadan önce iki ayrı okumada görmeyi bekleyin.
Bu yaklaşım son adette kısa bir gecikme yaratır ama yanlış sıfırın bütün pazaryerlerinde satışı durdurmasını önler. Ayrıntı: sıfır stok onayı.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Adet değişmiyor | manage_stock kapalı | manage_stock true gönderin |
| Varyasyon stoğu yazılamıyor | Varyasyon numarası ürün adresine gönderildi | variations yolunu kullanın |
| Stok eksiye düştü | Ön siparişe izin verilmiş | Senkron ürünlerde backorders değerini no yapın |
| Yazılan değer geri döndü | Başka bir eklenti ya da entegrasyon da yazıyor | Tek stok kaynağı belirleyin |
Sık sorulanlar
WooCommerce stok API ile nasıl güncellenir?
PUT /wp-json/wc/v3/products/ID isteğinde gövdeye stock_quantity yazarsınız. Ürünün manage_stock alanı açık olmalıdır.
Varyasyon stoğu için hangi adres kullanılır?
PUT /wp-json/wc/v3/products/ANA_URUN/variations/ID. Çok sayıda varyasyon için /products/ANA_URUN/variations/batch kullanılır.
stock_status alanını da göndermem gerekir mi?
Stok yönetimi açıksa durum adede ve mağazanın “Stokta yok eşiği” ayarına göre belirlenir. Stok yönetimi kapalı üründe ise durumu stock_status ile elle seçersiniz.
Stok neden kendiliğinden eski değere dönüyor?
Aynı ürüne başka bir eklenti, ERP ya da entegrasyon da yazıyor olabilir. Her ürün için tek bir stok kaynağı belirleyin.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı