Temel alanlar
| Alan | Zorunlu mu | Açıklama |
|---|---|---|
| name | Evet | Ürün adı |
| type | Evet | PHYSICAL, DIGITAL, BUNDLE, MEMBERSHIP ya da SUBSCRIPTION |
| variants | Evet | En az bir varyant |
| description | Hayır | Açıklama; HTML kabul eder |
| brandId, categoryIds | Hayır (v1) | Marka ve kategori kimlikleri |
| brand, categories | Hayır (v2) | Marka ve kategori adları; yoksa oluşturulur |
| salesChannelIds ya da salesChannels | Hayır | Ürünün görüneceği satış kanalları |
Varyant ve fiyat
Varyant girdisinde sku, barcodeList, isActive, sellIfOutOfStock ve prices alanları bulunur. prices dizisinde sellPrice satış fiyatıdır; discountPrice indirimli fiyatı, buyPrice alış fiyatını taşır.
- Tek varyantlı ürün için variants dizisine tek bir öğe yazılır.
- Beden ya da renk gibi seçenekli ürünlerde v2 her varyanta variantValues ile tip ve değer adı verilmesine izin verir; ör. Beden ve S.
- sellIfOutOfStock false ise varyant stok bitince satılmaz. Pazaryerleriyle stok paylaşan mağazada bu alanı false tutmak fazla satışı önler.
- v2 createProduct varyant girdisinde görsel adresi de kabul eder; v1'de görsel ayrı uçtan yüklenir.
Oluşturduktan sonra
Ürün açma isteği stok yazmaz. Yanıttan ürün ve varyant kimliklerini alıp stoğu stok güncelleme işlemiyle depoya yazmanız gerekir. Görseller için görsel yükleme ucu kullanılır.
v1'deki saveProduct girdide id gönderildiğinde var olan ürünü günceller. Yeni ürün açarken id göndermeyin; aksi hâlde başka bir ürünün üzerine yazabilirsiniz. v2'de bu ayrım createProduct ve updateProduct adlarıyla yapılır.
Çok sayıda ürünü tek seferde aktarmak için bulkUpdateProducts işlemi vardır. İşlem arka planda bir içe aktarma işi olarak çalışır; yanıt işin kimliğini döndürür ve durum getImportJobData ile sorgulanır.
Sık sorunlar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Ürün açıldı ama vitrinde yok | Satış kanalı verilmedi | salesChannelIds ile STOREFRONT kanalını ekleyin |
| Ürün kategorisiz (v1) | Kategori kimliği bulunamadı | Önce listCategory ile kimliği alın |
| Stok 0 görünüyor | Stok ayrı yazılmadı | Ürün açıldıktan sonra stok işlemini çağırın |
| Aynı SKU iki kez | Önceden açılmış ürün kontrol edilmedi | Açmadan önce sku filtresiyle arayın |
Sık sorulanlar
ikas'ta API ile varyantlı ürün açılabilir mi?
Evet. v2 createProduct her varyanta variantValues ile tip ve değer adı vermeye izin verir. v1'de varyant tipleri productVariantTypes alanıyla tanımlanır.
Ürün açarken stok da yazılır mı?
Hayır. Ürün ve varyant kimlikleri döndükten sonra stok, depo kimliğiyle birlikte ayrı bir işlemle yazılır.
v2'de olmayan marka ne olur?
ikas'ın createProduct örneğine göre marka ve kategori adla gönderilir; mağazada yoksa otomatik oluşturulur.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı