İşlemler
| Kayıt | Okuma | Oluşturma v1 | Oluşturma v2 |
|---|---|---|---|
| Marka | listProductBrand | saveProductBrand | createProductBrand |
| Kategori | listCategory | saveCategory | createCategory |
| Satış kanalı | listSalesChannel | saveSalesChannel | updateSalesChannel (güncelleme) |
| Varyant tipi | listVariantType | saveVariantType | saveVariantType |
v2'de createProduct marka ve kategoriyi adla da kabul eder; mağazada yoksa oluşturur. v1'de ürün açmadan önce kimlikleri bulmanız ya da kaydı açmanız gerekir.
Satış kanalı tipleri
Satış kanalı, ürünün nerede satıldığını belirler. listSalesChannel her kanalın id, name ve type alanlarını döndürür. ikas'ın tanımladığı tipler şunlardır:
| Tip | Kullanım |
|---|---|
| STOREFRONT | Online mağaza vitrini |
| B2B_STOREFRONT | Kurumsal satış vitrini |
| POS | Fiziksel mağaza satış noktası |
| ADMIN, APP, STOREFRONT_APP | Panel ve uygulama kaynaklı satışlar |
| FACEBOOK, GOOGLE, FIRSAT | Dış kanallar |
Satış kanalının stockLocations alanı kanala bağlı depoları ve sıralarını gösterir. Çok depolu mağazada hangi deponun hangi kanala stok verdiğini buradan görürsünüz.
Ürünün kanal durumu ve fiyat listesi
Ürünün salesChannels alanı, her kanal için bir status değeri taşır: VISIBLE (görünür), HIDDEN (gizli) ya da PASSIVE (pasif). Bu durum updateProductSalesChannelStatus işlemiyle değiştirilir; işlem v1 ve v2'de bulunur.
Satış kanalının da bir priceListId alanı vardır. Kanal belirli bir fiyat listesine bağlıysa o kanaldaki fiyat, varyantın varsayılan fiyatından değil bu listeden gelir. Fiyat güncellerken hangi listeyi değiştirdiğinizi bu yüzden bilmeniz gerekir; ayrıntı fiyat güncelleme sayfasında.
Eşleştirme önerileri
- Marka ve kategori adlarını karşılaştırırken büyük-küçük harf ve baştaki, sondaki boşlukları yok sayın.
- Kategori ağacında aynı adlı iki kategori olabilir; v1'de kategorinin parentId alanına bakarak doğru olanı seçin.
- Her ürün açılışında tüm marka listesini yeniden okumak yerine listeyi kısa süre önbellekte tutun.
- Silinmiş kayıtları (deleted: true) eşleştirmeye dahil etmeyin.
- Yeni marka açmadan önce aynı adın farklı yazımlarını, örneğin kısaltmaları, kontrol edin.
Sık sorunlar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Ürün vitrinde görünmüyor | STOREFRONT kanalı eklenmedi | Ürünü vitrin kanalına ekleyin |
| Aynı marka iki kez açıldı | Ad karşılaştırması harf duyarlı | Adları normalize ederek karşılaştırın |
| Yanlış kategoriye bağlandı | Aynı adlı farklı kategori | Kategori yolunu da kontrol edin |
Sık sorulanlar
ikas'ta marka adını API'ye serbest metin olarak verebilir miyim?
v1 saveProduct marka kimliği (brandId) ister. v2 createProduct ise marka adını kabul eder ve marka yoksa oluşturur.
Ürünüm neden vitrinde görünmüyor?
Ürün büyük olasılıkla STOREFRONT tipindeki satış kanalına eklenmedi. listSalesChannel ile kanal kimliğini bulup ürünü bu kanala bağlayın.
Kategori ağacını API ile okuyabilir miyim?
Evet. listCategory kategorileri döndürür; v1'de parentId alanı üst kategoriyi gösterir.
Ürünü yalnız bir kanalda gizleyebilir miyim?
Evet. Ürünün kanal durumu VISIBLE, HIDDEN ya da PASSIVE olabilir. updateProductSalesChannelStatus işlemi bu durumu kanal bazında değiştirir.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı