VibeFox J&T Express for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

J&T Express Malaysia API erişimi (yalnızca anlık fiyat teklifleri için): anlık fiyat teklifleri yalnızca Malezya'daki teslimat adresleri için J&T Express Malaysia'da mevcuttur. Dört değere ihtiyacınız var. J&T Express Malaysia web sitesinde bir J&T VIP hesabı başvurusunda bulunun (modül sayfasında bir bağlantı var): J&T size VIP müşteri kodunu ve VIP API anahtarını verir. API hesabı ve istekleri imzalamak 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 yüzden 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

1. Back Office'te Modules > Module Manager bölümüne 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 J&T Express öğesini bulup Configure düğmesine tıklayın.

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

4. Fiyat tablosunu ve/veya yedek ücreti doldurun. Malezya için 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. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, Courier delivery teslimat süresi metniyle J&T Express taşıyıcısını oluşturur. Taşıyıcı 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 içinde değiştirebilirsiniz. Orada fiyat ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox J&T Express > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt ayrıca önbellekteki J&T tekliflerini temizler. Anlık fiyat teklifleri yalnızca kısmen yapılandırılmışsa, sayfanın üstündeki bir uyarı eksik ayarları listeler veya para birimi dönüşüm kurunun eksik olduğunu belirtir. 0 veya daha büyük bir sayı olmayan tutarlar bir hatayla reddedilir; 0 olan bir Currency conversion rate ve Max weight değerinden büyük bir Min weight de reddedilir. Mağazanızın ağırlık birimi tanınmazsa, bir uyarı sizden International > Localization bölümünde standart bir birim ayarlamanızı ister.

Genel

Bu sayfadaki ayarlar tüm bölgeler için geçerlidir. Taşıyıcının bölgeleri, müşteri grupları ve boyut sınırları Shipping > Carriers içinde ayarlanır (ya da aşağıdaki Ignore shipping zones seçeneğini kullanın).

Enable J&T Express: taşıyıcıyı açar veya kapatır. Bu, Shipping > Carriers içindeki taşıyıcı durumuyla aynı anahtardır.

Method title: sepette ve ödeme sayfasında gösterilen taşıyıcı adı. Varsayılan: J&T Express. Zorunlu.

Tax: taşıyıcının vergi kuralı veya No tax. Vergi kuralı, mağazanızın kargo vergisini ücrete ekler. J&T fiyatı tahsil etmek istediğiniz her şeyi zaten içeriyorsa No tax seçin.

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

VIP customer code: J&T Express VIP müşteri kodunuz. Bunu temizlemek, kayıtlı VIP API anahtarını da siler.

VIP API key: VIP koduyla birlikte J&T Express'in size 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 istediğinizde yeni bir değer girin.

API account: J&T Express API hesabınızın adı. Bunu temizlemek, kayıtlı özel anahtarı da siler.

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.

Sender postcode: paketlerin gönderildiği Malezya posta kodu. Mağaza Malezya'daysa, Shop Parameters > Contact > Stores içindeki mağaza posta kodunu kullanmak için boş bırakın. Kaydederken boşluklar kaldırılır.

Currency conversion rate: J&T Express Malaysia teklifleri MYR cinsindendir. Mağazanızın varsayılan para birimi MYR değilse, bir MYR'nin kaç birim sizin para biriminize eşdeğer olduğunu girin (1 MYR = X). Bu değer olmadan anlık teklifler kullanılmaz; bunun yerine fiyat tablosu veya yedek ücret uygulanır. Varsayılan para biriminiz MYR ise alan bunu belirtir ve kur gerekmez: teklifler olduğu gibi kullanılır. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir. 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; fiyatlar mağazanızın varsayılan para biriminde, vergi hariç)

Country prices: ülke başına bir satırlık bir tablo. Satır eklemek için Add country düğmesine, satır silmek için çöp kutusu simgesine tıklayın. Kendi satırı olmayan tüm ülkeler için * Any other country seçin. Her satırda bir Base price 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 olan temel fiyat ücretsiz kargo anlamına gelir; boş temel fiyat 0 olarak kaydedilir. Bir ülke iki satırda görünürse son satır tutulur. Satırı olmayan ülkeler (* satırı yoksa) tablo fiyatı alamaz.

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

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

Koşullar

Free shipping from: ücretsiz kargonun başladığı sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergilerden önce). Ücretsiz kargo olmasın istiyorsanız boş bırakın.

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

Min weight: sepet bundan daha hafifse taşıyıcıyı gizler (kg cinsinden). Ürün ağırlıkları mağazanızın ağırlık biriminden dönüştürülür. 0 sınır yok anlamına gelir. Max weight değerinden büyük olamaz.

Max weight: sepet bundan daha ağırsa taşıyıcıyı gizler (kg cinsinden). Varsayılan: 50. 0 sınır yok anlamına gelir.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: taşıyıcı, aşağıdaki ülkeler için bu ülkelerin bölgesine bağlı olmasa bile sunulur. Açtığınızda taşıyıcı tüm etkin bölgelere bağlanır ve daha sonra oluşturduğunuz bölgeler de bağlanır. Kapalıyken taşıyıcı yalnızca Shipping > Carriers içindeki kendi bölgelerinde sunulur. Kapatmak taşıyıcıya önceki bölgelerini geri verir.

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.

Gelişmiş

Debug log: fiyat hesaplamalarını modül klasöründeki logs/vfd_jtex_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. J&T API hataları, bu seçenek kapalı olsa bile her zaman günlüğe yazılır. Anahtar, şifre veya müşteri posta kodu yazılmaz. İşiniz bittiğinde günlüğü kapatın.

Log: günlüğü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çıkken modülü kaldırmak modül ayarlarını, taşıyıcıyı, önbellekteki teklifleri ve günlüğü siler. Kapalıyken yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop, modülden J&T Express fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül önce koşulları kontrol eder: teslimat ülkesi (Ignore shipping zones ile), sepet ağırlığı ve minimum ara toplam. Sepet ara toplamı Free shipping from tutarına ulaşırsa fiyat 0 olur ve J&T'ye hiçbir istek gönderilmez.

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

1. J&T anlık 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. Modül, J&T'ye gönderici ve alıcı posta kodlarını ve sepet ağırlığını (en az 0,1 kg) standart EZ hizmeti, tek paket için 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 kaynaklardan hiçbiri fiyat vermezse, taşıyıcı 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 ve sonra müşterinin sepet para biriminde gösterilir.

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

Taşıyıcıyı siparişleri olduktan sonra Shipping > Carriers içinde düzenlerseniz, PrestaShop bunu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca kargo ücretlerini hesaplar. Gönderi belgesi, irsaliye veya etiket oluşturmaz, kurye randevusu ayarlamaz, gönderileri iptal etmez veya takip etmez ve müşterilerin bir teslim noktası seçmesine izin vermez. Gönderileri her zamanki gibi J&T hesabınızda oluşturun ve takip edin. Modül, resmi J&T Express Malaysia eklentisinin istek formatına göre geliştirilmiştir. Canlıya geçmeden önce fiyatları J&T hesabınızla doğrulayın.

Lisans anahtarı

Modül, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox J&T Express lisans bloğu, Modules > Module Manager > VibeFox J&T Express > Configure 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ı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve Check now (durumu yeniden kontrol etmek için), Change key (başka bir anahtar girmek için) ve Remove key (anahtarı bu mağazadan kaldırmak için) düğmelerini gösterir. Bunların altında Product: presta-shipping-jt-express 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 modül için Configure izni olan çalışanlar değiştirebilir. Bloktaki metinler arka ofis dilini takip eder (İ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ı boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül, son bilinen durumu kullanarak çalışmaya devam eder.

Bir anahtar 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ı boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan, J&T Express taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop vitrini arka ofise giriş yaptığınızı bilmez, bu nedenle taşıyıcı sizden de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, arka ofiste çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak 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. Shipping > Carriers içinde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin (ya da Ignore shipping zones açık ve ülkeye izin veriliyorsa). Ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Country prices içinde ülke için bir satır veya bir * satırı olduğunu ya da Fallback cost ayarının yapılmış olduğunu kontrol edin. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlanabilir. Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın.

Fiyat J&T'den değil, tablodan geliyor: anlık teklifler dört API kimlik bilgisinin tamamını, bir gönderici posta kodunu, 5 haneli posta koduyla bir Malezya teslimat adresini ve MYR kullanmayan mağazalar için Currency conversion rate değerini gerektirir. Modül 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 teklif 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. Ayrıca Free shipping from değerini kontrol edin.

Bir değişiklikten sonra tarifeler güncel görünmüyor: modül sayfasındaki Save düğmesine tıklayın. Bu, önbellekteki J&T tekliflerini temizler.

Sayfada J&T Express taşıyıcısının bulunamadığı yazıyor: taşıyıcı Shipping > Carriers içinde silinmiştir. Yeniden oluşturmak için Modules > Module Manager içinde modülü sıfırlayın.

Geliştirici kancaları: actionVfdJtexQuoteRequest kancası teklif isteğinin gövdesini (örneğin hizmet türünü) değiştirir ve actionVfdJtexApiUrl teklif uç noktasını değiştirir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox J&T Express yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbellekteki teklifler her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak, kayıtlı taşıyıcıya önceki durumunu geri verir.

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