ikas

Bu rehberde: ikas mağazanızı bir özel uygulama (private app) ile bağlarsınız. Yeni sipariş ve yeni müşteri olayları iş akışı başlatır (teşekkür mesajı, değerlendirme isteği, hoş geldin e-postası); akış içinden sipariş ve ürün okuyabilirsiniz.

⏱ 15 dakika

Kimlik kartı#

Ne işe yarar?#

Tetikleyiciler:

ikas kutusunun işlemleri (hepsi okuma):

Ön koşullar#

• ikas mağazanızda sahip veya uygulama yönetme yetkisi olan bir hesap.
• Mağaza adınız: yönetim adresinizdeki magazam.myikas.com içindeki magazam kısmı.

Adım adım kurulum#

A) ikas'ta özel uygulama#

1. ikas yönetim panelinde sol menüden Uygulamalar → Uygulamalarım → Özel Uygulamalar'a Git.
2. Yeni bir özel uygulama oluşturun (ad: OrqLabs). İzin seçimi istenirse en az siparişleri okuma, müşterileri okuma, ürünleri okuma ve webhook izinlerini verin.
3. Oluşturulan client_id ve client_secret değerlerini kopyalayın. Client secret yalnızca bir kez gösterilir.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → ikas → Bağla → Proje seçin.
2. Mağaza adı: magazam (magazam.myikas.com veya tam adres de kabul edilir), Client ID, Client secret → Bağla.

OrqLabs bu bilgilerle 4 saat geçerli bir erişim anahtarı alır ve süresi dolunca yeniler. Bağlantı kurulunca store/order/created ve store/customer/created webhook'ları ikas'a (saveWebhook) otomatik kaydedilir. Kayıt başarısız olursa entegrasyon kartında Webhook kaydı başarısız: … uyarısı görünür; özel uygulamanın izinlerini kontrol edip entegrasyonu silerek yeniden bağlayın.

Örnek iş akışları#

1) Ödenen siparişe teşekkür mesajı#

1. Entegrasyon olayı – IKAS · Order created.
2. Eğer – {{ $json.paymentStatus }} eşittir PAID.
3. Metin üret – {{ $json.buyerName }} adlı müşterimize {{ $json.productName }} siparişi için kısa bir teşekkür mesajı yaz.
4. Mesaj gönder – WhatsApp, alıcı {{ $node["Entegrasyon olayı"].json.buyerPhone }}, onaylı sipariş şablonuyla; telefon yoksa E-posta gönder (buyerEmail).

2) Değerlendirme isteği#

Entegrasyon olayı (IKAS · Order created) → Bekle (7 gün) → ikas → Get order ({{ $json.orderId }}; sipariş iptal edildiyse Eğer ile durdurun) → E-posta gönder (değerlendirme bağlantısı).

3) Yeni müşteriye hoş geldin e-postası#

Entegrasyon olayı (IKAS · Customer created) → Aday oluştur (ad, e-posta, telefon) → Eğer ({{ $json.acceptsMarketing }} doğru) → E-posta gönder (hoş geldin + ilk sipariş indirim kodu).

İYS ve izin: Sipariş onayı, kargo ve teşekkür mesajları işlemseldir. İndirim kodu veya kampanya içeren mesajlar ticari elektronik ileti sayılır; Türkiye'de tüketicilere göndermeden önce alıcının onayı alınmış ve İYS'ye kaydedilmiş olmalıdır. ikas'taki acceptsMarketing / notificationsAccepted alanları mağazadaki izin işaretini gösterir; İYS kaydının yerini tutmaz (İYS kutusunun Query consent işlemiyle kontrol edin).

Tetikleyiciler nasıl çalışır?#

• ikas teslimatları { scope, merchantId, data, signature, … } biçiminde gelir; data sipariş veya müşteri kaydıdır.
• signature client secret ile doğrulanabiliyorsa (HMAC-SHA256) teslimattaki veri doğrudan kullanılır. Doğrulanamazsa OrqLabs teslimatı reddetmez; kaydı ikas API'sinden yeniden okur (listOrder / listCustomer) ve yalnızca API'nin döndürdüğü veriyi kullanır. Siparişlerde bu yolda yalnızca son 3 gün içinde verilmiş siparişler akış başlatır.
• ikas 200 alamazsa teslimatı 3 kez dener ve bırakır. Aynı sipariş/müşteri için tekrar gelen teslimatlar ikinci kez akış başlatmaz.

Limitler#

Bağlantıyı test etme#

Bağlantıyı test et erişim anahtarı alır ve sipariş sayısını okur; başarılıysa magazam.myikas.com görünür. Webhook'ları denemek için mağazanızda bir test siparişi verin veya müşteri hesabı açın, ardından iş akışının Çalıştırmalar sekmesine bakın.

Kimlik bilgilerini yenileme#

ikas'ta client secret'ı yenilerseniz OrqLabs'ta ayrıntı panelinden Kimlik bilgileri → Güncelle ile yenisini girin. Webhook aboneliklerini yenilemek için entegrasyonu silip yeniden bağlayın (silinirken abonelikler ikas'tan kaldırılır).

Sık karşılaşılan hatalar#

Sonraki adım#

• Ticimax
• Shopier
• Entegrasyonlara genel bakış