VibeFox DPD Pickup for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x arası.

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

DPD Baltic kimlik bilgileri (Litvanya, Letonya, Estonya): teslim alma noktası listesi DPD Baltic web servisinden gelir. DPD'nin iş müşterilerine verdiği API kullanıcı adı ve şifresine ihtiyacınız var. Bunları DPD hesap yöneticinizden veya ülkenizdeki DPD müşteri hizmetlerinden isteyin. Bir hesap, Litvanya, Letonya ve Estonya'nın teslim alma noktalarını listeler.

DPD Slovakya: DPD Slovakya'nın herkese açık parcelshop araması kimlik bilgisi gerektirmez.

VibeFox lisans anahtarı: 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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox DPD Pickup öğesini bulup Configure düğmesine tıklayın.

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

4. DPD API'nizi seçin. DPD Litvanya, Letonya veya Estonya için API kullanıcı adı ve şifresini girin. Ülke başına fiyatları kontrol edin ve Save düğmesine tıklayın. Ardından bağlantıyı test etmek için Refresh pickup points düğmesine tıklayın (bkz. Yapılandırma).

Kurulumda modül, DPD Pickup point or locker teslimat süresi metniyle DPD Pickup Point taşıyıcısını oluşturur. Taşıyıcı, Slovakya, Litvanya, Letonya ve Estonya bölgelerine ve tüm müşteri gruplarına, vergi kuralı olmadan atanır. Bölgeleri, müşteri gruplarını, teslimat süresi metnini, logoyu ve boyut sınırlarını Shipping > Carriers bölümünden 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 DPD Pickup > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbelleğe alınmış teslim alma noktası listelerini de temizler.

Sayfanın üst kısmındaki uyarılar; DPD Baltic kullanıcı adı veya şifresi boş olduğunda, fiyat ayarlanmadığında (her iki durumda da taşıyıcı ödeme sayfasında gösterilmez), taşıyıcı silindiğinde ve mağaza ağırlık biriminin (International > Localization, Local units) modül tarafından bilinmediğinde gösterilir; bu durumda ürün ağırlıkları kg olarak okunur. Bir tutar veya ağırlık alanında sayı olmayan ya da negatif bir değer kaydedilmez: alan boşalır ve bir uyarı bu alanı belirtir. CC:FİYAT biçiminde olmayan Country prices satırları bir uyarıda listelenir ve yok sayılır.

Genel

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

Name: ödeme sayfasında müşteriye gösterilen taşıyıcı adı. Varsayılan: DPD Pickup Point. Zorunlu, en fazla 64 karakter.

Tax status: kargo fiyatına uygulanan taşıyıcı vergi kuralı. None vergi olmadığı anlamına gelir. Diğer seçenekler, mağazanızdaki bir vergi kuralının adıyla birlikte Taxable gösterir.

DPD teslim alma noktası listesi

Teslim alma noktaları DPD'den yüklenir ve 24 saat önbelleğe alınır.

DPD API: hesabınızın bağlı olduğu DPD şirketi. Baltık hesapları kendi ülkelerinin web servisini kullanır.

API username (Baltic): DPD Baltic web servisi kullanıcı adınız. DPD Slovakya için gerekli değildir. Bunu temizlemek, kayıtlı şifreyi de siler.

API password (Baltic): DPD Baltic web servisi şifreniz. DPD Slovakya için gerekli değildir. 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.

Pickup points: Refresh pickup points düğmesi önbelleği temizler ve teslim alma noktalarını şimdi DPD'den yükler: Baltic API için Litvanya, Letonya ve Estonya ve DPD Slovakya için Bratislava'da bir deneme araması. Her ülke için teslim alma noktası sayısını veya hatayı gösterir. Önce ayarları kaydedin.

Fiyatlar

Kargo fiyatları ülkeye göre sabittir, mağazanızın varsayılan para biriminde ve vergi hariçtir. DPD fiyatları API'den talep edilmez.

Country prices: ülke başına bir satır: CC:fiyat, örneğin EE:3.50. Ondalık virgül kabul edilir. Varsayılan: SK:3.50, LT:4.00, LV:4.00, EE:4.00.

Fallback cost: Country prices içinde olmayan ülkeler için fiyat. Varsayılan: 5.00. Taşıyıcıyı yalnızca listelenen ülkelerde sunmak için boş bırakın.

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

Free shipping from: sipariş ara toplamı (indirimlerden sonra, vergiden önce) bu tutara ulaştığında kargo ücretsizdir. Kapatmak için boş bırakın.

Kullanılabilirlik

Taşıyıcı, DPD müşterinin adresi için teslim alma noktası döndürmediğinde veya DPD API'sine ulaşılamadığında da gizlenir; çünkü teslim alma noktası olmadan bir sipariş teslim edilemez.

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. Boş veya 0 sınır olmadığı anlamına gelir.

Max weight (kg): daha ağır sepetler taşıyıcıyı görmez. Varsayılan: 31.5. 0 sınır olmadığı anlamına gelir. Ülkenizdeki DPD teslim alma noktaları ve dolapları için paket sınırlarını kontrol edin. Min weight (kg) değeri Max weight (kg) değerinden büyükse reddedilir ve hiçbir şey kaydedilmez.

Minimum subtotal: taşıyıcıyı yalnızca sipariş ara toplamı (indirimlerden sonra, vergiden önce) bu tutarın en az bir değerine ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Ignore shipping zones: açıkken taşıyıcı tüm bölgelere bağlanır ve aşağıdaki ülkeler için sunulur. Daha sonra oluşturduğunuz bir bölge hemen bağlanır. Kapalıyken taşıyıcı yalnızca Shipping > Carriers bölümündeki bölgelerinde sunulur. Kapatmak, taşıyıcıyı daha önce sahip olduğu bölgelere geri döndürür.

Countries: bu mod için hedef ülkeler. Tüm ülkeler için boş bırakın. Yalnızca Ignore shipping zones ile kullanılır.

Teslim alma noktası seçici

City order: önce büyük şehirleri gösterir (Tallinn, Riga, Vilnius, Bratislava ve diğerleri). Varsayılan olarak açıktır.

City list width: şehir listesinin CSS genişliği, örneğin 100% veya 300px. Varsayılan: 100%.

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

Gelişmiş

Debug log: API isteklerini ve ödeme adımlarını modül klasöründeki logs/vfd_dpd_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları, bu seçenek kapalı olsa bile her zaman kaydedilir. Kimlik bilgileri hiçbir zaman kaydedilmez.

Log: hata ayıklama günlüğünün boyutunu ve 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, modül ayarlarını ve taşıyıcıyı siler. Siparişlerde kaydedilen teslim alma noktası her zaman korunur.

Ödeme sürecinde nasıl çalışır

Kargo adımında PrestaShop, modülden DPD Pickup fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül ülkeleri (Ignore shipping zones ile), sepet ağırlığını ve minimum ara toplamı kontrol eder, ülke fiyatını (veya yedek maliyeti) alır ve ara toplam yeterince yüksekse ücretsiz kargoyu uygular. Ardından adres için DPD teslim alma noktalarını yükler. DPD hiç nokta döndürmezse, ulaşılamazsa veya Baltic kimlik bilgileri eksikse taşıyıcı gizlenir. Fiyat, mağazanızın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Bir teslim alma noktası listesi 24 saat, boş bir liste 1 saat önbelleğe alınır. Başarısız bir istek 5 dakika hatırlanır; böylece bir DPD kesintisi ödeme sürecini asla yavaşlatmaz. API zaman aşımı 15 saniyedir.

Siparişleri olan bir taşıyıcıyı Shipping > Carriers bölümünde düzenlerseniz PrestaShop bunu yeni bir taşıyıcı sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül DPD fiyatlarını talep etmez, DPD gönderisi oluşturmaz, etiket yazdırmaz, manifesto oluşturmaz, kurye alımı ayarlamaz, kargo takibi yapmaz veya harita göstermez. Yalnızca DPD Baltic web servisi ve DPD Slovakya parcelshop araması desteklenir.

Teslim alma noktaları

Müşteri DPD Pickup'ı seçtiğinde, taşıyıcının altında bir şehir listesi ve bir teslim alma noktası listesi görünür. Müşterinin adresindeki şehir önceden seçilidir. Seçim, müşteri seçer seçmez sepete kaydedilir. DPD Slovakya ile müşteri, adres tamamlanana kadar Enter your city and postcode to see the DPD pickup points nearby. mesajını görür; ardından yakındaki noktaları görür. DPD adres için hiç nokta bulamazsa müşteri No DPD pickup points are available for this address right now. Please check the address or choose another shipping method. mesajını görür.

Bir teslim alma noktası zorunludur. Nokta olmadan müşteri devam edemez ve Please select a DPD pickup point. mesajını görür. Sunucu, noktanın müşterinin adresi için DPD listesine ait olduğunu kontrol eder. Sahte veya güncel olmayan bir seçim The selected DPD pickup point is not available for this address. Please choose another one. mesajıyla reddedilir.

Seçilen nokta siparişe kaydedilir. Sipariş onay sayfasında ve müşterinin sipariş ayrıntılarında DPD pickup point: olarak gösterilir. Sipariş onay e-postasında taşıyıcı adının ardından eklenir. Mağazaya giden yeni sipariş e-postası (ps_emailalerts) nokta kimliğini de gösterir. Siparişe kaydedilen ad tarayıcıdan değil, DPD'den gelir.

Back office'teki sipariş sayfasında DPD pickup point bloğu nokta adını, kimliğini ve ülkesini gösterir. Edit düğmesine tıklayın, bir şehir ve başka bir nokta seçin ve Save düğmesine tıklayın. Nokta, siparişin adresi için DPD listesiyle kontrol edilir ve sayfa Pickup point updated. veya Pickup point not found for the order address. mesajını gösterir. Noktayı değiştirmek için Modules sayfalarına erişim değil, siparişleri düzenleme izni gerekir. Her değişiklik, siparişin Advanced Parameters > Logs bölümüne eski nokta, yeni nokta ve çalışanla birlikte kaydedilir. DPD Slovakya ile noktayı değiştirmek için siparişin bir teslimat şehri ve posta kodu olmalıdır.

Bir sepet birden fazla siparişe bölünürse, teslim alma noktası ilk siparişte kalır. Diğer siparişler No pickup point was selected for this order. mesajını gösterir, hata ayıklama günlüğünde her biri için bir hata bulunur ve oradaki Edit düğmesi The pickup point of this cart belongs to another order of the same cart. Nothing was changed. mesajını gösterir. Bu tür bir siparişin noktasını DPD'ye elle bildirmeniz gerekir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox DPD Pickup lisans bloğu, Modules > Module Manager > VibeFox DPD Pickup > 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ı maskelenmiş olarak, durumu (ö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üğmelerini gösterir. Bunların altında Product: presta-shipping-dpd-pickup 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 izni olan çalışanlar değiştirebilir. Bloktaki metinler back office 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 bir tarihle 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 DPD Pickup taşıyıcısı ödeme sürecinde müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop vitrini back office'e giriş yaptığınızı bilmediği için taşıyıcı sizden de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme sürecinde test edemezsiniz. Modules > Module Manager sayfasında 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. Back office'te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün içinde günde bir kez, ardından 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

DPD Pickup ö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 (ya da Ignore shipping zones açık ve ülke izinliyse). Modül sayfasının üstündeki uyarıları inceleyin ve Refresh pickup points düğmesine tıklayın. Ağırlık ve ara toplam sınırlarını ve ülkenin bir fiyatı (ya da yedek maliyeti) olup olmadığını kontrol edin. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlandırılmış olabilir.

Refresh pickup points sonrasında hata: sonuç, her ülke için DPD hatasını gösterir. Örneğin "Login failed", DPD'nin Baltic kimlik bilgilerini reddettiği anlamına gelir; bu nedenle hiçbir teslim alma noktası yüklenemez. API kullanıcı adını ve şifresini DPD ile kontrol edin.

DPD Slovakya nokta göstermiyor: noktalar, müşteri şehri ve posta kodunu girdikten sonra görünür. DPD yalnızca bu adresin 50 km çevresindeki noktaları listeler. Geliştiriciler, yarıçapı actionVfdDpdSkSearchRadius modül kancasıyla değiştirebilir.

Nedeni bulmak: Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve modül sayfasındaki Log alanına bakın. Her karar orada yazılır. API hataları her zaman kaydedilir. API kullanıcı adları ve şifreleri günlüğe asla yazılmaz.

Bir değişiklikten sonra teslim alma noktaları eski görünüyor: modül sayfasında Save veya Refresh pickup points düğmesine tıklayın. İkisi de önbelleğe alınmış listeleri temizler.

Sayfa DPD Pickup taşıyıcısının bulunamadığını söylüyor: 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.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox DPD Pickup yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu ve teslim alma noktası önbelleği her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişlerini korur) ve ayarlar, günlük ile tamamlanmamış sepetlerin seçimleri 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 veya bir Reset yapmak, kayıtlı taşıyıcıya daha önceki durumunu geri verir: devre dışı bıraktığınız bir taşıyıcı devre dışı kalır. Siparişlerde saklanan teslim alma noktası asla silinmez.

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