Varyant alanları
| Alan | Anlamı |
|---|---|
| id | Varyant kimliği; stok ve fiyat yazarken kullanılır |
| sku | Varyantın stok kodu |
| barcodeList | Varyantın barkod listesi; birden fazla barkod olabilir |
| isActive | Varyant aktif mi |
| prices | Fiyat listesi: priceListId, sellPrice, discountPrice, buyPrice |
| stocks | Depo stokları: stockLocationId ve stockCount |
| sellIfOutOfStock | Stok bitince satışa devam edilsin mi |
Ürün düzeyinde id, name, type, description, brand, categories ve totalStock gibi alanlar bulunur (ikas: Ürünler).
Filtreler
listProduct şu filtreleri alır: id, sku, barcodeList, brandId, categoryIds, salesChannelIds, tagIds, variantTypeId, vendorId ve serbest metin için search. v2'de stockLocationId ve totalStock filtreleri, v1'de ise name, includeDeleted ve variantStockLocationId filtreleri vardır.
Tek bir ürünü yenilemek için tüm kataloğu okumayın; id: { eq: URUN_ID } filtresiyle yalnız o ürünü isteyin. SKU ya da barkodla eşleştirme yapıyorsanız sku ve barcodeList filtreleri serbest aramadan daha kesin sonuç verir.
Stok entegrasyonu için öneriler
- Her varyantı ayrı bir stok kalemi olarak izleyin; ürün kimliği ile varyant kimliğini birlikte saklayın, çünkü stok yazarken ikisi de istenir.
- Barkod bir liste olduğu için eşleştirmede hangi barkodu esas aldığınızı belirleyin.
- Çok depolu mağazada stocks dizisi her depo için ayrı satır taşır. Toplamı mı, belirli bir depoyu mu izleyeceğinize baştan karar verin.
- v1'de stok okumak için read_inventories, v2'de read_products gerekir.
- Silinmiş kayıtlar varsayılan olarak gelmez; v1'de includeDeleted ile istenebilir.
Sık sorunlar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| stocks alanı boş | Stok okuma izni yok ya da depoda kayıt yok | v1'de read_inventories ekleyin; depoda stok tanımlayın |
| Varyantlar SKU'suz | SKU panelde doldurulmamış | Eşleştirme için her varyanta SKU girin |
| Bazı ürünler eksik | Sayfalama erken bitti | hasNext false olana kadar okuyun |
| Fiyat listesi birden fazla | Mağazada ek fiyat listeleri var | priceListId'ye göre doğru fiyatı seçin |
Sık sorulanlar
ikas'ta stok ürün düzeyinde mi, varyant düzeyinde mi?
Varyant düzeyinde. Her varyantın stocks dizisi depo bazında adetleri taşır; ürünün totalStock alanı genel toplamı verir.
ikas ürününü SKU ile nasıl bulurum?
listProduct sorgusuna sku: { eq: STOK_KODU } filtresini verin. Barkodla aramak için barcodeList filtresi kullanılır.
Varyantın birden fazla barkodu olabilir mi?
Evet. barcodeList bir dizidir. Eşleştirmede hangi barkodu esas aldığınızı belirleyin ve bu kuralı tüm kanallarda aynı uygulayın.
Tek bir ürünü kimliğiyle nasıl okurum?
listProduct sorgusuna id: { eq: URUN_ID } filtresini verin. Tüm kataloğu okumadan tek ürünün güncel fiyat ve stok bilgisini alırsınız.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı