VibeFox Blue Express for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

Blue Express hesabı (yalnızca canlı tarifeler için): canlı tarifeler için bir Blue Express e-ticaret hesabı ve API anahtarı (x-api-key) gerekir. Bunu Blue Express'ten isteyin: developers.bluex.cl veya gpo.integraciones@bx.cl. Kullandığınız hizmet (EX, PY veya MD) Blue Express sözleşmenizde etkinleştirilmiş olmalıdır. Yalnızca sabit fiyat kullanıyorsanız API anahtarına ihtiyacınız yoktur.

Teslim alma noktaları: Blue Express haritası, müşterinin tarayıcısında widget-pudo.blue.cl adresinden yüklenir.

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. vfd_blue_express 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 Blue Express, ya da Plugins 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. API anahtarını, hizmeti, çıkış ilçe kodunu (örneğin SCL), mağaza para biriminiz CLP değilse CLP kurunu ve sabit fiyatları (örneğin CL=4500) girin. Bkz. Yapılandırma.

6. WooCommerce > Settings > Shipping > Shipping zones bölümüne gidin ve Şili bölgenize VibeFox Blue Express ekleyin. Yöntem ayarlarında başlığı ve teslimat türünü (eve teslimat ya da Blue Express noktasından teslim alma) seçin. Her iki seçeneği sunmak için yöntemi iki kez ekleyin.

Yapılandırma

Ana ayarlar WooCommerce > Settings > Shipping > VibeFox Blue Express altındadır. Tüm kargo bölgeleri için geçerlidir. Yöntemi veya canlı tarifeyi gizleyecek ayarlarla ilgili uyarılar (API anahtarı yok, CLP kuru yok, sabit fiyat tablosu boş) sayfanın üst kısmında gösterilir. Ayarları kaydetmek önbelleği temizler.

Bölge penceresi (yöntemi bir kargo bölgesine eklediğinizde)

Title: bu bölge için müşteriye gösterilen kargo yöntemi adı. Genel Name değerini kullanmak için boş bırakın.

Delivery type: As in the global settings (varsayılan), Home delivery veya Pickup at a Blue Express point (PUDO). Hem eve teslimat hem teslim alma sunmak için yöntemi bir bölgeye iki kez ekleyin.

Genel

Enable/Disable: yöntemi tüm kargo bölgelerinde açar veya kapatır.

Name: ödeme sayfasında gösterilen kargo yöntemi adı. Bir bölge kendi başlığını ayarlayabilir. Varsayılan: Blue Express.

Tax status: Blue Express fiyatları IVA dahildir. WooCommerce'in üzerine vergi eklememesi gerekiyorsa None, eklemesi gerekiyorsa Taxable seçin.

Blue Express API (canlı tarifeler için gerekli)

API key: Blue Express API anahtarınız (x-api-key başlığı). Bu olmadan yalnızca sabit fiyatlar kullanılır.

Service: tarife için kullanılan Blue Express hizmeti: Express (EX) (varsayılan), Prioritario (PY) veya SameDay (MD). Blue Express sözleşmenizde etkin olmalıdır.

Origin district code: gönderim yaptığınız yerin Blue Express ilçe kodu, örneğin Santiago için SCL (varsayılan). Emin değilseniz Blue Express'e sorun.

CLP per 1 (your currency): Blue Express fiyatları Şili pesosu (CLP) cinsindendir. Mağazanız başka bir para birimi kullanıyorsa, o para biriminin bir biriminin kaç CLP ettiğini girin, örneğin 1050. Bu değer olmadan canlı tarifeler kullanılmaz. Mağaza para biriminiz CLP ise yok sayılır.

Fiyat

Rate source: fiyatın nasıl hesaplanacağı.

Fixed prices: her ülke için bir satır, COUNTRY_CODE=PRICE biçiminde ve mağaza para biriminizde, örneğin CLP mağazasında CL=4500 veya EUR mağazasında CL=4.50. Ondalık ayırıcı olarak virgül veya nokta kabul edilir. Geçersiz satırlar kaydederken bildirilir. Sabit fiyatlar her ülke için kullanılabilir.

Fixed price per: Order fiyatı bir kez alır. Item (price x quantity) fiyatı sepetteki ürün sayısıyla çarpar. Bu yalnızca sabit fiyat için geçerlidir. API tarifesi her zaman tüm gönderi içindir.

Koşullar

Min weight (kg): sepet bundan az tartıyorsa yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Max weight (kg): sepet bundan fazla tartıyorsa yöntemi gizler. Varsayılan: 100. 0 sınır olmadığı anlamına gelir.

Minimum order subtotal: yöntemi yalnızca bu sepet ara toplamından itibaren gösterir (mağaza para birimi). Her zaman göstermek için boş bırakın.

Excluded shipping classes: sepetteki herhangi bir ürün seçilen bir WooCommerce kargo sınıfına aitse yöntem gizlenir.

Ücretsiz kargo

Free shipping: bir sepet ara toplamından itibaren ücretsiz kargoyu açar.

Free from subtotal: kargonun ücretsiz olduğu sepet ara toplamı (mağaza para birimi).

Blue Express noktalarından teslim alma (PUDO)

Pickup point by default: açıksa Blue Express yöntemleri, müşterinin seçtiği bir Blue Express noktasına teslim eder. Delivery type = As in the global settings olan bölge yöntemleri için varsayılandır. Müşteri siparişi vermek için bir nokta seçmelidir.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: yöntem, ilgili kargo bölgesine eklenmemiş olsa bile sunulur. Bu durumda genel ayarları kullanır (bölge başlığı ya da teslimat türü yoktur).

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız tüm ülkeleri kullanmak için boş bırakın. Yalnızca Ignore shipping zones ile kullanılır.

Gelişmiş

Debug log: istekleri ve kararları WooCommerce > Status > Logs içine, kaynak "vfd-blue-express" olarak kaydeder. API hataları her zaman kaydedilir. API anahtarı ve müşteri adresleri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek ayarlarını ve bölge yöntemlerini kaldırır. Devre dışı bırakmak ayarları asla silmez. Siparişlerde kaydedilmiş teslim alma noktaları korunur.

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

Müşteri bir teslimat adresi girdiğinde eklenti sepet ağırlığını, Minimum order subtotal değerini ve Excluded shipping classes ayarlarını kontrol eder. Ücretsiz kargo uygulanırsa tarife 0 olur ve Blue Express'e istek gönderilmez.

Canlı tarife için adresin Şili'de, bölge ve şehir (komün) bilgisiyle girilmiş olması gerekir. Eklenti önce Blue Express'ten komünü tanımasını ister, ardından hizmet, çıkış ilçesi, varış ve paketler için fiyat ister. Her ürün, ağırlığı ve boyutları kg ve cm'ye çevrilmiş olarak gönderilir. Ağırlığı veya boyutu olmayan ürünler 0,01 kg, 10 x 10 x 10 cm olarak gönderilir. Beyan edilen değer CLP olarak gönderilir. CLP fiyatı mağazanızın para birimine çevrilir.

Tarifeler 1 saat, komün verileri 12 saat önbelleğe alınır. Başarısız bir API çağrısı 5 dakika hatırlanır ve zaman aşımı 10 saniyedir; böylece yavaş veya erişilemeyen bir API her ödeme sayfası yenilemesini yavaşlatmaz. API hataları müşteriye asla gösterilmez: yöntem gizlenir veya yedek modda sabit fiyat kullanılır. Nedeni günlüğe yazılır.

Yöntem klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti Blue Express'te gönderi veya etiket oluşturmaz, takip numarası atamaz ve takip güncellemeleri göstermez. Gönderiyi Blue Express hesabınızda oluşturun. Komün bazında bölgesel tarife tabloları yoktur: Blue Express API tarifesini ya da ülke başına tek bir sabit fiyatı kullanın. Canlı tarifeler yalnızca Şili için çalışır.

Teslim alma noktaları

Teslimat türü Pickup at a Blue Express point (PUDO) olduğunda müşteri, Blue Express seçeneğinin altında hem klasik hem blok ödeme sayfasında Choose pickup point düğmesini görür. Düğme, müşterinin bir nokta seçtiği resmi Blue Express haritasını açar. Seçilen nokta adı ve adresiyle gösterilir ve düğme Change pickup point olarak değişir. Ardından tarife, Blue Express teslim alma (PUDO) ücretiyle yeniden hesaplanır.

Nokta seçilmeden sipariş verilemez: müşteri Please choose a Blue Express pickup point. uyarısını görür. Bu kontrol sunucuda yapılır.

Seçilen nokta, Blue Express acente kodu, adı ve adresiyle birlikte siparişe kaydedilir. Yönetici sipariş ekranında, teslimat adresinin altında Blue Express pickup point olarak gösterilir. Başka bir nokta seçmek ya da acente kodunu, adı ve adresi elle girmek için Edit düğmesine tıklayın, ardından Save pickup point düğmesine tıklayın. Değişiklik bir sipariş notu olarak kaydedilir. Müşteri noktayı sipariş sayfasında ve sipariş e-postalarında (HTML ve düz metin) görür. Mağazaya giden e-postalar da acente kodunu gösterir. Mevcut siparişler kendi teslim alma noktası verilerini korur.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Blue Express 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 aktif olduğunu ve alan adınızı. Check now ile durumu yeniden kontrol edebilir, Change key ile başka bir anahtar girebilir ve Remove key ile anahtarı bu siteden kaldırabilirsiniz. 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 Blue Express müşterilere ödeme sayfasında gösterilmez. Oturum açmış mağaza yöneticileri yine de (unlicensed — visible to admins only) etiketiyle görür; 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 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

Blue 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 adresinin bölgesine eklendiğini kontrol edin (ya da Ignore shipping zones açık ve ülke izinliyse). Ayarlar sayfasının üstündeki uyarıları okuyun. Ağırlık sınırlarını, Minimum order subtotal ve Excluded shipping classes ayarlarını ve sabit fiyat kullanıyorsanız ya da yedek modu kullanıyorsanız Fixed prices alanında ülke için bir satır olup olmadığını kontrol edin.

Canlı tarifeler görünmüyor: Blue Express API only seçiliyken tarife yoksa yöntem gizlenir. Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve WooCommerce > Status > Logs sayfasını açın (kaynak "vfd-blue-express"). Yaygın nedenler: API anahtarı yok, mağaza para birimi CLP değil ve kur yok, adreste bölge ya da komün eksik, komünün Blue Express tarafından tanınmaması ya da bir API hatası (örneğin API anahtarı reddedildiğinde HTTP 401 veya 403). Blue Express API, fixed price if the API gives no rate seçiliyken, siz sorunu çözerken müşteriler yine sabit fiyatı alır.

Blue Express fiyatının üzerine vergi ekleniyor: Blue Express fiyatları IVA dahildir. WooCommerce'in üzerine vergi eklememesi gerekiyorsa Tax status değerini None olarak ayarlayın.

Harita açılmıyor: harita, müşterinin tarayıcısında widget-pudo.blue.cl adresinden yüklenir. Bu nedenle bu adrese erişilebilmeli ve sitenizde engellenmemelidir.

Bir değişiklikten sonra tarifeler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış tarifeleri ve komün verilerini temizler.

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 serbest bırakı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şılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları korur ve yalnızca önbelleği temizler. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı, lisans durumu ve önbelleği 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, daha sonra yeniden kurulum için saklanırlar. Siparişlerde kaydedilmiş teslim alma noktaları hiçbir zaman kaldırılmaz.

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