VibeFox Aramex for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin olmalı. WooCommerce olmadan eklenti etkinleştirilmez.

PHP: 8.0 veya üzeri.

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), parola, hesap numarası, hesap PIN'i, hesap birimi (ö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 bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_aramex 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 Aramex yolunu izleyin ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Kargo ücretinin nasıl hesaplanacağını seçin ve ilgili bölümleri doldurun (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde VibeFox Aramex yöntemini bir gönderim bölgesine ekleyin ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Shipping > VibeFox Aramex. Bu ayarlar tüm gönderim bölgelerinde 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. Boş bırakırsanız genel Method title kullanılır.

Ayarları her kaydettiğinizde Aramex'ten alınan önbellekteki tarifeler temizlenir.

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 gönderim yöntemi adı. Varsayılan: Aramex.

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 hiçbir zaman gösterilmez.

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

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

Password: Aramex API parolanız.

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

Account PIN: Aramex hesabınızın PIN'i.

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 (anlık tarifeler için kullanılır)

Teslimat adresi çıkış ülkesi içindeyse gönderi Yurt içi olarak fiyatlandırılır. Diğer tüm gönderiler Uluslararası ekspres olarak fiyatlandırılır.

International service: yurt dışı gönderileri 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önderinin Aramex ücretini kim öder: Prepaid (gönderici öder), Collect (alıcı öder) veya Third party. Genellikle Prepaid.

API weight unit: Aramex'e gönderilen birim, KG veya LB. Ürün ağırlıkları mağazanızın ağırlık biriminden çevrilir. Ücretlendirilen ağırlık, gerçek ağırlık ile hacimsel ağırlıktan (uzunluk × genişlik × yükseklik, cm cinsinden / 5000) büyük olanıdır. En az ağırlık 0,5 kg'dır ve ağırlığı girilmemiş ürünler için de bu değer kullanılır.

Currency conversion rate: Aramex'ten mağazanızın para birimiyle fiyat 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ğaza para biriminin X birimi). Bu tür teklifleri reddetmek için boş bırakın; böylece müşteri hiçbir zaman yanlış para biriminde ücretlendirilmez. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

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ş kalan alanlar WooCommerce > Settings > General altındaki mağaza adresinden alınır.

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

Price per country: mağaza para biriminde, 2 harfli ülke kodları ve fiyatlardan oluşan bir tablo. Bir ülke eklemek için Add row düğmesine, birini kaldırmak için çarpı işaretine tıklayın. Diğer tüm ülkeler için ülke kodu olarak * kullanın. Fiyatı olmayan ülkelere (* satırı yoksa) sabit tarife verilmez, bu nedenle yöntem o ülkeler için gizlenir.

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

Koşullar

Minimum weight (kg): sepet bu değerden hafifse yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet bu değerden ağırsa yöntemi gizler. Varsayılan: 100. 0 sınır olmadığı anlamına gelir.

Minimum order amount: yöntemi 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.

Excluded shipping classes: sepette bu WooCommerce gönderim sınıflarından birine ait bir ürün varsa yöntemi gizler.

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

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

Tax status: Taxable WooCommerce vergisini kargo ücretine ekler, None eklemez. Aramex anlık tarifeleri KDV'yi zaten içerebilir. Bu durumda vergi iki kez alınmasın diye None seçin.

Gönderim bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: yöntem herhangi bir gönderim bölgesine eklenmemiş olsa bile Aramex'i aşağıdaki ülkeler için sunar.

Countries: bu mod için hedef ülkeler. Boş bırakırsanız gönderim yaptığınız tüm ülkeler kullanılır. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını ve API hatalarını eklenti klasöründeki logs/vfd_armx_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Parolalar, PIN, hesap numarası ve müşteri adresleri maskelenir. İşiniz bittiğinde günlüğü kapatın.

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

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

Müşteri teslimat adresini girdiğinde, WooCommerce eklentiden bir tarife ister. Eklenti önce koşulları kontrol eder: teslimat ülkesi, sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan gönderim sınıfları. Ücretsiz kargo geçerliyse müşteri yöntemi Aramex (free) olarak görür ve Aramex'e hiçbir istek gönderilmez.

Sabit modda fiyat tablodan alınır. Anlık modlarda eklenti Aramex'e çıkış ve teslimat adreslerini, ücretlendirilen ağırlığı, hizmeti ve mağaza para birimini gönderir, dönen toplam tutarı gösterir. Anlık tarife ancak müşteri bir şehir veya posta kodu girdikten sonra istenir. Her yanıt 1 saat boyunca önbellekte tutulur, 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 yenilendiğinde Aramex'in yanıtını 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.

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

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

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Shipping > VibeFox Aramex sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm durumu gösterir; örneğin lisansın hangi tarihe kadar etkin 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 bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz; bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Aramex ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de görür; yöntem (unlicensed — visible to admins only) etiketiyle işaretlenir. Böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Lisans 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

Aramex ödeme sayfasında görünmüyor: lisansın etkin 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 olmalı ve ülke izinli olmalı). Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını kontrol edin. Sabit modda ülkenin veya * satırının bir fiyatı olduğunu kontrol edin.

Anlık tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve eklenti klasöründeki logs/vfd_armx_debug.log.php dosyasını açın. Dosya nedeni gösterir: eksik API kimlik bilgileri, Aramex hata kodu, çıkış şehri yok, henüz teslimat şehri veya posta kodu yok, 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ı alır.

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

Başka para biriminde teklif reddedildi: Aramex mağaza para biriminiz dışında bir para biriminde yanıt verdi. Currency conversion rate alanını girin ya da Aramex'ten teklifi sizin para biriminizde vermesini isteyin.

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

Bir değişiklikten sonra tarifeler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki Aramex tarifelerini temizler.

Aramex sandbox (test ortamı): eklenti canlı ortamdaki Aramex Rate Calculator'ı kullanır. Geliştiriciler vfd_armx_api_url filtresiyle uç noktayı değiştirebilir. vfd_armx_rate_request, vfd_armx_number_of_pieces ve vfd_armx_volumetric_divisor filtreleri isteği, parça sayısını ve hacimsel böleni ayarlar.

Lisans bölümü bir hata gösteriyor: bölümdeki 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, anahtarı yeni alan adı için 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. Tamamen kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri, önbellekteki tarifeler ve günlükler yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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