Parametreler
| Parametre | Anlamı | Not |
|---|---|---|
| page | Getirilecek sayfa | 1'den başlayarak artırın |
| limit | Bir yanıttaki ürün sayısı | Örneğin 100 |
| barcode | Barkoda göre filtre | Tek ürünü bulmanın en hızlı yolu |
| state | Duruma göre filtre | Örneğin not_matched ürünleri ayırmak için |
idefix dokümanı, satıcının tüm ürünlerini çekerken sayfalama kullanımının zorunlu olduğunu belirtir. Sayfalamasız istekle bütün listeyi almayı beklemeyin.
Yanıtta hangi alanlar var?
Yanıt products dizisi döndürür. Her ürün, gönderdiğiniz create isteğinin alanlarını ve idefix'in eklediği durum alanlarını taşır.
| Alan | Anlamı |
|---|---|
| barcode, title, productMainId | Ürünün kimliği ve adı |
| brandId, categoryId | Marka ve kategori ID'leri |
| vendorStockCode | Sizin stok kodunuz |
| price, comparePrice | Ürün kaydındaki fiyatlar |
| inventoryQuantity | Ürün kaydındaki stok; güncel stok için güvenilir değil |
| images, attributes | Görseller ve özellikler |
| status, failureReasons | Ürünün durumu ve varsa ret nedeni |
| matchedProduct | Eşleştiği katalog ürünü |
| addType | Ürünün nasıl eklendiği; dokümandaki örnekte integration |
Ürün listesi mi, envanter listesi mi?
| Soru | Doğru servis |
|---|---|
| Hangi ürünlerim var, durumları ne? | GET /pim/pool/{vendorId}/list |
| Güncel stok ve fiyatım ne? | GET /pim/catalog/{vendorId}/inventory/list |
| Gönderdiğim partinin sonucu ne? | batch-result ya da inventory-result |
idefix SSS'ye göre güncel stok ve fiyat inventory-list servisinden alınır. Canlı kullanımda ürün listesindeki inventoryQuantity alanının, ürün oluşturulurken gönderilen ilk değer olarak kaldığı görüldü. Stoğu bitmiş bir ürün bu listede stokta görünebilir. Stok kararlarını bu alana dayandırmayın; ayrıntılar envanter listesi sayfasında.
Sayfalama ipuçları
- limit'i makul tutun, örneğin 100, ve page'i 1'den artırın.
- Dönen kayıt sayısı limit'ten azsa ya da boş sayfa gelirse liste bitmiştir.
- Tek bir ürünü aramak için barcode filtresi tüm listeyi indirmekten hızlıdır.
- Sayfalar arasında kısa bir ara verin; sınır aşılırsa 429 kuralı devreye girer.
- Büyük kataloglarda listeyi gece gibi sakin saatlerde tam, gün içinde yalnız değişen barkodlar için sorgulayın.
Sık hatalar ve çözümleri
- Ürün listesindeki stoğu güncel stok sanmak: envanter listesini kullanın.
- Tüm ürünleri tek istekte beklemek: page ve limit ile sayfalayın.
- İlk istekte boş liste gelince ürün yok sanmak: canlı kullanımda ilk çağrının zaman zaman boş döndüğü görüldü; kısa bir aradan sonra yeniden deneyin.
- status alanını tek başına satışta olma bilgisi saymak: ready_for_sale ürün de stok ve fiyat gönderilene kadar satılmaz.
Sık sorulanlar
idefix'teki tüm ürünlerimi nasıl çekerim?
GET /pim/pool/{vendorId}/list servisini page ve limit ile sayfa sayfa çağırın. Boş sayfa ya da limit'ten az kayıt gelince liste bitmiştir.
Ürün listesindeki stok neden yanlış görünüyor?
Bu listedeki inventoryQuantity, ürün açılırken gönderilen değeri gösterebilir. Güncel stok için /pim/catalog/{vendorId}/inventory/list servisini kullanın.
Tek bir barkodu nasıl sorgularım?
Liste servisine barcode parametresiyle istek atın. Tüm listeyi indirmeden yalnız o ürün döner.
Ürün listesi onay durumunu gösterir mi?
Evet. Her ürünün status alanı ürün durumunu (ör. not_matched, ready_for_sale), failureReasons alanı varsa ret nedenini gösterir.
Kaynaklar
İlgili idefix API konuları
Son güncelleme: 27.10.2026 · idefix API rehberinin tamamı