ShopPHP bağlantısı, mağazanızda oluşturacağınız bir REST API kullanıcısıyla kurulur. Bu entegrasyon ürün ve varyant gönderme, fiyat/stok senkronizasyonu ile sipariş çekmeyi kapsar ve Pazaryeri Ayarları sayfasında beta olarak işaretlidir.
Ön koşullar
- Aktif bir ShopPHP mağazanız ve yönetim paneline erişiminiz olmalı.
- Panelde REST API kullanıcısı oluşturma ve bayi grubu düzenleme yetkiniz olmalı.
Adım adım
- Entegrasyonlar → Pazaryeri Ayarları sayfasını açın, E-Ticaret Yazılımları sekmesindeki ShopPHP kartında Entegrasyonu Kur butonuna tıklayın.
- Sayfadaki Kurulum Adımları bölümünü açın ve yönergeleri ShopPHP panelinizde uygulayın: REST API bölümünde yeni bir kullanıcı oluşturun.
- Oluşturduğunuz kullanıcıyı bir bayi grubuna atayın.
- Bayi grubunun "Rest API kullanabilir" iznini açın. Bu izin olmadan bağlantı kurulamaz.
- Panelde IP kısıtı tanımlıysa Pazarus'un çıkış adresini listeye ekleyin; kısıt yoksa bu adımı atlayın.
- Pazarus'a dönüp ShopPHP Bağlantı Bilgileri bölümünü doldurun: Mağaza URL'i alanına mağazanızın tam adresini sonunda eğik çizgi olmadan yazın, REST API Email alanına API kullanıcısının e-posta adresini, REST API Şifresi alanına şifresini girin.
- Senkronizasyon Ayarları bölümünde Entegrasyon Aktif anahtarını açık bırakın ve Siparişleri Otomatik Çek anahtarını açın; açıkken günlük yeni siparişler arka planda çekilir.
- Görsel Gönderme Stratejisi alanında URL Bağlantısı (önerilen) seçili kalsın. Mağazanız Pazarus'taki görsel adreslerine erişemiyorsa Base64 Encoded seçeneğine geçin.
- Sağ üstteki Kaydet butonuna basın. Şifre alanı zorunludur ve her sayfa açılışında boş gelir; kaydettiğiniz her seferde şifreyi yeniden girmeniz gerekir.
- Sağ üstteki Bağlantıyı Test Et ve Şimdi Sipariş Çek butonları bu entegrasyonda henüz gerçek bir işlem başlatmaz: test butonu bilgilerinizi doğrulamadan "Bağlantı Başarılı" bildirimi verir, sipariş butonu ise bir çekim tetiklemez. Bildirimleri bağlantınızın çalıştığının kanıtı olarak görmeyin; sipariş aktarımı Siparişleri Otomatik Çek anahtarı üzerinden arka planda yürür.
Sık karşılaşılan sorunlar
- Belirti: "Önce Bilgileri Kaydedin" uyarısı alıyorsunuz. Çözüm: Bağlantı testi ve sipariş çekme kayıtlı ayar üzerinde çalışır; alanları doldurup Kaydet deyin, sonra tekrar deneyin.
- Belirti: Mağaza URL'i kabul edilmiyor. Çözüm: Adresi https ile birlikte ve sonunda eğik çizgi olmadan yazın.
- Belirti: Ürün görselleri mağazaya gitmiyor. Çözüm: Sunucunuz dış adreslere erişemiyor olabilir; Görsel Gönderme Stratejisi alanını Base64 Encoded yapıp yeniden deneyin.
- Belirti: Siparişleriniz panele düşmüyor. Çözüm: Entegrasyon Aktif ve Siparişleri Otomatik Çek anahtarlarının açık ve kaydedilmiş olduğundan emin olun. Sorun sürerse API kullanıcısının bayi grubunda "Rest API kullanabilir" izninin açık olduğunu ve IP kısıtı varsa Pazarus adresinin listeye eklendiğini kontrol edin.
İpuçları
- API şifresi panelde tekrar gösterilmez; alan her açılışta boş gelir ve zorunlu olduğu için ayarları her kaydedişinizde şifreyi yeniden yazmanız gerekir.
- Sayfanın üstündeki Desteklenen Özellikler bölümü kapsamı özetler: Ürün Push, Varyant, Fiyat/Stok, Sipariş Çekme ve Durum Bildirimi.
- Entegrasyonu kaldırmak için Tehlikeli Bölge → Entegrasyonu Tamamen Kaldır seçeneğini kullanın; ürünleriniz korunur.
