VibeFox J&T Express for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

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 J&T Express Malaysia için ve Malezya'daki teslimat adresleri için vardır. Dört değere ihtiyacınız vardır. J&T Express Malaysia web sitesinden bir J&T VIP hesabı için başvurun (ayarlar sayfasında bir bağlantı vardır): 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 ülkeler için fiyat tablosunu kullanın. Yalnızca fiyat tablosu ve yedek ücret 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 tek bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Alternatif olarak vfd_jt_express klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox J&T Express veya 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. Fiyat tablosunu ve/veya yedek ücreti doldurun. Malezya için anlık fiyat teklifleri kullanacaksanız J&T API bilgilerini, gönderici posta kodunu ve mağaza para biriminiz MYR değilse dönüşüm kurunu da girin (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde VibeFox J&T Express yöntemini bir kargo bölgesine ekleyin veya Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox J&T Express. Bu ayarlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde yalnızca bir alan bulunur:

Title (zone): müşterinin bu bölge için gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Ayarları her kaydettiğinizde önbelleğe alınmış J&T fiyat teklifleri silinir. 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.

Genel

Enable/Disable: yöntemi tüm bölgelerde aynı anda açar veya kapatır. Varsayılan: on.

Method title: sepette ve ödeme sayfasında gösterilen kargo yönteminin adı. Bir bölge bunu geçersiz kılabilir. Varsayılan: J&T Express.

Tax status: Taxable seçilirse mağazanızın kargo vergisi ücrete eklenir, None seçilirse eklenmez. J&T fiyatı tahsil etmek istediğiniz her şeyi zaten içeriyorsa None seçin.

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

VIP customer code: J&T Express VIP müşteri kodunuz.

VIP API key: J&T Express'in VIP kodunuzla birlikte verdiği API anahtarı (şifre). Asla günlüğe yazılmaz.

API account: J&T Express API hesabınızın adı.

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.

Sender postcode: paketlerin gönderildiği Malezya posta kodu. Mağaza Malezya'daysa, WooCommerce > Settings > General bölümündeki mağaza posta kodunu kullanmak için boş bırakın. Kaydederken boşluklar silinir.

Currency conversion rate: J&T Express Malaysia fiyatları MYR cinsindendir. Mağaza para biriminiz MYR değilse, bir MYR'nin kaç birim sizin paranıza eşit olduğunu girin (1 MYR = X). Bu değer olmadan anlık fiyat teklifleri kullanılmaz; bunun yerine fiyat tablosu veya yedek ücret kullanılır. Mağaza para biriminiz MYR ise boş bırakın: teklifler olduğu gibi kullanılır. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Fiyat tablosu ve yedek (Malezya dışındaki ülkeler için, anlık fiyat teklifleri yapılandırılmadığında veya J&T teklif vermediğinde kullanılır; fiyatlar mağaza para biriminizdedir)

Country prices: ülke başına bir satır içeren bir tablo. Satır eklemek için Add country düğmesine, silmek için çarpı işaretine tıklayın. Kendi satırı olmayan tüm ülkeler için * Any other country seçeneğini seçin. Her satırda bir Base price ve beş ağırlık kademesi bulunur: 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 yerini alır. 0 olan bir kademe temel fiyatı kullanır. Temel fiyat 0 ise ücretsiz kargo anlamına gelir; boş temel fiyat 0 olarak kaydedilir. Satırı olmayan ülkelerde (* satırı yoksa) tablo fiyatı uygulanmaz.

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

Table / fallback price is: Per order fiyatı bir kez uygular. 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ı (indirimlerden sonra, vergiden önce). Ücretsiz kargo olmasın istiyorsanız boş bırakın.

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

Min weight (kg): sepet bundan hafifse yöntemi gizler. Ürün ağırlıkları mağazanızın ağırlık biriminden dönüştürülür. 0 sınır olmadığı anlamına gelir.

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

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

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: yöntem herhangi bir kargo bölgesine eklenmemiş olsa bile, aşağıdaki ülkeler için sunar. Kapalıyken yöntem yalnızca eklendiği bölgelerde görünür.

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ı WooCommerce > Status > Logs sayfasına, kaynak vfd-jt-express olarak yazar. J&T API hataları bu seçenek kapalıyken bile her zaman kaydedilir. Anahtarlar, şifreler veya müşteri posta kodları yazılmaz. İşiniz bittiğinde günlüğü kapatın.

Remove data on uninstall: açıksa eklentiyi silmek ayarlarını, bölge yöntemlerini ve önbelleğe alınmış teklifleri kaldırır. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir fiyat ister. Eklenti önce koşulları kontrol eder: teslimat ülkesi, sepet ağırlığı, minimum ara toplam ve hariç tutulan kargo sınıfları. Sepet ara toplamı Free shipping from değerine ulaşırsa yöntem 0 ücretle gösterilir, ancak yalnızca ülkenin bir fiyatı varsa: Country prices içinde bir satır, bir Fallback cost veya bir J&T anlık fiyat teklifi. J&T yalnızca tablo ve yedek ücret fiyat vermediğinde sorgulanır.

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

1. J&T anlık fiyat teklifi: yalnızca dört API bilgisinin ve bir gönderici posta kodunun girili olduğu, teslimat ülkesinin Malezya olduğu, müşterinin 5 haneli bir posta kodu girdiği ve MYR dışındaki mağazalarda bir dönüşüm kurunun ayarlandığı durumlarda. Eklenti 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; dönen MYR fiyatını mağaza para biriminize dönüştürür.

2. Country prices: teslimat ülkesinin satırı veya * satırı, sepetin ağırlık kademesi fiyatıyla.

3. Fallback cost.

Bu kaynaklardan hiçbiri fiyat vermezse yöntem gizlenir. Per item yalnızca tablo ve yedek fiyatlar için geçerlidir.

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 güncellemede J&T'yi beklemez. İstek zaman aşımı 10 saniyedir. J&T bir hata, sıfır fiyat veya hiç yanıt döndürürse müşteri herhangi bir hata görmez. Tablo veya yedek fiyat kullanılır ve nedeni günlüğe 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 kargo ücretlerini hesaplar. Gönderi belgesi, taşıma belgesi veya etiket oluşturmaz, kurye randevusu ayarlamaz, gönderileri iptal etmez veya takip etmez ve müşterinin bir teslim noktası seçmesine izin vermez. Gönderileri her zamanki gibi J&T hesabınızdan oluşturun ve takip edin. Eklenti, resmi J&T Express Malaysia eklentisinin istek biçimi esas alınarak geliştirilmiştir. Canlıya geçmeden önce fiyatları J&T hesabınızla doğrulayın.

Lisans anahtarı

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

Etkin bir anahtar olmadan J&T Express ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise yine de (unlicensed — visible to admins only) etiketiyle görür; böylece anahtar satın almadan önce eklentiyi kurabilir ve test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. 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 arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

J&T Express ö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 (veya Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını, Minimum subtotal ve Excluded shipping classes ayarlarını kontrol edin. Country prices içinde ülke için bir satır veya * satırı olduğunu ya da Fallback cost değerinin girili olduğunu doğrulayın. Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasına bakın.

Fiyat J&T'den değil, tablodan geliyor: anlık fiyat teklifleri dört API bilgisinin tümünü, bir gönderici posta kodunu, 5 haneli posta koduyla bir Malezya teslimat adresini ve MYR dışındaki mağazalar için Currency conversion rate değerini gerektirir. Ayarlar 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 fiyat teklifi yok: J&T bu ülkeler için herkese açık bir fiyat teklifi API'si sunmaz. Bu ülkeler için fiyat tablosunu ve yedek ücreti kullanın.

Bir ülke yanlışlıkla ücretsiz kargo alıyor: satırındaki temel fiyat 0'dır (boş temel fiyat 0 olarak kaydedilir). Bir temel fiyat girin veya satırı kaldırın.

Bir değişiklikten sonra fiyatlar eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış J&T tekliflerini temizler.

Geliştirici kancaları: vfd_jtex_quote_request filtresi teklif isteğinin gövdesini (örneğin hizmet türünü) değiştirir, vfd_jtex_api_url teklif uç noktasını değiştirir ve standart woocommerce_shipping_vfd_jt_express_is_available filtresi kullanılabilirliği denetler.

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 alan adı hakkını 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 saklar. Tamamen kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri ve önbelleğe alınmış teklifler yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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