VibeFox SMSA Express for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

SMSA Express tarifesi: fiyat tablosundaki fiyatlar SMSA hesabınızdan ya da SMSA satış ekibinden gelir. Bunları mağaza para biriminizde girin. Tarifeniz SAR, AED veya başka bir para biriminde ise önce çevirin.

SMSA passKey (yalnızca canlı ücretler için): canlı ücretler SMSA web servisini (SECOM, getShipCharges işlemi) kullanır. SMSA passKey'i talep üzerine verir: SMSA hesap yöneticinize sorun veya info@smsaexpress.com adresine yazıp hesap numaranızla birlikte SMSA web servisine erişim isteyin. passKey, SMSA e-ticaret portalının API anahtarından farklı olabilir. SMSA bu servis için test (sandbox) sunucusu sunmaz.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_smsa_express klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox SMSA Express ya da Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üst kısmındaki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

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

6. İsteğe bağlı: Live rates (API) altında Live charges seçeneğini açın, SMSA passKey'inizi, gönderim şehrini ve ülkesini girin; mağaza para biriminiz SAR değilse döviz kurunu da girin.

7. VibeFox SMSA Express yöntemini WooCommerce > Settings > Shipping > Shipping zones altında bir kargo bölgesine ekleyin (örneğin "Suudi Arabistan") ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox SMSA Express. Tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): müşterilerin bu bölge için gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Ayarları her kaydettiğinizde önbelleğe alınmış SMSA ücretleri temizlenir. Canlı ücretler açıkken ayarların üstündeki uyarılar eksik passKey, gönderim şehri veya döviz kuru ya da boş fiyat tablosu hakkında bilgi verir.

Genel

Enable/Disable: yöntemi tüm bölgelerde aynı anda açar veya kapatır.

Method title: sepette ve ödeme sayfasında gösterilen kargo yöntemi adı. Bir bölge bunu değiştirebilir. Varsayılan: SMSA Express.

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

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

SMSA passKey: SMSA web servisinin anahtarı (SECOM). Günlükte "Invalid Passkey" görünürse bu servis anahtarı kabul etmiyor demektir. SMSA'dan bir web servisi passKey'i isteyin.

Ship-from city: paketlerinizin gönderildiği şehir; SMSA'nın yazdığı biçimde, örneğin Riyadh, Jeddah veya Dammam. WooCommerce > Settings > General altındaki mağaza şehrini 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 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 her ücreti para birimi koduyla, genellikle SAR (varsayılan) olarak döndürür. Bu para birimi veya mağaza para biriminiz dışındaki bir para birimindeki ücret kullanılmaz.

Exchange rate: SMSA para biriminin 1 biriminin mağaza para birimindeki fiyatı, örneğin 0.24. İ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ğaza para biriminde; canlı ücretler kapalıyken 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, satır silmek için çarpı işaretine tıklayın. * All other countries satırı kendi satırı olmayan ülkeler için geçerlidir. Her satırda temel fiyat ve ağırlık sütunları bulunur: 1 kg'a kadar XS, 2 kg'a kadar S, 3 kg'a kadar M, 5 kg'a kadar L ve 5 kg'ın üzeri XL. Boş veya 0 olan bir ağırlık sütunu temel fiyatı kullanır. Temel fiyat 0 ücretsiz kargo anlamına gelir. Hiçbir fiyatı olmayan satırlar kaydedildiğinde silinir. "9.99" ve "9,99" ikisi de 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 yöntemi 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 (kg): sepet bundan hafifse yöntemi gizler. 0 sınır yok anlamına gelir.

Maximum weight (kg): sepet bundan ağırsa yöntemi gizler. Varsayılan: 30. 0 sınır yok anlamına gelir.

Minimum order amount: yöntemi yalnızca sepet ara toplamı (indirimler sonrası, 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ı (indirimler sonrası, vergi öncesi). Ücretsiz kargo yalnızca yöntemin hedef için fiyatı olduğu yerlerde sunulur: bir SMSA ücreti, bir tablo satırı veya tabloda olmayan ülkeler için fiyat. Tabloda fiyat varsa SMSA'ya istek gönderilmez. Hiçbir zaman ücretsiz kargo sunulmaması için boş bırakın.

Excluded shipping classes: sepette bu WooCommerce kargo sınıflarından birinde yer alan bir ürün varsa yöntemi gizler.

Tax status: Taxable WooCommerce vergisini kargo maliyetine ekler, None eklemez. Fiyatlarınız (tablo ve SMSA ücretleri) vergiyi zaten içeriyorsa, örneğin Suudi KDV, None seçin.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: yöntem hiçbir kargo bölgesine eklenmemiş olsa bile aşağıdaki ülkeler için SMSA Express sunar.

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız tüm ülkeleri kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır. Bir kargo bölgesine eklenen yöntem her zaman o bölgenin ülkeleri için çalışır.

Gelişmiş

Debug log: her ücret hesaplamasını WooCommerce > Status > Logs altına, kaynak vfd_smsa_express ile kaydeder. Müşteri adresleri ve anahtarlar kaydedilmez. Canlı ücret hataları bu seçenek kapalı olsa bile her zaman kaydedilir. İşiniz bittiğinde günlüğü kapatın.

Remove data on uninstall: açıksa eklentiyi silmek tüm SMSA Express ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir fiyat ister. Eklenti önce koşulları kontrol eder: teslimat ülkesi, sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Ücretsiz kargo uygulanıyorsa ve hedefin bir fiyatı varsa yöntem 0 fiyatla gösterilir.

Canlı ücretler açıkken eklenti SMSA'ya gönderim şehrinizi ve ülkenizi, müşterinin şehrini ve ülkesini, gönderim türünü, kg cinsinden paket ağırlığını ve 0 kapıda ödeme tutarını gönderir. SMSA ücreti ve para birimini yanıtlar. Eklenti bunu mağaza para biriminize çevirir ve gösterir. Canlı ücret yalnızca müşteri bir şehir 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 sorulmaz. Reddedilen bir anahtardan sonra 5 dakika boyunca sorulmaz. Böylece ödeme sayfası her yenilemede arızalı bir servisi beklemez. İstek zaman aşımı 12 saniyedir.

SMSA kullanılabilir bir ücret döndürmediğinde (passKey yok, henüz şehir girilmedi, ürün ağırlıkları eksik, 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 fiyat vermezse yöntem gizlenir. Müşteri asla bir hata görmez. Neden günlüğe yazılır.

Yöntem klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur. Arapça çeviri dahildir.

Eklenti yalnızca kargo ücretini hesaplar. SMSA gönderileri oluşturmaz, AWB etiketleri yazdırmaz, iadeleri yönetmez veya paketleri takip etmez. Kapıda ödeme ve ücreti canlı ücrete dahil değildir. SMSA perakende noktası seçici yoktur: yöntem kapıya teslimattır.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox SMSA Express sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir, örneğin lisansın hangi tarihe kadar aktif olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Bunu vibefox.net hesabınızdan serbest bırakın.

Aktif bir anahtar olmadan SMSA Express ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri hâlâ görür; (unlicensed — visible to admins only) ibaresiyle işaretlenir. Böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

SMSA Express ödeme sayfasında görünmüyor: lisansın aktif olduğunu, Enable/Disable seçeneğinin açık olduğunu ve yöntemin müşterinin ülkesinin bölgesine eklendiğini kontrol edin (ya da Ignore shipping zones açık ve ülke izinli olmalı). Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını kontrol edin. Ülkenin veya *'nin bir fiyatı olduğunu ya da Price for countries not in the table ayarının yapıldığını doğrulayın.

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 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 kullanılır. Nedeni görmek için WooCommerce > Status > Logs sayfasını, kaynak vfd_smsa_express olarak açın.

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

Müşterinin şehri kabul edilmiyor: SMSA kendi şehir yazımını bekler. Geliştiriciler isteği, örneğin şehir adını, vfd_smsa_express_live_request_fields filtresiyle düzenleyebilir.

Kargoda vergi iki kez alınıyor: tarifeniz ya da SMSA ücretleri KDV'yi zaten içeriyor olabilir. Tax status değerini None olarak ayarlayın.

Bir değişiklikten sonra fiyatlar eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış SMSA ücretlerini temizler.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir hak serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri ve önbelleğe alınmış ücretler yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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