VibeFox bpost Cubee for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin olmalıdır. Eklenti WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

bpost Shipping Platform hesabı (yalnızca teslim alma noktası seçici için): eklenti, teslim alma noktalarını bpost Shipping Platform API'si üzerinden arar. plugins.bpost.be adresinden 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 (ortak anahtar), Passphrase (özel anahtar) ve bir App ID (X-APPID). App ID, entegrasyonunuz için bpost tarafından verilir; bpost e-ticaret destek ekibinden (eol@bpost.be) talep edin. Ayrıca sözleşmenizdeki taşıyıcı kimliğine (68 = bpost) ihtiyacınız var. Tam anahtarlar olmadan yöntem sabit fiyatlı bir kargo yöntemi olarak çalışmaya devam eder, ancak müşteriden teslim alma noktası seçmesi istenmez.

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 sayfasına gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_bpost_cubee klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox bpost Cubee ya da Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Fiyatlarınızı girin ve teslim alma noktası seçici için bpost API anahtarlarını girin (bkz. Yapılandırma).

6. VibeFox bpost Cubee yöntemini, WooCommerce > Settings > Shipping > Shipping zones bölümünde Belçika için kargo bölgenize ekleyin ya da 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 bpost Cubee. Ayarlar tüm kargo bölgelerinde geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölge için ödeme sayfasında bu seçeneğin adı. Genel Name değerini kullanmak için boş bırakın.

Ayarlar sayfası, yöntemi ya da seçiciyi sessizce gizleyen bir durum olduğunda uyarı gösterir: teslim alma noktası seçici açık ama API anahtarları eksik, Belçika için fiyat yok ya da bpost API'sine son bağlantı başarısız oldu. Ayarları her kaydettiğinizde, kayıtlı API jetonu ve önbelleğe alınmış teslim alma noktası listeleri temizlenir.

Genel

Enable/Disable: bpost paket dolabı kargosunu tüm bölgelerde aynı anda açar veya kapatır.

Name: müşterinin ödeme sayfasında gördüğü kargo yöntemi adı. Varsayılan: bpost parcel locker.

Tax status: Taxable fiyatlarınıza WooCommerce vergisini ekler, None ise fiyatların kesin olduğu anlamına gelir.

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

Account ID (public key): bpost Shipping Platform hesabınızın ortak anahtarı; plugins.bpost.be üzerindeki Key management bölümünden alın.

Passphrase (private key): her isteği imzalamak için kullanılan özel anahtar (HMAC-SHA256). Asla bpost'a gönderilmez ve günlüğe yazılmaz.

App ID (X-APPID): entegrasyonunuz için bpost tarafından verilen 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 taşıyıcısı. Varsayılan: 68 (bpost). Sözleşmenizde etkin olan diğer taşıyıcıların kendi kimlikleri vardır.

Teslim alma noktası seçici

Pickup points: ödeme sayfası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 da doldurulmuş olması durumunda görünür.

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 para biriminde; bpost bu API üzerinden kargo fiyatı döndürmez)

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

Country prices: her ülke için CC=PRICE biçiminde bir satır, örneğin BE=4.95. *=PRICE 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 ve kaydederken bir hata mesajında listelenir. Fiyatı olmayan ülkelere (* satırı yoksa) yöntem sunulmaz.

Size prices: Price by paket boyutu olarak ayarlandığında kullanılır, S=3.50, M=4.50, L=6.00, XL=8.00 biçiminde. Boyut sepet ağırlığına göre belirlenir: S 2 kg'a kadar, M 5 kg'a kadar, L 10 kg'a kadar, XL 10 kg'ın üzeri.

Calculation: Per order fiyatı bir kez tahsil eder. Per item (price x number of items) ise fiyatı sepetteki ürün adediyle çarpar.

Koşullar

Min weight (kg): yöntemin görünmesi için gereken minimum sepet ağırlığı. 0 sınır olmadığı anlamına gelir.

Max weight (kg): sepet ağırlığı bu değerin üzerindeyse yöntem 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: yöntemi yalnızca sepet ara toplamı (vergi hariç) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Excluded shipping classes: sepetteki herhangi bir ürün bu WooCommerce kargo sınıflarından birine aitse yöntemi gizler.

Ürün ağırlıkları, mağazanızın ağırlık biriminden kilograma çevrilir.

Ücretsiz kargo

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

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı (vergi hariç). Yalnızca Free shipping açıkken kullanılır.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: yöntemi bir bölgeye eklemeden aşağıdaki ülkelerde sunar.

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ı WooCommerce > Status > Logs içinde, kaynak vfd-bpost-cubee olarak günlüğe yazar. API hataları bu seçenek kapalı olsa bile her zaman günlüğe yazılır. Anahtarlar, jetonlar ve müşteri verileri asla günlüğe yazılmaz.

Remove data on uninstall: açık olduğunda eklentiyi silmek, ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak hiçbir veriyi silmez. Siparişlerde kayıtlı teslim alma noktaları her zaman korunur.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir ücret ister. Eklenti koşulları kontrol eder: teslimat ülkesi, sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Ardından fiyatı ülke listesinden ya da paket boyutuna göre alır, ürün başına modda ürün adediyle çarpar ve ücretsiz kargo geçerliyse sıfıra ayarlar.

Müşteri bpost ücretini seçtiğinde, altında bir arama alanı, bir Search düğmesi ve bir teslim alma noktası listesi görünür. Arama alanı boşsa, ödeme adresindeki posta kodu otomatik olarak aranır. Müşteri başka bir posta kodu ya da şehir adı girebilir. Her nokta adı ve adresiyle gösterilir. En fazla 50 nokta listelenir. Teslim alma noktası listesi Hollandaca sitelerde Hollandaca, diğer durumlarda Fransızca olarak istenir.

Müşteri bir teslim alma noktası seçmek zorundadır. Seçim yapılmazsa klasik ödeme sayfası Please select a bpost pickup point. mesajını gösterir; blok ödeme sayfası da siparişi aynı mesajla vermez. Seçim ödeme oturumu boyunca saklanır, bu nedenle sayfayı yenilemek seçimi kaybettirmez.

Teslim alma noktalarını listelemek için eklenti, bpost'a yalnızca aranan posta kodunu ya da şehri, ülkeyi ve taşıyıcı kimliğini gönderir; bunlar anahtarlarınızla imzalanır. Müşterinin adı, e-posta adresi veya adres satırı gönderilmez. API jetonu otomatik olarak istenir ve yenilenir. bpost bir jetonu reddederse yeni bir jeton 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 eklenti 5 dakika sonra yeniden dener. API zaman aşımı 15 saniyedir.

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 sabit fiyat 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 ya da Shipping Manager hesabınızda oluşturun; teslim alma noktası kimliği siparişte bulunur.

Teslim alma noktaları

Seçilen teslim alma noktası (ad ve adres) ile kimliği siparişe kaydedilir. Yönetici sipariş ekranında teslimat adresinin altında bpost pickup point olarak görünür. Change bağlantısına tıklayın, bir posta kodu ya da şehir arayın ve listeden başka bir nokta seçin. Sipariş hemen güncellenir ve bpost pickup point changed to: … sipariş notu eklenir. Change bağlantısı yalnızca API anahtarları doldurulduğunda kullanılabilir.

Müşteriler teslim alma noktasını teşekkür sayfasında ve My account > Orders bölümünde görür. Ayrıca sipariş e-postalarına hem HTML hem de düz metin olarak eklenir.

Paket dolabı ve ev teslimatını birlikte sunmak için aynı bölgeye başka bir kargo yöntemi, örneğin Flat rate ekleyin. Teslim alma noktası seçici yalnızca bpost ücretinin altında görünür.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox bpost Cubee sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu 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 düğmesini 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 sitenin alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan bpost yöntemi ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yöntemi yine görür; yanında (unlicensed — visible to admins only) ifadesi bulunur. Böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler 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

bpost ö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 olup ülkeye izin veriliyor olmalı). Ülkenin bir fiyatı ya da bir *=PRICE satırı olduğunu kontrol edin; ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını da inceleyin. Belçika'nın fiyatı yoksa ayarlar sayfası bir 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 tamamının dolu olduğunu kontrol edin. Anahtarlar eksikse ayarlar sayfası bir 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. Nedeni WooCommerce > Status > Logs içinde (kaynak vfd-bpost-cubee) ve ayarlar sayfasında görebilirsiniz. Eklenti 5 dakika sonra otomatik olarak yeniden dener. Ayarları kaydetmek hemen yeniden dener.

Bu posta kodu ya da şehir için teslim alma noktası bulunamadı: bpost bu arama için nokta döndürmedi. Müşteriden yakın bir posta kodu ya da ş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. Country prices içinde CC=PRICE biçimine uymayan satırlar yok sayılır; kaydettikten sonra çıkan hata mesajı bunları listeler.

Fiyatlara vergi dahil mi? Tax status Taxable olarak ayarlandığında WooCommerce fiyatlarınızın üzerine vergi ekler. None seçildiğinde fiyatlar kesindir.

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 hak 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 ayarları korur; yalnızca API jetonunu ve önbelleğe alınmış teslim alma noktası listelerini temizler. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu, API jetonu ve önbellekler her zaman kaldırılır. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanırlar. Siparişlerde kayıtlı teslim alma noktaları sipariş geçmişinin parçasıdır ve asla silinmez.

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