Alanlar
| Alan | Zorunlu | Anlamı |
|---|---|---|
| barcode | Evet | Güncellenecek ürünün barkodu |
| price | Hayır | idefix satış fiyatı |
| comparePrice | Hayır | Tavsiye edilen satış fiyatı; göndermek istemiyorsanız 0 |
| inventoryQuantity | Hayır | Satılabilir stok adedi |
| maximumPurchasableQuantity | Hayır | Ürünün en fazla satın alma adedi |
| deliveryDuration | Hayır | Kargoya verme süresi |
| deliveryType | Hayır | regular ya da same_day_shipping |
| isZoneSale | Hayır | Bölgesel satış bilgisi |
Örnek kalem: barcode: BARKOD, price: 3000, comparePrice: 3000, inventoryQuantity: 0, maximumPurchasableQuantity: 0, deliveryDuration: 1, deliveryType: regular. Stoğu 0 göndermek ürünü satışa kapatmanın yoludur; ürünü silmez.
Stok ve fiyat birlikte mi gitmeli?
Dokümanda yalnız barcode zorunlu görünür. Ancak inventory-result örnek yanıtında NO_PRICE kodu geçer; bu, fiyatsız gönderimin reddedilebileceğini düşündürür. Canlıda çalışan entegrasyonlar bu yüzden stok güncellemesinde ürünün bilinen fiyatını da gönderir.
comparePrice için kural açıktır: tavsiye fiyatı göstermek istemiyorsanız alanı 0 gönderin. Alanı boş bırakmak ya da satış fiyatının altında bir değer göndermek, vitrinde anlamsız bir indirim görüntüsüne yol açabilir.
Aynı ürünü idefix'te diğer kanallardan farklı fiyatla satmak istiyorsanız idefix'e giden price değerini ayrı hesaplamanız gerekir. Komisyon ve kargo farkını görmek için satış fiyatı hesaplama aracını kullanabilirsiniz.
İşlem sırası
- Ürün onaylı ve envantere eklenmiş olmalı. Onay bekleyen ürüne stok gönderimi PRODUCT_NOT_FOUND ile dönebilir.
- inventory-upload ile kalemleri toplu gönderin.
- Yanıttaki batchRequestId'yi saklayın.
- inventory-result ile kalemlerin completed olup olmadığını kontrol edin.
- Şüphede güncel değeri inventory/list servisinden okuyun.
Yanıttaki parti durumu tek başına yeterli değildir: dokümandaki örnek yanıtta kalem completed iken parti FAILED görünür. Kalem durumlarını ayrı ayrı okuyun. Sonuç sorgusu ve envanter listesi envanter ve işlem sonucu sayfasında.
Sık hatalar ve çözümleri
| Hata | Neden | Çözüm |
|---|---|---|
| PRODUCT_NOT_FOUND | Barkod ürün havuzunuzda yok | Önce ürünü create ya da fast-listing ile ekleyin |
| CATALOG_PRICE_LOCKED | Fiyat kilitli | idefix destek ekibiyle görüşün |
| Değişiklik vitrine yansımadı | Parti reddedilmiş ya da yanlış ekrana bakılıyor | inventory-result'a ve Envanterim ekranına bakın |
| Stok ondalık ya da negatif | Hesaplama hatası | Tam sayı ve en az 0 gönderin |
| Her satışta tek barkod gönderimi | İstek sınırına takılma | Değişiklikleri biriktirip toplu gönderin |
idefix SSS'nin önerisi: stok ve fiyat yansımadıysa önce sonuç servisinde hata olup olmadığına bakın, sonra doğru ekrana (Mcenter, Envanterim) ya da inventory-list servisine bakın.
Sık sorulanlar
idefix stok güncelleme hangi servisle yapılır?
POST /pim/catalog/{vendorId}/inventory-upload ile. Aynı servis fiyatı da günceller; kalemler barkodla tanınır.
Yalnız stok gönderip fiyatı boş bırakabilir miyim?
Dokümanda fiyat zorunlu görünmez, ama sonuç örneğinde NO_PRICE hatası geçer. Güvenli yol, stokla birlikte ürünün mevcut fiyatını da göndermektir.
comparePrice göndermek istemiyorsam ne yapmalıyım?
idefix dokümanına göre alanı 0 olarak göndermelisiniz.
Stok güncellemem yansımadı, ne yapmalıyım?
Önce inventory-result ile kalemin durumuna ve failureReasons alanına bakın. Hata yoksa güncel değeri inventory-list servisinden ya da panelde Envanterim ekranından kontrol edin.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı