VibeFox bpost Cubee for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 - 9.x.

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

bpost Shipping Platform hesabı (yalnızca teslim alma noktası seçici için): modül, teslim alma noktalarını bpost Shipping Platform API'si üzerinden arar. plugins.bpost.be adresinde bpost Shipping Platform hesabınıza giriş yapın ve anahtarları Settings > Key management bölümünde oluşturun. Üç değere ihtiyacınız var: Account ID (genel anahtar), Passphrase (özel anahtar) ve bir App ID (X-APPID). App ID, entegrasyonunuz için bpost tarafından verilir; bpost e-ticaret desteğinden (eol@bpost.be) isteyin. Ayrıca sözleşmenizdeki taşıyıcı kimliğine (68 = bpost) ihtiyacınız var. Eksiksiz anahtarlar olmadan kargo firması yine sabit fiyatlarla çalışır, ancak müşterilerden teslim alma noktası seçmeleri istenmez.

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

Kurulum

1. Yönetici panelinde 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 tamamlandığında Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox bpost Cubee'yi bulup Configure düğmesine tıklayın.

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

4. Fiyatlarınızı ve teslim alma noktası seçici için bpost API anahtarlarını girin (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, Pickup point or parcel locker teslimat süresi metniyle birlikte bpost parcel locker kargo firmasını oluşturur. Kargo firması Belçika bölgesine ve tüm müşteri gruplarına bağlanır; vergi kuralı yoktur. Bölgeleri, müşteri gruplarını, teslimat süresi metnini ve logoyu Shipping > Carriers bölümünde değiştirebilirsiniz. Fiyatları burada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox bpost Cubee > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kaydetme işlemi ayrıca saklanan API token'ını ve önbelleğe alınmış teslim alma noktası listelerini temizler.

Sayfa, kargo firmasını veya seçiciyi sessizce gizleyen durumlarda uyarı gösterir: teslim alma noktası seçici açık ama API anahtarları eksik, Belçika (BE) için fiyat yok ve varsayılan fiyat da yok, bpost API'sine son bağlantı başarısız oldu, mağazanın ağırlık birimi modül tarafından bilinmiyor (International > Localization, Local units bölümünden ayarlayın) veya bpost kargo firması bulunamadı. Kaydettiğinizde okunamayan Country prices satırları bir uyarıda listelenir; herhangi bir boyut tanınmayan Size prices değeri de öyle. Sayı olmayan veya negatif bir ağırlık ya da tutar kaydedilmez: uyarı alanı belirtir ve önceki değer korunur. Min weight (kg), Max weight (kg) değerinden büyükse ağırlıklar da kaydedilmez.

Genel

Enable/Disable: bpost parcel locker kargosunu açar veya kapatır. Bu, Shipping > Carriers bölümündeki kargo firması durumuyla aynı anahtardır.

Name: müşteriye ödeme sırasında gösterilen kargo yöntemi adı (kargo firmasının adı). Varsayılan: bpost parcel locker. Boş bırakırsanız varsayılan kullanılır. En fazla 64 karakter; daha uzun ad reddedilir ve hiçbir şey kaydedilmez.

Tax status: None fiyatların nihai olduğu anlamına gelir. Bir vergi kuralı olan Taxable, o kuralın vergisini fiyatlarınıza ekler. Seçim kargo firmasına kaydedilir.

bpost API (teslim alma noktası araması) (yalnızca teslim alma noktası seçici için gerekli)

Account ID (public key): plugins.bpost.be üzerindeki Key management bölümünden alınan bpost Shipping Platform hesabınızın genel anahtarı. Bu alanı boşaltmak kayıtlı Passphrase'i de siler.

Passphrase (private key): her isteği imzalamak için kullanılan özel anahtar (HMAC-SHA256). Hiçbir zaman bpost'a gönderilmez ve 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.

App ID (X-APPID): bpost'un entegrasyonunuz için verdiği uygulama kimliği. X-APPID başlığında gönderilir.

Carrier ID: teslim alma noktaları ve paket dolaplarının listelendiği bpost Shipping Platform sözleşmenizin kargo firması. Varsayılan: 68 (bpost). Sözleşmenizde etkin olan diğer kargo firmalarının kendi kimlikleri vardır.

Teslim alma noktası seçici

Pickup points: ödeme sırasında teslim alma noktası ve paket dolabı seçicisini gösterir. Varsayılan olarak açıktır. Seçici yalnızca üç API anahtarının tamamı doldurulduğunda görünür ve teslim alma noktası yalnızca o zaman zorunlu olur.

Search field width: posta kodu / şehir alanının CSS genişliği, örneğin 100% veya 300px. Varsayılan: 100%.

Pickup point list width: teslim alma noktası listesinin CSS genişliği, örneğin 100% veya 400px. Varsayılan: 100%.

Fiyatlar (mağazanızın varsayılan para biriminde, vergi hariç; bpost bu API üzerinden kargo ücretlerini döndürmez)

Price by: fiyatın nasıl seçileceği.

Country prices: ülke başına bir satır, CC=FİYAT biçiminde, örneğin BE=4.95. *=FİYAT satırı diğer tüm ülkeler için fiyatı belirler, örneğin *=9.95. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir. Geçersiz satırlar yok sayılır. Fiyatı olmayan ülkelere (bir * satırı yoksa) kargo firması sunulmaz.

Size prices: Price by paket boyutu olduğunda kullanılır; S=3.50, M=4.50, L=6.00, XL=8.00 biçimindedir. Boyut sepet ağırlığından belirlenir: S 2 kg'a kadar, M 5 kg'a kadar, L 10 kg'a kadar, XL üzeri.

Calculation: Per order fiyatı bir kez alır. Per item (price x number of items) ise sepetteki ürün sayısıyla çarpar.

Fiyatlar varsayılan para biriminizin ondalık basamaklarına yuvarlanır ve ardından müşterinin sepet para biriminde gösterilir.

Koşullar

Min weight (kg): kargo firmasının görünmesi için gereken 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): kargo firması bu sepet ağırlığının üzerinde gizlenir. Varsayılan: 30, çünkü bpost paket dolapları 30 kg'a kadar paketleri kabul eder. 0 sınır olmadığı anlamına gelir.

Minimum order amount: kargo firmasını yalnızca sepet ara toplamı bu tutara ulaştığında gösterir. Ara toplam, indirimlerden sonra ve vergi hariç olarak kargo gerektiren ürünleri sayar. Kargo firmasını her zaman göstermek için alanı boş bırakın.

Ücretsiz kargo

Free shipping: aşağıdaki tutardan itibaren ücretsiz teslimatı açar.

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergi hariç). Yalnızca Free shipping açıkken kullanılır. Ülkenin yine bir fiyatı olmalıdır; aksi halde kargo firması sunulmaz.

Kargo bölgesi olmadan kullanılabilirlik

Normalde kargo firması Shipping > Carriers içindeki kargo bölgelerinde sunulur. Kurulumda bu Belçika bölgesidir.

Ignore shipping zones: kargo firmasını bir bölgeye eklemeden aşağıdaki ülkelerde sunar. Bu durumda kargo firması, daha sonra oluşturacaklarınız dahil tüm etkin bölgelere bağlanır. Seçeneği tekrar kapattığınızda kargo firması önceki bölgelerini geri alır.

Countries: bu mod için hedef ülkeler. Varsayılan: Belçika. 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: API isteklerini ve fiyat hesaplamalarını modül klasöründeki logs/vfd_bpst_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. Anahtarlar ve token'lar hiçbir zaman günlüğe yazılmaz.

Log: hata ayıklama günlüğünün boyutunu ve 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 modül ayarlarını ve kargo firmasını siler. Siparişlerde kayıtlı teslim alma noktaları her zaman korunur.

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

Teslimat adımında PrestaShop modülden bpost fiyatını ister. Yalnızca kargo gerektiren ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül koşulları kontrol eder: Ignore shipping zones ülkeleri (açıksa), sepet ağırlığı ve minimum sipariş tutarı. Ardından fiyatı ülke listesinden veya paket boyutuna göre alır, ürün başına modda ürün sayısıyla çarpar ve ücretsiz kargo uygulandığında sıfırlar. Fiyat için bpost'a hiçbir istek gönderilmez.

bpost kargo firmasının altında müşteri bir Postal code or city alanı, bir Search düğmesi ve bir teslim alma noktası listesi görür. Müşteri kargo firmasını seçtiğinde ve henüz arama yapmadıysa teslimat adresinin posta kodu otomatik olarak aranır. Müşteri başka bir posta kodu veya şehir adı girebilir. Her nokta adı ve adresiyle gösterilir. En fazla 50 nokta listelenir. Mağaza dili Hollandaca ise liste Hollandaca, değilse Fransızca istenir.

Müşteri bir teslim alma noktası seçmelidir. Seçmeden Continue düğmesine basarsa teslimat adımında Please select a bpost pickup point. mesajı görünür ve Place order düğmesi aynı mesajla sayfada tutulur. Yalnızca arama için bpost listesindeki bir nokta kabul edilir. Aksi halde müşteri The selected bpost pickup point is not in the list of your search. Please choose another one. mesajını görür. Arama ve seçim sepetle birlikte kaydedilir; bu nedenle sayfayı yenilemek bunları kaybettirmez. Yeni bir arama önceki seçimi temizler.

Teslim alma noktalarını listelemek için modül bpost'a yalnızca aranan posta kodunu veya şehri, ülkeyi ve taşıyıcı kimliğini gönderir; bunlar anahtarlarınızla imzalanır. API token'ı otomatik olarak istenir ve yenilenir. bpost bir token'ı reddederse yeni bir token bir kez istenir ve arama tekrarlanır. Arama sonuçları 6 saat önbellekte tutulur. bpost yanıt vermezse müşteri Pickup points cannot be loaded right now. Please try again in a few minutes or choose another shipping method. mesajını görür ve modül 5 dakika sonra yeniden dener. API zaman aşımı 15 saniyedir.

Shipping > Carriers bölümünde kargo firması siparişler aldıktan sonra düzenlenirse PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca sabit fiyatları kullanır. bpost'tan canlı ücret almaz, gönderi oluşturmaz, etiket yazdırmaz ve paketleri takip etmez. Teslim alma noktaları harita üzerinde değil, liste olarak gösterilir. Gönderileri bpost Shipping Platform veya Shipping Manager hesabınızda oluşturun; teslim alma noktası kimliği siparişte bulunur.

Teslim alma noktaları

Sipariş verildiğinde seçilen teslim alma noktası (ad ve adres) ve kimliği siparişle birlikte kaydedilir. Yönetici sipariş sayfasında bpost pickup point bloğu noktayı ve kimliğini gösterir ya da No pickup point was selected for this order. mesajını verir. Change düğmesine tıklayın, bir posta kodu veya şehir arayın, listeden başka bir nokta seçin ve Save düğmesine tıklayın. Sipariş hemen güncellenir ve sayfa Pickup point updated. mesajını gösterir. Debug log açıksa değişiklik hata ayıklama günlüğüne yazılır. Change bağlantısı yalnızca API anahtarları doldurulmuşsa kullanılabilir. Yeni bir nokta kaydetmek için siparişleri düzenleme izni gerekir; aksi halde sayfa Permission denied. mesajını gösterir. Modules sayfalarına erişim gerekmez.

PrestaShop bir sepeti birden çok siparişe bölerse teslim alma noktası ilk siparişte kalır. Diğer siparişlerde teslim alma noktası olmaz ve hata ayıklama günlüğü ilk siparişin adını içeren bir hata gösterir; bu paketler için noktayı bpost'ta elle ayarlayın.

Müşteriler teslim alma noktasını sipariş onay sayfasında ve hesaplarındaki sipariş ayrıntılarında bpost pickup point: olarak görür. Ayrıca sipariş onay e-postasında kargo firması adına eklenir. Mağazaya giden yeni sipariş e-postası (e-posta bildirimleri modülünü kullanıyorsanız) da nokta kimliğini içerir.

Paket dolabı ve ev teslimatını birlikte sunmak için aynı bölgede ev teslimatı için başka bir kargo firması kullanın. Teslim alma noktası seçici yalnızca bpost kargo firması altında görünür.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox bpost Cubee lisans bloğu, ayarların üstünde, Modules > Module Manager > VibeFox bpost Cubee > Configure sayfasındaki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı gizli olarak, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-shipping-bpost-cubee 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 yönetici panelinin diline uyar (İ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 veya hesabınızda bir alan adı yuvası 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ızdan serbest bırakın.

Etkin bir anahtar olmadan bpost kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop'un mağaza ön yüzü yönetici paneline giriş yaptığınızı bilmez; bu yüzden kargo firması sizden de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager bölümündeki 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. Yönetici panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonra haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

bpost ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde kargo firmasının müşterinin ülke bölgesini ve müşteri grubunu kapsadığını ya da Ignore shipping zones seçeneğinin açık ve ülkenin Countries içinde olduğunu kontrol edin. Ülkenin bir fiyatı olduğunu veya bir *=FİYAT satırı bulunduğunu kontrol edin; ağırlık sınırlarını ve Minimum order amount değerini de inceleyin. Ürün sayfasında ürünler belirli kargo firmalarıyla sınırlandırılmış olabilir. Ayarlar sayfası, Belçika'nın fiyatı yoksa uyarı gösterir.

Ödeme sayfasında teslim alma noktası seçici yok: Pickup points seçeneğinin açık olduğunu ve Account ID (public key), Passphrase (private key) ve App ID (X-APPID) alanlarının dolu olduğunu kontrol edin. Anahtarlar eksikse ayarlar sayfası uyarı gösterir.

Müşteriler "Pickup points cannot be loaded right now" mesajını görüyor: bpost yanıt vermedi ya da anahtarları reddetti. Neden ayarlar sayfasında ve hata ayıklama günlüğünde gösterilir (modül sayfasındaki Log alanı). Modül 5 dakika sonra otomatik olarak yeniden dener. Ayarları kaydetmek hemen yeniden dener.

Bu posta kodu veya şehir için teslim alma noktası bulunamadı: bpost bu arama için nokta döndürmedi. Müşteriden yakın bir posta kodu veya şehir adı denemesini isteyin ve Carrier ID değerini kontrol edin.

Virgüllü fiyatlar kullanılmıyor: hem 5,50 hem de 5.50 kabul edilir. CC=FİYAT biçimine uymayan Country prices satırları yok sayılır; kaydettikten sonraki uyarı bunları listeler.

Fiyatlar vergi dahil mi? Tax status None olduğunda fiyatlar nihaidir. Taxable bir vergi kuralıyla PrestaShop bu vergiyi fiyatlarınızın üzerine ekler.

Sayfa bpost kargo firmasının bulunamadığını söylüyor: kargo firması Shipping > Carriers bölümünde silinmiş. Yeniden oluşturmak için Modules > Module Manager bölümünde modülü sıfırlayın.

Geliştiriciler için: actionVfdBpstApiUrl ve actionVfdBpstApiLanguage hook'ları bpost API adresini ve teslim alma noktası listesinin dilini değiştirir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox bpost Cubee yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Saklanan API token'ı ve önbelleğe alınmış teslim alma noktası listeleri her zaman silinir. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişini korur), tamamlanmamış sepetlerin ayarları, günlüğü ve teslim alma noktaları da silinir. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak, kargo firmasına kaldırılmadan önceki durumunu geri verir. Modules > Module Manager bölümündeki Reset de aynı şekilde çalışır; yani devre dışı bırakılmış bir kargo firması devre dışı kalır. Siparişlerde kayıtlı teslim alma noktaları sipariş geçmişinin parçasıdır ve hiçbir zaman silinmez.

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