ikas entegrasyonu: API bilgisinden ilk siparişe kadar adım adım
ikas entegrasyonu, ikas altyapısındaki sitenizi ürün, stok, fiyat ve sipariş tarafında pazaryerlerinizle aynı panelden yönetebilmeniz için ikas'ın Admin API'sine bağlamaktır. Bağlantının kendisi kısa sürer; sonucu asıl belirleyen, SKU ve barkod düzeninizin, kanal fiyatlarınızın ve sipariş akışınızın baştan doğru kurulmasıdır. Bu bölümde ikas'ta API bilgisinin nasıl oluşturulduğunu, eşleştirmeden önce nelere bakmanız gerektiğini, stok ve fiyat kurallarını, sipariş akışını ve en sık yapılan hataları anlatıyoruz.
ikas entegrasyonu hangi satıcı için gerekli?
ikas, uygulama mağazasında Trendyol, Hepsiburada, Amazon ve Etsy gibi pazaryerleri için kendi uygulamalarını sunuyor; bu uygulamaların bir kısmı ücretli ve hangi pazaryerlerine erişebileceğiniz ikas paketinize göre değişiyor. Yalnızca bir-iki pazaryerinde satış yapıyorsanız ve siparişleri ikas panelinden yönetmek size yetiyorsa ek bir yazılıma ihtiyacınız olmayabilir.
Ayrı bir ikas entegrasyon programı genellikle şu durumlarda işe yarar:
- ikas sitenizin yanında, ikas paketinizin kapsamadığı pazaryerlerinde ya da Ozon, Allegro, bol.com gibi yurt dışı kanallarda da satış yapıyorsanız
- Kargo etiketi, e-Arşiv faturası ve hakediş kontrolünü bütün kanallar için tek yerden yürütmek istiyorsanız
- Tedarikçi XML'i ya da ortak ürün havuzundan gelen ürünleri hem sitenize hem pazaryerlerine aynı stokla açmak istiyorsanız
- Her kanal için ayrı fiyat farkı ve stok kuralı tanımlamanız gerekiyorsa
Desteklenen bütün kanalları entegrasyonlar sayfasında görebilirsiniz.
ikas API bilgileri nasıl oluşturulur?
ikas'ın dış sistemlere açtığı kapı GraphQL tabanlı Admin API'dir. ikas'ın geliştirici dokümanına göre bu API'ye erişmek için mağaza panelinizde bir özel uygulama oluşturup client_id ve client_secret bilgilerini almanız gerekir. Mağaza şifrenizi kimseyle paylaşmazsınız; bağlantı bu bilgiler üzerinden kurulur ve istediğiniz zaman uygulamayı silerek erişimi kapatabilirsiniz.
- ikas yönetim panelinde sol menüden Uygulamalar > Uygulamalarım bölümüne gidin.
- Özel uygulamalar kısmına geçip yeni bir uygulama oluşturun ve Standart Uygulama seçeneğiyle devam edin.
- Ekranda görünen client_id ve client_secret değerlerini kopyalayın.
- Bu iki bilgiyi eticaretcim panelindeki ikas bağlantı ekranına girin.
- Bağlantı kurulunca mevcut ürünleriniz panele okunur; eşleştirme sonucunu kontrol edip onayladığınızda senkron başlar.
Teknik ayrıntı merak edenler için: ikas, bu bilgilerle alınan erişim belirtecinin süreli olduğunu belirtiyor (dokümandaki örnek yanıtta 14400 saniye, yani 4 saat). Belirtecin yenilenmesi entegrasyonun işidir; sizin her seferinde yeni bilgi girmeniz gerekmez.
ikas ürünlerini eşleştirmeden önce: SKU, barkod ve varyant kontrolü
ikas'ta varyantlı bir ürünün her varyantı için ayrı SKU, Barkod ve Stok alanı bulunur. eticaretcim mevcut ürünlerinizi barkod ya da stok koduyla eşleştirdiği için bu alanların düzgün dolu olması kurulumun en belirleyici adımıdır. Siz onaylamadan hiçbir ilan değişmez; ama eşleşmeyen ürünler listede bekler ve bunları tek tek bağlamak zaman alır.
| ikas alanı | Eşleştirmedeki rolü | Kontrol edilecek nokta |
|---|---|---|
| SKU | Ürünü bütün kanallarda tanıyan stok kodu | Her varyantta dolu mu, başka bir varyantla aynı mı? |
| Barkod | Pazaryeri ilanıyla eşleşmede kullanılan diğer anahtar | Pazaryerindeki ilanla aynı barkod mu? |
| Stok | Tek stok kartına aktarılan başlangıç miktarı | Sayım güncel mi, eksi stok var mı? |
| Satış Fiyatı / İndirimli Fiyat | Kanal fiyatlarının hesaplandığı taban | Fiyatlar güncel mi, indirimli fiyat bilerek mi girildi? |
| Desi | Kargo etiketi ve kargo kesintisi kontrolü | ikas'ta başlangıçta kapalı gelir; varyant ayarından açıp doldurdunuz mu? |
Aynı ürün sitede ve pazaryerinde farklı kodla açılmışsa
Sık görülen bir durum, ürünün ikas'ta bir SKU ile, Trendyol'da ya da Hepsiburada'da başka bir stok koduyla açılmış olmasıdır. Barkodlar da farklıysa bu ürünler otomatik eşleşmez. Ya kodları bir tarafta birleştirirsiniz ya da panelde ürünleri elle bağlarsınız; ikisinde de amaç aynı fiziksel ürünün tek stok kartına bağlanmasıdır.
ikas'ta 5'li, 10'lu paket ve set ürünler nasıl tanımlanır?
Sitenizde 5'li ya da 10'lu paket satıyorsanız, bunları ayrı stokla tutmak yerine tek stok biriminden düşecek şekilde tanımlayabilirsiniz. Set satıldığında stok bileşenlerden düşer, böylece tekli ürün ile paketi ayrı ayrı saymanız gerekmez.
ikas stok entegrasyonu ve kanal fiyatları nasıl çalışır?
ikas stok entegrasyonu kurulduğunda stok tek kartta tutulur: sitenizde satılan ürün pazaryerlerinde, pazaryerinde satılan ürün ikas sitenizde düşer. Fiyat tarafında ise her kanala yüzde ya da tutar olarak fark tanımlanır. Örneğin ikas'taki satış fiyatı 1.000 TL olan bir ürüne bir pazaryeri için %15, diğeri için 120 TL fark tanımlarsanız ilanlar 1.150 TL ve 1.120 TL olarak hesaplanır; taban fiyatı değiştirdiğinizde iki kanal da yeniden hesaplanır.
Kanal farkını belirlerken komisyon ve kargo kesintisini hesaba katmak gerekir; nasıl hesaplanacağını stok ve fiyat senkronu sayfasında anlattık. Senkronun doğru işleyip işlemediğini ise panelde üç yerden izleyebilirsiniz:
- Kritik stok uyarısı: azalan ürünleri tükenmeden fark edersiniz.
- Stok çakışmaları listesi: kanallar arasında tutmayan miktarları gösterir.
- Senkron sağlığı ekranı: pazaryerinin reddettiği ilanları ve ret sebebini listeler.
ikas API sınırları senkronu nasıl etkiler?
ikas, Admin API için 10 saniyede en fazla 50 istek sınırı uyguluyor; son bir saatte isteklerin %25'inden fazlası hatalı dönerse de erişimi bir saatliğine kapatıyor. Bu kurallar ikas'a bağlanan bütün yazılımlar için geçerlidir ve çok sayıda ürünü güncelleyen bir entegrasyon, istekleri bu sınıra göre parça parça göndermek zorundadır. Bu yüzden büyük bir fiyat değişikliğinin bütün ürünlere yansıması ürün sayınıza göre uzar. Hatalı istek oranını düşük tutmanın en kolay yolu, eşleşmemiş ya da eksik verili ürünleri senkrona almadan önce düzeltmektir.
ikas sipariş entegrasyonu: siparişten faturaya adım adım akış
ikas'ın kendi Siparişler sayfası da web ve pazaryeri siparişlerini bir arada gösteriyor ve satış kanalına göre filtrelenebiliyor. Ayrı bir panelin farkı, ikas'a bağlı olmayan kanallar dahil bütün siparişlerin kargo, fatura ve iade adımlarını aynı yerden yürütmenizdir. eticaretcim'de ikas siparişleri diğer kanallarınızla aynı listeye Yeni, Hazırlanıyor, Faturalandı, Kargolandı ve Teslim aşamalarıyla düşer.
- Sipariş ikas sitenizde oluşur ve listeye Yeni olarak düşer; stok bütün kanallarda azalır.
- Otomatik onay açıksa sipariş Hazırlanıyor aşamasına geçer; geciken siparişler için uyarı alırsınız.
- Siparişe e-Arşiv ya da e-Fatura kesilir; birden fazla siparişi toplu da faturalayabilirsiniz.
- Kendi kargo sözleşmenizle etiket basılır, takip numarası siparişe işlenir.
- İade ya da değişiklik talebi gelirse iade ve talepler kutusundan yönetilir.
Sipariş aşamalarının ayrıntısı sipariş yönetimi, fatura tarafı ise e-Fatura ve e-Arşiv entegrasyonu sayfasında yer alıyor.
ikas pazaryeri entegrasyonunda sık yapılan hatalar
Senkron sorunlarının çoğu yazılımdan değil, başlangıçtaki veri düzeninden kaynaklanır. Senkronu açmadan önce şu listeyi gözden geçirin:
- Aynı stoğu iki ayrı sistemin güncellemesi: ikas'ın kendi pazaryeri uygulaması ile başka bir panel aynı ilanın stoğunu birlikte yönetirse miktarlar birbirini ezer. Her kanal için tek bir yönetici sistem seçin.
- Boş ya da tekrar eden SKU: iki varyant aynı kodu taşıyorsa eşleşme yanlış ürüne gider.
- Sayım yapılmadan bağlanmak: ikas'taki stok güncel değilse yanlış miktar bütün kanallara yayılır.
- Eşleşme listesini incelemeden onaylamak: önerilen eşleşmelerde varyant sayısının ve barkodların iki tarafta tuttuğunu kontrol edin.
- Kanal fiyat farkını komisyonsuz hesaplamak: pazaryerinde satış görünür ama kâr düşer.
Birden fazla kanalda aynı ürünü satarken stok eksiye düşmesin diye hazırladığımız aşırı satışı önleme kontrol listesi bu konuyu daha ayrıntılı ele alıyor.
ikas entegrasyonu fiyatı: hangi paket gerekir?
eticaretcim'de ikas siteniz de bir satış kanalı sayılır. Başlangıç paketindeki tek kanal Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, PttAVM ve idefix arasından seçildiği için ikas bu pakette yer almaz; ikas bağlantısı için en az Büyüme paketi gerekir. Büyüme paketinde 80 kanaldan herhangi üçünü seçebildiğiniz için ikas siteniz ve iki pazaryeri bu pakete sığar.
- Büyüme (aylık ₺999): 80 kanaldan herhangi 3'ü, 5.000 ürün, aylık 500 sipariş, 1 kargo firması, sınırsız tedarikçi XML
- Profesyonel (aylık ₺1.999): 28 kanal arasından 5'i, 10.000 ürün, aylık 2.000 sipariş, 2 kargo firması, 1 e-fatura programı
- Kurumsal (aylık ₺3.999): sınırsız kanal, 25.000 ürün, aylık 5.000 sipariş, 5 kargo firması, 3 e-fatura programı
Siparişe otomatik e-Arşiv/e-Fatura kesmek istiyorsanız e-fatura programı bağlantısının Profesyonel paketle başladığını hesaba katın. Profesyonel paketin beş kanalı 28 kanallık bir listeden seçildiği için ikas'ı bu pakette kullanacaksanız listeyi de kontrol edin. Yıllık ödemede %20 indirim uygulanır. Bütün limitleri fiyatlar sayfasında karşılaştırabilir, 3 günlük ücretsiz denemeyle kendi ikas ürünlerinizi bağlayıp eşleşme sonucunu görebilirsiniz.
- ikas Builders – Admin API: Authorization
- ikas Builders – Rate Limits and Blocking Rules
- ikas Builders – Private App (Özel Uygulama oluşturma)
- ikas Builders – Private App Authentication (token süresi)
- ikas Admin API v1 – kapsamlar (scopes)
- ikas – Pazaryeri Entegrasyonları
- ikas Destek – Varyantlı Ürün Oluşturma ve Düzenleme
- ikas Destek – Siparişler
Son kontrol: · Bilgiler resmî kaynaklardan derlendi · Hazırlayan: eticaretcim ekibi
