Fiyat alanları
| Alan | Anlamı | Öneri |
|---|---|---|
| stockCode | Ürünü seçen stok kodu | Yüklemede kullanılan kodun aynısı |
| salesPrice | Müşterinin ödediği satış fiyatı | Sıfırdan büyük |
| listPrice | Üstü çizili liste fiyatı | Satış fiyatına eşit ya da yüksek |
Örnek satır: stockCode: STOK_KODU, salesPrice: 349.90, listPrice: 419.90. İki fiyatı birlikte göndermek, Çiçeksepeti'nde gösterilen indirimin tutarlı kalmasını sağlar. Stok da değişiyorsa aynı satıra stockQuantity eklenebilir.
Liste fiyatı ve indirim
Liste fiyatı, ürün sayfasında üstü çizili gösterilen fiyattır. Satış fiyatıyla arasındaki fark indirim olarak görünür. Bu yüzden:
- Liste fiyatı satış fiyatından düşük olmamalıdır.
- Gerçekte uygulanmayan, şişirilmiş bir liste fiyatı yazmaktan kaçının. İndirimli fiyat gösterimi Türkiye'de tüketici mevzuatına tabidir.
- Çok büyük indirim oranları (örneğin yüzde 80'in üzeri) dikkat çeker; fiyat hatası gibi görünür.
Çalışan bir entegrasyon, ürün yüklemede liste fiyatının satış fiyatından en az yüzde 1 yüksek, indirimin de en fazla yüzde 80 olmasını sağlayacak şekilde düzenleme yapıyor. Bu, Çiçeksepeti'nin resmî bir sınırı olarak değil, bir iç kural olarak anlaşılmalıdır.
Sonuç kontrolü ve kanal fiyatı
Fiyat değişikliklerini toplu yapıyorsanız (örneğin kampanya öncesi bütün kategoride yüzde 10 indirim) önce küçük bir ürün grubuyla deneyin. Sonucu batch-status ve ürün sayfasından kontrol ettikten sonra kalan ürünleri gönderin. Yanlış hesaplanmış bir fiyatın binlerce ürüne aynı anda yazılması, düzeltilmesi saatler alan bir sorundur.
Fiyat güncellemesi de batchId ile izlenir. GET /api/v1/Products/batch-status/{batchId} yanıtında Failed satırların fiyatı değişmemiştir; nedeni failureReasons alanında yazar. Ayrıntı: batch-status ile işlem takibi.
Çiçeksepeti'nin komisyonu diğer pazaryerlerinden farklı olabildiği için birçok satıcı burada ayrı fiyat kullanır. Temel fiyattan bir yüzde farkıyla hesaplamak, binlerce üründe tutarlı kalmayı kolaylaştırır. Hesap için pazaryeri komisyon hesaplama aracını kullanabilirsiniz.
Sık hatalar
- Yalnız satış fiyatını değiştirmek: Liste fiyatı eski kalırsa indirim oranı beklenmedik biçimde değişebilir.
- Fazla ondalık hane: Hesaplanan fiyatı göndermeden önce iki haneye yuvarlayın.
- Virgüllü sayı: JSON'da sayılar nokta ile yazılır; 349,90 değil 349.90.
- Sonucu okumamak: 200 yanıtı fiyatın değiştiğini göstermez; batch sonucunu kontrol edin.
- Kampanya fiyatını ezmek: Panelden tanımladığınız bir kampanya fiyatı varsa otomatik fiyat gönderimi bunu bozabilir; hangi fiyatın kaynağın hangisi olduğunu netleştirin.
Sık sorulanlar
Çiçeksepeti'nde fiyat API ile nasıl güncellenir?
PUT /api/v1/Products/price-and-stock isteğinde items listesine her ürün için stockCode, salesPrice ve listPrice yazılır. Sonuç batchId ile batch-status servisinden kontrol edilir.
Liste fiyatı satış fiyatına eşit olabilir mi?
Liste fiyatının satış fiyatından düşük olmaması gerekir. Eşit olduğunda indirim gösterilmez. Saystok yüklemede liste fiyatını satış fiyatından en az yüzde 1 yüksek tutan bir iç kural uygular.
Fiyat ve stok aynı istekte gönderilebilir mi?
Evet. Aynı items satırına stockQuantity, salesPrice ve listPrice birlikte yazılabilir. Sonuç yine tek bir batchId ile izlenir.
Fiyat güncellemesi Failed dönerse ne yapmalıyım?
batch-status yanıtındaki failureReasons mesajını okuyun. Stok kodu eşleşmesini, fiyatların sıfırdan büyük olduğunu ve liste fiyatının satış fiyatından düşük olmadığını kontrol edip düzeltilmiş satırı yeniden gönderin.
Kaynaklar
İlgili Çiçeksepeti API konuları
Son güncelleme: 27.10.2026 · Çiçeksepeti API rehberinin tamamı