VibeFox Instabee for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Budbee API kimlik bilgileri (yalnızca paket kutusu seçimi için): bir API anahtarı ve bir API gizli anahtarı. Instabee bunları teslimat anlaşması olan satıcılara verir. Instabee iletişim kişinize sorun veya Instabee satıcı portalını kullanın. API belgeleri developer.budbee.com adresindedir. Kimlik bilgileri olmadan kargo firması sabit fiyatlarla çalışmaya devam eder, ancak müşteriler paket kutusu seçemez.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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 bittiğinde Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox Instabee öğesini bulup Configure düğmesine tıklayın.

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

4. Prices bölümünü doldurun ve paket kutusu seçici için Budbee API key ve API secret değerlerinizi girin (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, Delivery to an Instabee parcel box teslimat süresi metniyle Instabee parcel box kargo firmasını oluşturur. Kargo firması tüm müşteri gruplarına ve İsveç, Finlandiya, Danimarka, Hollanda ve Belçika bölgelerine atanır. Bölgeleri, müşteri gruplarını, teslimat süresini ve logoyu Shipping > Carriers üzerinden 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 Instabee > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder.

Ayarların üstündeki uyarılar; API kimlik bilgilerinden yalnızca birinin girildiğini, hiç kimlik bilgisi olmadığını, ülke fiyatı ve yedek ücret bulunmadığını, son Budbee API isteğinin başarısız olduğunu (tarih, saat ve nedenle birlikte), Instabee kargo firmasının bulunamadığını ve mağaza ağırlık biriminin tanınmadığını (kg, g, lb veya oz değerlerini International > Localization, Local units bölümünden ayarlayın) belirtir. Ayarları her kaydettiğinizde önbelleğe alınmış paket kutusu listeleri ve son API hatası temizlenir. Yöntem adı veya vergi durumu geçerli değilse ya da Min weight (kg) değeri Max weight (kg) değerinden büyükse hiçbir şey kaydedilmez ve bir hata gösterilir.

General

Enable/Disable: kargo firmasını açar veya kapatır. Bu, Shipping > Carriers altındaki kargo firması durumuyla aynı anahtardır.

Method name: müşterinin ödeme sayfasında gördüğü kargo firması adı. Varsayılan: Instabee parcel box. Zorunlu, en fazla 64 karakter.

Tax status: None aşağıdaki fiyatların kesin olduğu anlamına gelir. Bir vergi kuralıyla birlikte Taxable ise PrestaShop, aşağıdaki fiyatların üzerine o kuralın kargo vergisini ekler.

Paket kutusu seçici (Budbee API)

API kimlik bilgileriyle müşteri ödeme sayfasında posta koduna yakın bir paket kutusu seçer ve kutu siparişe kaydedilir. İki alan da gereklidir. Her ikisi de girilene kadar seçici kapalı kalır.

API key: Budbee API anahtarınız (HTTP Basic kullanıcı adı).

API secret: Budbee API gizli anahtarınız (HTTP Basic parolası). Günlüğe hiçbir zaman yazılmaz.

Kaydettikten sonra iki alan da 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. Kayıtlı kimlik bilgilerini silmek için Remove the saved API key and secret kutusunu işaretleyip kaydedin. Hiçbir şey kayıtlı değilse sayfa No credentials saved. gösterir.

Test environment: Budbee staging API'sini (api.staging.budbee.com) kullanır. Yalnızca Instabee'den alınan staging kimlik bilgileriyle açın. Canlı mağazalar kapalı bırakır (api.budbee.com). Varsayılan: kapalı.

Prices (bölüm başlığı, mağazanızın varsayılan para birimini gösterir)

Tüm fiyatlar mağazanın varsayılan para biriminde ve vergi hariç girilir. Ondalık virgül ve ondalık nokta ikisi de kabul edilir (49,90 = 49.90). Fiyat müşteriye sepet para biriminde gösterilir.

Calculation type: fiyatın nasıl uygulandığı.

Country prices: Country, Price, XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg ve XL >5 kg sütunlarından oluşan bir tablo. Satır eklemek için Add country düğmesine, satır silmek için çöp kutusu simgesine tıklayın. Kendi satırı olmayan tüm ülkelere uygulanan bir satır için * Any other country seçin. Boş veya 0 olan bir aralık Price sütununu kullanır. Price değeri 0 ise teslimat ücretsizdir. Ülke satırında sepet ağırlığı için fiyat yoksa * satırı, o da yoksa Fallback cost kullanılır. Sayı olmayan bir fiyat temizlenir ve bir uyarı bunu listeler. Ağırlıklar mağazanızın ağırlık biriminden kg'a çevrilir.

Fallback cost: hedef ülkenin satırı da * satırı da fiyat vermediğinde kullanılır. Bu ülkelerde kargo firmasını gizlemek için boş bırakın.

Conditions

Min weight (kg): bu sepet ağırlığının altında kargo firmasını gizler. Varsayılan: 0 (sınır yok).

Max weight (kg): bu sepet ağırlığının üstünde kargo firmasını gizler. Paket kutuları yaklaşık 20 kg'a kadar taşır. Varsayılan: 20. 0 sınır yok anlamına gelir. Min weight (kg) değerinden düşük olamaz.

Minimum order amount: kargo firmasını yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergiden önce) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: kargo firmasının ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergiden önce). Hiçbir zaman ücretsiz olmaması için boş bırakın.

Bu alanlardan veya Fallback cost alanından birinin değeri sayı değilse kaydedilmez, önceki değer kalır ve bir uyarı alanın adını belirtir.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde kargo firması, Shipping > Carriers altında bağlı olduğu kargo bölgelerinde sunulur. Alternatif olarak, burada bir ülke listesi için etkinleştirebilirsiniz.

Ignore shipping zones: kargo firmasını, bölgeleri bu ülkeleri içermese bile aşağıdaki ülkelerde sunar. Kargo firması sonradan oluşturulanlar 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. Tüm ülkelere izin vermek için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: hata ayıklama mesajlarını modül klasöründeki logs/vfd_ibee_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları, bu kapalı olsa bile her zaman günlüğe yazılır. API anahtarları ve müşteri verileri hiçbir zaman günlüğe yazılmaz.

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 kargo firmasını siler. Kapalıysa kaldırmak yalnızca kargo firmasını kapatır. Siparişlerde kayıtlı paket kutuları her zaman korunur.

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

Kargo adımında PrestaShop modülden Instabee fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül koşulları kontrol eder: sepet ağırlığı ve minimum sipariş tutarı ile Ignore shipping zones açıksa izin verilen ülkeler. Sepet ara toplamı Free shipping from değerine ulaşırsa fiyat 0 olur. Aksi halde fiyat, hedef ülkenin Country prices satırından, * satırından ya da Fallback cost değerinden alınır. Fiyat yoksa kargo firması gizlenir.

Müşteri Instabee kargo firmasını seçtiğinde ve API kimlik bilgileri girildiğinde, İsveç, Finlandiya, Danimarka, Hollanda ve Belçika için kargo firmasının altında bir Parcel box bloğu görünür. Bu blok, teslimat adresinin posta koduna yakın kutuları mesafeye göre sıralı olarak ad, adres ve mesafeyle listeler. Müşteri başka bir posta kodu yazabilir ve Search düğmesine tıklayabilir (ya da Enter tuşuna basabilir). Bir posta kodu girilene kadar blok bunu ister. Hiçbir kutu bulunamazsa müşteriden başka bir posta kodu denemesi ya da başka bir kargo yöntemi seçmesi istenir. Diğer ülkeler için kargo firması kutu olmadan sunulur.

Paket kutusu zorunludur. Seçilen kutu, yalnızca o posta kodu için Budbee listesinde varsa sepete kaydedilir. Müşteri teslimat adımında Continue düğmesine tıkladığında modül kutuyu sunucuda yeniden kontrol eder. Aksi halde müşteri Please choose an Instabee parcel box. mesajını görür. Kutu adı tarayıcıdan değil, Budbee listesinden alınır. Müşteri adresin teslimat ülkesini veya posta kodunu değiştirirse önceki seçim iptal edilir.

Modül Budbee'ye yalnızca hedef ülkeyi ve posta kodunu gönderir; ad, adres, e-posta ya da sipariş verisi asla gönderilmez. Kutu listeleri posta kodu başına 12 saat, kutusu olmayan bir posta kodu 1 saat, başarısız bir istek ise 5 dakika önbelleğe alınır; böylece yavaş veya çalışmayan bir API her ödeme sayfası yenilemesini yavaşlatmaz. Ödeme sayfası hiçbir zaman Budbee'yi beklemez: kargo firması seçilir seçilmez liste arka planda yüklenir. API zaman aşımı 10 saniyedir.

Budbee API'ye ulaşılamazsa müşteri Parcel boxes cannot be loaded right now. You can place the order without choosing a box - the shop will assign one. mesajını görür. Sipariş bu durumda işaretlenir ve kutuyu gönderiyi rezerve ederken siz seçersiniz. Daha önce seçilmiş ve o anda kontrol edilemeyen bir kutu korunur ve doğrulanmamış olarak işaretlenir.

Seçici, Classic ve Hummingbird temalarıyla çalışır. Kargo firmasında siparişleri olduktan sonra Shipping > Carriers üzerinden düzenlerseniz PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül canlı tarife hesaplamaz, gönderi oluşturmaz, etiket yazdırmaz, takip numarası veya takip e-postası vermez, Budbee Home teslimat zaman aralıkları sunmaz ve harita göstermez. Paketi, Instabee / Budbee satıcı araçlarınızda seçilen kutu için rezerve edin.

Teslim noktaları

Sipariş oluşturulduğunda kutu bir kez daha kontrol edilir ve siparişe kaydedilir. Bundan sonra mağaza ön yüzü bunu değiştiremez. Kutu şu yerlerde gösterilir:

Yönetim panelinde sipariş sayfası: kutu adı, adresi ve Box ID ile birlikte Instabee parcel box bloğu. Kutu ödeme sayfasında kontrol edilemediyse not verified (Budbee API was unavailable at checkout) olarak işaretlenir. API kullanılamadığı için hiçbir kutu seçilmediyse blokta Not chosen - the Budbee API was unavailable at checkout. Choose the box when you book the shipment. yazar.

Müşteri hesabında sipariş onayı sayfası ve sipariş ayrıntıları: Instabee parcel box: kutu adı ve adresiyle birlikte.

Sipariş e-postaları: kutu, müşteriye giden sipariş onay e-postasında kargo firması adına eklenir. Mağazaya giden yeni sipariş e-postası (PrestaShop Mail alerts modülünden) kutu kimliğini de gösterir. API kullanılamadığı için hiçbir kutu seçilmediyse yalnızca mağazaya giden e-posta bunu belirtir.

Lisans anahtarı

Modül, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Instabee lisans bloğu, Modules > Module Manager > VibeFox Instabee > Configure sayfasındaki ilk bloktur ve ayarların üstündedir. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-instabee satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir; ö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 ya da 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 tek 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ızda serbest bırakın.

Etkin bir anahtar yoksa Instabee kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. PrestaShop mağaza ön yüzü yönetim paneline giriş yaptığınızı bilmediği için kargo firması sizden de gizlenir: modülü bir anahtar satın almadan önce yapılandırabilirsiniz, 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 boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Instabee ö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 altında kargo firmasının müşterinin ülkesinin bölgesini ve müşteri grubunu kapsadığını ya da Ignore shipping zones seçeneğinin açık olduğunu ve ülkenin izinli olduğunu kontrol edin. Ülkenin bir fiyatı olduğunu ya da bir * satırının ya da Fallback cost değerinin bulunduğunu kontrol edin. Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Ayarların üstündeki bir uyarı, fiyat yapılandırılmadığında sizi bilgilendirir. Ürün sayfasında ürünler belirli kargo firmalarıyla da sınırlandırılabilir. Nedenini Log alanında görmek için Debug log seçeneğini açın.

Müşteriler paket kutusu listesini görmüyor: liste yalnızca API key ve API secret alanları doldurulduğunda, İsveç, Finlandiya, Danimarka, Hollanda ve Belçika için ve bir posta kodu girildikten sonra görünür. Son API hatası ayarların üstünde gösterilir. Ayrıntılar modül sayfasındaki Log alanındadır. Daha fazla ayrıntı için Debug log seçeneğini açın.

Günlükte HTTP 401 veya 403: Budbee API anahtarını ya da gizli anahtarı reddetti. Bunları kontrol edin ve Test environment seçeneğinin kimlik bilgilerinize uyduğunu doğrulayın (staging kimlik bilgileri yalnızca test ortamı açıkken).

Bir posta kodu için kutu yok: Budbee bu posta kodunu hizmet vermiyor. Müşteri başka bir posta kodu arayabilir ya da başka bir kargo yöntemi seçebilir.

Müşteri teslimat adımından devam edemiyor: Budbee API'ye ulaşılamadığı durum dışında, paket kutusunun listeden seçilmesi gerekir. Aranan posta kodunun listesinde olmayan bir kutu kaydedilmez ve müşteri This parcel box is not in the Budbee list for the postal code. Please choose the parcel box again. mesajını görür.

Bir değişiklikten sonra eski kutu listeleri: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış kutu listelerini temizler.

Sayfa Instabee kargo firmasının bulunamadığını söylüyor: kargo firması Shipping > Carriers üzerinden silinmiş. Yeniden oluşturmak için Modules > Module Manager üzerinden modülü sıfırlayın. Aynısı The settings were saved, but the carrier could not be updated. mesajı için de geçerlidir. Sıfırlama kargo firmasının durumunu korur: kapatılmış bir kargo firması kapalı kalır.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Instabee yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman silinir. Önbelleğe alınmış kutu listeleri her zaman silinir. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişini korur), ayrıca ayarlar, günlük ve hiçbir zaman siparişe dönüşmemiş sepetlerde seçilmiş kutular kaldırılır. Kapalıysa kargo firması yalnızca kapatılır ve tüm ayarlar korunur. Modülü yeniden kurmak, kayıtlı kargo firmasına sahip olduğu durumu geri verir. Siparişlerde kayıtlı paket kutuları her zaman korunur.

Instabee ve Budbee, ilgili sahiplerinin ticari markalarıdır. Bu modül Instabee veya Budbee ile bağlantılı değildir ve onlar tarafından onaylanmamıştır.