E-ticaret Bağlantısı

E-ticaret bağlantısı, Selwise'ın mağazanızın kendi sisteminden okuduğu bilgidir: tarayıcıda hiç görünmeyen siparişler (mağaza içi satış, çağrı merkezi), bir siparişin sonradan iptali ve iadesi, üyelerin e-posta ve SMS izinleri, fiyat ve stok değişimleri. Vitrine kurulan widget ziyaretçinin yaptığını ölçer; bağlantı, siparişin ve üyenin sonrasını tamamlar. Bu sayfa bağlantının ne okuduğunu, nasıl kurulduğunu ve neyi bilerek yapmadığını anlatır.

Panelde nerede

Sol menüde Ayarlar → Entegrasyonlar → Store connection (Settings → Integrations) (Mağaza bağlantısı). Ekran, seçili kanalın e-ticaret platformuna göre çizilir; platformu önce kanal ayarlarında seçin — bkz. Kanal Ayarları. Bağlantıyı kurmak ve değiştirmek admin rolünün yetkisidir (site:update); geçmiş aktarımını başlatmak Veri İçe Aktarma yetkisi ister.

Hangi platformlar

Platform	Bağlantı	Okunanlar
Akinon	Omnitron entegrasyon kullanıcısı (kullanıcı adı ve parola bir kez, anahtar alınır, parola saklanmaz)	Siparişler, iptal ve iadeler, mağaza içi satış; üyeler ve izinleri; fiyat listesi, stok ve kapatılan ürünler; geçmiş üyeler ve siparişler
IdeaSoft	Mağaza yönetiminde açtığınız API uygulamasının onayı (OAuth)	Siparişler ve durum değişimleri; geçmiş siparişler
Diğerleri (Ticimax, T-Soft, ikas, Shopify, özel)	Sunucu bağlantısı yok	Ekran, sipariş durumu ve izin uçlarının rehberini gösterir: kendi sisteminizden Sipariş API'si ve İzin Senkronizasyonu ile gönderirsiniz

Kurulum

1. Kanal ayarlarında E-commerce platform (E-ticaret platformu) alanından platformu seçin.
2. Bu ekranda platformun formunu doldurun ve Connect (Bağlan) düğmesine basın.
   • Akinon: Omnitron adresi, entegrasyon kullanıcısının adı ve parolası. Bağlandıktan sonra bu Selwise kanalının hangi satış kanalı olduğunu seçersiniz; pazaryeri kanalları listelenir ama seçilemez. Data Warehouse açık değilse siparişler kanalın sipariş listesinden okunur ve yalnız yeni siparişler gelir; sonraki durum değişimleri webhook'la gelir. Ekran hangisi olduğunu Orders read from (Siparişlerin okunduğu yer) satırında söyler.
   • IdeaSoft: mağaza adresi, istemci kimliği ve istemci sırrı. Düğme sizi IdeaSoft'a götürür, onay verip panele dönersiniz. IdeaSoft onayı belirli aralıklarla yenilenmelidir; ekran Approval renews by (Onayın yenileneceği tarih) satırında son tarihi gösterir.
3. Akinon webhook'u. Ekran bir webhook adresi ve bir imza sırrı gösterir; sır yalnızca bir kez gösterilir. Omnitron'da order.created ve order.updated olaylarını, Commerce'te user_registered ve user_updated olaylarını bu adrese yönlendirin. Webhook şart değildir: bağlantı her 15 dakikada bir okur; webhook değişikliği dakikalar yerine saniyeler içinde getirir.

Ne okunur, nasıl yazılır

Bağlantı okuduğunu canlı sipariş akışının aynı kurallarıyla yazar; ekranlarınızdaki her rakam tek bir defterden gelir.

• Yeni siparişler. Vitrin siparişi zaten bildirdiyse ikinci kez yazılmaz (sipariş numarası aynıdır). Vitrinin bildirmediği bir sipariş, verildiği andan 30 dakika sonra yazılır: vitrin sayfası gecikmeli bildirebilir ve ilk gelen ziyareti taşımalıdır. Sunucudan gelen sipariş hiçbir Selwise yüzeyine atfedilmez: bir ziyaretin içinde verildiği görülemez.
• Mağaza içi satış offline kaynağıyla yazılır; cirolarınızda görünür, hiçbir kampanyaya yazılmaz.
• Pazaryeri siparişleri (Trendyol, Hepsiburada, n11…) hiç yazılmaz: alıcı pazaryerinin müşterisidir ve vitrininize gelmemiştir.
• İptal ve iade siparişin durumunu ve iade tutarını günceller; iade, siparişin kayıtlı tutarını aşamaz. Ciro raporları iadeyi düşülmüş tutarla gösterir.
• Kupon kodları siparişin üzerine yazılır; indirim sinyalli segmentler bunları okur.
• Üyeler ve izinler. Bir üyenin e-posta ve SMS izni, mağazadaki karar tarihiyle yazılır; daha yeni bir geri çekme, daha eski bir onayla geri alınmaz. Mağaza bir izni kaldırdığında Selwise yalnızca kendisinde de var olan bir izni geri çeker.
• Fiyat, stok, kapatılan ürün (Akinon) bir sonraki besleme okumasını beklemeden ürüne yazılır; fiyatı düşen ya da stoğa giren ürün senaryoları dakikalar içinde tetiklenir. Ürünü bağlantı oluşturmaz: katalogda olmayan bir ürün beslemeyle gelir.

İYS

Akinon'da üye izinlerini İYS'ye mağazanın kendisi bildiriyorsa Selwise aynı izni ikinci kez bildirmez. Members and permissions (Üyeler ve izinler) akışının altındaki Akinon files these permissions with İYS itself anahtarı bunu söyler; varsayılanı açıktır. Mağazanız izinleri İYS'ye bildirmiyorsa kapatın; Selwise bildirir — bkz. İYS.

Akışlar ve durum

Her akışın (Orders, Members and permissions, Catalogue changes) kendi anahtarı ve satırı vardır: son okuma, yazılan, güncellenen ve atlanan sayıları. Bir akışı kapatmak ilerlemesini silmez; açtığınızda kaldığı yerden devam eder.

Ekrandaki durum	Anlamı
Connected (Bağlı)	Bağlantı çalışıyor
Waiting for approval (Onay bekleniyor)	IdeaSoft onayından dönülmedi
One more step (Bir adım kaldı)	Akinon satış kanalı seçilmedi
Off (Kapalı)	Bağlantı kapatıldı ya da platform kimlik bilgisini reddetti (parola değişti, onay geri alındı); ekrandaki cümle hangisi olduğunu söyler, yeniden bağlanın
Another platform (Başka platform)	Kanalın platformu bağlantı kurulduktan sonra değişti; hiçbir şey okunmaz

Geçmişi içe aktarma

Import the history (Geçmişi içe aktar) kartı, bağlantıdan önceki üyeleri ve siparişleri bir kez okur ve Veri İçe Aktarma hattına verir. Canlı akış bağlantı anından sonrasını getirir; ikisi çakışmaz.

• Siparişler için son 3, 6, 12 ya da 24 ayı seçersiniz; üyelerin süresi yoktur.
• Aktarılan siparişler geçmiştir: hiçbir kampanyaya atfedilmez, bir takip olayı üretmez, oluşturulma tarihi siparişin verildiği andır.
• Yalnız onaylar aktarılır, tarihi ve kaynağıyla (platform_sync); tarihsiz bir onay aktarılmaz. Platformdaki "izin yok" aktarılmaz: çoğu zaman hiç işaretlenmemiş bir kutudur ve aktarılmış bir geri çekme, kişinin sonradan vitrinde verdiği onayı da geçersiz kılardı. Güncel "hayır"lar canlı üye akışıyla gelir. Aktarılan izinler İYS'ye bildirilmez (geçmiş bir karardır).
• Siparişin bugüne kadarki iadesi de aktarılır: tamamı iade edilmiş sipariş ciro dışında kalır, kısmen iade edilmiş sipariş net değeriyle ciroya girer.
• İş arka planda çalışır ve kayıtları en çok 20.000'lik parçalar hâlinde Veri İçe Aktarma ekranına koyar. Her parça önce doğrulanır (en önemlisi ürün kodu eşleşme oranı); siz raporu görüp Apply (Uygula) düğmesine basana kadar hiçbir şey yazılmaz — bkz. Doğrulama ve Uygulama. Parçalar 24 saat saklanır; süresi geçen parça için aktarımı yeniden başlatın.
• Akinon'da geçmiş Data Warehouse'tan okunur; Data Warehouse'u olmayan projede kart bunu söyler ve geçmişi dosyayla aktarırsınız.

Bilerek yapılmayanlar

• Ürün çevirileri bağlantıdan yazılmaz. Bir dilin kelimeleri tek kaynaktan gelir: dil beslemesi ya da ana beslemenin dil sütunları — bkz. Dil Beslemeleri. Kelimeler fiyat ve stok gibi zamana karşı yarışmaz.
• Uygulamadan gelen iptal talebi siparişi iptal etmez. App Maker'da müşterinin iptal talebi bir olay olarak kaydedilir; siparişin durumu bu bağlantıdan, mağazanın kararıyla gelir.
• Selwise mağazanıza hiçbir şey yazmaz; bağlantı yalnızca okur.

Güvenlik

• Akinon parolası saklanmaz; yalnızca dönen anahtar şifreli tutulur. IdeaSoft token'ları şifreli tutulur. Hiçbir ekran ve API yanıtı bir sır döndürmez.
• Mağaza adresi yalnızca https olabilir ve özel ağ adreslerine çözülen bir adres reddedilir; bağlantı yönlendirme izlemez.
• Webhook gövdesi ham baytlar üzerinden HMAC ile doğrulanır; aynı olay iki kez gelirse bir kez işlenir.

Sorun giderme

Belirti	Neden
Bağlantı Off oldu	Platform kimlik bilgisini reddetti. Ekrandaki cümle hangisi olduğunu söyler; yeniden bağlanın
Mağaza içi satışlar kampanya raporlarında yok	Doğru: mağaza içi satış hiçbir yüzeye atfedilmez; cirolarınızda görünür
Pazaryeri siparişleri hiç görünmüyor	Doğru: pazaryeri siparişi yazılmaz
Yeni bir sipariş 30 dakika geç göründü	Vitrin bildirmediyse sunucu kopyası 30 dakika bekler
Fiyat değişimi gelmiyor	Seçilen Akinon satış kanalına bağlı bir fiyat listesi bulunamadıysa fiyat okunmaz; stok ve kapatılan ürünler yine gelir. Satış kanalını yeniden seçmek listeyi yeniden arar