VibeFox Blue Express for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

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

Şili bölgeleri: gerçek zamanlı bir tarife için teslimat adresinde bir Şili bölgesi olmalıdır. Mağazanızda Şili için bölge yoksa modül bunları sizin için ekleyebilir (bkz. Yapılandırma).

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. Yönetim panelinde Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modül ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Blue Express öğesini 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. API anahtarını, hizmeti, çıkış bölge kodunu (örneğin SCL), mağaza para biriminiz CLP değilse CLP kur oranını ve sabit fiyatları (örneğin CL=4500) girin. Blue Express noktalarında teslim alma seçeneği sunmak istiyorsanız Pickup point carrier seçeneğini açın. Save düğmesine tıklayın. Bkz. Yapılandırma.

Kurulumda modül iki taşıyıcı oluşturur: Blue Express (adrese teslimat, teslimat süresi metni Home delivery, açık) ve Blue Express pickup point (teslimat süresi metni Pickup at a Blue Express point, siz açana kadar kapalı). İkisi de Şili bölgesine 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 bölümünden değiştirebilirsiniz. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Blue Express > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbelleğe alınmış Blue Express tarifelerini ve komün verilerini de temizler. Sayfanın üstünde, taşıyıcıları veya gerçek zamanlı tarifeyi gizleyecek ayarlar için uyarılar gösterilir: API anahtarı yok, döviz kuru olmadan CLP dışında mağaza para birimi, boş sabit fiyat tablosu, Şili için bölge yok, modülün tanımadığı bir mağaza ağırlık veya boyut birimi (ağırlıklar o zaman kg, boyutlar cm olarak okunur) veya silinmiş bir taşıyıcı. Geçersiz değerler hatayla reddedilir ve hiçbir şey kaydedilmez: boş veya geçersiz bir taşıyıcı adı, 64 karakterden uzun bir ad, negatif veya geçersiz bir sayı ya da Min weight (kg) değerinin Max weight (kg) değerinden büyük olması. Aşağıdaki koşullar ve fiyatlar her iki taşıyıcı için de geçerlidir.

Genel

Enable/Disable: adrese teslimat taşıyıcısını açar veya kapatır. Bu, Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır.

Name: adrese teslimat için ödeme sayfasında gösterilen taşıyıcı adı. Varsayılan: Blue Express. Zorunlu, en fazla 64 karakter.

Tax status: None (no tax on shipping) veya tanımladığınız vergi kurallarından biriyle Taxable. Blue Express fiyatları IVA içerir. PrestaShop'un üzerine vergi eklemesini istemiyorsanız None seçin. Her iki taşıyıcı için de geçerlidir.

Blue Express noktalarında teslim alma (PUDO)

Pickup point carrier: adrese teslimatın yanında ikinci bir taşıyıcı olarak, müşterinin seçtiği bir Blue Express noktasına teslimat sunar. Varsayılan olarak kapalıdır. Bu, Shipping > Carriers bölümünde Blue Express pickup point taşıyıcısının durumuyla aynı anahtardır.

Pickup point name: bir Blue Express noktasında teslim alma için ödeme sayfasında gösterilen taşıyıcı adı. Varsayılan: Blue Express pickup point. Zorunlu, en fazla 64 karakter.

Blue Express API (gerçek zamanlı 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. Kaydettikten sonra alan boş kalır ve A key is saved - leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı API anahtarını silmek için Remove the saved API key kutusunu işaretleyip kaydedin.

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 bölge kodu, örneğin Santiago için SCL (varsayılan). Emin değilseniz Blue Express'e danışın.

CLP per 1 unit of store currency: mağazanızın varsayılan para birimi CLP değilse etiket bunu gösterir, örneğin CLP per 1 EUR. Blue Express fiyatları Şili pesosu (CLP) cinsindendir. Mağaza varsayılan para biriminizin bir biriminin kaç CLP ettiğini girin, örneğin 1050. Bu olmadan gerçek zamanlı tarifeler kullanılmaz. Mağaza para birimi CLP ise yok sayılır.

Fiyat

Rate source: fiyatın nasıl hesaplanacağı. Gerçek zamanlı tarife, bölge ve komün (şehir) içeren bir Şili adresi gerektirir. Hatalar günlüğe yazılır ve müşteriye asla gösterilmez.

Fixed prices: her ülke için bir satır, COUNTRY_CODE=PRICE biçiminde, mağaza varsayılan para biriminizde, vergi hariç; örneğin CLP mağazada CL=4500 veya EUR mağazada CL=4.50. Ondalık ayırıcı olarak virgül veya nokta kabul edilir. Geçersiz satırlar yok sayılır ve kaydederken bir uyarıda listelenir. Satırı olmayan bir ülkenin sabit fiyatı yoktur, bu yüzden sabit fiyat gerektiğinde o ülke için taşıyıcılar gizlenir. Sabit fiyatlar herhangi bir ülke için kullanılabilir.

Fixed price per: Order fiyatı bir kez alır. Item (price x quantity) ise 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 ağırlıktaysa taşıyıcıları gizler. 0, sınır olmadığı anlamına gelir.

Max weight (kg): sepet bundan fazla ağırlıktaysa taşıyıcıları gizler. Varsayılan: 100. 0 sınır olmadığı, boş alan ise 100 kg anlamına gelir. Min weight (kg), Max weight (kg) değerinden büyük olamaz.

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

Ü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, indirimlerden sonra, vergi hariç). Yalnızca Free shipping açıkken kullanılır.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: her iki taşıyıcıyı her bölgede sunar. Ülkeler o zaman aşağıdaki listeyle sınırlandırılır. Sonradan oluşturulan bölgeler de eklenir. Tekrar kapattığınızda taşıyıcılar önceki bölgelerini geri alır.

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ı modül klasöründeki logs/vfd_blex_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API hataları her zaman kaydedilir. API anahtarı ve müşteri adresleri asla kaydedilmez. İşiniz bittiğinde günlüğü kapatın.

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ı ve taşıyıcıları siler. Siparişlerde kaydedilmiş teslim alma noktaları korunur.

Şili bölgeleri (yalnızca mağazanızda kullanılabilir bir Şili bölgesi yoksa gösterilir)

Blue Express, gerçek zamanlı tarife için bir Şili adresinin bölgesini (RM, VS vb.) gerektirir. PrestaShop varsayılan olarak Şili bölgelerini içermez. 16 Şili bölgesini Şili'nin eyaletleri olarak, Blue Express'in kullandığı kodlarla eklemek ve Şili adres formunda bölge alanını göstermek için Add Chilean regions düğmesine tıklayın. Zaten sahip olduğunuz bölgeler, kod veya ad bakımından, ikinci kez eklenmez. Düğmeye tıklayana kadar hiçbir şey değişmez. Bunları International > Locations > States bölümünde RM, VS vb. kodlarla kendiniz de ekleyebilirsiniz.

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

Kargo adımında PrestaShop, her Blue Express taşıyıcısının 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 Countries (Ignore shipping zones ile birlikte), sepet ağırlığını ve Minimum order subtotal değerini kontrol eder. Ücretsiz kargo uygulanıyorsa fiyat 0 olur ve Blue Express'e istek gönderilmez.

Gerçek zamanlı bir tarife için adres Şili'de olmalı, bölge ve şehir (komün) içermelidir. Modül önce Blue Express'ten komünü tanımasını ister, ardından hizmet, çıkış bölgesi, hedef ve koliler için fiyatı talep eder. 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ın varsayılan para birimine çevrilir ve sonra müşterinin sepet para biriminde gösterilir.

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 kullanılamayan bir API her ödeme sayfası yenilemesini yavaşlatmaz. API hataları müşteriye asla gösterilmez: taşıyıcı gizlenir ya da yedek modda sabit fiyat kullanılır. Neden günlüğe yazılır.

Bir taşıyıcıda siparişler olduktan sonra Shipping > Carriers bölümünde bir düzenleme yaparsanız PrestaShop bunu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül, 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 veya ülke başına tek bir sabit fiyatı kullanın. Gerçek zamanlı tarifeler yalnızca Şili için çalışır.

Teslim alma noktaları

Müşteri teslimat adımında Blue Express pickup point seçtiğinde, altında Choose pickup point düğmesi olan bir kutu belirir. 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. Nokta sepette saklanır ve tarife, Blue Express teslim alma (PUDO) ücretiyle yeniden hesaplanır. Fiyat değişirse, sayfa bunu göstermek için yeniden yüklenir. Bir nokta seçilene kadar taşıyıcı, adrese teslimat paket fiyatını gösterir.

Müşteri nokta seçmeden devam edemez: Please choose a Blue Express pickup point. Bu kontrol, müşteri teslimat adımında Continue düğmesine tıkladığında mağaza tarafından yapılır. Hatalı biçimli bir nokta kodu The selected Blue Express pickup point is not valid. Please choose it again on the map. mesajıyla reddedilir ve önceki seçim korunur.

Sipariş verildiğinde nokta, Blue Express acente kodu, adı ve adresiyle birlikte siparişe kaydedilir. Yönetim paneli sipariş sayfasında Blue Express pickup point bloğunda gösterilir. Başka bir nokta seçmek için Edit düğmesine tıklayın ve Choose on the Blue Express map ile seçin ya da Agency code, Name ve Address alanlarını elle girin, ardından Save pickup point düğmesine tıklayın. Değişiklik, siparişe özel bir mesaj olarak kaydedilir. Noktayı değiştirmek için yalnızca sipariş düzenleme yetkisi gerekir, Modules sayfalarına erişim gerekmez. Müşteri noktayı sipariş onay sayfasında, sipariş detay sayfasında ve sipariş onay e-postasında, taşıyıcı adının yanında görür. Mağazaya giden yeni sipariş e-postası (Mail alerts modülünden) acente kodunu da gösterir. Mevcut siparişler kendi teslim alma noktası verilerini korur.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Blue Express lisans bloğu, Modules > Module Manager > VibeFox Blue Express > Configure sayfasında ayarların üstünde, ilk blok olarak yer alır. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blokta anahtar maskelenmiş olarak, durum (örneğin lisansın hangi tarihe kadar etkin olduğu 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, anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-blue-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 yönetim paneli 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 tarihiyle birlikte License expired on. 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Blue Express taşıyıcıları ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. PrestaShop vitrini, yönetim paneline giriş yaptığınızı bilmez; bu nedenle taşıyıcılar sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde 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önetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Blue Express ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable (veya Pickup point carrier) seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını doğrulayın ya da Ignore shipping zones seçeneğini açıp Countries alanını kontrol edin. Modül sayfasının üstündeki uyarıları okuyun. Ağırlık sınırlarını, Minimum order subtotal değerini ve sabit fiyat veya yedek fiyat kullanıyorsanız Fixed prices alanında ülke için bir satır olup olmadığını kontrol edin. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlanmış olabilir.

Gerçek zamanlı tarifeler görünmüyor: Blue Express API only seçiliyken tarife olmadığında taşıyıcılar gizlenir. Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Yaygın nedenler: API anahtarı yok, döviz kuru olmadan CLP dışında mağaza para birimi, adreste bölge veya 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 düzeltirken müşteriler yine sabit fiyatı alır.

Şili adreslerinde bölge yok: sayfa, eksik bölgeler hakkında bir uyarı gösterir. Modül sayfasında Add Chilean regions düğmesine tıklayın. Adresleri bölge olmadan kaydedilmiş müşterilerin adresi düzenleyip bölgeyi seçmesi gerekir.

Blue Express fiyatının üzerine vergi ekleniyor: Blue Express fiyatları IVA içerir. Tax status seçeneğini None (no tax on shipping) 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 engellenmemiş olmalıdır.

Bir değişiklikten sonra tarifeler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış tarifeleri ve komün verilerini temizler.

Sayfa bir Blue Express taşıyıcısının eksik olduğunu söylüyor: taşıyıcı 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. Sıfırlama ayarlarınızı ve taşıyıcıların durumunu korur.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Blue Express yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu ve önbelleğe alınmış tarifeler her zaman kaldırılır. Remove data on uninstall açıksa her iki taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar, günlük ile hiçbir siparişe bağlı olmayan teslim alma noktaları kaldırılır. Kapalıysa taşıyıcılar yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak, taşıyıcıları daha önceki durumlarıyla geri getirir. Siparişlerde kaydedilmiş teslim alma noktaları asla kaldırılmaz.

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