İki fiyat alanı
N11 her ürün için iki fiyat tutar:
| Alan | Anlamı | Kural |
|---|---|---|
| listPrice | Liste fiyatı (PSF); satış fiyatı düşükken üstü çizili gösterilir | salePrice'a eşit ya da daha yüksek |
| salePrice | Satış fiyatı (TSF); müşterinin ödediği fiyat | En fazla iki ondalık hane |
| currencyType | Fiyatın para birimi | TL, USD ya da EUR |
İndirim göstermek istemiyorsanız iki alana aynı değeri yazın. İndirim göstermek istiyorsanız liste fiyatını yüksek, satış fiyatını düşük gönderin. Örnek satır: stockCode: STOK_KODU, listPrice: 1200.00, salePrice: 1100.00, currencyType: TL.
Biçim kuralları
N11 dokümanı fiyat biçimi için üç kural koyar ve bunlara uyulmazsa isteğin FAIL olacağını söyler:
- Ondalık kısım nokta ile ayrılır. 1100,50 değil 1100.50 yazılır.
- Noktadan sonra en fazla iki hane bulunur. 1100.505 gibi bir değer reddedilir.
- Fiyat güncellemesinde listPrice ve salePrice birlikte gönderilir. Yalnız birini göndermek kuralı bozar.
Fiyatı yazılım içinde hesaplıyorsanız (örneğin komisyon payı eklerken) sonucu göndermeden önce iki haneye yuvarlayın. Kayan noktalı sayı hesapları 0.1 + 0.2 gibi işlemlerde fazladan hane üretebilir.
Fiyat sınırları ve para birimi
N11 bazı ürünlerde fiyat hatasına karşı alt ve üst sınır uygular. Hata listesinde iki mesaj yer alır: girilen fiyatta fahiş düşüklük olduğu için "Minimum X TL" ve fahiş artış olduğu için "Maximum X TL" uyarısı. Bu sınırların dışına API ile çıkamazsınız. Fiyat gerçekten doğruysa N11 mağaza destek merkezinden talep açmanız gerekir.
USD ve EUR ile fiyatlandırma yapılabilir. Ürün yükleme dokümanına göre bu fiyatlar Merkez Bankası kuruna göre güncellenir. Kur değiştikçe TL karşılığı da değişeceği için kâr hesabını buna göre yapın.
Kanal bazlı fiyat ve sık hatalar
N11'in komisyon ve hizmet bedelleri diğer pazaryerlerinden farklı olduğu için çoğu satıcı N11'e ayrı fiyat verir. Bunu yaparken temel fiyattan bir yüzde farkıyla hesaplamak işi düzenli tutar. Komisyonu hesaplamak için pazaryeri komisyon hesaplama aracını kullanabilirsiniz.
- Virgüllü ondalık: En sık FAIL nedeni budur.
- Liste fiyatını unutmak: Yalnız salePrice gönderen istekler kuralı bozar.
- Liste fiyatı düşük: "listPrice salePrice'dan küçük olamaz" hatası döner.
- Sonucu okumamak: Fiyat satırının SUCCESS olduğunu task detayından kontrol edin.
Sık sorulanlar
N11'de yalnız satış fiyatını güncelleyebilir miyim?
Hayır. N11 dokümanına göre fiyat güncellemelerinde listPrice ve salePrice birlikte gönderilmelidir. İndirim göstermek istemiyorsanız ikisine aynı değeri yazın.
Fiyatta virgül kullanılır mı?
Kullanılmaz. Ondalık ayıracı nokta olmalı ve noktadan sonra en fazla iki hane bulunmalıdır. Virgül kullanımı isteğin hata almasına yol açar.
N11 "fahiş fiyat" uyarısı neden çıkar?
N11 bazı ürünlerde fiyat hatasını önlemek için alt ve üst sınır uygular. Mesajdaki minimum ya da maksimum değerin dışına çıkamazsınız; gerekirse mağaza destek merkezinden talep açın.
Fiyat ve stok aynı istekte gönderilebilir mi?
Evet. price-stock-update aynı satırda quantity, salePrice ve listPrice alanlarını birlikte alır. Fiyat gönderiyorsanız iki fiyat alanının birlikte olması kuralı yine geçerlidir.
Kaynaklar
İlgili N11 API konuları
Son güncelleme: 27.10.2026 · N11 API rehberinin tamamı