VibeFox Sameday Easybox for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde kurulmaz.

Sameday API kullanıcı adı ve şifresi: API erişimi, Romanya, Macaristan veya Bulgaristan'daki bir Sameday iş hesabının parçasıdır. Sameday hesap yöneticinize veya Sameday entegrasyon ekibine danışın. Kimlik bilgileri çoğunlukla eAWB portalındakilerle aynıdır (eawb.sameday.ro, .hu veya .bg). Demo API için Sameday ayrı test kimlik bilgileri verir. API kullanıcı adı ve şifresi olmadan kargo seçeneği sunulmaz, çünkü müşteri bir locker seçemez.

Adres formundaki ilçeler: Sameday tahmini, teslimat adresinin ilçesini gerektirir. PrestaShop'ta Romanya, Macaristan ve Bulgaristan için varsayılan olarak ilçe yoktur. Modül bunları sizin için ekleyebilir (aşağıdaki Lockers easybox bölümüne bakın). Bunlar olmadan fiyatlar tablonuzdan veya yedek ücretten gelir.

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 bittiğinde Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox Sameday Easybox öğesini bulup Configure düğmesine tıklayın.

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

4. Sameday API username ve API password değerlerinizi girin, Sameday country seçin ve Save düğmesine tıklayın. Sayfa "Sameday'e bağlandı ... easybox locker'ları" yazmalıdır. Pickup point ve Easybox service hesabınızdan doldurulur.

5. Fiyatlarınızı ayarlayın: mağaza para biriminiz Sameday para biriminden farklıysa Exchange rate of the estimate, ayrıca bir Country prices satırı (örneğin * Default) ya da bir Fallback cost.

6. Sayfa, mağazanın Sameday ülkeniz için ilçesi olmadığını bildiriyorsa Lockers easybox bölümündeki Add counties düğmesine tıklayın.

Kurulumda modül, Delivery to a Sameday easybox locker teslimat süresi metniyle Sameday easybox taşıyıcısını oluşturur. Tüm müşteri gruplarına ve Romanya bölgesine atanır. Bölgeleri, müşteri gruplarını, teslimat süresini ve logoyu Shipping > Carriers bölümünde değiştirebilirsiniz. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modülün Configure sayfasında, altı bölümde yer alır. Herhangi bir bölümün Save düğmesi tüm sayfayı kaydeder.

Ayarların üstünde sayfa bağlantı durumunu gösterir: Sameday sunucusu, locker sayısı ve listenin ne zaman güncellendiği ya da Sameday'in kullanıcı adını veya şifreyi reddettiği. Ayrıca yapılandırma sorunlarını listeler; örneğin kimlik bilgilerinin, fiyatın, tahmin için döviz kurunun, ilçelerin eksik olması, modülün tanımadığı bir mağaza ağırlık birimi ya da taşıyıcının bulunamaması.

Tüm fiyat ve sınırlar ondalık ayırıcı olarak virgül veya nokta kabul eder (4,99 ya da 4.99). Geçersiz ya da negatif bir sayı kaydedilmez: bir uyarı alanı belirtir ve önceki değer korunur.

Genel

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

Name: müşterinin gördüğü kargo yönteminin adı (taşıyıcı adı). Varsayılan: Sameday easybox.

Tax status: None, fiyatın nihai olduğu anlamına gelir. Vergi kuralı olan Taxable seçeneği, PrestaShop'un bu kargo vergisini fiyatın üstüne eklemesini sağlar.

Sameday hesabı (API)

Kaydettiğinizde modül Sameday'e giriş yapar ve hizmetlerinizi, teslim noktalarınızı ve easybox locker listesini yükler. Liste her gün yenilenir.

API username: Sameday API kullanıcı adınız.

API password: Sameday API şifreniz. Bir daha gösterilmez: kayıtlı olanı korumak için alanı boş bırakın. Kullanıcı adını boşaltmak şifreyi de kaldırır. Sameday şifreyi reddederse 10 dakika boyunca yeniden denenmez.

Sameday country: Sameday hesabınızın ülkesi: Romania (api.sameday.ro) (varsayılan), Hungary (api.sameday.hu) veya Bulgaria (api.sameday.bg). Bu ülkenin locker'ları sunulur ve taşıyıcı yalnızca bu hedef ülke için gösterilir. Değiştirdiğinizde taşıyıcı da yeni ülkenin bölgesine bağlanır.

Test mode: demo kimlik bilgileriyle Sameday demo API'sini (sameday-api.demo.zitec.com) kullanır.

Fiyatlar

Kullanım sırası şöyledir: önce Sameday tahmini (Pickup point ve Easybox service ayarlıysa), sonra ülke fiyat tablosu, en son yedek ücret. Tablo fiyatları mağazanın varsayılan para biriminde girilir. Başka bir para birimiyle ödeyen müşteriler dönüştürülmüş fiyatı görür.

Pickup point: Sameday'in paketleri aldığı teslim noktanız. Başarılı girişten sonra hesabınızdaki teslim noktalarının listesidir ve varsayılan olanı otomatik seçilir. Sameday tahmini için gereklidir. Yalnızca fiyat tablosunu kullanmak için - not set (price table only) - seçin.

Easybox service: easybox teslimatı için Sameday hizmeti, genellikle "Locker NextDay" (kod LN), otomatik seçilir. Sameday tahmini için gereklidir.

Exchange rate of the estimate: Sameday, Sameday ülkenizin para biriminde tahmin verir: RON, HUF veya BGN (euro ile satış yapan Bulgar mağazalar için EUR). Mağazanız başka bir para biriminde satış yapıyorsa, Sameday para biriminin 1 biriminin mağaza para birimindeki değerini girin, örneğin 0.20. Kur 0'dan büyük olmalıdır. Kur olmadan tahmin kullanılmaz ve fiyat tablosu uygulanır. Lev ve euro sabit kurdan otomatik olarak çevrilir.

Table price: Per order fiyatı bir kez alır. Per item (price x quantity) ise ürün adedi ile çarpar. Bu, tablo fiyatı ve yedek ücret için geçerlidir. Sameday tahmini her zaman tüm paket içindir.

Country prices: hedef ülke ve paket ağırlığı başına bir fiyat. Satır eklemek için + Add country, silmek için çöp kutusu simgesine tıklayın. Her satırda bir Price sütunu ve ağırlık sütunları vardır: XS 1 kg'a kadar, S 1–2 kg, M 2–3 kg, L 3–5 kg ve XL 5 kg'ın üzeri. 0 bırakılan bir ağırlık sütunu Price sütununu kullanır. * Default satırı kendi satırı olmayan ülkeler için kullanılır. Yeni bir satır, tüm fiyatları 0 olan bir * Default olarak başlar; bu da ücretsiz kargo anlamına gelir. Kaydetmeden önce ülkeyi seçin ve fiyatları girin ya da satırı kaldırın. Aynı ülke iki satırdaysa kaydederken yalnızca ilki tutulur ve bir uyarı bunu belirtir. Bir hücre geçerli bir sayı değilse tablo kaydedilmez.

Fallback cost: Sameday tahmini yoksa ve ülke tablosunda hedef için satır yoksa kullanılır. Bu durumda kargo seçeneğini sunmamak için boş bırakın.

Free shipping from: easybox teslimatının ücretsiz olduğu sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergisiz). Ara toplam bu tutara ulaştığında taşıyıcı ücretsiz sunulur ve fiyat sorgulanmaz. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.

Kullanılabilirlik

Minimum weight (kg): sepet bundan hafifse taşıyıcıyı gizler. Ağırlık, mağaza ağırlık biriminden (kg, g, lb veya oz) çevrilir. Boş ya da 0, sınır olmadığı anlamına gelir.

Maximum weight (kg): bundan ağır paketlere easybox teslimatı sunulmaz. Varsayılan: 30. Sameday sözleşmenizin sınırını ve easybox kutu boyutlarını kontrol edin. Boş ya da 0, sınır olmadığı anlamına gelir. Maksimum ağırlıktan büyük bir minimum ağırlık kaydedilmez: bir uyarı bunu belirtir ve önceki değerler korunur.

Minimum cart subtotal: taşıyıcıyı yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergisiz) bu tutara ulaştığında sunun.

Ignore shipping zones: açıksa, taşıyıcı aşağıda seçilen ülkeler için sunulur (liste boşsa Sameday ülkesi için), bu ülkelerin bölgesi taşıyıcı için ayarlanmamış olsa bile. Taşıyıcı o durumda etkin tüm bölgelere bağlanır; sonradan oluşturulan bölgeler dahil. Tekrar kapatırsanız taşıyıcı önceki bölgelerini geri alır. Kapalıyken taşıyıcı yalnızca Shipping > Carriers bölümündeki bölgelerinde sunulur.

Countries (ignore zones mode): bu mod için hedef ülkeler. Sameday ülkesi dışındaki ülkeler atlanır ve sayfa bunlar hakkında uyarır. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Lockers easybox

Locker list: kaç şehirde kaç easybox locker'ının yüklü olduğunu ve ne zaman yüklendiğini gösterir. Refresh the locker list now bunu yeniden yükler. Liste ayarlar kaydedildiğinde ve bir günden eski olduğunda, bir ödeme isteğinden sonra yenilenir. Sabit günlük yenileme için sunucunuzun bir cron işinden burada gösterilen Cron URL adresini günde bir kez çağırın. URL gizli bir belirteç içerir. Belirteç olmadan hata döndürür ve Sameday'e bağlanmaz.

Counties: Sameday tahmini adresin ilçesini gerektirir. PrestaShop'ta Sameday ülkeniz için ilçe (states) yoksa Add counties düğmesine tıklayın. Modül, Romanya, Macaristan veya Bulgaristan ilçelerini ve o ülkenin adres formuna ilçe alanını ekler. Zaten var olan ilçeler iki kez eklenmez. Yerleştiğinde sayfa sayılarını gösterir.

Gelişmiş

Debug log: tarife hesaplamalarını, API çağrılarını ve locker seçimlerini modül klasöründeki logs/vfd_sdeb_debug.log.php dosyasına yazar; bu dosya web üzerinden okunamaz. API hataları her zaman kaydedilir. Hiçbir şifre, belirteç veya müşteri kişisel verisi kaydedilmez. Aşağıdaki Log alanı dosyanın sonunu, Clear log düğmesiyle birlikte gösterir. İşiniz bittiğinde günlüğü kapatın.

Remove data on uninstall: açıksa, modülü kaldırmak ayarları ve taşıyıcıyı siler. Bu seçenek kapalıysa kaldırma yalnızca taşıyıcıyı kapatır. Locker listesi ve önbellekler her zaman silinir. Siparişlerde kaydedilmiş locker her zaman korunur.

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

Mağaza bir sepetin kargosunu hesapladığında PrestaShop, modülden Sameday easybox taşıyıcısının fiyatını ister. Modül koşulları kontrol eder: Sameday hesabınızın teslimat ülkesi, API kimlik bilgileri ve kullanılabilir bir locker listesi, Ignore shipping zones ülkeleri, sepet ağırlığı ve minimum sepet ara toplamı. Kargo gerektirmeyen ürünler (sanal ürünler) sayılmaz. Ücretsiz kargo geçerliyse müşteri taşıyıcıyı ücretsiz görür.

Aksi halde modül, müşteri bir şehir ve ilçe girdikten sonra Sameday'den bir tahmin ister. Teslim noktanızı ve hizmetinizi, paketin ağırlığını ve müşterinin sokak, şehir, ilçe ve posta kodu bilgilerini gönderir. Ad, e-posta veya telefon numarası gönderilmez. Bükreş, resmi Sameday eklentisinde olduğu gibi "Sector 1" olarak gönderilir. Tahmin mağaza para birimine çevrilir. Tahmin yoksa (kurulmamış, henüz şehir ya da ilçe yok, hata, kur yok), fiyat ülke tablosundan, ardından yedek ücretten gelir. Fiyat yoksa taşıyıcı gizlenir.

Sameday sorunları ödeme sayfasını asla bozmaz. Tahmin 1 saat önbellekte tutulur. Hata 10 dakika önbellekte tutulur. Zaman aşımı ya da sunucu hatasından sonra 5 dakika boyunca tahmin istenmez. İstekler 15 saniyede zaman aşımına uğrar. Ödeme sırasında locker listesi Sameday'den değil, sizin sunucunuzdan okunur.

Taşıyıcı, Classic temasının (PrestaShop 8) ve Hummingbird temasının (PrestaShop 9) teslimat adımında çalışır.

Modül AWB (gönderi) oluşturmaz, etiket yazdırmaz, kargo takibi yapmaz ve kapıda ödemeyi yönetmez. Eve kurye teslimatı ve Sameday harita widget'ı yoktur. AWB'yi Sameday eAWB portalında ya da alışık olduğunuz araçta, siparişte görünen locker kimliğiyle oluşturun.

Teslim noktaları

Müşteri taşıyıcıyı seçtiğinde altında iki listeli bir easybox locker bloğu görünür: - Select city - ve - Select easybox locker -. Teslimat adresinin şehri locker'ı varsa önceden seçilir. Her locker adını ve adresini gösterir. Seçim hemen sepete kaydedilir; bu yüzden teslimat adımı yenilendiğinde ya da sayfa yeniden yüklendiğinde korunur.

Locker zorunludur. Locker olmadan müşteri devam edemez ve "Lütfen bir Sameday easybox locker'ı seçin." uyarısını görür. Müşteri Continue düğmesine tıkladığında sunucu seçilen locker'ın listede olduğunu doğrular. Sahte veya kaldırılmış bir locker kimliği "Seçilen easybox locker'ı artık kullanılamıyor. Lütfen başka bir easybox locker'ı seçin." mesajıyla reddedilir. Liste yüklenemezse müşteri "Easybox locker'ları yüklenemedi. Lütfen birazdan tekrar deneyin ya da başka bir kargo yöntemi seçin." mesajını görür. Siparişle kaydedilen ad ve adres tarayıcıdan değil, listeden gelir. Sipariş verildikten sonra locker'ı değişmez.

Yönetici sipariş sayfası: AWB için ad ve adres ile Locker ID içeren bir Sameday easybox locker bloğu. Bir easybox siparişinde locker yoksa blok "Bu sipariş için easybox locker'ı seçilmedi." yazar.

Sipariş onayı ve sipariş geçmişi sayfaları: Sameday easybox locker: ad ve adresiyle birlikte.

Sipariş e-postaları: locker adı ve adresi, sipariş onay e-postasında taşıyıcıya eklenir. Mağazaya gönderilen yeni sipariş e-postası (Mail alerts modülü) ayrıca Locker ID içerir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Sameday Easybox lisans bloğu, Modules > Module Manager > VibeFox Sameday Easybox > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarihi 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-sameday-easybox satırı ile 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 yetkisi 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 License expired on ve bir tarih. 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 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 Sameday easybox taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat istenmez ya da hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez; bu yüzden 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 sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim panelinde çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülün kaldırılması lisans anahtarını ve lisans durumunu her zaman siler. Bu modülün Reset işlemi veri silmez, bu yüzden anahtar ve durum korunur.

Sorun giderme

Sameday easybox ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, API kullanıcı adı ve şifresinin girildiğini, Configure sayfasının "Sameday'e bağlandı" yazdığını ve hedef ülkenin Sameday hesabınızın ülkesi olduğunu kontrol edin. Bir fiyatın kullanılabilir olduğunu (Sameday tahmini, ülke satırı, * Default satırı ya da Fallback cost) ve ağırlık ile ara toplam sınırlarını kontrol edin. Shipping > Carriers bölümünde taşıyıcının müşterinin ülke bölgesini ve müşteri grubunu kapsadığını doğrulayın ya da Ignore shipping zones seçeneğini açın. Ürün sayfasında ürünler belirli taşıyıcılarla da sınırlandırılmış olabilir. Nedeni Log alanında görmek için Debug log seçeneğini açın.

Sameday API kullanıcı adını ya da şifresini reddetti: bunları kontrol edip yeniden kaydedin. Demo kimlik bilgileri yalnızca Test mode açıkken, üretim kimlik bilgileri yalnızca kapalıyken çalışır. O zamana kadar varsa kayıtlı locker listesi sunulur ve Sameday tahmini kullanılmaz.

Fiyat Sameday'den değil, benim tablomdan geliyor: tahmin için bir Pickup point, Easybox service, adres formunda ilçeler ve mağaza para birimi Sameday para biriminden farklıysa Exchange rate of the estimate gerekir. Tahmin, müşteri bir şehir ve ilçe girdikten sonra istenir. Sameday ulaşılamaz olduğunda ya da hata döndürdüğünde tablo ya da yedek ücret kullanılır; neden günlükte yazar.

Locker listesi eski ya da eksik: Refresh the locker list now düğmesine tıklayın ya da ayarları kaydedin. Yenileme başarısız olursa önceki liste kullanılır ve durum bunu belirtir. Mağaza bakım modundaysa cron URL'si, cron sunucusunun IP'sine izin verilmediği sürece mağazanın geri kalanı gibi engellenir.

Kargo yanlışlıkla ücretsiz: Free shipping from ile Country prices satırlarında Price değeri 0 olanları kontrol edin; özellikle + Add country ile eklenip doldurulmamış bir * Default satırını.

Ağırlık sınırları ya da ağırlık sütunları uyuşmuyor: sayfa mağaza ağırlık biriminin bilinmediğini belirtiyorsa International > Localization (Local units) bölümünde kg, g, lb veya oz ayarlayın.

Sayfa Sameday easybox taşıyıcısının bulunamadığını bildiriyor: 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, mevcut bir taşıyıcının ayarlarını ve durumunu korur.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Sameday Easybox yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Kayıtlı locker listesi, hesap kontrolü sonucu ve tüm önbellekler her zaman silinir. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa taşıyıcı yalnızca kapatılır ve tüm ayarlar korunur. Modülü yeniden kurmak, kayıtlı taşıyıcıya sahip olduğu durumu geri verir. Mevcut siparişler kayıtlı locker'ı korur.

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