VibeFox J&T Express for OpenCart — Yardım

Gereksinimler

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

PHP: 8.0 veya üzeri.

J&T Express Malaysia API erişimi (yalnızca anlık fiyat teklifleri için): anlık fiyat teklifleri yalnızca Malezya teslimat adresleri için J&T Express Malaysia'da mevcuttur. Dört değere ihtiyacınız vardır. J&T Express Malaysia web sitesinden bir J&T VIP hesabı için başvurun (eklenti sayfasında bir bağlantı vardır): J&T size VIP müşteri kodunu ve VIP API anahtarını verir. API hesabı ve isteklerin imzalanması için kullanılan özel anahtar, API entegrasyonu için J&T tarafından verilir. Bunları J&T hesap yöneticinizden isteyin. J&T Filipinler, Endonezya ve diğer ülkelerin herkese açık bir fiyat teklifi API'si yoktur, bu ülkeler için fiyat tablosunu kullanın. Yalnızca fiyat tablosunu ve yedek ücreti kullanıyorsanız J&T API erişimine ihtiyacınız yoktur.

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

OpenCart 3

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_jt_express-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu yüzden Extensions > Modifications bölümü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 J&T Express öğesini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) 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. Fiyat tablosunu ve/veya yedek ücreti doldurun. Malezya'daki anlık fiyat teklifleri için ayrıca J&T API kimlik bilgilerini, gönderici posta kodunu ve mağazanızın varsayılan para birimi MYR değilse para birimi dönüşüm kurunu girin (bkz. Configuration). Enable J&T 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_jt_express.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4, eklenti kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

2. Paket, aynı sayfadaki yüklü 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 J&T Express öğesini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) 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 J&T Express seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız J&T Express ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox J&T Express > Edit. Bölümler solda listelenir. Sayfanın altındaki tek Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt ayrıca önbelleğe alınmış J&T fiyat tekliflerini temizler. Bir değer hatalıysa hiçbir şey kaydedilmez ve sayfa nedenini gösterir: geçersiz bir yöntem başlığı, 0 veya daha büyük bir sayı olmayan bir tutar, değeri 0 olan bir Currency conversion rate, Max weight (kg) değerinden büyük bir Min weight (kg) ya da tam sayı olmayan bir sıralama. Ayarları yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar kaydedebilir.

Ayarların üstündeki uyarılar (her kayıttan sonra yeniden gösterilir) anlık fiyat tekliflerinin yalnızca kısmen yapılandırıldığını bildirir: eksik API ayarlarını listelerler veya mağaza para biriminizin MYR olmadığını ve dönüşüm kurunun eksik olduğunu belirtirler. Mağazanızda System > Localisation > Weight Classes bölümünde kg birimli bir ağırlık sınıfı yoksa başka bir uyarı görünür. Bu durumda ürün ağırlıkları birim adına göre (kg, g, lb, oz) dönüştürülür, diğer birimler kg olarak okunur.

Genel

Yöntem, seçilen coğrafi bölge için veya Ignore shipping zones ülkeleri için sunulur. Bu sayfadaki ayarlar tüm bölgeler için geçerlidir.

Enable J&T Express: yöntemi ödeme sayfasında gösterir veya gizler (bu eklentinin durumu). Varsayılan: kapalı.

Method title: sepette ve ödeme sayfasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: J&T Express. Zorunlu, en fazla 64 karakter, < > ; = # { } karakterleri olmadan.

Tax class: kargo ücretinin vergi sınıfı veya No tax (varsayılan). Bir vergi sınıfı, kargo ücretinin üzerine kargo vergisini ekler. J&T fiyatı tahsil etmek istediğiniz her şeyi zaten içeriyorsa No tax seçin.

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

J&T Express Malaysia API (anlık fiyat teklifleri) (isteğe bağlı, Malezya teslimat adresleri için; dört kimlik bilgisinin tümü zorunludur)

Her Malezya posta kodu için fiyat teklifi J&T Express Malaysia'dan istenir ve bir saat önbellekte tutulur. Kimlik bilgileri olmadan ve diğer ülkeler için fiyat tablosu ve yedek ücret kullanılır.

VIP customer code: J&T Express VIP kodunuz. Temizlenmesi kayıtlı VIP API anahtarını da temizler.

VIP API key: J&T Express'in VIP koduyla birlikte verdiği API anahtarı (şifre). Asla günlüğe yazılmaz. 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. Kaldırmak için VIP customer code alanını temizleyin ve kaydedin.

API account: J&T Express API hesabınızın adı. Temizlenmesi kayıtlı özel anahtarı da temizler.

API private key: API hesabının özel anahtarı. Yalnızca istekleri imzalamak için kullanılır (SHA-256). Asla J&T'ye gönderilmez ve günlüğe yazılmaz. VIP API anahtarı gibi, kaydettikten sonra tekrar gösterilmez. Kaldırmak için API account alanını temizleyin ve kaydedin.

Sender postcode: paketlerin gönderildiği Malezya posta kodu, örneğin 50000. Anlık fiyat teklifleri için zorunludur: OpenCart'taki mağaza adresi serbest metindir, bu yüzden posta kodu asla oradan alınmaz.

Currency conversion rate: J&T Express Malaysia fiyat teklifleri MYR cinsindendir. Mağazanızın varsayılan para birimi MYR değilse, bir MYR'nin kaç birim sizin para biriminize eşit olduğunu girin (1 MYR = X), örneğin 0.20. Bu olmadan anlık teklifler kullanılmaz ve fiyat tablosu veya yedek ücret kullanılır. Varsayılan para biriminiz MYR ise alan bunu belirtir ve gerekli değildir: teklifler olduğu gibi kullanılır. Kur 0'dan büyük olmalıdır.

Fiyat tablosu ve yedek (Malezya dışındaki ülkeler için, anlık fiyat teklifleri yapılandırılmamışsa veya J&T teklif vermezse kullanılır; mağazanızın varsayılan para biriminde, vergi hariç fiyatlar)

Country prices: ülke başına bir satır içeren bir tablo. Satır eklemek için Add country düğmesine, bir satırı silmek için silme düğmesine tıklayın. Kendi satırı olmayan tüm ülkeler için * Any other country seçin. Her satırın bir Base price değeri ve beş ağırlık kademesi vardır: XS 1 kg'a kadar, S 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar ve XL 5 kg'ın üzeri. 0'dan büyük bir kademe fiyatı, o kademedeki sepetler için temel fiyatın yerine geçer. 0 olan bir kademe temel fiyatı kullanır. 0 temel fiyat ücretsiz kargo anlamına gelir ve boş temel fiyat 0 olarak kaydedilir. Satırı olmayan ülkeler (* satırı yoksa) tablo fiyatı almaz.

Fallback cost: J&T ve tablo fiyat vermediğinde kullanılan fiyat. Bu durumda yöntemi gizlemek için boş bırakın. 0 ücretsiz kargo anlamına gelir.

Table / fallback price is: Per order (varsayılan) fiyatı bir kez tahsil eder. Per item (multiplied by the number of items) fiyatı sepetteki ürün sayısıyla çarpar. J&T anlık fiyat teklifleri her zaman tüm sipariş içindir.

Koşullar

Free shipping from: ücretsiz kargonun başladığı sepet ara toplamı (kargo gerektiren ürünler, kupon sonrası, vergi öncesi). Ücretsiz kargo olmaması için boş bırakın.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Min weight (kg): sepet bundan hafifse yöntemi gizler. Ürün ağırlıkları ağırlık sınıflarıyla dönüştürülür. 0 sınır olmadığı anlamına gelir (varsayılan). Max weight (kg) değerinden büyük olamaz.

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

Geo zone: yöntemi yalnızca bu coğrafi bölgedeki adresler için sunar. All zones (varsayılan) sınır olmadığı anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde yönetilir. Ignore shipping zones açıkken kullanılmaz.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: yöntemi, coğrafi bölge ne olursa olsun aşağıdaki ülkeler için sunar. Varsayılan: kapalı.

Countries: bu mod için hedef ülkeler, mağazanızda etkinleştirilmiş ülkeler arasından seçilir. Tüm ülkelere izin vermek için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: fiyat hesaplamalarını storage/logs/vfd_jtex_debug.log.php dosyasına yazar (OpenCart 4'te system/storage/logs/vfd_jtex_debug.log.php). Dosya web'den okunamaz. J&T API hataları bu seçenek kapalı olsa bile her zaman günlüğe yazılır. Anahtarlar, şifreler, müşteri kodu veya müşteri posta kodları asla yazılmaz. İşiniz bittiğinde günlüğü kapatın. Dosya 5 MB'a ulaştığında vfd_jtex_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. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa, eklentiyi kaldırmak J&T Express ayarlarını ve günlüğü siler. Kapalıysa (varsayılan), yeniden kurulum için saklanırlar. Önbelleğe alınmış teklifler her zaman silinir.

İçe / Dışa Aktarma

Export: ayarları JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. VIP API anahtarı ve özel anahtar 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ıt gibi kontrol edilir. Kaydedilmiş anahtarlar korunur.

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

OpenCart kargo yöntemlerini gösterdiğinde, eklentiden J&T Express fiyatını ister. Bir Geo zone ayarlıysa (ve Ignore shipping zones kapalıysa) ve adres bunun dışındaysa yöntem sunulmaz. Yalnızca Requires Shipping değeri Yes olarak ayarlanmış ürünler sayılır: diğer ürünler ağırlığa eklenmez ve ara toplama dahil edilmez. Eklenti ardından koşulları kontrol eder: izin verilen ülkeler (Ignore shipping zones ile), sepet ağırlığı ve minimum ara toplam. Ara toplam, kargo gerektiren ürünlerin kupon indiriminden sonra ve vergi öncesi fiyatıdır. Hediye sertifikaları, ödül puanları ve mağaza kredisi dikkate alınmaz. Ara toplam Free shipping from değerine ulaşırsa fiyat 0 olur ve J&T'ye hiçbir istek gönderilmez.

Aksi takdirde ücret, fiyat veren ilk kaynaktan alınır:

1. J&T anlık fiyat teklifi: yalnızca dört API kimlik bilgisinin tamamı ve bir gönderici posta kodu ayarlıysa, teslimat ülkesi Malezya ise, müşteri 5 haneli bir posta kodu girdiyse ve varsayılan para birimi MYR olmayan mağazalar için bir dönüşüm kuru ayarlıysa kullanılır. Eklenti J&T'ye gönderici ve teslimat posta kodlarını ve standart EZ hizmeti, tek paket için sepet ağırlığını (en az 0,1 kg) gönderir ve dönen MYR fiyatını mağazanızın varsayılan para birimine dönüştürür.

2. Ülke fiyatları: teslimat ülkesinin satırı veya * satırı, sepet ağırlık kademesinin fiyatıyla birlikte.

3. Yedek ücret.

Bu kaynakların hiçbiri fiyat vermezse yöntem o sepet için gizlenir. Per item yalnızca tablo ve yedek fiyatlara uygulanır. Fiyat mağazanızın varsayılan para biriminde hesaplanır, ondalık basamaklarına yuvarlanır ve seçilen Tax class vergisiyle müşteriye kendi para biriminde gösterilir.

Her J&T 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 yenilemede J&T'yi beklemez. İstek zaman aşımı 10 saniyedir. J&T bir hata, sıfır fiyat veya yanıt döndürmezse müşteri hiçbir hata görmez. Tablo veya yedek fiyat kullanılır ve nedeni günlüğe yazılır.

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

Eklenti yalnızca kargo ücretlerini hesaplar. Kargo irsaliyesi, faturası veya etiket oluşturmaz, kargo alımı ayarlamaz, gönderileri iptal etmez veya takip etmez ya da müşterinin bir teslim noktası seçmesine izin vermez. Siparişlere hiçbir şey eklemez: sipariş, diğer OpenCart kargo yöntemlerinde olduğu gibi yöntem adını ve kargo ücretini gösterir. Gönderileri her zamanki gibi J&T hesabınızda oluşturun ve takip edin. Eklenti, resmi J&T Express Malaysia entegrasyonunun istek biçimine göre geliştirilmiştir. Canlıya geçmeden önce fiyatları J&T hesabınızla doğrulayın.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox J&T Express lisans bloğu, Extensions > Extensions > Shipping > VibeFox J&T Express > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin 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: Check now durumu yeniden kontrol eder, Change key başka bir anahtar girmenizi sağlar, Remove key anahtarı bu mağazadan kaldırır. Bunların altında Product: opencart-shipping-jt-express satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca 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 tarihiyle birlikte 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 olmadan J&T Express kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi yine de mağazada (unlicensed — visible to admins only) işaretiyle görür; böylece anahtarı satın almadan önce eklentiyi kurabilir ve test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan yöntem herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma görünür. × ile kapatırsanız 7 gün boyunca gizlenir. 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. 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 her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

J&T Express ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable J&T Express seçeneğinin açık olduğunu kontrol edin. Geo zone değerini kontrol edin (veya Ignore shipping zones açık olup ülkenin Countries içinde olduğunu), ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Country prices alanında ülke için bir satır veya bir * satırı olduğunu ya da Fallback cost değerinin ayarlı olduğunu doğrulayın. Ürünlerde Requires Shipping değerinin Yes olarak ayarlı olduğunu kontrol edin. Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın.

Fiyat J&T'den değil, tablodan geliyor: anlık fiyat teklifleri dört API kimlik bilgisinin tamamını, bir gönderici posta kodunu, 5 haneli posta koduna sahip bir Malezya teslimat adresini ve MYR dışındaki mağazalar için Currency conversion rate değerini gerektirir. Eklenti sayfasının üstündeki uyarıları kontrol edin. J&T isteği reddeder veya yanıt vermezse hata günlüğe yazılır ve tablo veya yedek fiyat kullanılır. Başarısız istek 10 dakika sonra yeniden denenir.

Filipinler veya Endonezya için anlık teklif yok: J&T bu ülkeler için herkese açık bir fiyat teklifi API'si sunmaz. Bu ülkelerde fiyat tablosunu ve yedek ücreti kullanın.

Bir ülke yanlışlıkla ücretsiz kargo alıyor: satırının temel fiyatı 0'dır (boş temel fiyat 0 olarak kaydedilir). Bir temel fiyat girin veya satırı kaldırın. Free shipping from değerini de kontrol edin.

Bir değişiklikten sonra fiyatlar eski görünüyor: eklenti sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış J&T tekliflerini temizler.

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

Geliştiriciler için: diğer eklentiler, OpenCart vfd_jt_express/quote_request olayıyla fiyat isteğinin gövdesini (örneğin hizmet türü) ve vfd_jt_express/api_url ile fiyat teklifi uç noktasının adresini değiştirebilir.

Kaldırma

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

OpenCart 4'te eklentinin dosyalarını da kaldırmak için kaldırma işleminden sonra Extensions > Installer sayfasına gidin, yüklü eklentiler listesinde VibeFox J&T Express 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.

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