Ticimax

Bu rehberde: Ticimax mağazanızı alan adı ve web servis yetki kodu ile bağlarsınız. OrqLabs yeni siparişleri 5 dakikada bir kontrol eder; her yeni sipariş bir iş akışı başlatır (teşekkür mesajı, değerlendirme isteği, WhatsApp takibi). Akış içinden son siparişleri de listeleyebilirsiniz.

⏱ 10 dakika

Kimlik kartı#

Ne işe yarar?#

Tetikleyici: Order created – kontrol sırasında son görülen sipariş numarasından daha yeni bir sipariş bulunduğunda. Akış şu alanlarla başlar:

orderId (Ticimax sipariş ID'si), orderNumber, status (sipariş durumu metni), statusCode (Ticimax durum kodu: 0 onay bekliyor, 2 ödeme bekliyor, 3 paketleniyor, 5 kargoya verildi, 6 teslim edildi, 7 iptal …), total, currency, buyerName, buyerEmail, buyerPhone (teslimat adresindeki telefon, +90…), city, district, items (name, quantity, price, sku), productName (ilk ürün), customerId, createdAt (Türkiye saati, +03:00), raw.

Ticimax kutusunun işlemi:

Ön koşullar#

• Ticimax mağazanızda web servis erişimi (yönetim panelinde web servis ayarları) ve bir yetki kodu.
• Mağazanızın alan adı (https://www.magazam.com).
• Web servis ayarlarında IP kısıtlaması kullanıyorsanız OrqLabs sunucularının çıkış adresine izin verilmesi gerekir; adres için destek ekibimize yazın.

Adım adım kurulum#

A) Ticimax'ta web servis yetki kodu#

1. Ticimax yönetim panelinde Ayarlar → Web Servis (Web Servis Ayarları) sayfasını açın.
2. Mevcut bir yetki kodu varsa kopyalayın; yoksa yeni bir kod oluşturun ve sipariş servisi erişimini açın.
3. Kodu yalnızca OrqLabs için kullanın; kod mağazanızın sipariş ve müşteri verilerine erişim verir.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → Ticimax → Bağla → Proje seçin.
2. Mağaza alan adı: https://www.magazam.com (yalnızca alan adı; /admin gibi yollar yok sayılır).
3. Web servis yetki kodu → Bağla. Bağlantı testi son siparişi okur.

C) İş akışında tetikleyici#

Entegrasyon olayı kutusunda Ticimax hesabınızı ve TICIMAX · Order created olayını seçip iş akışını etkinleştirin. Kontrol yalnızca etkin bir iş akışı bu olayı dinlerken çalışır.

Örnek iş akışları#

1) Sipariş sonrası WhatsApp teşekkürü#

1. Entegrasyon olayı – TICIMAX · Order created.
2. Eğer – {{ $json.statusCode }} 7'den (iptal) farklı.
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ı (TICIMAX · Order created) → Bekle (10 gün) → E-posta gönder ("Siparişinizi nasıl buldunuz?" + ürün sayfası bağlantısı).

3) Günlük sipariş özeti#

Zamanlama tetikleyicisi (her gün 09:00) → Ticimax → List orders (Placed after: dünün tarihi) → Metin üret (özet) → Ekibe bildir veya Slack/Telegram mesajı.

İ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 (İYS kutusunun Query consent işlemiyle akışta kontrol edebilirsiniz).

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

• OrqLabs 5 dakikada bir SelectSiparis ile siparişleri ID'ye göre azalan sırada okur. İlk kontrol yalnızca son sipariş numarasını başlangıç noktası olarak kaydeder; bağlamadan önceki siparişler akış başlatmaz.
• Sonraki kontrollerde başlangıç noktasından yeni siparişler eskiden yeniye sırayla akış başlatır. Bir kontrolde en fazla 200 yeni sipariş işlenir; daha fazlası bir sonraki kontrole kalır.
• Tüm sayısal filtreler -1 ("filtreleme yok") olarak gönderilir; servisin alan sırası ve ad alanları mağazanızın WSDL'inden (?singleWsdl) okunur.
• Siparişin daha sonraki durum değişiklikleri (kargoya verildi, teslim edildi) yeni olay üretmez.

Limitler#

Kimlik bilgilerini yenileme#

Ticimax'ta yetki kodunu değiştirirseniz OrqLabs'ta ayrıntı panelinden Kimlik bilgileri → Güncelle ile yenisini girin; aksi hâlde kontroller AUTH hatasıyla durur.

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

Sonraki adım#

• ikas
• Shopier
• Entegrasyonlara genel bakış