VibeFox Sameday Easybox for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

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 genellikle 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 yöntem sunulmaz, çünkü müşteri bir locker seçemez.

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 yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_sameday_easybox 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 Sameday Easybox ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Sameday API username ve API password bilgilerinizi girin, Sameday country seçin ve kaydedin. Sayfada "Connected to Sameday ... easybox lockers" yazmalıdır. Pickup point ve Easybox service hesabınızdan otomatik doldurulur.

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

7. WooCommerce > Settings > Shipping > Shipping zones bölümünde, Sameday ülkenizin kargo bölgesine VibeFox Sameday Easybox ekleyin veya Ignore shipping zones seçeneğini açın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox Sameday Easybox. Bunlar tüm kargo bölgelerinde geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölgede müşterilerin gördüğü ad. Genel Name alanını kullanmak için boş bırakın.

Ayarların üstünde sayfa bağlantı durumunu gösterir: Sameday sunucusu, easybox 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 bilgisi, fiyat veya tahmin için döviz kuru eksikliği.

Tüm fiyat ve sınırlar ondalık ayırıcı olarak virgül ya da nokta kabul eder (4,99 veya 4.99). Geçersiz bir sayı bir mesajla reddedilir.

Genel

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

Name: müşteriye gösterilen kargo yöntemi adı. Bir bölge bunu kendi Title alanıyla değiştirebilir. Default: Sameday easybox.

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez.

Sameday hesabı (API)

Kaydettiğinizde eklenti 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. Sameday 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 lockerları sunulur ve yöntem yalnızca bu hedef ülke için gösterilir.

Test mode: Sameday demo API'sini demo kimlik bilgileriyle kullanır.

Fiyatlar

Kullanım sırası şöyledir: Sameday tahmini (Pickup point ve Easybox service ayarlıysa), ardından ülke fiyat tablosu, en sonunda yedek ücret. Tablo fiyatları mağaza para biriminde girilir.

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) ve otomatik seçilir. Sameday tahmini için gereklidir.

Exchange rate of the estimate: Sameday tahminleri Sameday ülkenizin para biriminde yapar: 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. Bu olmadan tahmin kullanılmaz ve fiyat tablosu uygulanır. Lev ve euro sabit kurla otomatik olarak çevrilir.

Table price: Per order fiyatı bir kez alır. Per item (price x quantity) fiyatı gönderilebilir ürün sayısıyla ç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ığına göre fiyat. Satır eklemek için + Add country düğmesine, satır silmek için çarpı işaretine 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 ü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, ücretsiz kargo anlamına gelir. Kaydetmeden önce ülkeyi seçin ve fiyatları girin ya da satırı silin. Aynı ülke iki satırdaysa, kaydederken yalnızca ilki tutulur. 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 yöntemin sunulmaması için boş bırakın.

Free shipping from: easybox teslimatının ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergi hariç). Yalnızca bir fiyatın bulunduğu yerlerde geçerlidir: bir ülke satırı, * Default satırı veya yedek ücret (bu durumda tahmin istenmez) ya da Sameday tahmini. Ücretsiz kargonun hiç sunulmaması için boş bırakın.

Uygunluk

Minimum weight (kg): sepet bundan hafifse yöntemi gizler. Ağırlık, mağazanızın ağırlık biriminden çevrilir. Boş veya 0, sınır olmadığı anlamına gelir.

Maximum weight (kg): bundan ağır paketlere easybox teslimatı sunulmaz. Default: 30. Sameday sözleşmenizdeki sınırı ve easybox kutu boyutlarını kontrol edin. Boş veya 0, sınır olmadığı anlamına gelir.

Minimum cart subtotal: yöntemi yalnızca sepet ara toplamı (indirimlerden sonra, vergi hariç) bu tutara ulaştığında sunar.

Excluded shipping classes: sepette bu WooCommerce kargo sınıflarından birine ait bir ürün varsa yöntemi gizler.

Ignore shipping zones: açıkken yöntem, ilgili kargo bölgesine eklenmemiş olsa bile aşağıda seçilen ülkeler için sunulur. Kapalıyken yalnızca eklendiği bölgelerde sunulur.

Countries (ignore zones mode): bu mod için hedef ülkeler. Sameday ülkesini kullanmak için boş bırakın. Sameday ülkesi dışındaki ülkeler atlanır. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: fiyat hesaplamalarını, API çağrılarını ve locker seçimlerini WooCommerce > Status > Logs sayfasına yazar (kaynak "vfd-sameday-easybox"). API hataları her zaman kaydedilir. Şifre, jeton veya müşteri kişisel verisi kaydedilmez. İşiniz bittiğinde günlüğü kapatın.

Remove data on uninstall: açıkken eklentiyi silmek, ayarları ve bu yöntemin bölge örneklerini kaldırır. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlerde kaydedilen locker her zaman korunur.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir fiyat ister. Eklenti koşulları kontrol eder: Sameday hesabınızın teslimat ülkesi, API kimlik bilgileri ve kullanılabilir bir locker listesi, sepet ağırlığı, minimum sepet ara toplamı ve hariç tutulan kargo sınıfları. Ardından bir fiyat arar: Sameday tahmini, ülke tablosu, yedek ücret. Fiyat yoksa yöntem gizlenir. Ücretsiz kargo geçerliyse müşteri yöntemi ücretsiz olarak görür.

Aksi halde eklenti, müşteri bir şehir ve ilçe girdikten sonra Sameday'den tahmin ister. Teslim noktanızı ve hizmetinizi, paketin ağırlığını ve müşterinin cadde adresini, şehrini, ilçesini ve posta kodunu 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 biriminize çevrilir. Tahmin yoksa (kurulum yapılmamış, henüz şehir veya ilçe yok, hata, döviz kuru yok), fiyat önce ülke tablosundan, sonra yedek ücretten alınır. Fiyat yoksa yöntem gizlenir.

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

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

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

Locker seçimi

Müşteri yöntemi seçtiğinde altında iki listeli bir easybox locker bloğu görünür: - Select city - ve - Select easybox locker -. Müşterinin kendi şehrinde locker varsa o şehir önceden seçilir. Her locker adını ve adresini gösterir. Seçim, ödeme sayfası yenilendiğinde veya sayfa yeniden yüklendiğinde hatırlanır.

Locker zorunludur. Locker seçilmezse ödeme "Please choose a Sameday easybox locker." mesajıyla durur. Sunucu, seçilen locker'ın listede olduğunu hem klasik hem de blok ödeme sayfasında kontrol eder. Sahte veya kaldırılmış bir locker kimliği "The selected easybox locker is not available any more. Please choose another easybox locker." mesajıyla reddedilir. Siparişle kaydedilen ad ve adres tarayıcıdan değil, listeden gelir.

Yönetici sipariş ekranı: Sameday AWB'si için ad ve adres ile Locker ID içeren Sameday easybox locker bilgisi, teslimat adresinin altında gösterilir. Bir easybox siparişinde locker yoksa ekran "No easybox locker was selected for this order." yazar.

Teşekkür sayfası ve sipariş görünümü: Sameday easybox locker: ad ve adresle birlikte.

Sipariş e-postaları: HTML ve düz metin e-postalarda locker adı ve adresi. Yönetici e-postaları ayrıca Locker ID içerir.

Veritabanında locker, sipariş meta alanlarında _vfd_sdeb_locker_id (AWB için Sameday locker kimliği) ve _vfd_sdeb_locker_name (ad ve adres) olarak saklanır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Sameday Easybox 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 etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. 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, o alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Sameday easybox, ödeme sayfasında müşterilere gösterilmez. Giriş yapmış mağaza yöneticileri yine de (unlicensed — visible to admins only) ibaresiyle 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ın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

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 ve ayarlar sayfasında "Connected to Sameday" yazdığını, hedef ülkenin Sameday hesabınızın ülkesi olduğunu kontrol edin. Bir fiyatın mevcut olduğunu (Sameday tahmini, ülke satırı, * Default satırı veya Fallback cost), ağırlık ve ara toplam sınırlarını, Excluded shipping classes ayarını ve yöntemin uygun bölgeye eklendiğini (ya da Ignore shipping zones açık olduğunu) kontrol edin. Nedenini WooCommerce > Status > Logs sayfasında görmek için Debug log seçeneğini açın.

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

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

Locker listesi eski veya eksik: ayarları kaydedin. Liste boşsa, bir saatten eskiyse veya son yükleme başarısız olduysa yeniden yüklenir. Yenileme başarısız olursa önceki liste kullanılır ve durum bunu belirtir.

Kargo yanlışlıkla ücretsiz: Country prices içinde Price değeri 0 olan satırları kontrol edin; özellikle + Add country ile eklenip doldurulmamış bir * Default satırını.

Sınır ötesi lockerlar: geliştiriciler vfd_sdeb_countries filtresiyle hedef ülke ekleyebilir. Locker listesi her zaman sizin hesabınızın listesidir.

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, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur ve yalnızca günlük locker listesi yenilemesini durdurur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu, kayıtlı locker listesi, hesap kontrolü sonucu ve tüm önbellekler her zaman silinir. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa silinir. Aksi halde sonraki yeniden kurulum için saklanırlar. Mevcut siparişler kargo satırlarını ve kaydedilen lockerı korur.

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