Fiyat alanları
| Alan | Yazılabilir mi | Açıklama |
|---|---|---|
| regular_price | Evet | Normal fiyat |
| sale_price | Evet | İndirimli fiyat |
| price | Hayır | Geçerli fiyat; indirim varsa indirimli fiyat |
| on_sale | Hayır | Ürün şu an indirimde mi |
| date_on_sale_from | Evet | İndirim başlangıcı, site saat diliminde |
| date_on_sale_to | Evet | İndirim bitişi, site saat diliminde |
| date_on_sale_from_gmt, date_on_sale_to_gmt | Evet | Aynı tarihler GMT olarak |
| price_html | Hayır | Vitrinde gösterilen biçimli fiyat |
Para tutarları her zaman iki ondalıklı metin olarak döner. Yazarken de metin göndermek en güvenli yoldur.
Örnek istekler
Numaralar ve tutarlar sahtedir.
- Yalnız normal fiyat: PUT /products/101 ve gövde: regular_price 249.90
- İndirim: PUT /products/101 ve gövde: regular_price 249.90, sale_price 199.90
- Tarihli indirim: yukarıdakine ek olarak date_on_sale_from ve date_on_sale_to
- Varyasyon: PUT /products/200/variations/201 ve aynı alanlar
- Çok ürün: POST /products/batch ve update listesinde id ile fiyat alanları
PUT isteği yalnız gönderdiğiniz alanları değiştirir. Bu yüzden sadece regular_price gönderirseniz üründe önceden tanımlı indirimli fiyat yerinde kalır ve vitrinde o fiyat görünmeye devam eder.
Varyasyonlu ürünlerde fiyat
Varyasyonlu ürünün satış fiyatı varyasyonlarda tutulur. Ana ürünün price değeri salt okunurdur ve varyasyon fiyatlarından türetilir.
| Ürün türü | Fiyat nereye yazılır |
|---|---|
| Basit ürün | /products/ID |
| Varyasyon | /products/ANA_URUN/variations/ID |
| Çok varyasyon | /products/ANA_URUN/variations/batch |
Her bedenin ya da rengin fiyatı farklıysa her varyasyona ayrı değer yazın. Hepsi aynı fiyattaysa da tek tek yazmanız gerekir; ana ürüne yazılan fiyat varyasyonlara geçmez.
Fiyatı pazaryerleriyle uyumlu tutmak
Site ve pazaryeri fiyatları çoğu zaman bilinçli olarak farklıdır. Pazaryeri komisyonu ve kargo bedeli yüzünden pazaryeri fiyatı genellikle sitedekinden yüksek tutulur. Fiyatı API ile yazan bir entegrasyon kurarken şu kuralları baştan belirleyin:
- Fiyatın tek kaynağı neresi: site mi, ERP mi, entegrasyon yazılımı mı?
- İndirimli fiyat da senkron edilecek mi, yoksa yalnız normal fiyat mı?
- Vergi: siparişteki prices_include_tax alanı, fiyatların ödeme anında vergi dahil olup olmadığını gösterir. Fiyatı yazarken mağazanızın vergi ayarıyla aynı mantığı kullanın.
Pazaryeri fiyatını belirlerken komisyon ve kargoyu hesaba katmak için satış fiyatı hesaplama aracını kullanabilirsiniz.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Vitrinde eski indirimli fiyat duruyor | sale_price gönderilmedi ya da boşaltılmadı | İndirimi açıkça kaldırın, ürünü yeniden okuyup on_sale değerini kontrol edin |
| Varyasyonlu ürünün fiyatı değişmedi | Fiyat ana ürüne yazıldı | Varyasyonlara yazın |
| İndirim beklenen saatte başlamadı | Tarih saat dilimi karıştı | GMT alanlarını kullanın |
| Tutar yanlış hesaplandı | Metin değer sayıya çevrilmedi | Hesaplamadan önce sayıya çevirin |
Pazaryerinde farklı fiyat tutmak istiyorsanız site fiyatını taban alıp kanal bazında yüzde eklemek yaygın bir yöntemdir: platforma özel fiyat.
Sık sorulanlar
WooCommerce API ile fiyat nasıl güncellenir?
PUT /wp-json/wc/v3/products/ID isteğinde regular_price ve gerekirse sale_price alanlarını metin olarak gönderirsiniz. Çok ürün için /products/batch kullanılır.
price alanını neden güncelleyemiyorum?
price salt okunurdur ve geçerli satış fiyatını gösterir. Fiyatı regular_price ve sale_price ile değiştirirsiniz.
Varyasyonlu ürünün fiyatı nereye yazılır?
Her varyasyona ayrı ayrı: /products/ANA_URUN/variations/ID ya da toplu olarak variations/batch.
Süreli indirim API ile tanımlanabilir mi?
Evet. sale_price ile birlikte date_on_sale_from ve date_on_sale_to alanlarını gönderirsiniz; GMT karşılıkları da vardır.
Kaynaklar
İlgili WooCommerce API konuları
Son güncelleme: 27.10.2026 · WooCommerce API rehberinin tamamı