VibeFox SMSA Express for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

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 ücretler için): anlık ücretler SMSA web servisini kullanır (SECOM, getShipCharges işlemi). SMSA passKey'i talep üzerine verir: SMSA hesap yöneticinizden isteyin ya da info@smsaexpress.com adresine yazın. passKey, SMSA e-ticaret portalının API anahtarından farklı olabilir. SMSA bu hizmet için test (sandbox) sunucusu sağlamaz.

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

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi vfd_smsa_express-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_smsa_express.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_smsa_express-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu yüzden Extensions > Modifications sayfasını yenilemeniz gerekmez. Installer yerine bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox SMSA Express eklentisini bulun ve Install düğmesine tıklayın (yeşil + düğmesi).

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgesi) tıklayın.

4. VibeFox lisans anahtarınızı, Edit sayfasının en üstündeki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

5. Fiyat tablosuna SMSA Express fiyatlarınızı girin.

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

7. Enable SMSA Express seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_smsa_express.ocmod.zip dosyasını seçin. Dosyayı yeniden adlandırmayın: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox SMSA Express eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4 ila 7. adımlardaki gibi girin. Ayarlar sayfası ve alanları her iki sürümde de aynıdır.

Kurulumdan sonra yöntem, Enable SMSA Express seçeneğini açıp kaydedene kadar kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız SMSA Express ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox SMSA Express > Edit. Bölümler solda listelenir. Tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt ayrıca önbelleğe alınmış SMSA ücretlerini de temizler. Geçersiz bir yöntem başlığı, sayı olmayan bir değer, negatif bir sayı, 0 döviz kuru, 3 harfli olmayan bir para birimi kodu, tabloda hatalı bir fiyat, Maximum weight (kg) değerinden büyük bir Minimum weight (kg) veya tam sayı olmayan bir sıralama bir hatayla reddedilir ve düzeltene kadar hiçbir şey kaydedilmez. Ayarları yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar kaydedebilir.

Anlık ücretler açıkken, ayarların üstündeki uyarılar eksik bir passKey, gönderici şehri veya döviz kuru ya da boş bir fiyat tablosu hakkında sizi bilgilendirir. Mağazada kg ağırlık sınıfı yoksa ve varsayılan ağırlık birimi eklenti tarafından bilinmiyorsa da uyarı görünür (bu durumda ürün ağırlıkları kg olarak okunur). System > Localisation > Weight Classes bölümüne bir kg ağırlık sınıfı ekleyin.

Genel

Ayarlar tüm coğrafi bölgeler için geçerlidir. Yöntemi Conditions bölümünde bir coğrafi bölgeyle ya da Ignore shipping zones ile bir ülke listesiyle sınırlayabilirsiniz.

Enable SMSA Express: SMSA Express'i ödeme sayfasında gösterir veya gizler. Varsayılan: kapalı.

Method title: müşterinin sepette ve ödeme sayfasında gördüğü kargo yönteminin adı. Varsayılan: SMSA Express. Zorunlu, en fazla 64 karakter, şu karakterler olmadan: < > ; = # { }.

Sort order: SMSA Express'in ödeme sayfasındaki kargo yöntemleri arasındaki konumu. Bir tam sayı.

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

Live charges: SMSA Express'ten kargo ücreti alır. Kapalıyken ödeme sayfasında SMSA'ya hiçbir şey gönderilmez. Varsayılan: kapalı.

SMSA passKey: SMSA web servisinin (SECOM) anahtarı. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek için yeni bir değer girin. Silmek için Remove the saved passKey seçeneğini işaretleyin. Günlükte "Invalid Passkey" görünüyorsa bu anahtar bu serviste kabul edilmiyor demektir. SMSA'dan web servisi için bir passKey isteyin.

Ship-from city: paketlerinizin gönderildiği şehir; SMSA'nın yazdığı gibi yazılır, örneğin Riyadh, Jeddah veya Dammam. Anlık ücretler için zorunludur: OpenCart'ta mağaza şehri yoktur, bu yüzden mağaza adresinden asla alınmaz.

Ship-from country: paketlerinizin gönderildiği ülke. İlk seçenek olan Store country, System > Settings > Store > Local bölümünden mağazanızın ülkesini kullanır. Bu varsayılandır.

Shipment type: SMSA'ya gönderi türü 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'nın ücretleri döndürdüğü para biriminin 3 harfli kodu; genellikle SAR (varsayılan). Bu para biriminden ve mağazanızın varsayılan para biriminden farklı bir para birimindeki ücret kullanılmaz.

Exchange rate: SMSA para biriminin 1 biriminin mağazanızın varsayılan para biriminde fiyatı, örneğin 0.27. İki para birimi aynıysa gerekmez. Bu olmadan başka bir para birimindeki ücretler kullanılmaz ve fiyat tablosu uygulanır.

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

Price table: hedef ülke başına bir satır. Satır eklemek için Add country düğmesine tıklayın. * All other countries satırı, kendi satırı olmayan ülkeler için geçerlidir. Her satırda bir Base fiyatı ve ağırlık sütunları vardır: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg ve XL >5 kg. Boş veya 0 olan bir ağırlık sütunu temel fiyatı kullanır. 0 temel fiyatı ücretsiz kargo anlamına gelir. Hiçbir fiyatı olmayan satırlar kaydedilmez. Bir ülkenin iki satırı varsa ilki kullanılır. Hem "9.99" hem de "9,99" kabul edilir.

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

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

Ürün ağırlıkları OpenCart ağırlık sınıfından kilograma dönüştürülür.

Koşullar

Minimum weight (kg): sepet bundan hafifse yöntemi gizler. 0 sınır olmadığı anlamına gelir (varsayılan).

Maximum weight (kg): sepet bundan ağırsa yöntemi gizler. Varsayılan: 30. 0 veya boş bir alan sınır olmadığı anlamına gelir.

Minimum order amount: yöntemi yalnızca kargo gerektiren ürünlerin ara toplamı (kupondan sonra, vergi öncesi) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupondan sonra, vergi öncesi); bu tutardan itibaren SMSA Express kargosu ücretsizdir. Sepet bu tutara ulaştığında fiyat 0 olur ve SMSA'ya istek gönderilmez. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.

Tax class: kargo ücretinin vergi sınıfı veya No tax (varsayılan). Fiyatlarınız (tablo ve SMSA ücretleri) zaten vergi içeriyorsa, örneğin Suudi KDV'si, No tax seçin.

Geo zone: SMSA Express'i yalnızca bu coğrafi bölgedeki adresler için sunar. All zones (varsayılan) sınır olmadığı anlamına gelir. Ignore shipping zones açıkken kontrol edilmez. Coğrafi bölgeler System > Localisation > Geo Zones sayfasında yönetilir.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde yöntem, Conditions bölümünde seçilen coğrafi bölgenin adresleri için sunulur.

Ignore shipping zones: SMSA Express'i coğrafi bölgeden bağımsız olarak aşağıdaki ülkeler için sunar. Kapalıyken karar coğrafi bölge tarafından verilir ve ülke listesi kullanılmaz.

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

Gelişmiş

Debug log: kargo hesaplamalarını storage/logs/vfd_smsa_debug.log.php dosyasına kaydeder. Dosya web üzerinden okunamaz. Müşteri adresleri ve anahtarlar kaydedilmez. Anlık ücret hataları bu seçenek kapalı olsa bile her zaman kaydedilir. İşiniz bittiğinde günlüğü kapatın. Dosya 5 MB'a ulaştığında vfd_smsa_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log: hata ayıklama günlüğünün boyutunu ve en son girişlerini gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa eklentiyi kaldırmak SMSA Express ayarlarını ve hata ayıklama günlüğünü siler. Kapalıysa (varsayılan), ayarlar yeniden kurulum için saklanır. Önbelleğe alınmış ücretler her zaman kaldırılır.

İçe / Dışa Aktarma

Export: ayarları bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. passKey dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın; örneğin başka bir mağazada. Değerler normal bir kayıttaki gibi kontrol edilir. Kaydedilmiş passKey korunur.

Ödeme sayfasında nasıl çalışır

OpenCart kargo yöntemlerini gösterdiğinde, eklentiden SMSA Express fiyatını ister. Bir Geo zone ayarlıysa (ve Ignore shipping zones kapalıysa) ve adres bunun dışındaysa SMSA Express sunulmaz. Yalnızca Requires Shipping değeri Yes olan ürünler sayılır: diğer ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Eklenti ardından koşulları kontrol eder: Ignore shipping zones ülkeleri (açıksa), sepet ağırlığı ve minimum sipariş tutarı. Hediye sertifikaları, puanlar ve mağaza kredisi dikkate alınmaz. Ücretsiz kargo uygulanırsa fiyat 0 olur ve SMSA'ya istek gönderilmez.

Anlık ücretler açıkken eklenti SMSA'ya gönderici şehri ve ülkesini, müşterinin şehrini ve ülkesini, gönderi türünü, kg cinsinden paket ağırlığını ve 0 olan bir kapıda ödeme tutarını gönderir. SMSA ücreti ve para birimini yanıtlar. Eklenti bunu mağazanızın varsayılan para birimine çevirir ve ondalık basamaklarına yuvarlar. Fiyat daha sonra seçilen Tax class vergisiyle müşterinin para biriminde gösterilir. Anlık ücret, müşteri şehir içeren bir teslimat adresi girdikten sonra istenir.

Her ücret bir saat önbelleğe alınır, böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 5 dakika önbelleğe alınır. 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 başarısız bir hizmeti beklemez. İstek zaman aşımı 12 saniyedir.

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

Eklenti yalnızca kargo fiyatını hesaplar. SMSA gönderileri oluşturmaz, AWB etiketleri yazdırmaz, iadeleri yönetmez ve paketleri takip etmez. Kapıda ödeme ve bu ödemenin ücreti anlık ücrete dahil değildir. SMSA perakende noktası seçici yoktur: yöntem kapıya teslimattır. Siparişlere hiçbir şey eklemez: sipariş, diğer OpenCart kargo yöntemleri gibi yöntem başlığını ve kargo maliyetini gösterir.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinden SMSA Express'i seçer. Yöntem, OpenCart 3'teki gibi çalışır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox SMSA Express lisans bloğu, Extensions > Extensions > Shipping > VibeFox SMSA Express > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınızı) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: opencart-shipping-smsa-express satırı ile hesabınızda vibefox.net'i açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca bu eklenti için Modify yetkisi olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici 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 ya da hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa SMSA Express ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi mağazada (unlicensed — visible to admins only) işaretiyle yine görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu yüzden etkin anahtar olmadan yöntem herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard sayfasını veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman 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. Geo zone değerini (veya Ignore shipping zones açıksa Countries değerini), ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Ülkenin veya * değerinin bir fiyatı olup olmadığını ya da Price for countries not in the table değerinin ayarlı olup olmadığını kontrol edin. Ürünlerin Requires Shipping değerinin Yes olduğunu kontrol edin.

Müşteriler SMSA ücreti yerine tablo fiyatını görüyor: SMSA müşterinin şehrine ihtiyaç duyar, bu yüzden girilene kadar tablo fiyatı gösterilir. Tablo ayrıca SMSA yanıt vermediğinde, anahtarı veya şehri reddettiğinde ya da ücreti döviz kuru olmayan bir para biriminde döndürdüğünde de kullanılır. Nedeni görmek için eklenti sayfasındaki Log alanına bakın.

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 değerini kontrol edin.

Ayarlar kaydedilmiyor ve bir hata gösteriliyor: bir sayısal alan metin veya negatif bir değer içeriyor, döviz kuru 0, para birimi kodu 3 harfli değil veya Minimum weight (kg) değeri Maximum weight (kg) değerinden büyük. Mesajda belirtilen değeri düzeltin ve yeniden Save düğmesine tıklayın.

Kargoda vergi iki kez alınıyor: tarifeniz veya SMSA ücretleri KDV'yi zaten içeriyor olabilir. Tax class değerini No tax olarak ayarlayın.

Bir değişiklikten sonra tarifeler eski görünüyor: eklenti sayfasındaki Save düğmesine tıklayın. Bu, önbelleğe alınmış SMSA ücretlerini temizler.

Sayfada "Warning: You do not have permission to modify VibeFox SMSA Express!" yazıyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebilir. Gruba System > Users > User Groups bölümünde extension/shipping/vfd_smsa_express (OpenCart 3) veya extension/vfd_smsa_express/shipping/vfd_smsa_express (OpenCart 4) için değiştirme yetkisi verin.

Geliştiriciler için: SMSA web servisi adresi vfd_smsa_api_url ayarıyla değiştirilebilir (testler için); ayarlar sayfasında bunun bir alanı yoktur.

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox SMSA Express yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable SMSA Express, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Önbelleğe alınmış ücretler her zaman kaldırılır. Remove data on uninstall açıksa SMSA Express ayarları ve hata ayıklama günlüğü de silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Mevcut siparişler kargo yöntemini ve maliyetini korur.

OpenCart 4'te eklentinin dosyalarını da kaldırmak için, kaldırdıktan sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox SMSA Express yanındaki Uninstall düğmesine (turuncu − düğmesi) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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