VibeFox SF Express for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

SF Express hesabı (yalnızca anlık fiyatlar için): anlık fiyatlar SF Express FengQiao açık platformunu (open.sf-express.com) kullanır. Aylık bir SF Express hesabına ve FengQiao'da bir geliştirici hesabına ihtiyacınız vardır. Orada kaydolun, bir uygulama oluşturun, uygulamaya "Delivery time standard and price query" (EXP_RECE_QUERY_DELIVERTM) API'sini ekleyin ve müşteri kodunu ile checkword'ü kopyalayın. Sandbox ve canlı ortam checkword'leri farklıdır. Yalnızca fiyat tablosunu kullanırsanız SF Express 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 bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_sf_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 SF Express, veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Fiyat tablosunu ve/veya yedek ücreti doldurun.

6. Çin anakarasında anlık fiyatlar için müşteri kodunu ve checkword'ü, gönderici il ve şehrini girin (ya da Çin'deki bir mağaza adresi tanımlayın) ve mağaza para biriminiz CNY değilse dönüşüm kurunu girin. Önce Sandbox ve sandbox kimlik bilgileriyle test edin.

7. WooCommerce > Settings > Shipping > Shipping zones bölümünde VibeFox SF Express'i bir kargo 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 bulunur: WooCommerce > Settings > Shipping > VibeFox SF Express. Bunlar 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): bu bölge için müşterilerin gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Ayarları her kaydettiğinizde önbelleğe alınmış SF Express fiyatları temizlenir. Anlık fiyatlar kısmen ayarlanmışsa, ayarların üstündeki bir uyarı eksik ayarları ya da eksik dönüşüm kurunu listeler.

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 kargo yönteminin adı. Bir bölge bunu geçersiz kılabilir. Varsayılan: SF Express.

Tax status: Taxable ücrete mağazanızın kargo vergisini ekler, None eklemez. SF Express fiyatı tahsil etmek istediğiniz her şeyi zaten içeriyorsa None seçin.

SF Express FengQiao API (anlık fiyatlar) (isteğe bağlı, Çin anakarasındaki teslimat adresleri için)

Customer code (partnerID): FengQiao uygulamanızın müşteri kodu (顾客编码).

Checkword: aynı ortamın checkword'ü (校验码). Yalnızca istekleri imzalamak için kullanılır, hiçbir zaman gönderilmez veya günlüğe yazılmaz.

Sandbox: sandbox kimlik bilgileriyle test etmek için FengQiao sandbox'ını kullanın. Sandbox fiyatları gerçek değildir. Canlı bir mağazada kapatın. Varsayılan: off.

SF Express product: hangi SF Express ürününün fiyatının gösterileceği.

Sender province: paketlerin gönderildiği il. Mağaza Çin'deyse, WooCommerce > Settings > General altındaki mağaza adresinin ilini kullanmak için boş bırakın.

Sender city: standart Çince şehir adı, örneğin 深圳市. Mağaza Çin'deyse, mağaza şehrini kullanmak için boş bırakın.

Currency conversion rate: SF Express fiyatları CNY (yuan) cinsindendir. Mağaza para biriminiz CNY değilse, bir CNY'nin mağaza para biriminden kaç birime karşılık geldiğini girin. Bu girilmezse anlık fiyatlar kullanılmaz. Mağaza para biriminiz CNY ise fiyatlar olduğu gibi kullanılır. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Fiyat tablosu ve yedek ücret (Hong Kong, Makao, Tayvan ve diğer ülkeler için kullanılır; anlık fiyatlar ayarlanmamışsa ya da SF Express fiyat döndürmezse; fiyatlar mağaza para biriminizdedir)

Country prices: ülke başına temel fiyatın yer aldığı bir tablo. * Any other country satırı, kendi satırı olmayan tüm ülkelere uygulanır. 0'dan büyük bir ağırlık aralığı fiyatı, o aralıktaki paketler için temel fiyatın yerini alır: ≤ 1 kg, ≤ 2 kg, ≤ 3 kg, ≤ 5 kg ve > 5 kg. Temel fiyat 0 ise kargo ücretsizdir. Temel fiyat boşsa bu ülke için fiyat yoktur ve yedek ücret kullanılır.

Fallback cost: ne SF Express ne de tablo bir fiyat verdiğinde kullanılır. Bu durumda yöntemi gizlemek için boş bırakın.

Table / fallback price is: tablo ve yedek fiyatların nasıl tahsil edileceği.

Anlık SF Express fiyatları her zaman tüm sipariş içindir.

Koşullar

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Ücretsiz kargo yalnızca yöntemin hedef için fiyatı olduğu yerlerde sunulur: anlık fiyat, tablo satırı veya Fallback cost. Ücretsiz kargoyu hiç sunmamak 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): kg cinsinden minimum sepet ağırlığı. Ü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): kg cinsinden maksimum sepet ağırlığı. Varsayılan: 50. 0 sınır olmadığı anlamına gelir.

Excluded shipping classes: sepet bu WooCommerce kargo sınıflarına ait ürünler içeriyorsa yöntemi gizler.

Kargo bölgeleri olmadan kullanılabilirlik

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

Countries: bu mod için hedef ülkeler. Kargo gönderdiğiniz 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 günlüğüne yazar: WooCommerce > Status > Logs, kaynak vfd-sf-express. API hataları bu seçenek kapalı olsa bile her zaman günlüğe yazılır. Checkword veya müşteri adresleri yazılmaz.

Remove data on uninstall: açıkken eklentiyi silmek, ayarlarını, kargo bölgesi yöntemlerini ve önbelleklerini 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ı. Ücretsiz kargo geçerliyse ve fiyat tablosu ya da Fallback cost hedef için bir fiyat içeriyorsa, yöntem 0 fiyatla gösterilir ve SF Express'e istek gönderilmez. Aksi halde eklenti önce SF Express'ten anlık bir fiyat ister ve yöntemi yalnızca bir fiyat döndüğünde ücretsiz olarak gösterir.

Müşteri kodu ve checkword ayarlıyken Çin anakarasındaki bir teslimat adresi için eklenti, SF Express'e gönderici il ve şehrini, müşterinin ilini ve şehrini, sepet ağırlığını ve sepet hacmini gönderir (üç boyutu da dolu olan ürünlerden). İstek checkword'ünüzle imzalanır. SF Express fiyatları CNY olarak döndürür ve eklenti seçilen fiyatı mağaza para biriminize çevirir.

SF Express adresleri standart Çince adlarla tanır. Müşterinin ili, ödeme sayfasındaki eyalet alanından alınır. Şehir Çince yazılmalıdır, örneğin 广州市. Pekin, Şanghay, Tianjin ve Chongqing için şehir otomatik doldurulur. "Guangzhou" gibi Latin harfleriyle yazılmış bir şehir tablo fiyatını alır.

Her fiyat bir 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 SF Express'i beklemez. HTTP zaman aşımı 10 saniyedir.

Anlık fiyat yoksa fiyat, fiyat tablosundan ve ardından Fallback cost'tan gelir. İkisi de geçerli değilse yöntem gizlenir. Müşteri hiçbir zaman bir hata görmez. Hata günlüğe yazılır.

Yöntem klasik ödeme sayfasında ve Sepet ve Ödeme bloklarında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur. İngilizce ve Basitleştirilmiş Çince çeviriler dahildir.

Eklenti yalnızca fiyatları hesaplar. Taşıma belgesi (waybill) veya etiket oluşturmaz, SF Express'te sipariş oluşturmaz, kurye alımı ayarlamaz, gönderileri iptal etmez veya takip etmez. Gönderileri her zamanki gibi SF Express hesabınızda oluşturun ve takip edin. Müşteriler bir SF hizmet noktası veya dolap seçemez. SF Express, kapıdan kapıya kurye olarak kullanılır. Anlık fiyatlar yalnızca Çin anakarasındaki teslimat adresleri için vardır. Eklenti FengQiao belgelerine ve simüle edilmiş yanıtlara göre geliştirildi; bu nedenle canlıya almadan önce fiyatları SF Express hesabınızla (önce sandbox'ta) doğrulayın.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox SF Express sayfasının üst kısmındadır. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın ne zamana 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 bir alan adında çalışır. Anahtarı bir siteden kaldırmak, alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan SF Express müşterilere ödeme sayfasında gösterilmez. Oturum açmış mağaza yöneticileri, bir anahtar satın almadan önce eklentiyi kurup test edebilmeniz için hâlâ (unlicensed — visible to admins only) işaretiyle görür. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

SF 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 (ya da Ignore shipping zones açık ve ülke izinli olmalı). Ağırlık sınırlarını, Minimum subtotal ve Excluded shipping classes ayarlarını kontrol edin. Tablonun ya da Fallback cost'un ülke için bir fiyatı olduğunu doğrulayın.

Fiyat SF Express'ten değil tablodan geliyor: anlık fiyatlar için müşteri kodu ve checkword, bir gönderici ili ve şehri, il ve Çince şehir adı içeren Çin anakarasında bir teslimat adresi ve (CNY dışı mağazalar için) dönüşüm kuru gerekir. Nedenini görmek için WooCommerce > Status > Logs sayfasını, kaynak vfd-sf-express olacak şekilde açın. Başarısız bir istek 10 dakika sonra yeniden denenir.

Günlükte A1006 hatası: geçersiz imza. Checkword yanlış ya da diğer ortama ait. Sandbox ayarını kontrol edin.

Günlükte A1004 hatası: fiyat sorgulama API'si FengQiao uygulamanıza eklenmemiş.

Hong Kong: fiyat tablosu ve yedek ücretle çalışır. FengQiao fiyat sorgusu yalnızca Çin anakarasındaki adresler içindir.

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

Geliştiriciler için: vfd_sfex_quote_request filtresi fiyat isteğini değiştirir, örneğin farklı bir ürün koduna. vfd_sfex_api_url ağ geçidi URL'sini değiştirir.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir yuva açın ve Check now düğmesine tıklayın. Site adresi değiştiyse, yeni alan adı için anahtarı etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için 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ış fiyatlar yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanırlar. Mevcut siparişler kargo satırlarını korur.

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