Sedeus Bağlayıcı kurulum rehberi

Sedeus Bağlayıcı, Günlük Mağaza Raporu ve Döviz Kuruna Göre Fiyat Güncelleme modüllerinin mağazanıza ulaşmasını sağlayan ücretsiz eklentidir. WooCommerce'te bir WordPress eklentisi, OpenCart'ta bir modüldür. Kurulumu Sedeus ekibi yapar; bu rehber, bağlayıcıyı kendiniz kurmak ya da kurulumda ne yapıldığını görmek isteyenler içindir. Kurulum yaklaşık 10 dakika sürer.

Bağlayıcı kendiliğinden hiçbir şey yapmaz ve dışarıya istek göndermez. Yalnızca mağazanızda üretilen bağlantı anahtarıyla imzalanmış isteklere yanıt verir. Müşterilerinizin adını, e-postasını, telefonunu ve adresini döndürmez; rapor için sipariş numarası, tarih, tutar, durum, ürün adı, stok kodu ve stok bilgisi yeterlidir.

Başlamadan önce

• Etkin bir lisans. Modül, Hesabım › Entegrasyonlarım'da görünür.
• https:// ile açılan, herkese açık bir alan adında mağaza. IP adresi ya da yerel adres kabul edilmez.
• Mağazanın yönetim paneline eklenti (OpenCart'ta uzantı) yükleyebilen bir yönetici hesabı.
• Döviz modülü için mağazanın ana para birimi Türk lirası (TRY) olmalı.

Bağlayıcıyı indirin

Sürüm 1.0.0. Mağazanızın altyapısına uyan dosyayı indirin.

OpenCart 4 dosyasının adı sedeus_connector.ocmod.zip olarak kalmalı: OpenCart uzantının kodunu dosya adından okur. Tarayıcınız adın sonuna "(1)" eklediyse dosyayı yeniden adlandırın. OpenCart 2.x ile 4.0.0 ve 4.0.1 desteklenmez.

WooCommerce'e kurulum

1. WordPress yönetim paneli › Eklentiler › Yeni eklenti ekle › Eklenti yükle. sedeus-connector.zip dosyasını seçip Şimdi kur'a, sonra Etkinleştir'e basın.
2. WooCommerce › Sedeus Bağlayıcı sayfasını açın. Bağlantı anahtarı etkinleştirmede üretilir; "Bağlantı" kutusu işaretlidir.
3. Bağlantı adresi ve Bağlantı anahtarı alanlarına tıklayınca içerik seçilir; ikisini de kopyalayın.

Ayarlar › Kalıcı bağlantılar'da "Düz" seçiliyse bağlantı adresi çalışmaz; "Yazı adı" gibi bir yapı seçin. Bağlantı adresi /wp-json/sedeus-connector/v1/run ile biter.

OpenCart 3'e kurulum

1. Yönetim paneli › Extensions (Eklentiler) › Installer (Eklenti Yükleyici) › Upload. OpenCart 3 dosyasını seçin; yükleme bitince ilerleme çubuğu tamamlanır.
2. Extensions › Extensions › tür olarak Modules (Modüller) seçin. "Sedeus Bağlayıcı" satırında yeşil Install (+) düğmesine, sonra mavi Edit (kalem) düğmesine basın.
3. "Bağlantı" açık olmalı (kurulumda açıktır). Bağlantı adresi ve Bağlantı anahtarı'nı kopyalayın.
4. Sayfanın altındaki Sipariş durumları, günlük raporun hangi durumu nasıl sayacağını belirler. Varsayılanlar OpenCart'ın kurulumdaki durumlarıdır; kendi durumlarınızı eklediyseniz burada seçip Kaydet'e basın.

Bağlayıcı OpenCart 3'te modifikasyon (OCMOD) kullanmaz; Modifications sayfasında yenileme gerekmez. Bağlantı adresi sedeus_connector/run ile biter.

OpenCart 4'e kurulum

1. Yönetim paneli › Extensions (Eklentiler) › Installer (Eklenti Yükleyici) › Upload. OpenCart 4 dosyasını seçin. Listede "Sedeus Bağlayıcı" satırı çıkar; satırdaki yeşil Install düğmesine basın.
2. Extensions › Extensions › tür olarak Modules (Modüller) seçin. "Sedeus Bağlayıcı" satırında yeşil Install (+) düğmesine, sonra mavi Edit (kalem) düğmesine basın.
3. "Bağlantı" açık olmalı. Bağlantı adresi ve Bağlantı anahtarı'nı kopyalayın.
4. Sipariş durumları'nı OpenCart 3'teki gibi kontrol edip kaydedin.

Bağlantı adresi sedeus_connector.run ile biter.

Modüle bağlayın

1. Sedeus'ta Hesabım › Entegrasyonlarım › modül › Ayarlar'ı açın.
2. "Mağaza bağlantısı" bölümünde Mağaza altyapısı'nı seçin; bağlantı adresini ve bağlantı anahtarını yapıştırın.
3. Modülün öteki ayarlarını doldurup Kaydet'e basın.

Kayıttan sonra birkaç dakika içinde kurulum kontrolü çalışır. Durum sekmesinde "Mağaza bağlantısı" satırı mağazanızın adını, altyapı sürümünü ve bağlayıcı sürümünü gösterir.

Aynı mağazada iki modül kullanıyorsanız bağlayıcı bir kez kurulur; iki modülün ayarına da aynı adres ve anahtar yazılır.

Bağlantı anahtarı ve güvenlik

• Anahtar mağazanızda üretilir: 64 karakterlik rastgele bir değerdir. Sedeus'ta şifreli saklanır; kaydedildikten sonra Hesabım'da yalnızca son dört karakteri görünür.
• Yeni anahtar üretmek: Bağlayıcının ayar sayfasında "Anahtarı yenile" › Yeni anahtar üret. Eski anahtar hemen çalışmaz olur; yenisini Sedeus'taki bütün modül ayarlarına yazana kadar raporlar ve fiyat güncellemeleri durur.
• Bağlantıyı kapatmak: "Bağlantı" kapalıyken bütün istekler reddedilir; modüller rapor gönderemez ve fiyat yazamaz.
• Kaldırmak:
  • WooCommerce'te eklentiyi silmek bağlayıcının ayarlarını ve anahtarını siler.
  • OpenCart'ta modülü kaldırıp yeniden kurmak anahtarı değiştirmez.
  • İki altyapıda da ürünlere girdiğiniz döviz fiyatları silinmez.
• Saat: İmzalı istekler 5 dakika geçerlidir. Sunucunuzun saati 5 dakikadan fazla kaymışsa istekler reddedilir.

Güvenlik duvarı ve önbellek

• İstekler Sedeus'un sunucusundan gelir. Cloudflare'in bot koruması ("Bot Fight Mode" gibi) ya da bir güvenlik eklentisi bu istekleri engelleyebilir. Engelleniyorsa bağlantı adresinin yoluna izin veren bir kural ekleyin: WooCommerce'te /wp-json/sedeus-connector/, OpenCart'ta route=extension/…sedeus_connector içeren adresler.
• IP adresine göre izin vermeniz gerekiyorsa bize yazın.
• Tam sayfa önbelleği kullanıyorsanız bağlantı adresini önbellek dışında bırakın.
• Bakım modu ya da şifreli dizin (HTTP kimlik doğrulaması) açıkken istekler mağazaya ulaşmaz.

Sık karşılaşılan hatalar

Hatalar Hesabım › Entegrasyonlarım › modül › Durum sekmesinde olay olarak görünür.

"Bağlayıcı isteği reddetti"

• Bağlantı anahtarı modül ayarındakiyle aynı değil. Mağazada yeni anahtar üretildiyse yenisini modül ayarlarına yazın.
• Bağlayıcının ayar sayfasında "Bağlantı" kapalı.
• Sunucunuzun saati kaymış (bkz. Bağlantı anahtarı ve güvenlik).

"Bağlayıcı adresi bulunamadı (HTTP 404)"

• Eklenti kurulu değil ya da etkin değil. OpenCart'ta hem Installer'daki kurulum hem Modules'taki kurulum yapılmış olmalı.
• Adres eksik kopyalanmış. Bağlayıcının ayar sayfasındaki adresi olduğu gibi yapıştırın.
• WooCommerce'te kalıcı bağlantılar "Düz".

"Mağaza isteği engelledi (HTTP 403)" ya da "Mağazaya ulaşılamadı"

Güvenlik duvarı, bot koruması ya da güvenlik eklentisi isteği durduruyor. Güvenlik duvarı ve önbellek bölümüne bakın.

"Bağlayıcı adresi yönlendiriyor"

Adres, mağazanızın açıldığı adresle aynı değil (www ya da http farkı). Bağlayıcının ayar sayfasındaki adresi kullanın; mağaza http'den https'e yönlendiriyorsa adres https ile başlamalı.

"Mağaza para birimi" satırı hata veriyor

Döviz modülü yalnızca ana para birimi Türk lirası olan mağazalarda fiyat yazar.

Kurulumda takılırsanız bize yazın; bağlayıcıyı sizin için kuralım.