Lokasyon alanları
| Alan | Anlamı |
|---|---|
| id | Lokasyon kimliği; stok yazarken stockLocationId |
| name | Lokasyon adı |
| type | PHYSICAL ya da VIRTUAL |
| deleted | Silinmiş mi |
| address | Adres, şehir, ilçe, telefon, posta kodu |
| deliveryTime | Teslim süresi; ör. WITHIN_TWENTY_FOUR_HOURS, TWO_IN_FOUR_DAYS |
| isRemindOutOfStockEnabled, outOfStockMailList | Stok bitince e-posta hatırlatması |
Sorgu id, name ve updatedAt filtrelerini alır (ikas: Stok lokasyonları).
Depo ID nasıl bulunur?
- listStockLocation sorgusunu id, name, type ve deleted alanlarıyla çalıştırın.
- deleted değeri true olanları ayıklayın.
- Adı panelde gördüğünüz depoyla eşleşen kaydın id değerini alın.
- Bu değeri entegrasyon ayarlarınızda saklayın; her stok yazımında yeniden sorgulamayın.
- Depo adı panelde değiştirilebilir; eşleştirmeyi ada göre değil id değerine göre yapın.
Tek depolu mağazada liste tek kayıt döndürür. Çok depolu mağazada hangi deponun pazaryerleriyle paylaşılacağı bilinçli bir karardır.
Çok depolu mağazada stok
Varyantın stocks dizisi her depo için ayrı bir satır taşır. Ürünün totalStock alanı ise genel toplamı verir. Siparişlerde de her satırın stockLocationId alanı, satırın hangi depodan karşılanacağını gösterir.
Satış kanallarının stockLocations alanı, kanalın hangi depolardan hangi sırayla stok aldığını belirler. Pazaryeri entegrasyonunda yaygın düzen, pazaryerleriyle tek bir depoyu paylaşmak ve diğer depoları yalnız ikas vitrininde kullanmaktır.
Bu kararın etkisini çok depolu stok yönetimi yazısı ayrıntılı anlatır; hangi kanalın stok kaynağı olacağı ise stok kaynağı seçimi rehberinde.
Depo bazındaki stok kayıtlarını doğrudan okumak için listProductStockLocation sorgusu da vardır. v1'de productId, variantId ve stockLocationId filtreleriyle tek bir varyantın tek bir depodaki kaydı istenebilir.
Sık sorunlar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Stok yanlış depoda görünüyor | Depo kimliği boş ya da yanlış | Doğru lokasyonun id değerini kullanın |
| Lokasyon listesi yetki hatası veriyor | v1'de read_inventories izni yok | İzni özel uygulamaya ekleyin |
| Silinmiş depoya yazılıyor | deleted alanı kontrol edilmedi | deleted true olan kayıtları ayıklayın |
| Toplam stok beklenenden yüksek | Aynı varyant birden fazla depoya yazıldı | Senkronu tek depoya sabitleyin |
Sık sorulanlar
ikas depo ID nereden bulunur?
listStockLocation sorgusu tüm depoları id ve name alanlarıyla döndürür. Paneldeki depo adıyla eşleşen kaydın id değeri depo kimliğidir.
ikas'ta API ile yeni depo açılabilir mi?
Hayır. ikas'a göre stok lokasyonları API ile yalnız okunabilir. Depo yönetim panelinden eklenir.
Ürünün toplam stoğu nerede?
Ürünün totalStock alanında. Depo bazında adetler ise varyantın stocks dizisinde, her depo için ayrı satırdadır.
Siparişin hangi depodan düştüğünü nasıl anlarım?
Sipariş satırının stockLocationId alanına bakın. Siparişte farklı depolara atanmış satırlar varsa, kargoya hazırlarken fulfillOrder işlemine satır listesi vermek zorunludur.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı