# E-ticaret Bağlantısı

Siparişleri, iadeleri, üye izinlerini ve katalog değişimlerini mağazanın kendi sisteminden okuma
Kaynak: https://selwise.com/docs/integration/commerce-connection

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ı](/docs/channels/channel-settings#e-ticaret-platformu). 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](/docs/api-reference/orders-api) ve [İzin Senkronizasyonu](/docs/integration/consent) 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](/docs/customers/iys).

## 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](/docs/data-import/overview) 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](/docs/data-import/validate-and-apply). 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](/docs/product-feeds/language-feeds). 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 |