İki servisin farkı
| Özellik | inventory/list | inventory-result |
|---|---|---|
| Yanıtladığı soru | Güncel stok ve fiyat ne? | Gönderim işlendi mi? |
| Girdi | Satıcı ID | Satıcı ID ve batchId |
| Döndürdüğü | barcode, stockCode, price, comparePrice, inventoryQuantity | Kalem bazında status ve failureReasons |
| Ne zaman | Senkron ve kontrol | Her inventory-upload sonrasında |
idefix SSS, envantere eklenmiş ürünlerin güncel stok ve fiyatının inventory-list servisinden alınacağını söyler. Ürün listesindeki (pool/list) stok alanı bu amaçla kullanılmamalıdır.
Pratik bir düzen şöyledir: her gönderimden sonra inventory-result ile kalemlerin işlendiğini doğrulayın, günde birkaç kez de inventory/list ile tüm envanteri okuyup kendi kayıtlarınızla karşılaştırın. Fark çıkan barkodlar, ya reddedilmiş bir gönderimi ya da panelden elle yapılmış bir değişikliği gösterir.
inventory-result durumları ve hata kodları
| Değer | Anlamı | Ne yapmalı |
|---|---|---|
| created | Talep oluşturuldu | Birkaç saniye sonra yeniden sorgulayın |
| completed | Gönderim başarıyla tamamlandı | İşlem yok |
| decline | Hata oluştu; failureReasons dolu | Koda göre düzeltin |
| DATA_PARSE_ERROR | Gönderilen veri okunamadı | Gövdenin JSON biçimini kontrol edin |
| BATCH_NOT_EXIST | Parti bulunamadı | batchId'yi doğru kaydettiğinizden emin olun |
| BATCH_ALREADY_PROCESSED | Parti hâlihazırda işleniyor | Bekleyip yeniden sorgulayın |
| PRODUCT_NOT_FOUND | Barkod ürün havuzunda yok | Ürünü önce ekleyin |
| CATALOG_PRICE_LOCKED | Ürün fiyatı kilitli | idefix destek ekibiyle görüşün |
failureReasons alanı yalnız status=decline olduğunda döner.
Envanter listesinde sayfalama
Doküman inventory/list için parametre belirtmez. Canlı kullanımda page ve limit parametreleriyle çağrılabildiği görüldü; ancak sunucunun sayfa boyutunu istenenden küçük kırpabildiği de görüldü. Bu yüzden "gelen kayıt limit'ten az, liste bitti" varsayımı bu serviste güvenli değildir. Boş sayfa gelene ya da yeni barkod gelmeyene kadar devam edin.
Listede görünmeyen bir barkodun stoğunu 0 saymayın. Liste eksik okunmuş olabilir. O ürün için mevcut değeri koruyup sonraki okumada tekrar bakmak, ürünü yanlışlıkla satıştan düşürmekten iyidir. Bu tür hatalı sıfır okumalarına karşı korumanın genel mantığı sıfır stok onayı rehberinde anlatılıyor.
Sık hatalar ve çözümleri
- Stoğu ürün listesinden (pool/list) okumak: oluşturma anındaki ilk değeri görürsünüz.
- inventory-result'u hemen sorgulayıp created değerini hata sanmak: parti henüz işlenmemiştir.
- batchId'yi kaydetmeden yeni gönderime geçmek: sonucu bir daha sorgulayamazsınız.
- Envanter okuması başarısız olunca tüm stokları 0 yazmak: ürünler satıştan düşer.
- Parti durumuna bakıp kalemleri okumamak: parti completed olsa da tek tek kalemler decline olabilir.
Envanter listesindeki stockCode alanı sizin stok kodunuzdur. Barkodu olmayan ya da barkodu değişmiş ürünlerde eşleştirmeyi bu alanla doğrulamak, yanlış ürüne stok yazmayı önler.
Sık sorulanlar
idefix'teki güncel stoğumu hangi servis gösterir?
GET /pim/catalog/{vendorId}/inventory/list. Yanıtta her barkod için stok kodu, fiyat, tavsiye fiyatı ve stok adedi döner.
inventory-result yanıtında created görüyorum, sorun mu var?
Hayır. Talep alınmış ama henüz işlenmemiştir. Birkaç saniye sonra yeniden sorgulayın; nihai değer completed ya da decline olur.
CATALOG_PRICE_LOCKED ne demek?
Ürünün fiyatı idefix tarafında kilitlenmiştir. idefix dokümanı bu durumda destek ekibiyle görüşülmesini söyler.
Envanter listesinde ürünüm yok, neden?
Liste yalnız envantere eklenmiş ürünleri döndürür. Onay bekleyen ya da reddedilen ürün burada görünmez; durumunu ürün listesinden ya da batch-result'tan kontrol edin.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı