VibeFox SF Express for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerinde kurulmayı reddeder.

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ı ortamların checkword'leri farklıdır. Yalnızca fiyat tablosunu kullanıyorsanız SF Express hesabına ihtiyacınız yoktur.

Çin illeri (yalnızca anlık fiyatlar için): anlık fiyat, teslimat adresinin ilini gerektirir. PrestaShop varsayılan olarak Çin illerini içermez. Modül bunları sizin için ekleyebilir (aşağıdaki Chinese provinces bölümüne bakın).

VibeFox lisans anahtarı: vibefox.net'ten satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. Back office'te Modules > Module Manager sayfasına 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 SF Express modülünü 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 ve Save düğmesine tıklayın.

5. Çin anakarası için anlık fiyatlar almak üzere müşteri kodunu ve checkword'ü, gönderici ilini ve şehrini (veya Çin'deki bir mağaza adresini) girin; mağaza para biriminiz CNY değilse dönüşüm kurunu da girin. Sayfa isterse Add Chinese provinces düğmesine tıklayın. Önce Sandbox ve sandbox bilgileriyle test edin.

Kurulumda modül, Courier delivery teslimat süresi metniyle SF 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 tanımlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox SF Express > Configure. Ayarlar taşıyıcının tüm bölgeleri için geçerlidir. 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 SF Express fiyatlarını temizler.

Kaydederken modül sayıları kontrol eder. Sayı olmayan bir değer, negatif bir tutar veya ağırlık, 0 olan bir dönüşüm kuru, Max weight değerinden büyük bir Min weight ya da fiyat tablosunda hatalı bir fiyat bir mesajla reddedilir ve siz düzeltene kadar hiçbir şey kaydedilmez. Ayarların üstündeki uyarılar; anlık fiyatların kısmen ayarlandığını (eksik ayarlar listelenir), dönüşüm kurunun eksik olduğunu, Çin adreslerinde il alanı bulunmadığını veya mağazanızın ağırlık ya da boyut biriminin modül tarafından bilinmediğini bildirir. Birimler International > Localization bölümünde (Local units) ayarlanır.

Genel

Enable SF 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: SF Express. Zorunlu, en fazla 64 karakter.

Tax: taşıyıcının vergi kuralı veya No tax. Bir vergi kuralı seçilirse mağazanızın kargo vergisi ücrete eklenir. SF Express fiyatı tahsil etmek istediğiniz her şeyi zaten içeriyorsa No tax 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 (顾客编码). Bunu temizlemek, kayıtlı checkword'ü de siler; böylece bilgileri kaldırabilirsiniz.

Checkword: aynı ortamın checkword'ü (校验码). Yalnızca istekleri imzalamak için kullanılır, hiçbir zaman gönderilmez veya kaydedilmez. 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.

Sandbox: sandbox bilgileriyle test için FengQiao sandbox'ını (sfapi-sbox.sf-express.com) kullanır. Sandbox fiyatları gerçek değildir. Canlı bir mağazada kapatın. Varsayılan: kapalı.

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, Shop Parameters > Contact > Stores içindeki 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ğazanızın varsayılan para birimi CNY değilse, bir CNY'nin kaç birim sizin para biriminize eşit olduğunu girin (1 CNY = ? birim). Kur 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.

Chinese provinces: Çin adreslerinin il alanına sahip olup olamayacağını gösterir. Olamıyorsa Add Chinese provinces düğmesine tıklayın. Düğme, 32 il, özerk bölge ve belediyeyi Çin'in eyaletleri olarak ekler (GD ve BJ gibi ISO kodları, "Guangdong / 广东" gibi adlar), Çin için "Contains states" seçeneğini açar ve Çin adres formuna eyalet alanını ekler. Zaten var olan iller tekrar eklenmez. Bu tıklama olmadan hiçbir şey değişmez.

Fiyat tablosu ve yedek ücret (Hong Kong, Makao, Tayvan ve diğer ülkeler için kullanılır; anlık fiyatlar yapılandırılmadığında veya SF Express fiyat döndürmediğinde; fiyatlar mağazanızın varsayılan para biriminde, vergi hariç)

Country prices: ülke başına temel fiyat içeren bir tablo. Satır eklemek için Add country düğmesine, satır silmek için çöp kutusu simgesine tıklayın. * All other countries 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 yerine geçer: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg ve XL >5 kg. Temel fiyat 0 ise ücretsiz kargo anlamına gelir. Temel fiyat boşsa bu ülke için fiyat yoktur ve yedek ücret kullanılır. "9.99" ve "9,99" kabul edilir. Hiçbir fiyatı olmayan satır kaydedilmez.

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

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

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

Koşullar

Free shipping from: ücretsiz kargonun başladığı sepet ara toplamı (indirimlerden sonra, vergiden önce). Hiçbir zaman ücretsiz kargo sunulmaması için boş bırakın. Ücretsiz kargo, herhangi bir fiyat aranmadan önce kontrol edilir; bu tutardan itibaren taşıyıcı, kullanılabildiği her hedef için ücretsiz sunulur; tablo satırı veya Fallback cost olmayan bir ülke için bile.

Minimum subtotal: sepet ara toplamı (indirimlerden sonra, vergiden önce) bu tutara ulaştığında taşıyıcıyı gösterir. Her zaman göstermek için boş bırakın.

Min weight: sepetin kg cinsinden minimum 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: sepetin kg cinsinden maksimum ağırlığı. Varsayılan: 50. 0 veya boş, sınır olmadığı anlamına gelir.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: hangi bölge eşleşirse eşleşsin, SF Express'i aşağıdaki ülkeler için sunar. Kaydedildiğinde taşıyıcı tüm bölgelere eklenir ve daha sonra oluşturulan bölgeler de eklenir. Seçeneği kapatmak, eklenen bölgeleri kaldırır. Kapalıyken taşıyıcı yalnızca kendi bölgelerinde görünür.

Countries: bu mod için hedef ülkeler. Tüm aktif ü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ı modül klasöründeki logs/vfd_sfex_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları, bu seçenek kapalı olsa bile her zaman kaydedilir. Checkword veya müşteri adresleri yazılmaz.

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çıksa modülü kaldırmak ayarları, taşıyıcıyı, önbellekteki fiyatları ve günlükleri siler. Kapalıysa yeniden kurulum için her şey korunur.

Ödeme sırasında nasıl çalışır

Kargo adımında PrestaShop, SF Express fiyatını modülden 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: izin verilen ülkeler (Ignore shipping zones ile), sepet ağırlığı ve minimum ara toplam. Ara toplam Free shipping from tutarına ulaşırsa fiyat 0 olur ve SF Express'e istek gönderilmez.

Müşteri kodu ve checkword ayarlıyken Çin anakarasındaki bir teslimat adresi için modül, SF Express'e gönderici ilinizi ve şehrinizi, müşterinin ilini ve şehrini, sepet ağırlığını ve sepet hacmini gönderir (üç boyutu da olan ürünlerden). İstek checkword'ünüzle imzalanır. SF Express fiyatları CNY olarak döndürür ve modül seçilen fiyatı mağazanızın varsayılan para birimine çevirir. Fiyat daha sonra müşterinin sepet para biriminde gösterilir.

SF Express adresleri standart Çince adlarla tanır. Müşterinin ili, adresin eyalet alanından alınır. Şehir Çince yazılmalıdır, örneğin 广州市. Beijing, Shanghai, 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 önbellekte tutulur, bu yüzden aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 10 dakika önbellekte tutulur, böylece ödeme sayfası her yenilemede SF Express'i beklemez. HTTP zaman aşımı 10 saniyedir.

Anlık fiyat yoksa fiyat fiyat tablosundan, ardından Fallback cost değerinden alınır. İkisi de uygulanmazsa taşıyıcı gizlenir. Müşteri hiçbir zaman bir hata görmez. Hata günlüğe yazılır.

Taşıyıcı siparişler aldıktan sonra Shipping > Carriers içinde düzenlenirse PrestaShop onu 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 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. Modül FengQiao belgelerine ve simüle edilmiş yanıtlara göre geliştirilmiştir; bu yüzden canlıya geçmeden önce fiyatları SF Express hesabınızla (önce sandbox'ta) doğrulayın.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox SF Express lisans bloğu, Modules > Module Manager > VibeFox SF Express > Configure sayfasında, ayarların üstünde 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 son tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-sf-express satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir, örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla ç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ı serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan SF Express taşıyıcısı ödeme sırasında müşterilere gösterilmez ve fiyat hesaplanmaz. PrestaShop vitrini back office'e giriş yaptığınızı bilmez, bu yüzden taşıyıcı sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sırası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 yenileme gerektirir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonra 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

SF Express ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable SF 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 seçeneğini açıp Countries alanını kontrol edin). Ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Tablonun veya Fallback cost değerinin ülke için bir fiyatı olduğunu kontrol edin. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlandırılmış olabilir.

Fiyat SF Express'ten değil, tablodan geliyor: anlık fiyatlar için müşteri kodu ve checkword, gönderici ili ve şehri, il ve Çince şehir adı içeren Çin anakarasında bir teslimat adresi ve (CNY dışındaki para birimi kullanan mağazalar için) dönüşüm kuru gerekir. Modül sayfasının üstündeki uyarıları okuyun, ardından Debug log seçeneğini açın, ödeme sayfasını yenileyin ve nedenini görmek için Log alanına bakın. Başarısız bir istek 10 dakika sonra yeniden denenir.

Çin adres formunda il yok: modül sayfasının API bölümündeki Add Chinese provinces düğmesine tıklayın.

Günlükte A1006 hatası: geçersiz imza. Checkword yanlış veya 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ı adresleri içindir.

Bir değişiklikten sonra fiyatlar eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbellekteki SF Express fiyatlarını temizler.

Sayfa SF Express taşıyıcısının bulunamadığını söylüyor: taşıyıcı Shipping > Carriers içinde silinmiş. Yeniden oluşturmak için Modules > Module Manager içinde modülü sıfırlayın.

Geliştiriciler için: actionVfdSfExpressQuoteRequest kancası fiyat isteğini değiştirir, örneğin başka bir ürün koduna. actionVfdSfExpressApiUrl ağ geçidi URL'sini değiştirir.

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox SF Express yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman silinir. Önbellekteki fiyatlar her zaman silinir. 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 ya da bir Reset yapmak, taşıyıcıya daha önce sahip olduğu durumu geri verir. Mevcut siparişler kargo satırlarını korur.

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