Fiyat alanları
| REST | GraphQL | Anlamı |
|---|---|---|
| price | price | Müşterinin ödediği satış fiyatı |
| compare_at_price | compareAtPrice | İndirimi göstermek için üstü çizili fiyat |
Karşılaştırma fiyatı satış fiyatından yüksekse vitrinde indirim olarak görünür. İndirimi kaldırmak için karşılaştırma fiyatını boşaltmanız gerekir; yalnız price göndermek eski karşılaştırma fiyatını silmez.
Fiyatlar REST yanıtlarında “249.90” gibi metin olarak gelir. Hesaplamadan önce sayıya çevirin.
GraphQL ile toplu güncelleme
productVariantsBulkUpdate, tek bir ürünün birden çok varyantını tek işlemde günceller. Girdi yapısı özetle şöyledir; numaralar sahtedir.
- productId: gid://shopify/Product/100
- variants öğesi 1: id gid://shopify/ProductVariant/101, price 249.90, compareAtPrice 299.90
- variants öğesi 2: id gid://shopify/ProductVariant/102, price 249.90
| Kural | Değer |
|---|---|
| Kapsam | write_products |
| İşlem başına | Tek ürünün varyantları |
| Ürün başına varyant sınırı | Varsayılan 2.048 |
| Mutasyon maliyeti | Varsayılan 10 puan |
Farklı ürünlerin varyantları için ayrı çağrı gerekir. Binlerce ürünlük fiyat değişikliğinde mutasyonu toplu işlem içinde çalıştırabilirsiniz.
Eski REST yolu
REST’te fiyat PUT /admin/api/SURUM/variants/ID.json isteğiyle, gövdede variant nesnesi içinde price ve compare_at_price gönderilerek yazılır. Belgeye göre varyantları güncelleme 2024-04’ten beri kullanımdan kalkmış durumdadır.
| Yol | Bir istekte | Standart planda 100 varyant |
|---|---|---|
| REST PUT /variants/ID.json | 1 varyant | 100 istek, saniyede 2 istekle yaklaşık 50 saniye |
| GraphQL productVariantsBulkUpdate | Bir ürünün tüm varyantları | Ürün sayısı kadar çağrı |
Kullanımdan kalkmış bir uç nokta hemen durmaz ama belgeye göre desteklenmez ve her an durabilir. Fiyat güncellemesini düzenli çalıştıran bir entegrasyon kuruyorsanız GraphQL yolunu tercih edin.
Fiyat değişikliğini güvenle yapmak
- Değişiklikten önce mevcut price ve compareAtPrice değerlerini kaydedin; hata olursa geri dönebilirsiniz.
- Toplu fiyat değişikliğini önce birkaç üründe deneyin, vitrinde nasıl göründüğünü kontrol edin.
- Mutasyon yanıtındaki güncellenmiş varyantları okuyup yeni fiyatın yazıldığını doğrulayın.
- Kampanya dönemlerinde fiyatı ve karşılaştırma fiyatını aynı işlemde değiştirin; arada kalan kısa sürede yanlış indirim görünmesini önler.
Kampanya hazırlığının stok ve fiyat tarafı kampanya dönemlerine hazırlık yazısında.
Sık hatalar
| Belirti | Neden | Çözüm |
|---|---|---|
| Eski indirim vitrinde duruyor | Karşılaştırma fiyatı boşaltılmadı | compareAtPrice alanını açıkça kaldırın |
| Bir varyantın fiyatı değişmedi | Varyant başka ürüne ait | Her ürün için ayrı çağrı yapın |
| userErrors dolu, HTTP 200 | Girdi kurala uymuyor | userErrors mesajını okuyun |
| Çok sayıda 429 | REST’te varyant başına istek | GraphQL toplu güncellemeye geçin |
Pazaryeri ile site fiyatını farklı tutuyorsanız pazaryeri komisyonunu ve kargoyu hesaba katın: pazaryeri komisyon hesaplama.
Sık sorulanlar
Shopify’da fiyat API ile nasıl güncellenir?
GraphQL’de productVariantsBulkUpdate ile bir ürünün varyantlarına price ve compareAtPrice yazılır. Eski REST yolu PUT /variants/ID.json’dur.
Karşılaştırma fiyatı ne işe yarar?
Satış fiyatından yüksek bir compareAtPrice, vitrinde üstü çizili eski fiyat olarak görünür ve indirimi gösterir.
Fiyat ürüne mi varyanta mı yazılır?
Varyanta. Tek seçenekli ürünlerde de fiyat varsayılan varyantta durur.
Farklı ürünlerin fiyatını tek çağrıda güncelleyebilir miyim?
productVariantsBulkUpdate tek bir ürünün varyantlarıyla çalışır. Çok ürün için ayrı çağrı ya da toplu işlem kullanılır.
Kaynaklar
İlgili Shopify API konuları
Son güncelleme: 27.10.2026 · Shopify API rehberinin tamamı