Varyasyon uç noktaları
| İşlem | Yöntem ve adres |
|---|---|
| Oluşturma | POST /products/ANA_URUN/variations |
| Tek varyasyon | GET /products/ANA_URUN/variations/ID |
| Listeleme | GET /products/ANA_URUN/variations |
| Güncelleme | PUT /products/ANA_URUN/variations/ID |
| Silme | DELETE /products/ANA_URUN/variations/ID?force=true |
| Toplu işlem | POST /products/ANA_URUN/variations/batch |
Listeleme de sayfalanır ve varsayılan 10 kayıt döner. Çok seçenekli ürünlerde per_page=100 göndermeyi unutmayın.
Listeleme isteği sku, status, stock_status, on_sale, min_price ve max_price gibi filtreleri de kabul eder. Örneğin stokta olmayan varyasyonları bulmak için stock_status=outofstock gönderebilirsiniz.
Yeni varyasyon için örnek gövde (sahte değerler):
- regular_price: 249.90
- sku: SAHTE-001-M
- manage_stock: true
- stock_quantity: 4
- attributes: name değeri Beden, option değeri M olan bir öğe
Önemli varyasyon alanları
| Alan | Açıklama |
|---|---|
| id | Varyasyon numarası |
| sku | Varyasyonun stok kodu |
| global_unique_id | Varyasyonun GTIN, UPC, EAN ya da ISBN değeri |
| status | draft, pending, private ya da publish |
| regular_price, sale_price | Normal ve indirimli fiyat, metin |
| manage_stock | true, false ya da parent |
| stock_quantity | Stok adedi |
| stock_status | instock, outofstock ya da onbackorder |
| attributes | Seçenek adı ve seçilen değer: name ve option |
| image | Varyasyon görseli; tek bir nesne |
Ana üründen farklı olarak varyasyonda görsel images dizisi değil, tek bir image nesnesidir. Ek galeri görselleri gallery_image_ids alanında numara olarak durur.
Stok ürün düzeyinde mi, varyasyon düzeyinde mi?
WooCommerce iki yönteme izin verir. Ürün düzeyinde stok, bütün varyasyonların paylaştığı tek bir adet tutar. Varyasyon düzeyinde stok ise her seçeneğe ayrı adet verir.
| Yöntem | Nasıl kurulur | API’de görünüm |
|---|---|---|
| Ürün düzeyi | Ana ürünün Envanter sekmesinde stok yönetimi | Ana üründe manage_stock true |
| Varyasyon düzeyi | Her varyasyonda “Stoğu yönet” kutusu | Varyasyonda manage_stock true |
| Karma | Bazı varyasyonlar kendi stoğunu tutar | Diğerleri ana ürünün stoğunu kullanır |
WooCommerce belgesine göre kendi stoğunu yönetmeyen varyasyonlar, açıksa ürün düzeyindeki stoktan düşer. API bu durumu manage_stock değerini parent olarak göstererek anlatır.
Pazaryerleri her bedeni ya da rengi genellikle ayrı barkodla listeler. Bu yüzden pazaryeri senkronunda varyasyon düzeyinde stok daha net sonuç verir. Konunun stok tarafı varyantlı ürünlerde stok takibi yazısında.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| “Geçersiz kimlik” ya da 404 | Varyasyon numarası /products/ID adresine gönderildi | Ana ürün numarasıyla variations yolunu kullanın |
| Batch’te kayıt hatası | Varyasyon /products/batch’e gönderildi | /products/ANA_URUN/variations/batch kullanın |
| Silme reddedildi | force=true gönderilmedi | Varyasyonlar çöp kutusuna gitmez, force=true şart |
| Bazı varyasyonlar eksik | Varsayılan 10 kayıt | per_page=100 ve page kullanın |
| Stok değişmiyor | Varyasyonda stok yönetimi kapalı | Varyasyonda “Stoğu yönet” kutusunu açın |
Sık sorulanlar
WooCommerce varyasyon stoğu API ile nasıl güncellenir?
PUT /products/ANA_URUN/variations/ID ile tek varyasyonu ya da POST /products/ANA_URUN/variations/batch ile 100’e kadar varyasyonu güncellersiniz. Varyasyonda manage_stock açık olmalıdır.
Varyasyonları ürün listesinde neden göremiyorum?
Ürün listesinde yalnız ana ürün gelir; variations alanında varyasyon numaraları vardır. Ayrıntı için her ana ürünün variations adresini çağırmanız gerekir.
manage_stock değeri parent ne demek?
Varyasyonun kendi stoğu olmadığı, ana ürünün stoğunu kullandığı anlamına gelir. Belgede bu alan mantıksal değer ya da parent olabilir.
Varyasyon silme isteğim neden reddediliyor?
Belgeye göre varyasyonlar çöp kutusunu desteklemez. DELETE isteğine force=true eklemeniz gerekir.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı