VibeFox SMSA Express for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerine kurulmayı reddeder.

SMSA Express tarifesi: fiyat tablosundaki fiyatlar SMSA hesabınızdan veya SMSA satış ekibinden gelir. Bunları mağazanızın varsayılan para biriminde girin. Tarifeniz SAR, AED veya başka bir para birimindeyse, önce dönüştürün.

SMSA passKey (yalnızca anlık tarifeler için): anlık tarifeler SMSA web servisini (SECOM, getShipCharges işlemi) kullanır. SMSA passKey'i talep üzerine verir: SMSA hesap yöneticinizden isteyin ya da info@smsaexpress.com adresine yazıp hesap numaranızı belirterek SMSA web servisine erişim isteyin. passKey, SMSA e-ticaret portalının API anahtarından farklı olabilir. Bu servis için SMSA'nın test (sandbox) sunucusu yoktur.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

1. Back office'te Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox SMSA Express modülünü bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı yapılandırma sayfasının üstündeki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. SMSA Express fiyatlarınızı fiyat tablosuna girin ve Save düğmesine tıklayın.

5. İsteğe bağlı: Live rates (API) bölümünde Live charges seçeneğini açın, SMSA passKey'inizi, gönderim şehrini ve ülkesini girin; mağazanızın varsayılan para birimi SAR değilse döviz kurunu da girin.

Kurulumda modül, SMSA Express courier teslimat süresi metniyle SMSA Express taşıyıcısını oluşturur. Taşıyıcı tüm bölgelere ve tüm müşteri gruplarına atanır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers üzerinden değiştirebilirsiniz. Fiyatları orada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox SMSA Express > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbellekteki SMSA ücretlerini de temizler. Sayı olmayan bir değer, negatif bir sayı, 0 değerinde bir döviz kuru, 3 harften oluşmayan bir para birimi kodu veya Maximum weight değerinden büyük bir Minimum weight hata ile reddedilir ve düzeltene kadar hiçbir şey kaydedilmez.

Anlık tarifeler açıkken, ayarların üstündeki uyarılar eksik bir passKey, gönderim şehri ya da döviz kuru veya boş bir fiyat tablosu hakkında sizi bilgilendirir. Modül mağaza ağırlık birimini tanımıyorsa (bu durumda ürün ağırlıkları kg olarak okunur) da uyarı görünür. kg, g, lb veya oz birimini International > Localization bölümünde (Local units) ayarlayın.

Genel

Enable SMSA Express: taşıyıcıyı tüm bölgelerde aynı anda açar veya kapatır. Bu, Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır.

Method title: sepette ve ödeme sayfasında gösterilen taşıyıcı adı. Varsayılan: SMSA Express. Zorunlu, en fazla 64 karakter.

Tax: taşıyıcının vergi kuralı ya da No tax. Fiyatlarınız (tablo ve SMSA ücretleri) zaten vergi içeriyorsa, örneğin Suudi KDV, No tax seçin.

Anlık tarifeler (API) (isteğe bağlı; SMSA ücret döndürmezse fiyat tablosu kullanılır)

Live charges: SMSA Express'ten kargo ücretini alır. Varsayılan: kapalı.

SMSA passKey: SMSA web servisinin (SECOM) anahtarı. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı anahtarı silmek için Remove the saved passKey kutusunu işaretleyin. Günlükte "Invalid Passkey" görünüyorsa, bu servis anahtarı kabul etmiyor demektir. SMSA'dan web servisi için bir passKey isteyin.

Ship-from city: paketlerinizin gönderildiği şehir; SMSA'nın yazdığı biçimde yazılır, örneğin Riyadh, Jeddah veya Dammam. Mağaza şehrini Shop Parameters > Contact > Stores bölümünden kullanmak için boş bırakın.

Ship-from country: paketlerinizin gönderildiği ülke. Varsayılan olarak mağazanızın ülkesidir.

Shipment type: SMSA'ya gönderim tipi olarak iletilir. DLV (varsayılan) standart teslimattır. Yalnızca SMSA size başka bir kod verdiyse değiştirin.

Currency of SMSA charges: SMSA her ücreti para birimi koduyla birlikte döndürür, genellikle SAR (varsayılan). Bu para birimi ya da mağazanızın varsayılan para birimi dışındaki bir ücret kullanılmaz.

Exchange rate: SMSA para biriminin 1 birimi için mağazanızın varsayılan para birimindeki fiyat, örneğin 0.27. İki para birimi aynıysa gerekmez. Bu olmadan, başka para birimindeki ücretler kullanılmaz ve fiyat tablosu uygulanır. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Fiyatlar (SMSA Express tarifeniz, mağazanızın varsayılan para biriminde; anlık tarifeler kapalıyken kullanılır ve SMSA ücret döndürmediğinde yedek olarak devreye girer)

Price table: her hedef ülke için bir satır. Satır eklemek için Add country düğmesine, satır silmek için çöp kutusu simgesine tıklayın. * Default (all other countries) satırı, kendi satırı olmayan ülkelere uygulanır. Her satırda bir temel fiyat ve ağırlık sütunları vardır: XS 1 kg'a kadar, S 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar ve XL 5 kg'ın üzerinde. Boş veya 0 olan bir ağırlık sütunu temel fiyatı kullanır. Temel fiyat 0 ise kargo ücretsizdir. Hiçbir fiyatı olmayan satırlar kaydedilmez. Bir ülkenin iki satırı varsa ilki kullanılır. Hem "9.99" hem "9,99" kabul edilir.

Price for countries not in the table: tabloda hedef ülke için satır yoksa (ve * satırı da yoksa) ya da satırın bu ağırlık için fiyatı yoksa kullanılır. Bu durumda taşıyıcıyı gizlemek için boş bırakın.

Price applies: fiyatın nasıl hesaplandığı.

Ürün ağırlıkları, mağaza ağırlık biriminizden kilograma çevrilir.

Koşullar

Minimum weight: sepet bundan hafifse taşıyıcıyı gizler; kg cinsinden. 0 sınır olmadığı anlamına gelir.

Maximum weight: sepet bundan ağırsa taşıyıcıyı gizler; kg cinsinden. Varsayılan: 30. 0 veya boş alan sınır olmadığı anlamına gelir.

Minimum order amount: taşıyıcıyı yalnızca sepet ara toplamı (indirimlerden sonra, vergi öncesi) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: SMSA Express kargosunun ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergi öncesi). Sepet bu tutara ulaştığında fiyat 0 olur ve SMSA'ya istek gönderilmez. Ücretsiz kargoyu hiç sunmamak için boş bırakın.

Bölgeler olmadan kullanılabilirlik

Normalde taşıyıcı, Shipping > Carriers bölümünde atandığı bölgelerde sunulur.

Ignore shipping zones: SMSA Express'i, hangi bölge eşleşirse eşleşsin, aşağıdaki ülkeler için sunar. Bu açıkken taşıyıcı, sonradan oluşturulanlar dahil tüm bölgelere eklenir. Kapatmak, bu şekilde eklenen bölgeleri yeniden kaldırır.

Countries: bu mod için hedef ülkeler. Mağazanın tüm etkin ülkelerini kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını modül klasöründeki logs/vfd_smsa_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Müşteri adresleri ve anahtarlar kaydedilmez. Anlık tarife hataları, bu seçenek kapalı olsa bile her zaman kaydedilir. İşiniz bittiğinde günlüğü kapatın.

Log: hata ayıklama günlüğünün boyutunu ve en son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken modülü kaldırmak SMSA Express ayarlarını, taşıyıcıyı ve günlüğü siler. Kapalıyken yeniden kurulum için her şey saklanır. Önbellekteki ücretler her zaman silinir.

Ödeme sırasında nasıl çalışır

Kargo adımında PrestaShop, modülden SMSA Express fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül önce koşulları kontrol eder: Ignore shipping zones ülkeleri (açıksa), sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0 olur ve SMSA'ya istek gönderilmez.

Anlık tarifeler açıkken modül SMSA'ya gönderim şehrinizi ve ülkenizi, müşterinin şehrini ve ülkesini, gönderim tipini, paketin kg cinsinden ağırlığını ve 0 değerinde bir kapıda ödeme tutarını gönderir. SMSA ücreti ve para birimini yanıtlar. Modül bunu mağazanızın varsayılan para birimine çevirir; fiyat daha sonra müşterinin sepet para biriminde gösterilir. Anlık tarife, müşteri şehir içeren bir teslimat adresi girdikten sonra istenir.

Her ücret bir saat önbellekte tutulur, böylece aynı sepet yeni bir istek oluşturmaz. Başarısız bir istek 5 dakika önbellekte tutulur. Zaman aşımı veya sunucu hatasından sonra SMSA 2 dakika boyunca tekrar sorgulanmaz. Reddedilen bir anahtardan sonra 5 dakika boyunca sorgulanmaz. Böylece ödeme sayfası her yenilemede çalışmayan bir servisi beklemez. İstek zaman aşımı 12 saniyedir.

SMSA kullanılabilir bir ücret döndürmediğinde (passKey yok, henüz şehir girilmemiş, ürün ağırlıkları eksik, geçersiz anahtar, zaman aşımı, hata, şehre hizmet yok ya da bilinmeyen para birimi), fiyat tablosu kullanılır. Tablo ve Price for countries not in the table fiyat vermezse taşıyıcı gizlenir. Müşteri hiçbir zaman hata görmez. Neden günlüğe yazılır.

Shipping > Carriers bölümünde taşıyıcının siparişleri olduktan sonra onu düzenlerseniz, PrestaShop bunu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca kargo ücretini hesaplar. SMSA gönderisi oluşturmaz, AWB etiketi yazdırmaz, iade işlemi yapmaz ve paketleri takip etmez. Kapıda ödeme ve bu ödemenin ücreti anlık tarifeye dahil değildir. SMSA perakende noktası seçici yoktur: taşıyıcı kapıya teslimattır.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox SMSA Express lisans bloğu, Modules > Module Manager > VibeFox SMSA Express > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blokta anahtar maskeli olarak, durum (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeler görünür: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-smsa-express satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip personel değiştirebilir. Bloğun metinleri back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan SMSA Express taşıyıcısı ödeme sırasında müşterilere gösterilmez ve ücret hesaplanmaz. PrestaShop vitrini back office'e giriş yaptığınızı bilmez, bu yüzden taşıyıcı sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sırasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, back office'te çalıştığınız sürece otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

SMSA Express ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable SMSA Express seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşteri grubunu kapsadığını kontrol edin (ya da Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Ülkenin ya da * satırının bir fiyatı olduğunu, ya da Price for countries not in the table değerinin ayarlandığını doğrulayın. Ayrıca ürünler, ürün sayfasında belirli taşıyıcılarla sınırlanmış olabilir.

Müşteriler SMSA ücreti yerine tablo fiyatını görüyor: SMSA müşterinin şehrine ihtiyaç duyar; bu girilene kadar tablo fiyatı gösterilir. Tablo, SMSA yanıt vermediğinde, anahtarı ya da şehri reddettiğinde ya da ücreti döviz kuru olmayan bir para biriminde döndürdüğünde de kullanılır. Nedeni modül sayfasındaki Log alanında görebilirsiniz.

Günlükte "Invalid Passkey": anahtar SMSA web servisi tarafından kabul edilmiyor. SMSA'dan web servisi için bir passKey isteyin.

Müşterinin şehri kabul edilmiyor: SMSA kendi şehir yazımını bekler. Teslimat adresindeki şehri ve Ship-from city alanını kontrol edin.

Ayarlar kaydedilmiyor ve bir hata görünüyor: bir sayı alanı metin ya da negatif bir değer içeriyor, döviz kuru 0, para birimi kodu 3 harften oluşmuyor veya Minimum weight değeri Maximum weight değerinden büyük. Mesajda belirtilen değeri düzeltin ve yeniden Save düğmesine tıklayın.

Kargo üzerinden vergi iki kez alınıyor: tarifeniz ya da SMSA ücretleri KDV'yi zaten içeriyor olabilir. Tax ayarını No tax olarak değiştirin.

Bir değişiklikten sonra ücretler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbellekteki SMSA ücretlerini temizler.

Sayfa SMSA Express taşıyıcısının bulunamadığını söylüyor: taşıyıcı Shipping > Carriers bölümünde silinmiş. Yeniden oluşturmak için Modules > Module Manager bölümünde modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox SMSA Express yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbellekteki ücretler her zaman silinir. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak ya da Reset yapmak, taşıyıcıya önceki durumunu geri verir.

SMSA Express, ilgili sahibinin ticari markasıdır. Bu modül SMSA Express ile bağlantılı değildir ve SMSA Express tarafından onaylanmamıştır.