VibeFox Balikobot for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerine kurulmayı reddeder.

Balikobot hesabı (canlı tarifeler ve teslim noktaları için): API erişimi olan bir Balikobot hesabına ihtiyacınız vardır. API kullanıcısı ve API anahtarı, Balikobot müşteri bölgesinde (client.balikobot.cz) bulunur. Balikobot desteği (podpora@balikobot.cz) hesabınız ve taşıyıcılarınız için API'yi etkinleştirir. Canlı tarifeler, Balikobot'un "transportcosts" desteklediği bir taşıyıcı ve hizmet gerektirir. Teslim noktaları, "branchlocator" desteği olan bir taşıyıcı gerektirir (örneğin Česká pošta, Zásilkovna, PPL, DPD, GLS). Emin değilseniz Balikobot desteğine danışın. Sabit fiyatlar hesap olmadan çalışır.

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ün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Balikobot öğ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 kullanıcısını ve API anahtarını girin; taşıyıcıyı ve hizmet türünü, fiyat kaynağını ve ülke fiyatlarını seçin (bkz. Yapılandırma). Teslim noktalı hizmetler için Pickup point selection seçeneğini etkinleştirin. Save düğmesine tıklayın.

Kurulumda modül, Delivery by Balikobot teslimat süresi metniyle Balikobot taşıyıcısını oluşturur. Taşıyıcı, Çekya, Slovakya ve Macaristan bölgelerine 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ünde değiştirebilirsiniz. Fiyatları orada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Balikobot > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme sayfanın tamamını kaydeder. Kaydettikten sonra Settings saved. Cached rates and pickup points were cleared. mesajını görürsünüz. Sayfanın üstünde, taşıyıcıyı, canlı tarifeleri veya teslim noktalarını gizleyecek ayarlar için uyarılar gösterilir: API kullanıcısı veya API anahtarı olmadan canlı tarifeler ya da teslim noktaları, Exchange rate olmadan CZK dışında bir mağaza para birimi, sabit fiyatlar veya yedek mod kullanılırken boş Country prices, modülün tanımadığı bir mağaza ağırlık birimi (ağırlıklar bu durumda kg olarak okunur; kg, g, lb veya oz kullanın) ve silinmiş bir taşıyıcı. Sayı olmayan bir değer kaydedilmez ve alan adıyla birlikte bir uyarı görürsünüz.

General

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

Name: müşterilere gösterilen kargo yönteminin adı (taşıyıcının adı). Varsayılan: Balikobot. Zorunlu, en fazla 64 karakter.

Tax status: None ya da vergi kurallarınızdan biriyle Taxable. Bir vergi kuralı seçilirse, onun vergisi kargo fiyatına eklenir. Seçim taşıyıcıya kaydedilir. Balikobot fiyatları genellikle KDV hariçtir. Varsayılan: None.

Balikobot API hesabı (canlı tarifeler ve teslim noktaları için gerekir)

API user: müşteri bölgesindeki Balikobot API kullanıcınız.

API key: müşteri bölgesindeki Balikobot API anahtarınız. Kaydettikten sonra alan boş kalır ve Saved - leave empty to keep it. Clear the API user to remove the saved key. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Carrier: tarifeler ve teslim noktaları için kullanılan Balikobot taşıyıcısı: Česká pošta (varsayılan), Zásilkovna (Packeta), PPL, DPD, GLS, DHL Express, UPS, TNT, FedEx, Geis, InTime, Uloženka, Toptrans, Pošta bez hranic, Slovenská pošta, SPS (Slovak Parcel Service) veya Magyar Posta. Balikobot hesabınızda etkinleştirilmiş olmalıdır.

Service type: taşıyıcının Balikobot hizmet kodu. Varsayılan: NP. Česká pošta için: NP = postaneye paket, NB = Balíkovna'ya paket, DR = kapıya teslimat. Diğer taşıyıcıların kodları Balikobot müşteri bölgesinde ve API belgelerinde listelenmiştir.

Fiyat (tüm fiyatlar mağazanızın varsayılan para birimindedir)

Price source: fiyatın nasıl hesaplandığı.

Country prices: 2 harfli ülke kodları (örneğin CZ, SK) ve fiyatlardan oluşan bir tablo. Bir ülke eklemek için Add row düğmesine, birini kaldırmak için çöp kutusu simgesine tıklayın. Diğer tüm ülkeler için ülke kodu olarak * kullanın. Ondalıklar nokta veya virgülle yazılabilir. Sabit modda ve API yedeği olarak kullanılır. Fiyatı olmayan bir ülke (ve * satırı da yoksa) sabit tarife almaz. Geçersiz satırlar kaydederken kaldırılır ve bir uyarı bunları listeler.

Fixed price per: Order fiyatı bir kez uygular. Item (price x quantity) ise fiyatı sepetteki ürün adediyle çarpar. Bu yalnızca sabit fiyatlar için geçerlidir. Canlı bir Balikobot tarifesi her zaman tüm paket içindir.

Exchange rate: Balikobot fiyat para birimindeki (genellikle CZK) 1 birimin, mağazanızın varsayılan para birimindeki değeri, örneğin 0.04. Yalnızca Balikobot farklı bir para biriminde fiyat döndürdüğünde kullanılır. Bu tür fiyatları reddetmek için boş bırakın; böylece müşteri asla yanlış bir fiyat ödemez.

Koşullar

Min weight (kg): sepet bundan hafifse taşıyıcıyı gizler. 0 sınır olmadığı anlamına gelir. Ürün ağırlıkları mağazanızın ağırlık biriminden dönüştürülür.

Max weight (kg): sepet bundan ağırsa taşıyıcıyı gizler. Varsayılan: 100. 0 sınır olmadığı anlamına gelir. Boş alan 100 kg anlamına gelir. Min weight (kg) maksimumdan büyükse bir uyarı görürsünüz ve önceki ağırlıklar korunur.

Minimum order amount: taşıyıcıyı yalnızca bu sepet ara toplamından itibaren gösterir (indirimlerden sonra, vergisiz). Her zaman göstermek için boş bırakın.

Free shipping: aşağıda belirtilen tutardan itibaren ücretsiz kargoyu etkinleştirir.

Free shipping from: ücretsiz kargonun başladığı sepet ara toplamı (indirimlerden sonra, vergisiz). Bu durumda API'ye istek gönderilmez.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde taşıyıcı, Shipping > Carriers bölümündeki kendi bölgelerinde sunulur.

Ignore shipping zones: taşıyıcıyı, aşağıdaki ülkelerde bu ülkelerin bölgesine bağlı olmasa bile sunar. Modül taşıyıcıyı, daha sonra oluşturacağınız bölgeler dahil tüm bölgelere bağlar. Bu seçeneği kapattığınızda, bu şekilde eklenen bölgeler yeniden kaldırılır. Kendi bölgeleriniz kalır.

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

Teslim noktaları

Pickup point selection: müşteri bir teslim noktası seçmek zorundadır. Örneğin Česká pošta NP veya NB ya da Zásilkovna gibi teslim noktalı hizmetler için kullanın. API kullanıcısı ve API anahtarı gerektirir.

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

Gelişmiş

Debug log: API isteklerini ve tarife hesaplamalarını modül klasöründeki logs/vfd_blkb_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API hataları her zaman kaydedilir. Kimlik bilgileri ve müşteri adresleri hiçbir zaman 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 modül ayarlarını ve taşıyıcıyı siler. Bu seçenek kapalıyken kaldırma hiçbir veriyi silmez. Siparişlerde kaydedilmiş teslim noktaları korunur.

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

Kargo adımında PrestaShop, modülden Balikobot fiyatını ister. Yalnızca fiziksel ürünler dikkate alınır: sanal ürünler ağırlığa eklenmez ve sipariş tutarına dahil edilmez. Modül önce ülkeleri (Ignore shipping zones ile), sepet ağırlığını ve Minimum order amount değerini kontrol eder. Ücretsiz kargo uygulanırsa fiyat 0 olur ve Balikobot'a istek gönderilmez.

Sabit modda fiyat Country prices alanından alınır. Canlı modlarda modül, Balikobot'a taşıyıcıyı, hizmet türünü, varış ülkesini ve posta kodunu ve sepet ağırlığını kg olarak gönderir. Canlı tarife yalnızca teslimat adresinde posta kodu varsa istenir. Başka bir para birimindeki fiyat Exchange rate ile dönüştürülür; kur tanımlı değilse reddedilir. Fiyat mağazanızın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Canlı fiyatlar 1 saat önbellekte tutulur, böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 5 dakika önbellekte tutulur ve API zaman aşımı 12 saniyedir; böylece ödeme sayfası her yenilemede Balikobot'u beklemez. API hataları müşteriye hiçbir zaman gösterilmez: taşıyıcı gizlenir veya yedek modda sabit fiyat kullanılır. Ayrıntılar hata ayıklama günlüğüne gider.

Shipping > Carriers bölümünde taşıyıcıda sipariş olduktan sonra düzenlerseniz, 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 Balikobot'ta gönderi oluşturmaz, etiket yazdırmaz ve kurye talebi oluşturmaz: gönderiyi Balikobot müşteri bölgesinden sipariş edin. Paketleri takip etmez ve sipariş durumlarını güncellemez. Tüm bölgeler için tek bir taşıyıcı ve tek bir hizmet türü kullanılır. Teslim noktaları harita olmadan, açılır liste olarak gösterilir.

Teslim noktaları

Pickup point selection açıkken, teslimat adımında Balikobot taşıyıcısının altında bir teslim noktası listesi görünür. Liste, teslimat adresinin ülkesi, şehri ve posta kodu için Balikobot "branchlocator" üzerinden yüklenir. Adresin şehri olana kadar müşteri Enter your city to see the pickup points. mesajını görür. Liste 12 saat önbellekte tutulur.

Müşteri bir nokta seçer seçmez seçim sepete kaydedilir. Seçim zorunludur: teslimat adımındaki Continue ve Place order düğmeleri Please select a pickup point. uyarısıyla engellenir. Sunucu ayrıca seçilen noktanın teslimat adresine ait olduğunu kontrol eder. Aksi halde müşteri The selected pickup point is not available for your shipping address. Please choose a pickup point again. mesajını görür. Hiçbir nokta bulunamazsa müşteriden şehri ve posta kodunu kontrol etmesi ya da başka bir kargo yöntemi seçmesi istenir. Noktalar yüklenemezse müşteriden daha sonra tekrar denemesi ya da başka bir kargo yöntemi seçmesi istenir.

Seçilen teslim noktası siparişe kaydedilir. Yönetim paneli sipariş sayfasında Balikobot pickup point bloğunda, Balikobot şube kimliği ve taşıyıcıyla birlikte gösterilir; bunlar Balikobot'ta gönderi oluştururken gereklidir. Sipariş adresine yakın başka bir nokta seçmek için Change düğmesine, ardından Save düğmesine tıklayın. Noktayı değiştirmek için yalnızca siparişleri düzenleme yetkisi gerekir; Modules sayfalarına erişim gerekmez. Siparişte bir nokta yoksa blok No pickup point was selected for this order. mesajını gösterir.

Müşteri noktayı sipariş onay sayfasında ve sipariş ayrıntılarında Pickup point: olarak görür. Sipariş onay e-postasında ve mağaza için yeni sipariş e-postasında (Mail alerts modülü) taşıyıcı adından sonra eklenir. Mevcut siparişler teslim noktası verilerini korur.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Balikobot lisans bloğu, Modules > Module Manager > VibeFox Balikobot > 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-balikobot 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 Balikobot taşıyıcısı ö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ı 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

Balikobot ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin. Modül sayfasının üstündeki uyarıları okuyun. Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşteri grubunu kapsadığını kontrol edin ya da Ignore shipping zones seçeneğini açıp Countries alanını kontrol edin. Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Sabit modda ülkenin veya * satırının bir fiyatı olduğunu doğrulayın. Ürün sayfasında ürünler belirli taşıyıcılarla da sınırlanabilir.

Canlı tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Nedeni gösterir: eksik API kimlik bilgileri, henüz posta kodu olmaması, taşıyıcı ve hizmet için Balikobot hatası (örneğin authorization failed; API kullanıcısını ve API anahtarını kontrol edin) veya Exchange rate olmadan başka bir para biriminde fiyat. Live Balikobot rate, fixed price if the API fails seçeneğiyle, sorunu giderirken müşteriler yine sabit fiyatı görür.

Fiyatlar yanlış para biriminde: sabit fiyatlar mağazanızın varsayılan para birimindedir. Balikobot canlı fiyatları Balikobot sözleşmenizin para biriminde döndürür (genellikle CZK). Varsayılan para biriminizden farklıysa Exchange rate değerini ayarlayın.

KDV dahil mi?: Balikobot fiyatları genellikle KDV hariçtir. Tax status bir vergi kuralına ayarlıysa PrestaShop kargo vergisini ekler.

Listede teslim noktası yok: API kullanıcısının ve anahtarının girildiğini, taşıyıcının "branchlocator" desteklediğini ve teslimat adresinde şehir ile posta kodunun olduğunu kontrol edin. Balikobot hatası için günlüğe bakın.

Bir değişiklikten sonra tarifeler veya teslim noktaları eski görünüyor: modül sayfasındaki Save düğmesine tıklayın. Bu, önbellekteki tarifeleri ve teslim noktalarını temizler.

Sayfa Balikobot taşıyıcısının bulunamadığını bildiriyor: taşıyıcı Shipping > Carriers bölümünden silinmiş. Yeniden oluşturmak için Modules > Module Manager bölümünde modülü sıfırlayın.

Geliştiriciler için: modülün API adresini (actionVfdBlkbApiUrl), "transportcosts" paketini (actionVfdBlkbTransportcostsPackage) ve teslim noktası sayısını (actionVfdBlkbPickupMaxResults, varsayılan 30) değiştirmek için kendi hook'ları vardır.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Balikobot yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu, önbellekteki tarifeler ve teslim noktaları her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur), ayrıca ayarlar, günlük ve siparişi olmayan sepetlerin teslim noktaları kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurduğunuzda (veya sıfırladığınızda) kaydedilmiş taşıyıcı, kaldırmadan önceki durumunu geri alır: açık olan açık kalır, kapalı olan kapalı kalır. Siparişlerde kaydedilen teslim noktası verileri hiçbir zaman silinmez.

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