VibeFox Aramex for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 – 9.x.

PHP: 8.0 veya üzeri. Modül daha eski PHP sürümlerinde kurulmaz.

Aramex hesabı (yalnızca anlık tarifeler için): anlık tarifeler Aramex Rate Calculator API'sini kullanır. Aramex, API erişimini hesap sahiplerine verir. Aramex hesap yöneticinize danışın veya Aramex web sitesindeki Aramex Developers Solution Center'a bakın. Altı değere ihtiyacınız var: API kullanıcı adı (genellikle bir e-posta adresi), şifre, hesap numarası, hesap PIN'i, birim kodu (entity, örneğin DXB) ve hesap ülke kodu (örneğin AE). Yalnızca ülkeye göre sabit fiyat kullanıyorsanız Aramex hesabına ihtiyacınız yoktur.

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

Kurulum

1. Yönetim panelinde Modules > Module Manager sayfasına gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Aramex modülünü bulup Configure düğmesine tıklayın.

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

4. Kargo ücretinin nasıl hesaplanacağını seçin, ilgili bölümleri doldurun (bkz. Yapılandırma) ve Save düğmesine tıklayın.

Kurulumda modül, teslimat süresi metni Courier delivery olan Aramex kargo firmasını oluşturur. Kargo firması 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. Orada fiyat tanımlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Aramex > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbellekteki Aramex tarifelerini de temizler.

Genel

Enable Aramex: kargo firmasını açar veya kapatır. Bu, Shipping > Carriers içindeki kargo firması durumuyla aynı anahtardır.

Method title: sepette ve ödeme sayfasında gösterilen kargo firması adı. Varsayılan: Aramex. Zorunlu.

Shipping cost: fiyatın nasıl hesaplanacağı.

Anlık tarifenin eksik olmasının nedeni hata ayıklama günlüğüne yazılır. Bu bilgi müşteriye asla gösterilmez.

Aramex API hesabı (yalnızca anlık tarifeler için gerekir; altı alanın tümü zorunludur)

Username: Aramex API kullanıcı adınız, genellikle bir e-posta adresi.

Password: Aramex API şifreniz. 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.

Account number: Aramex müşteri hesap numaranız.

Account PIN: Aramex hesabınızın PIN'i. Şifre gibi, kaydettikten sonra tekrar gösterilmez.

Account entity: Aramex hesabınızın birim (ofis) kodu, örneğin DXB, AMM veya RUH.

Account country code: Aramex hesabınızın 2 harfli ülke kodu, örneğin AE.

Aramex hizmeti (anlık tarifeler için kullanılır)

Teslimat adresi çıkış ülkesindeyse gönderi Domestic olarak teklif edilir. Diğer tüm gönderiler International express olarak teklif edilir.

International service: yurt dışı gönderiler için Aramex ürünü: PPX Priority Parcel Express (varsayılan), PDX Priority Document Express, PLX Priority Letter Express, DPX Value Express Parcels, EPX Economy Parcel Express, EDX Economy Document Express, GPX Ground Parcel Express veya GDX Ground Document Express.

Domestic service: çıkış ülkesi içindeki gönderiler için Aramex ürünü: ONP Overnight Parcel (varsayılan), OND Overnight Document, SMP Same Day Parcel, SMD Same Day Document, SDD Same Day Delivery, EMD Early Morning Delivery, PEC Economy Delivery, PEX Road Express veya HVY Heavy (20 kg ve üzeri).

Payment type: gönderi için Aramex'e kimin ödeme yaptığı: Prepaid (gönderici öder), Collect (alıcı öder) veya Third party (üçüncü taraf). Genellikle Prepaid.

API weight unit: Aramex'e gönderilen birim, KG veya LB. Ürün ağırlıkları ve boyutları mağaza birimlerinizden çevrilir. Faturalandırılabilir ağırlık, gerçek ağırlık ile hacimsel ağırlığın (uzunluk × genişlik × yükseklik cm cinsinden / 5000) büyüğüdür. En az değer 0,5 kg'dır; bu, ağırlığı olmayan ürünler için de geçerlidir.

Currency conversion rate: Aramex'ten fiyatı mağazanızın varsayılan para biriminde vermesi istenir. Aramex yine de başka bir para biriminde yanıt verirse tarife bu sayıyla çarpılır (Aramex para biriminin 1 birimi = mağaza varsayılan para biriminin X birimi). Bu tür teklifleri reddetmek için alanı boş bırakın; böylece müşteri hiçbir zaman yanlış para biriminde ücretlendirilmez.

Gönderim yeri (çıkış adresi) (anlık tarifeler için kullanılır)

Origin country: gönderim yaptığınız ülke. Varsayılan olarak mağazanızın ülkesidir.

Origin city: gönderim yaptığınız şehir. Aramex bunu zorunlu tutar.

Origin state / emirate: isteğe bağlı.

Origin postcode: isteğe bağlı.

Çıkış ülkesi mağazanızın ülkesiyse, boş alanlar Shop Parameters > Contact > Stores altındaki mağaza adresinden doldurulur.

Sabit fiyatlar (sabit modda ve anlık tarifeler için yedek olarak kullanılır)

Price per country: mağazanızın varsayılan para biriminde, vergi hariç, 2 harfli ülke kodları ve fiyatlardan oluşan bir tablo. Bir ülke eklemek için Add row'a, birini silmek için çöp kutusu simgesine tıklayın. Diğer tüm ülkeler için ülke kodu olarak * kullanın. Fiyatı olmayan ülkeler (* satırı yoksa) sabit tarife almaz, bu nedenle kargo firması bu ülkeler için gizlenir.

Fixed price applies: Per order fiyatı bir kez alır. Per item fiyatı sepetteki ürün sayısıyla çarpar. Aramex anlık tarifeleri her zaman gönderi başınadır.

Koşullar

Minimum weight: sepet daha az ağırlıktaysa kargo firmasını gizler (kg). 0 sınır olmadığı anlamına gelir.

Maximum weight: sepet daha fazla ağırlıktaysa kargo firmasını gizler (kg). Varsayılan: 100. 0 sınır olmadığı anlamına gelir.

Minimum order amount: kargo firmasını 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: aşağıdaki tutardan itibaren ücretsiz Aramex teslimatını açar.

Free shipping from: ücretsiz teslimatın başladığı sepet ara toplamı (indirimlerden sonra, vergi öncesi). Yalnızca Free shipping açıkken kullanılır.

Tax: kargo firmasının vergi kuralı veya No tax. Aramex anlık tarifeleri KDV içerebilir. Bu durumda, vergiyi iki kez almamak için No tax seçin.

Countries: Aramex'i yalnızca bu hedef ülkeler için sunar. Kargo firması bölgelerindeki tüm ülkelere izin vermek için boş bırakın.

Gelişmiş

Debug log: tarife hesaplamalarını ve API hatalarını modül klasöründeki logs/vfd_armx_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Şifreler, PIN, hesap numarası ve müşteri adresleri maskelenir. İş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çıksa modülü kaldırdığınızda Aramex ayarları, kargo firması, önbellekteki tarifeler ve günlükler silinir. Kapalıysa yeniden kurulum için her şey korunur.

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

Kargo adımında PrestaShop modülden Aramex fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlığa eklenmez ve sipariş tutarına dahil edilmez. Modül önce koşulları kontrol eder: izin verilen ülkeler, sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0 olur ve Aramex'e istek gönderilmez.

Sabit modda fiyat tablodan alınır. Anlık modlarda modül Aramex'e çıkış ve teslimat adreslerini, faturalandırılabilir ağırlığı, hizmeti ve varsayılan para biriminizi gönderir, döndürülen toplamı kullanır. Anlık tarife yalnızca teslimat adresinde şehir veya posta kodu varsa istenir. Fiyat varsayılan para biriminizde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Her yanıt 1 saat önbellekte tutulur; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 10 dakika önbellekte tutulur; böylece ödeme sayfası her yenilemede Aramex'i beklemez. API zaman aşımı 10 saniyedir.

Aramex bir hata, sıfır tutar ya da dönüşüm kuru olmadan başka para biriminde teklif dönerse müşteri hata görmez. Kargo firması gizlenir ya da yedek modda sabit fiyat kullanılır. Nedeni hata ayıklama günlüğüne yazılır.

Kargo firmasını, siparişleri olduktan sonra Shipping > Carriers içinde düzenlerseniz PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak takip eder.

Modül yalnızca tarife hesaplar. Aramex gönderisi oluşturmaz, etiket basmaz, kurye randevusu almaz, paketleri takip etmez ve müşterinin bir Aramex ofisi seçmesine izin vermez. Paket her zaman Aramex'e tek parça olarak gönderilir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Aramex lisans bloğu, Modules > Module Manager > VibeFox Aramex > Configure sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) gösterir; ayrıca 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 düğmeleri görünür. Bunların altında Product: presta-shipping-aramex satırı ile Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip personel değiştirebilir. Bloktaki metinler yönetim paneli 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 tarihiyle birlikte 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Aramex kargo firması ödeme sırasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu nedenle kargo firması sizin için de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme sırasında test edemezsiniz. Modules > Module Manager sayfasındaki Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Aramex ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Aramex seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers içinde kargo firmasının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin. Countries, ağırlık sınırları ve Minimum order amount ayarlarını inceleyin. Sabit modda ülkenin veya * satırının bir fiyatı olduğunu kontrol edin. Ürünler, ürün sayfasında belirli kargo firmalarıyla da sınırlandırılmış olabilir.

Anlık tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve modül sayfasındaki Log alanına bakın. Nedeni gösterir: eksik API kimlik bilgileri, Aramex hata kodu, çıkış şehrinin olmaması, teslimat şehrinin veya posta kodunun olmaması, bir ağırlık ya da tutar sınırı veya başka para biriminde teklif. Aramex live rates, fixed prices if the API fails seçeneğiyle, siz sorunu düzeltirken müşteriler yine sabit fiyatı görür.

Günlükte ERR75 hatası: Aramex girişi reddetti. Kullanıcı adını, şifreyi, hesap numarasını, PIN'i, entity ve ülke kodunu Aramex hesap yöneticinizle kontrol edin.

Başka para biriminde teklif reddediliyor: Aramex, mağazanızın varsayılan para birimi dışında bir para biriminde yanıt verdi. Currency conversion rate alanını girin veya Aramex'ten teklifi para biriminizde vermesini isteyin.

Kargo ücretinden iki kez vergi alınıyor: Aramex toplamları KDV içerebilir. Tax seçeneğini No tax olarak ayarlayın.

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

Sayfa Aramex kargo firmasının bulunamadığını bildiriyor: kargo firması Shipping > Carriers içinde silinmiş. Yeniden oluşturmak için Modules > Module Manager üzerinden modülü sıfırlayın.

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox Aramex yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu ve önbellekteki tarifeler her zaman kaldırılır. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak, kayıtlı kargo firmasını yeniden etkinleştirir.

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