Fiyat alanları
| Alan | Anlamı | Not |
|---|---|---|
| sellPrice | Satış fiyatı | İndirim varsa üstü çizili görünen fiyat olarak kullanılır |
| discountPrice | İndirimli fiyat | Boşsa satış fiyatı geçerlidir |
| buyPrice | Alış fiyatı | Maliyet ve kâr hesabı için tutulur |
| priceListId | Fiyat listesi kimliği | Verilmezse varsayılan fiyatlar güncellenir |
Sipariş satırında da benzer bir kural geçerlidir: ikas'a göre indirimli fiyat satış fiyatından düşükse satırın nihai fiyatı indirimli fiyattır (ikas: Siparişler).
v1 ve v2 farkı
| v1 saveVariantPrices | v2 updateVariantPrices | |
|---|---|---|
| Girdi | priceListId ve variantPriceInputs | priceListId ve variantPriceInputs |
| En fazla satır | 3000 | 3000 |
| Dönen değer | true ya da false | errors listesi (errorCode, inputArrayIndex, inputData) |
| Dinamik fiyat listesi | Desteklenmez | Belgede ayrıca belirtilmez |
v2'de hatalı satırlar listede döner, diğerleri güncellenir. v1'de false yanıtı tüm grubun sonucunu tek değerle verir.
Örnek satır
ikas'ın örneğindeki bir fiyat satırı şu alanlardan oluşur (değerler sahtedir):
- productId: URUN_ID
- variantId: VARYANT_ID
- price.sellPrice: 549.9
- price.discountPrice: 449.9
- price.buyPrice: 210
Bu satırla varyant 549,90'dan satılıyor görünür ve 449,90'a indirimli satılır. Fiyatlar ondalık nokta ile, para birimi işareti olmadan gönderilir.
Fiyat listeleriyle çalışmak
Mağazada birden fazla fiyat listesi olabilir; satış kanalının da bir fiyat listesi bulunabilir. Varyantın prices dizisinde her öğe priceListId taşır. Varsayılan fiyatı değiştirmek için priceListId göndermeyin; belirli bir listeyi değiştirmek için o listenin kimliğini verin.
- Önce listProduct ile varyantın hangi fiyat listelerinde bulunduğunu okuyun.
- Aynı istekte yalnız tek bir priceListId gönderilir; farklı listeler için ayrı istek atın.
- buyPrice değerini değiştirmek istemiyorsanız mevcut değeri okuyup aynen gönderin.
- Fiyat listeleri listPriceList ile okunur; v2'de createPriceList, updatePriceList ve deletePriceListList işlemleri de vardır.
Sık sorunlar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Vitrinde fiyat değişmedi | Başka bir fiyat listesi güncellendi | Kanalın kullandığı listeyi kontrol edin |
| İndirim görünmüyor | discountPrice satış fiyatından düşük değil | İndirimli fiyatı daha düşük girin |
| v1 false döndü | Gruptaki bir satır hatalı | Grubu küçültüp sorunlu satırı bulun |
| v2'de bazı varyantlar güncellenmedi | Satırlar errors listesinde döndü | errorCode'a göre düzeltip yalnız onları gönderin |
Sık sorulanlar
ikas'ta sellPrice ile discountPrice farkı nedir?
sellPrice satış fiyatı, discountPrice indirimli fiyattır. İndirimli fiyat satış fiyatından düşükse alıcının ödediği nihai fiyat indirimli fiyattır.
ikas fiyat güncellemesinde kaç varyant gönderebilirim?
ikas'a göre tek istekte en fazla 3000 satır. Hata ayıklamayı kolaylaştırmak için daha küçük gruplar kullanabilirsiniz.
priceListId göndermezsem ne olur?
Varyantın varsayılan fiyatları güncellenir. Belirli bir fiyat listesini değiştirmek için o listenin kimliğini göndermeniz gerekir.
Fiyat güncellemesi stoğu etkiler mi?
Hayır. Fiyat ve stok ayrı işlemlerle yazılır. Fiyat isteği yalnız price nesnesindeki alanları değiştirir.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı