VibeFox Aramex for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edildi).

PHP: 8.0 veya üzeri.

Aramex hesabı (yalnızca canlı tarifeler için): canlı tarifeler Aramex Rate Calculator API'sini kullanır. Aramex, hesap sahiplerine API erişimi sağlar. Aramex hesap yöneticinize danışın veya Aramex web sitesindeki Aramex Developers Solution Center'a bakın. Altı değere ihtiyacınız vardır: API kullanıcı adı (genellikle bir e-posta adresi), şifre, hesap numarası, hesap PIN'i, hesap birimi (örneğin DXB) ve hesap ülke kodu (örneğin AE). Yalnızca ülke başına sabit fiyatları 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

İ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_aramex-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_aramex.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_aramex-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu nedenle 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 Aramex 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 üst kısmındaki lisans bloğunda bulunan License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

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

OpenCart 4

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_aramex.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ış 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 Aramex 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. ve 5. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

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

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Aramex > Edit. Bölümler solda listelenir. Sayfanın altındaki tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt, önbelleğe alınmış Aramex tarifelerini de temizler. Bir değer yanlışsa hiçbir şey kaydedilmez ve sayfa nedenini gösterir; örneğin Enter a method title (1 to 64 characters)., bir alanın sayı olması gerektiğine dair bir ileti veya The account country code must have 2 letters, e.g. AE. Ayarları yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar kaydedebilir.

Genel

Ayarlar tüm coğrafi bölgeler için geçerlidir. Yöntemi bir coğrafi bölge ve belirli ülkelerle Conditions bölümünden sınırlayabilirsiniz.

Enable Aramex: Aramex'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: Aramex. Zorunlu.

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

Canlı tarifenin eksik olmasının nedeni hata ayıklama günlüğüne yazılır. Müşteriye hiçbir zaman gösterilmez.

Sort order: Aramex'in ödeme sayfasındaki kargo yöntemleri arasındaki konumu. Tam sayı.

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

Username: Aramex API kullanıcı adınız, genellikle bir e-posta adresi. Bunu temizlemek kayıtlı şifreyi de siler.

Password: Aramex API şifreniz. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it. ibaresini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Account number: Aramex hesabınızın müşteri numarası. Bunu temizlemek kayıtlı PIN'i de siler.

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

Account entity: hesabınızın Aramex 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 (canlı 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ışına gönderiler için Aramex ürünü: PPX Priority Parcel Express (varsayılan), PDX Priority Document Express, PLX Priority Letter Express (0,5 kg'ın altındaki belgeler), 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 kim ödeme yapar: Prepaid (shipper pays) (varsayılan), Collect (receiver pays) veya Third party. Genellikle Prepaid.

API weight unit: Aramex'e gönderilen birim: Kilograms (KG) (varsayılan) veya Pounds (LB). Ürün ağırlıkları ağırlık sınıflarından, boyutlar uzunluk sınıflarından dönüştürülür. Ücretlendirilecek ağırlık, gerçek ağırlık ile hacimsel ağırlıktan (uzunluk × genişlik × yükseklik cm / 5000) büyük olanıdır. En az 0,5 kg uygulanır; bu, ağırlığı olmayan ürünleri de kapsar.

Currency conversion rate: Aramex'ten mağazanızın varsayılan para biriminde teklif vermesi istenir. Yine de başka bir para biriminde yanıt verirse, tarife bu sayıyla çarpılır (Aramex para biriminin 1 birimi = mağazanızın 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önderici adresi (canlı tarifeler için kullanılır)

Origin country: gönderim yaptığınız ülke. İlk seçenek olan Store country, mağazanızın ülkesini kullanır.

Origin city: gönderim yaptığınız şehir. Aramex bunu zorunlu tutar. OpenCart'taki mağaza adresi serbest metindir, bu nedenle şehir oradan alınmaz: burada girin.

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

Origin postcode: isteğe bağlı.

Çıkış ülkesi mağazanızın ülkesiyse, boş bırakılan il, System > Settings > Store > Local altındaki mağaza bölgesinden alınır.

Sabit fiyatlar (Shipping cost Fixed prices olduğunda ve canlı tarifeler için yedek olarak kullanılır)

Price per country: mağazanızın varsayılan para biriminde, vergi hariç ülkeler ve fiyatların listesi. Satır eklemek için Add country düğmesine, bir satırı silmek için × düğmesine tıklayın. Kendi satırı olmayan her ülke için kullanılacak fiyat için * All other countries seçeneğini seçin. Fiyatı olmayan ülkeler (* satırı yoksa) sabit tarife almaz, bu nedenle yöntem onlar için gizlenir.

Fixed price applies: Per order (varsayılan) fiyatı bir kez alır. Per item (price × quantity) ise fiyatı sepetteki ürün adedi ile çarpar. Aramex canlı tarifeleri her zaman gönderi başınadır.

Koşullar

Minimum weight (kg): sepet ağırlığı bu değerin altındaysa yöntemi gizler. 0 sınır olmadığı anlamına gelir (varsayılan).

Maximum weight (kg): sepet ağırlığı bu değerin üzerindeyse yöntemi gizler. Varsayılan: 100. 0 sınır olmadığı anlamına gelir. Alanı boş bırakırsanız 100 kg kullanılır.

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

Free shipping: aşağıdaki tutardan itibaren ücretsiz Aramex teslimatını açar.

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi); bu tutardan itibaren teslimat ücretsizdir. Yalnızca Free shipping açıkken kullanılır.

Tax class: kargo ücretinin vergi sınıfı veya No tax (varsayılan). Aramex canlı tarifeleri KDV'yi zaten içerebilir. Bu durumda kargoya iki kez vergi uygulanmaması için No tax seçin.

Geo zone: Aramex'i yalnızca bu coğrafi bölgedeki adresler için sunun. All zones (varsayılan) sınır olmadığı anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones altında yönetilir.

Countries: Aramex'i yalnızca bu hedef ülkeler için sunun. Tüm ülkelere izin vermek için alanı boş bırakın. Bu sınır Geo zone ile birlikte uygulanır.

Gelişmiş

Debug log: tarife hesaplamalarını ve API hatalarını storage/logs/vfd_armx_debug.log.php dosyasına yazar. Dosya web üzerinden okunamaz. Şifreler, PIN ve müşteri adresleri hiçbir zaman günlüğe yazılmaz. İşiniz bittiğinde günlüğü kapatın. Dosya 5 MB'a ulaştığında vfd_armx_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 kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa, eklentiyi kaldırmak Aramex ayarlarını, önbelleğe alınmış tarifeleri ve günlüğü siler. Kapalıysa (varsayılan), yeniden kurulum için saklanırlar.

İçe / dışa aktarma

Dışa aktarma: ayarları bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. Şifre ve PIN dışa aktarılmaz.

İçe aktarma: 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. Kayıtlı şifre ve PIN korunur.

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

OpenCart kargo yöntemlerini gösterirken, Aramex fiyatını eklentiden ister. Bir Geo zone ayarlıysa ve adres bunun dışındaysa Aramex 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 daha sonra koşulları kontrol eder: izin verilen ülkeler, sepet ağırlığı ve en düşük sipariş tutarı. Sipariş tutarı, kargo gerektiren ürünlerin kupon indirimi sonrası ve vergi öncesi fiyatıdır. Hediye sertifikaları, ödül puanları ve mağaza kredisi dikkate alınmaz. Ücretsiz kargo uygulanırsa fiyat 0 olur ve Aramex'e istek gönderilmez.

Sabit fiyat modunda fiyat tablodan alınır. Canlı tarife modlarında eklenti Aramex'e gönderici ve teslimat adreslerini, hacimsel ağırlığa göre ücretlendirilecek ağırlığı, hizmeti ve mağazanızın varsayılan para birimini gönderir; döndürülen toplamı kullanır. Canlı tarife yalnızca teslimat adresinde şehir veya posta kodu varsa istenir. Fiyat mağazanızın varsayılan para biriminde hesaplanır, ondalık basamaklarına yuvarlanır ve seçili Tax class vergisiyle birlikte müşteriye kendi para biriminde gösterilir.

Her yanıt 1 saat önbelleğe alınır; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 10 dakika önbelleğe alınır; böylece ödeme sayfası her güncellemede Aramex'i beklemez. API zaman aşımı 10 saniyedir.

Aramex bir hata, sıfır tutar veya dönüşüm kuru olmadan başka para biriminde bir teklif döndürürse müşteri hiçbir hata görmez. Yöntem gizlenir veya yedek modda sabit fiyat kullanılır. Nedeni hata ayıklama günlüğüne yazılır.

Eklenti yalnızca tarifeleri hesaplar. Aramex gönderileri oluşturmaz, etiket yazdırmaz, kurye randevusu almaz, paketleri takip etmez ve müşterilerin bir Aramex ofisi seçmesine izin vermez. Siparişlere hiçbir şey eklemez: sipariş, diğer tüm OpenCart kargo yöntemlerinde olduğu gibi yöntemin adını ve kargo ücretini gösterir. Paket Aramex'e her zaman tek parça olarak gönderilir.

OpenCart 4'te müşteri, ödeme sayfasının kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde Aramex'i seçer. Yöntem OpenCart 3'teki ile aynı şekilde çalışır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Aramex lisans bloğu, Extensions > Extensions > Shipping > VibeFox Aramex > 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 son 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-aramex satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar 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 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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek 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ızda serbest bırakın.

Etkin bir anahtar olmadan Aramex müşterilere ödeme sayfasında gösterilmez ve tarife hesaplanmaz. Aynı tarayıcıda yönetim paneline giriş yapmış bir yönetici kullanıcı yine de yöntemi mağazada görür; bu yöntem (unlicensed — visible to admins only) olarak işaretlenir, böylece eklentiyi bir anahtar satın almadan önce 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 herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim paneli Dashboard sayfasında bir hatırlatma görünür. 7 gün gizlemek için × düğmesine tıklayın. 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, anahtar girildikten sonraki ilk 14 gün her gün, ardından haftada bir kez, yönetim panelinde Dashboard veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir. Cron işi gerekmez. Eklentiyi kaldırmak 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. Geo zone, Countries, ağırlık sınırlarını ve Minimum order amount değerini inceleyin. Sabit fiyat modunda, ülkenin veya * All other countries seçeneğinin bir fiyatı olduğunu kontrol edin. Ürünlerin Requires Shipping değerinin Yes olduğunu doğrulayın.

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

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

Başka para biriminde teklif reddediliyor: Aramex, mağazanızın varsayılan para biriminden farklı bir para biriminde yanıt verdi. Currency conversion rate değerini girin veya Aramex'ten para biriminizde teklif vermesini isteyin.

Kargoda vergi iki kez alınıyor: Aramex toplamları KDV'yi zaten içerebilir. Tax class değerini No tax olarak ayarlayın.

Değişiklikten sonra tarifeler eski görünüyor: eklenti sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış Aramex tarifelerini temizler.

Sayfada "Warning: You do not have permission to modify VibeFox Aramex!" yazıyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebiliyor olabilir. Gruba System > Users > User Groups altında extension/shipping/vfd_aramex (OpenCart 3) veya extension/vfd_aramex/shipping/vfd_aramex (OpenCart 4) için değiştirme yetkisi verin.

Geliştiriciler için: Aramex API adresi vfd_armx_api_url ayarıyla (testler için) değiştirilebilir; ayarlar sayfasında bunun için bir alan yoktur.

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox Aramex yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. OpenCart her zaman Enable Aramex, Sort order, Tax class ve Geo zone ayarlarını sıfırlar. Önbelleğe alınmış tarifeler her zaman silinir. Remove data on uninstall açıksa Aramex 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öntemlerini ve maliyetlerini korur.

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

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