VibeFox SF 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.

SF Express hesabı (yalnızca canlı fiyatlar için): canlı fiyatlar, SF Express FengQiao açık platformunu (open.sf-express.com) kullanır. Aylık bir SF Express hesabına ve FengQiao üzerinde 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ıyorsanız SF Express hesabına ihtiyacınız yoktur.

Çin illeri (yalnızca canlı fiyatlar için): canlı fiyat, teslimat adresinin ilini gerektirir; bu, adresin OpenCart bölgesidir (Region / State). OpenCart'ta Çin'in bölgeleri vardır ancak Tibet eksiktir. Uzantı bunu sizin için ekleyebilir (aşağıda Chinese provinces bölümüne bakın).

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

Kurulum

İndirme dosyası, OpenCart'ın her iki 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_sf_express-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_sf_express.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan paketi kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_sf_express-oc3-(version).ocmod.zip dosyasını seçin. Uzantı OCMOD değişiklikleri eklemez, bu nedenle Extensions > Modifications sayfasını yenilemeniz gerekmez. Installer yerine, paketin upload klasöründeki içeriği mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions sayfasına gidin ve uzantı türü olarak Shipping seçin. VibeFox SF Express uzantısını bulun ve Install düğmesine tıklayın (yeşil + düğmesi).

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgesi) tıklayın.

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

5. Fiyat tablosunu ve/veya yedek maliyeti doldurun.

6. Çin anakarasında canlı fiyatlar için müşteri kodunu ve checkword'ü, gönderici ilini ve ilçesini girin; mağazanızın para birimi CNY değilse para birimi dönüşüm kurunu da girin. Sayfa isterse Add Chinese provinces düğmesine tıklayın. Önce Sandbox ve sandbox bilgileriyle test edin.

7. Enable SF Express seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_sf_express.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 uzantı kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

2. Paket, aynı sayfada kurulu uzantılar listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions sayfasına gidin, uzantı türü olarak Shipping seçin. VibeFox SF Express uzantısını bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4 ila 7. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

Kurulumdan sonra, Enable SF Express seçeneğini açıp kaydedene kadar yöntem kapalı kalır. Uzantıyı kaldırdıktan sonra yeniden kurarsanız, sakladığınız SF Express ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Shipping > VibeFox SF Express > Edit. Bölümler solda listelenir. Tüm geo bölgeleri için geçerlidir. Sayfanın altındaki tek Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt, önbellekteki SF Express fiyatlarını da temizler. Ayarları yalnızca bu uzantı için değiştirme izni olan yöneticiler kaydedebilir.

Kaydettiğinizde uzantı değerleri denetler. Boş bir yöntem başlığı, 64 karakterden uzun veya < > ; = # { } karakterlerini içeren bir başlık, sayı olmayan bir değer, negatif bir tutar veya ağırlık, 0 olan bir para birimi dönüşüm kuru, Max weight (kg) değerinden büyük bir Min weight (kg), fiyat tablosunda hatalı bir fiyat veya tam sayı olmayan bir sıralama değeri bir mesajla reddedilir ve siz düzeltene kadar hiçbir şey kaydedilmez. Ayarların üstündeki uyarılar; canlı fiyatlar kısmen ayarlandığında (eksik ayarlar listelenir), dönüşüm kuru eksik olduğunda, mağazada Çin bölgesi yoksa veya mağazada kg ağırlık birimi ya da cm uzunluk birimi yoksa ve varsayılan birimi uzantı tarafından bilinmiyorsa size bildirir.

Genel

Enable SF Express: SF Express'in ödeme sayfasında gösterilip gösterilmeyeceğini belirler. Varsayılan: kapalı.

Method title: sepette ve ödeme sayfasında gösterilen yöntem adı. Varsayılan: SF Express. Zorunlu, en fazla 64 karakter.

Tax class: kargo maliyetinin vergi sınıfı veya No tax. Bir vergi sınıfı seçilirse, mağazanızın kargo vergisi maliyetin üzerine eklenir. SF Express fiyatı tahsil etmek istediğiniz her şeyi zaten içeriyorsa No tax seçin.

Sort order: SF Express'in ödeme sayfasındaki kargo yöntemleri arasındaki konumu. Tam sayı.

SF Express FengQiao API (canlı 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 temizler, böylece kimlik bilgilerini kaldırabilirsiniz.

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

Sandbox: sandbox kimlik bilgileriyle test için FengQiao sandbox ortamı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: fiyatı gösterilecek SF Express ürünü.

Sender province: paketlerin gönderildiği il, örneğin Guangdong / 广东. Mağaza Çin'deyse ilk seçenek mağazanızın bölgesini (System > Settings > Store > Local) kullanır. Ardından il adıyla birlikte Same as the store region görünür; aksi halde — Select —.

Sender city: şehrin standart Çince adı, örneğin 深圳市. Canlı fiyatlar için zorunludur: OpenCart'taki mağaza adresi serbest metindir, bu yüzden şehir oradan alınmaz.

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), örneğin 0.13. Bu olmadan canlı fiyatlar kullanılmaz. Mağaza para biriminiz CNY ise alan bunun gerekli olmadığını belirtir ve fiyatlar olduğu gibi kullanılır. Ondalık ayırıcı olarak nokta da virgül de kabul edilir.

Chinese provinces: SF Express'in 32 il, özerk bölge ve belediyesinden kaçının OpenCart'ta Çin bölgesi olduğunu ve hangilerinin eksik olduğunu gösterir. Eksik bir ildeki adresler tablo fiyatını alır. Yalnızca eksik olanları Çin bölgesi olarak eklemek için Add Chinese provinces düğmesine tıklayın (ISO kodu, "Tibet / 西藏" gibi bir ad). Mevcut bölgeler değiştirilmez. Bu tıklama olmadan hiçbir şey değişmez. Bu şekilde eklenen bölgeler, kaldırmanın ardından da mağazada kalır.

Fiyat tablosu ve yedek (Hong Kong, Makao, Tayvan ve diğer ülkeler için, canlı fiyatlar ayarlanmamışsa veya SF Express fiyat döndürmezse kullanılır; 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, silmek için kaldırma düğmesine 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 kademesi fiyatı, o kademedeki paketler için temel fiyatın yerini alı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. Base fiyatı 0 ise ücretsiz kargo anlamına gelir. Temel fiyat boşsa bu ülke için fiyat yoktur ve yedek maliyet kullanılır. "9.99" ve "9,99" kabul edilir. Hiç fiyatı olmayan bir satır kaydedilmez.

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.

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

Koşullar

Free shipping from: kargonun ücretsiz olduğu, kargo gerektiren ürünlerin sepet ara toplamı (kupon sonrası, vergi öncesi). Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın. Ücretsiz kargo herhangi bir fiyat aramasından önce kontrol edilir; bu nedenle bu tutardan itibaren, tablosunda satırı veya Fallback cost değeri olmayan bir ülke dahil, yöntem kullanılabilir olduğu her hedef için ücretsiz sunulur.

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): yöntemi göstermek için gereken en düşük sepet ağırlığı (kg). Ürün ağırlıkları kendi ağırlık sınıflarından dönüştürülür. 0 sınır olmadığı anlamına gelir.

Max weight (kg): bu sepet ağırlığının üzerinde yöntem gizlenir. Varsayılan: 50. 0 veya boş, sınır olmadığı anlamına gelir.

Geo zone: SF Express'i yalnızca bu geo bölgesindeki adresler için sunar. All zones (varsayılan) sınır olmadığı anlamına gelir. Geo bölgeleri System > Localisation > Geo Zones altında yönetilir. Ignore shipping zones açıkken kontrol edilmez.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: SF Express'i geo bölgesinden bağımsız olarak aşağıdaki ülkeler için sunar. Kapalıyken geo bölgesi belirler ve ülke listesi kullanılmaz.

Countries: bu mod için hedef ülkeler. Etkin olan 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_sfex_debug.log.php dosyasına yazar. Dosya web üzerinden okunamaz. API hataları, bu seçenek kapalı olsa bile her zaman günlüğe yazılır. Checkword veya müşteri adresleri yazılmaz. Dosya 5 MB'a ulaştığında vfd_sfex_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log: günlüğün boyutunu ve son kayıtlarını gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken uzantıyı kaldırmak ayarları ve günlüğü siler. Kapalıyken (varsayılan) yeniden kurulum için saklanırlar. Önbellekteki fiyatlar her zaman silinir.

İçe / Dışa Aktarma

Export: ayarları, checkword olmadan bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın.

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. Değerler normal bir kayıt gibi denetlenir. Kayıtlı checkword korunur.

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

OpenCart kargo yöntemlerini gösterdiğinde, uzantıdan SF Express fiyatını ister. Bir Geo zone ayarlıysa ve adres bunun dışındaysa SF Express sunulmaz (Ignore shipping zones açık değilse). Yalnızca Requires Shipping değeri Yes olan ürünler dikkate alınır: diğerleri ağırlık eklemez ve ara toplama dahil edilmez. Ara toplam, bu ürünlerin kupon indirimi sonrası ve vergi öncesi fiyatıdır. Hediye sertifikaları, puanlar ve mağaza kredisi dikkate alınmaz. Uzantı ardından koşulları denetler: izin verilen ülkeler (Ignore shipping zones ile), sepet ağırlığı ve minimum ara toplam. Ara toplam Free shipping from değerine 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 uzantı, SF Express'e gönderici ilinizi ve şehrinizi, müşterinin il ve şehrini, sepet ağırlığını (en az 0,1 kg) ve sepet hacmini (üç boyutu da olan ürünlerden) gönderir. İstek checkword'ünüzle imzalanır. SF Express fiyatları CNY olarak döndürür; uzantı seçilen fiyatı mağazanızın varsayılan para birimine çevirir ve ondalık basamaklarına yuvarlar. Fiyat, ardından seçilen Tax class vergisiyle birlikte müşterinin para biriminde gösterilir.

SF Express adresleri standart Çince adlarla tanır. Müşterinin ili, adresin Region / State bölgesinden, adına göre eşleştirilerek alınır. "Hong Kong" bölgesi Çin anakarasının bir ili değildir ve tablo fiyatını alır. Şehir Çince yazılmalıdır, örneğin 广州市. Pekin, Şanghay, Tianjin ve Chongqing için şehir otomatik doldurulur. "Guangzhou" gibi Latin harfleriyle yazılan 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.

Canlı fiyat yoksa fiyat fiyat tablosundan, ardından Fallback cost değerinden alınır. İ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.

Uzantı yalnızca fiyat hesaplar. Gönderi belgesi veya etiket oluşturmaz, SF Express'te sipariş açmaz, kurye talebi oluşturmaz, 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ıya teslimat kuryesi olarak kullanılır. Canlı fiyatlar yalnızca Çin anakarasındaki teslimat adresleri için vardır. Uzantı FengQiao belgelerine ve simüle edilmiş yanıtlara göre geliştirilmiştir; bu nedenle canlıya geçmeden önce fiyatları SF Express hesabınızda (önce sandbox'ta) doğrulayın.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinden SF Express'i seçer; bu pencerede yöntemin adı fiyatıyla birlikte gösterilir. Yöntem, OpenCart 3'teki gibi çalışır.

Lisans anahtarı

Uzantı, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox SF Express lisans bloğu, Extensions > Extensions > Shipping > VibeFox SF Express > Edit sayfasındaki ilk bloktur ve ayarların üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blokta anahtar maskelenmiş olarak, durum (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeler görünür: 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: opencart-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 uzantı için Modify izni olan yöneticiler 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 tarihli License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa uzantı, bilinen son 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 yoksa SF Express kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. Yönetim paneline aynı tarayıcıdan giriş yapmış bir yönetici kullanıcı, yöntemi mağazada (unlicensed — visible to admins only) işaretiyle hâlâ görür; böylece anahtar satın almadan önce uzantıyı kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin 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. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez.

Bir lisans sona erdiğinde uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard veya Edit sayfası açıldığında durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir kez. Cron işi gerekmez. Uzantıyı kaldırmak 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. Geo zone ayarını kontrol edin veya Ignore shipping zones seçeneğini açın ve Countries ayarı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 fiyatı olduğunu kontrol edin. Ürünlerde Requires Shipping değerinin Yes olduğunu kontrol edin.

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

Günlükte imza hatası görünüyor: checkword yanlış veya diğer ortama ait. Sandbox ayarını kontrol edin. SF Express API'nin izinli olmadığını bildiriyorsa, fiyat sorgu API'sini FengQiao uygulamanıza ekleyin.

Tibet'teki adresler tablo fiyatını alıyor: uzantı sayfasının API bölümünde Add Chinese provinces düğmesine tıklayın.

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

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

Sayfada "Warning: You do not have permission to modify VibeFox SF Express!" yazıyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebilir. Gruba, System > Users > User Groups altında extension/shipping/vfd_sf_express (OpenCart 3) veya extension/vfd_sf_express/shipping/vfd_sf_express (OpenCart 4) için değiştirme iznini verin.

Geliştiriciler için: vfd_sf_express/quote_request ve vfd_sf_express/api_url OpenCart olayları, başka bir uzantının fiyat isteğini (örneğin başka bir ürün koduna) ve ağ geçidi URL'sini değiştirmesine izin verir.

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox SF Express yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu uzantının lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable SF Express, Sort order, Tax class ve Geo zone ayarlarını sıfırlar. Önbellekteki fiyatlar her zaman kaldırılır. Remove data on uninstall açıksa diğer ayarlar ve günlük de silinir. Kapalıysa saklanır ve uzantıyı yeniden kurduğunuzda tekrar kullanılır. Add Chinese provinces ile eklenen Çin bölgeleri kalır. Mevcut siparişler kargo yöntemini ve maliyetini korur.

OpenCart 4'te, uzantının dosyalarını da kaldırmak için kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu uzantılar listesinde VibeFox SF Express yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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