VibeFox DHL Packstation for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x arası. Classic ve Hummingbird temaları desteklenir.

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

DHL API key: teslim noktaları listesi, ücretsiz DHL Location Finder API'sinden gelir. DHL geliştirici portalına (developer.dhl.com) kaydolun, bir uygulama oluşturun, "Location Finder - Unified" API'sini ekleyin ve uygulamanın API anahtarını kopyalayın. Bu API için DHL ile ticari sözleşme gerekmez. Anahtar olmadan taşıyıcı ödeme sayfasında gizlenir. DHL uygulamanızın istek limitine dikkat edin: her yeni posta kodu veya şehir araması bir API isteğidir.

VibeFox license key: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. Back office'te 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 veya daha sonra modül listesinde VibeFox DHL Packstation modülünü bulup Configure düğmesine tıklayın.

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

4. DHL API anahtarını yapıştırın, Save düğmesine, ardından Test API key düğmesine tıklayın. Teslim noktası türlerini seçin ve ülke fiyatlarını girin (bkz. Yapılandırma).

Kurulumda modül, Delivery to a DHL Packstation or post office teslimat süresi metniyle DHL Packstation taşıyıcısını oluşturur. Taşıyıcı etkindir, tüm müşteri gruplarına ve varsayılan fiyat listesindeki ülkelerin (Almanya ve Avusturya) bölgelerine 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. Fiyatları burada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox DHL Packstation > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Bir alanda hata varsa (geçersiz veya negatif sayı, Min weight (kg) değerinin Max weight (kg) değerinden büyük olması, 64 karakterden uzun bir ad), hiçbir şey kaydedilmez ve hata en üstte gösterilir. Her kayıt, teslim noktası önbelleğini temizler.

Ayarların üstündeki uyarılar şunları bildirir: taşıyıcının bulunamadığını; mağazanın ağırlık birimini (International > Localization, Local units) modülün tanımadığını (bu durumda ağırlıklar kg olarak okunur; kg, g, lb veya oz kullanın); DHL API anahtarının boş olduğunu; hiçbir teslim noktası türünün etkin olmadığını ve ülke fiyat girişlerinin CC:PRICE biçiminde olmadığını (bu girişler yok sayılır).

Genel

Taşıyıcının müşteri grupları, bölgeleri ve boyut sınırları Shipping > Carriers bölümünde ayarlanır. Aşağıdaki ayarlar tüm bölgeler için geçerlidir.

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

Name: müşteriye gösterilen taşıyıcı adı. Varsayılan: DHL Packstation. Zorunlu, en fazla 64 karakter.

Tax: taşıyıcının vergi kuralı veya No tax. PrestaShop bu vergiyi aşağıdaki fiyatların üzerine ekler. No tax seçildiğinde fiyatlar kesindir.

DHL Location Finder API

DHL API key: developer.dhl.com üzerindeki uygulamanızın "API Key" değeri. Bu anahtar olmadan taşıyıcı ödeme sayfasında gizlenir. Kaydettikten sonra alan 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.

Remove the saved API key: bu kutuyu işaretleyin ve kaydedin; kayıtlı anahtar silinir.

Connection test: Test API key düğmesi, kayıtlı anahtarla 53113 Bonn yakınındaki teslim noktalarını arar ve teslim noktası önbelleğini temizler. Önce ayarları kaydedin. Bulunan teslim noktası sayısını, DHL'in anahtarı reddedip reddetmediğini (401/403) veya API'nin doğru yanıt verip vermediğini gösterir (ayrıntılar hata ayıklama günlüğündedir).

Teslim noktaları

Ödeme sayfasında müşteri, teslimat posta kodu yakınındaki teslim noktalarını görür ve başka bir posta kodu veya şehir arayabilir.

Location types: müşterinin seçebileceği DHL teslim noktaları: Packstation (parcel locker), Post Office (Postfiliale) ve DHL Parcel Shop (Paketshop). Varsayılan olarak üçü de seçilidir. Hiçbiri seçilmezse taşıyıcı gizlenir. Packstation için müşteri kendi DHL Postnummer numarasını girmelidir.

Search radius (meters): aranan posta kodu veya şehrin çevresindeki yarıçap. Varsayılan: 5000. Tam sayı; 100'den küçük veya 25000 m'den (DHL'in üst sınırı) büyük değerler bu sınıra çekilir.

Max results: her aramada gösterilen en fazla teslim noktası sayısı. Varsayılan: 20. Tam sayı; DHL en fazla 50'ye izin verir, daha büyük değerler 50'ye indirilir.

Shipping address: seçilen teslim noktasını siparişin teslimat adresi olarak kullanır. Varsayılan olarak açıktır. Adres satırı 1, örneğin "Packstation 105" (veya bir Post Office ya da Parcel Shop için "Postfiliale 502") olur; satır 2 ise numarasıyla birlikte "Postnummer" olur ve teslim noktasının posta kodu, şehri ve ülkesi eklenir. Böylece siparişten yazdırılan etiketler doğru yere gider. Ad, şirket ve telefon müşterinin adresinden alınır. Yeni adres yalnızca sipariş tarafından kullanılır ve müşterinin adres defterinde görünmez.

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

Country prices: hedef ülke başına fiyat; mağazanın varsayılan para biriminde, vergi hariç, CC:PRICE biçiminde, virgül veya yeni satırla ayrılmış. Varsayılan: DE:4.99, AT:5.99. Ondalık virgül de çalışır (DE:4,99).

Other countries: Country prices içinde bulunmayan bir hedef ülke için fiyat. Varsayılan: 5.99. Bu ülkeler için taşıyıcıyı gizlemek üzere boş bırakın.

Calculation: Per order fiyatı bir kez alır. Per item (price x quantity) ise fiyatı sepetteki ürün sayısıyla çarpar.

Free shipping from: bu kargonun ücretsiz olduğu sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergiden önce). Hiçbir zaman ücretsiz olmayacaksa boş bırakın.

Kullanılabilirlik

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

Max weight (kg): bu sepet ağırlığının üzerinde taşıyıcı gizlenir. Varsayılan: 31.5, çünkü bir Packstation 31,5 kg'a kadar paket kabul eder. 0 sınır olmadığı anlamına gelir.

Minimum subtotal: taşıyıcıyı yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergiden önce) bu değerin en az olduğunda gösterir. Her zaman göstermek için boş bırakın.

Ignore shipping zones: açıkken taşıyıcı tüm etkin bölgelere (sonradan oluşturulanlar dahil) bağlanır ve aşağıdaki ülkeler için sunulur; liste boşsa tüm ülkeler için sunulur. Tekrar kapattığınızda taşıyıcı, daha önce sahip olduğu bölgeleri geri alır.

Countries (ignore zones): bu mod için hedef ülkeler. Birden fazla ülke seçmek için Ctrl/Cmd + tıklama kullanın. Yalnızca Ignore shipping zones ile kullanılır.

Gelişmiş

Debug log: API isteklerini ve ödeme adımlarını, modül klasöründeki logs/vfd_dhlp_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları, bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarı, Postnummer ve müşteri adresleri hiçbir zaman yazılmaz.

Log: hata ayıklama günlüğünün boyutunu ve en son girişlerini gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken modülü kaldırmak ayarları, taşıyıcıyı, önbelleğe alınmış aramaları ve günlükleri siler. Seçilen teslim noktaları siparişlerde kalır. Kapalıyken yeniden kurulum için her şey saklanır.

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

Teslimat adımında PrestaShop, modülden DHL Packstation fiyatını ister. Yalnızca fiziksel ürünler dikkate alınır: sanal ürünler ağırlığa katkı sağlamaz ve ara toplama dahil edilmez. Modül; bir API anahtarının ve en az bir teslim noktası türünün ayarlı olduğunu, izin verilen ülkeleri (Ignore shipping zones ile), sepet ağırlığını ve minimum ara toplamı kontrol eder. Ardından hedef ülkenin fiyatını (veya diğer ülkelerin fiyatını) alır ve ara toplam yeterince yüksekse ücretsiz kargoyu uygular. Fiyat mağazanızın varsayılan para biriminde hesaplanır ve müşterinin sepet para biriminde gösterilir.

Taşıyıcı siparişler aldıktan sonra Shipping > Carriers bölümünde düzenlenirse PrestaShop onu yeni bir taşıyıcı sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül DHL gönderisi oluşturmaz, etiket yazdırmaz ve kargoları takip etmez. DHL işletme müşteri portalını veya bir etiket aracını kullanın: Shipping address açıkken sipariş zaten Packstation adresini ve Postnummer numarasını içerir. Modül canlı DHL tarifelerini hesaplamaz ve harita göstermez. Packstation numarasının elle girilmesi desteklenmez.

Teslim noktaları

Müşteri DHL Packstation seçtiğinde, taşıyıcının altında bir seçici belirir. Teslimat posta kodu ve şehrine yakın DHL teslim noktaları yüklenir. DHL yalnızca seçilen taşıyıcı için sorgulanır. Müşteri başka bir posta kodu veya şehir yazıp Search düğmesine tıklayabilir. Teslim noktaları türüne göre gruplanır (Packstation, Post Office, Parcel Shop) ve mesafeye göre sıralanır. Hiçbir şey bulunamazsa müşteri No DHL locations found near "…". Try another postcode or city. mesajını görür.

Packstation için müşteri, uygulamasından veya DHL hesabından alabileceği 6-12 haneli DHL müşteri numarası olan DHL Postnummer değerini girmelidir. Diğer teslim noktaları için bu isteğe bağlıdır. Seçim yapılır yapılmaz sepete kaydedilir. Continue düğmesine basıldığında sunucu bunu yeniden kontrol eder: teslim noktası, teslimat ülkesindeki DHL arama sonuçlarından biri olmalıdır. Teslim noktası yoksa müşteri Please choose a DHL Packstation or post office for delivery. mesajını görür ve devam edemez. Eksik veya geçersiz Postnummer da aynı şekilde bildirilir.

Arama sonuçları 12 saat önbelleğe alınır. Boş veya başarısız bir arama 10 dakika önbelleğe alınır; böylece ödeme sayfası her yenilemede DHL'i beklemez. API zaman aşımı 12 saniyedir. DHL API'sine ulaşılamazsa müşteri DHL locations cannot be loaded right now. Please try again later or choose another shipping method. mesajını görür. Müşterinin daha önce seçtiği bir teslim noktası yine de kabul edilir.

Sipariş verildiğinde teslim noktası (ID, tür, numara, ad, adres) ve Postnummer siparişle birlikte kaydedilir. Shipping address açıksa siparişin teslimat adresi, teslim noktasının adresiyle değiştirilir. Teslim noktası; sipariş onay sayfasında, müşteri hesabındaki Order history and details bölümünde ve Mail alerts modülünün sipariş onay e-postasında ile yeni sipariş e-postasında gösterilir; taşıyıcı adına DHL pickup location ve DHL Postnummer etiketleri eklenir.

Back office'teki sipariş sayfasında DHL pickup location bloğu teslim noktasını, türünü ve ID'sini ile Postnummer'ı gösterir. Change düğmesine tıklayın, posta kodu veya şehre göre arayın, başka bir teslim noktası seçin, Postnummer'ı değiştirin ve Save location düğmesine tıklayın. Yalnızca Postnummer'ı da değiştirebilirsiniz. Her değişiklik siparişe özel bir not ekler: DHL pickup location changed to: …. Shipping address açıksa siparişin teslimat adresi de güncellenir. Teslim noktasını değiştirmek için siparişleri düzenleme izni gerekir; Modules sayfalarına erişim gerekmez. Aynı sepetten birden fazla sipariş oluşturulduysa teslim noktası yalnızca ilk siparişe aittir; aynı sepetin başka bir siparişinde Change düğmesi The DHL location of this cart belongs to another order of the same cart - nothing was changed. mesajını gösterir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox DHL Packstation lisans bloğu, Modules > Module Manager > VibeFox DHL Packstation > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blokta anahtar maskeli olarak, durum (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmeleri görünür. Bunların altında Product: presta-shipping-dhl-packstation satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modülün Configure izni olan çalışanlar değiştirebilir. Bloktaki metinler 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 tarihli 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 yalnızca 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 DHL Packstation 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ü bir anahtar satın almadan önce yapılandırabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager bölümünde 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ın girildiği ilk 14 gün boyunca günde bir kez, ardından haftada bir. Cron işi gerekmez. Modülü kaldırmak her zaman lisans anahtarını ve lisans durumunu siler. Reset bu modülde veri silmez, bu nedenle anahtar ve durum korunur.

Sorun giderme

DHL Packstation ö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 bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşteri grubunu kapsadığını kontrol edin (veya Ignore shipping zones seçeneğini açıp Countries (ignore zones) alanını kontrol edin). DHL API key alanının dolu olduğunu, en az bir teslim noktası türünün seçili olduğunu, hedef ülkenin bir fiyatı olduğunu (veya Other countries ayarlandığını) ve ağırlık ile ara toplam kurallarının taşıyıcıyı gizlemediğini kontrol edin. Ürünler ürün sayfasında belirli taşıyıcılarla da sınırlandırılmış olabilir.

Hiçbir teslim noktası gösterilmiyor: Test API key düğmesine tıklayın. DHL anahtarı reddederse (401/403), anahtarı ve uygulamanızda "Location Finder - Unified" API'sinin bulunduğunu kontrol edin. Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve modül sayfasındaki Log alanına bakın. DHL uygulamanızın istek limitine ulaşılmadığını kontrol edin.

Bir adrese yakın teslim noktası yok: Search radius (meters) veya Max results değerini artırın ya da müşterinin başka bir posta kodu veya şehir aramasına izin verin. DHL verisinde numarası olmayan bir Packstation listelenmez.

Müşteri "Enter your postcode or city to see DHL locations near you." mesajını görüyor: teslimat adresinde posta kodu ve şehir yok. Müşteri arama alanına bunlardan birini yazabilir.

Sipariş sayfasındaki Change düğmesi "Please choose a DHL location of the search - nothing was changed." mesajını veriyor: posta kodu veya şehre göre arayın ve sonuçlardan bir teslim noktası seçin. Siparişin henüz bir teslim noktası yoksa, Postnummer kaydedilmeden önce bir teslim noktası seçilmelidir.

Sayfa DHL Packstation 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ü Reset ile sıfırlayın. Reset, mevcut bir taşıyıcının açık/kapalı durumunu korur.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox DHL Packstation yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu ve teslim noktası önbelleği her zaman silinir. 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ı da 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 kurmak, taşıyıcının daha önceki durumunu geri yükler. Seçilen teslim noktaları her zaman siparişlerde kalır.

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