VibeFox DHL Africa for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: cURL eklentisi bulunan 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde veya cURL olmadan kurulmaz. DHL XML Services ayrıca PHP SimpleXML eklentisini gerektirir.

DHL Express hesabı (yalnızca anlık tarifeler için): anlık tarifeler MyDHL API'yi kullanır. DHL Express hesap numaranıza ve MyDHL API kimlik bilgilerine ihtiyacınız vardır: bir API anahtarı ve bir API gizli anahtarı. Bunları DHL Developer Portal'dan (MyDHL API, "Get access") veya DHL Express hesap yöneticinizden talep edebilirsiniz. Hâlâ DHL XML Services kimlik bilgilerine (Site ID ve parola) sahip hesaplar bunları bunun yerine kullanabilir. Yalnızca yedek fiyatları kullanıyorsanız DHL kimlik bilgilerine ihtiyacınız yoktur.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar yalnızca 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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox DHL Africa öğesini 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'yi seçin, API key, API secret ve DHL hesap numaranızı girin. Test kimlik bilgilerini kullandığınız sürece Test mode seçeneğini açık tutun. Ship from adresini girin. DHL hesabınız mağazanızın varsayılan para biriminde faturalandırılmıyorsa DHL quote currency ve Exchange rate alanlarını ayarlayın. İsteğe bağlı olarak ülke fiyatlarını ve bir yedek ücret belirleyin (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, DHL Express courier teslimat süresi metniyle DHL Express taşıyıcısını oluşturur. Taşıyıcı tüm bölgelere ve tüm müşteri gruplarına 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ı orada belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox DHL Africa > Configure. Taşıyıcının her bölgesi için geçerlidir. 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ış DHL tekliflerini de temizler. Fiyatlar ve ağırlıklar ondalık virgül veya nokta kabul eder.

Sayfanın üstündeki uyarılar, API key, API secret veya hesap numarası eksik olduğu için (ya da XML Services ile Site ID veya parola eksik olduğu için) anlık tarifelerin kapalı olduğunu, gönderici ülke veya şehrin eksik olduğunu, XML Services seçildiğini (DHL bunları kaldırıyor), yani kur bilgisi olmadan bir teklif para birimi ayarlandığını ve International > Localization (Local units) altındaki mağaza ağırlık veya boyut biriminin modül tarafından bilinmediğini bildirir (bu durumda kg veya cm varsayılır). Kayıt sırasında bir değer geçersizse (boş veya 64 karakterden uzun bir ad, geçersiz veya negatif bir sayı, 0 kur, maksimum ağırlıktan büyük minimum ağırlık, teklif para birimi, gönderici ülke ya da vergi kuralı), bir hata ilgili alanı belirtir, o alanın önceki değeri korunur ve diğer ayarlar kaydedilir.

Genel

Enable DHL Express Africa: 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üşterinin ödeme sırasında gördüğü taşıyıcı adı. Varsayılan: DHL Express. Zorunlu, en fazla 64 karakter.

Tax: taşıyıcının vergi kuralı veya No tax. Bir vergi kuralı varsa (ve mağazada vergiler etkinse) DHL tarifesi, DHL'nin teklif ettiği vergi çıkarılarak alınır ve PrestaShop kendi vergisini ekler. No tax seçildiğinde DHL tarifesi, vergi dahil olarak teklif edildiği gibi alınır.

DHL Express hesabı (yalnızca anlık tarifeler için gereklidir)

DHL API: hangi DHL arayüzünün kullanılacağı. Yalnızca seçilen API'nin alanları gösterilir.

API key: MyDHL API kullanıcı adınız (API anahtarı).

API secret: MyDHL API parolanız (API gizli anahtarı). Kaydettikten sonra API key ve API secret alanları 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 and API secret: yalnızca bir anahtar veya gizli anahtar kayıtlıysa görünür. Açın ve ikisini de silmek için Save düğmesine tıklayın.

XML Site ID: DHL XML Services Site ID'niz (yalnızca eski API için). Temizlemek, kayıtlı XML parolasını da siler.

XML password: DHL XML Services parolanız (yalnızca eski API için). API secret gibi, kaydettikten sonra tekrar gösterilmez.

DHL account number: DHL Express hesap numaranız (9 haneli). MyDHL API bunu gerektirir. XML Services ile yayımlanmış tarifeler yerine hesabınızın tarifelerini döndürür.

Test mode: DHL test ortamını kullanır. Varsayılan olarak açıktır. Test kimlik bilgileri yalnızca test ortamında, canlı kimlik bilgileri yalnızca canlı ortamda çalışır. Canlıya geçtiğinizde kapatın.

Ship from

DHL'nin paketleri aldığı adres. Tarife buna bağlıdır.

Origin country: gönderim yaptığınız ülke.

Origin city: gönderim yaptığınız şehir, örneğin Johannesburg. MyDHL API bunu gerektirir.

Origin postcode: posta kodu olmayan ülkeler için boş bırakın (örneğin Kenya, Nijerya, Gana).

Tarifeler

Tüm fiyatlar mağazanızın varsayılan para biriminde, vergi hariç belirtilir. Anlık tarife, paket için en ucuz DHL Express ürünüdür. DHL yapılandırılmamışsa, hata verirse veya rota için hizmeti yoksa, ülke fiyatı, ardından yedek ücret kullanılır. İkisi de yoksa taşıyıcı gizlenir.

DHL quote currency: DHL, DHL hesabınızın ülke para biriminde teklif verir (örneğin ZAR, NGN veya KES). DHL mağazanızın varsayılan para biriminde bir tutar döndürmezse, anlık tarife bu para biriminden aşağıdaki kur bilgisiyle dönüştürülür. Aksi halde kullanılmaz. Varsayılan: — None —.

Exchange rate: DHL teklif para biriminden 1 birimin mağazanızın varsayılan para biriminde ne kadar olduğu, örneğin 1 ZAR = 0.05. 0'dan büyük olmalıdır. Dönüşüm istemiyorsanız boş bırakın. Kur bilgisi elle girilen bir ayardır.

Fallback cost: anlık tarife ve ülke fiyatı yoksa uygulanan sabit ücret. Bu durumda taşıyıcıyı gizlemek için boş bırakın.

Country prices: hedef ülke başına yedek fiyat, satır başına bir tane: CC:Price, örneğin ZA:25.00. Anlık tarife olmadığında kullanılır. Başka biçimdeki satırlar yok sayılır ve kayıt sırasında bir uyarı bunları listeler.

Fallback price basis: Per order ücreti bir kez alır. Per item (multiplied by the cart quantity) ücreti sepetteki ürün adediyle çarpar. Yalnızca ülke fiyatına ve yedek ücrete uygulanır. DHL anlık tarifesi her zaman tüm paket içindir.

Free shipping from: bu taşıyıcının ücretsiz olduğu sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergiden önce). DHL'ye sorulmaz. Hiçbir zaman ücretsiz olmaması için boş bırakın.

Koşullar

Minimum weight: sepet ağırlığı bu değerin altındaysa taşıyıcıyı gizler (kg cinsinden). 0 sınır olmadığı anlamına gelir. Maximum weight değerinden büyük olamaz.

Maximum weight: sepet ağırlığı bu değerin üstündeyse taşıyıcıyı gizler (kg cinsinden). Varsayılan: 70 (alan boş olduğunda da kullanılır). 0 sınır olmadığı anlamına gelir.

Minimum subtotal: taşıyıcıyı yalnızca sepet ara toplamı (indirimlerden sonra, vergiden önce) bu tutarın en az üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Teslimat bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: taşıyıcıya kendiniz bölge atamadan sunar. Taşıyıcı, daha sonra oluşturacaklarınız dahil tüm bölgeleri alır ve karar aşağıdaki ülkelerle verilir. Kapatmak, taşıyıcıya kendi bölgelerini geri verir.

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız tüm ülkelere izin vermek için boş bırakın. Yalnızca Ignore shipping zones ile kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını modül klasöründeki logs/vfd_dhla_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. DHL hataları bu seçenek kapalı olsa bile her zaman kaydedilir. Kimlik bilgileri ve müşteri adresleri hiçbir zaman kaydedilmez.

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

Remove data on uninstall: açıksa modülü kaldırmak ayarları, taşıyıcıyı, siparişlerin kayıtlı DHL ürünlerini ve günlüğü siler. Kapalıysa yeniden kurulum için her şey saklanır.

Ödeme sırasında nasıl çalışır

Teslimat adımında PrestaShop, modülden DHL Express 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 önce koşulları kontrol eder: Ignore shipping zones ülkeleri, sepet ağırlığı ve minimum ara toplam. Ücretsiz kargo geçerliyse fiyat 0 olur ve DHL'ye istek gönderilmez.

Aksi halde modül DHL'ye çıkış ve varış noktasını (ülke, şehir, posta kodu), kg'a çevrilmiş sepet ağırlığını (en az 0,5 kg) ve ürün ölçülerinden cm cinsinden oluşturulan tek bir kutuyu gönderir: en uzun uzunluk, en geniş genişlik ve üst üste konmuş yükseklikler. Ölçüsü olmayan ürünler bir şey eklemez. Hiçbir ürünün ölçüsü yoksa 10 x 10 x 10 cm'lik bir kutu kullanılır. Başka ülkeye gönderimler, beyan edilen değer olarak sepet ara toplamıyla gümrük için beyan edilir. Yurt içi gönderimler beyan edilmez. Toplama tarihi bugündür, hafta sonları ise pazartesidir. Anlık tarife, müşteri bir şehir girdikten sonra istenir (XML Services ile bir şehir veya posta kodu). Bundan önce yedek fiyatlar uygulanır.

En ucuz DHL Express ürünü, taşıyıcı adınızla tek bir fiyat olarak gösterilir. Müşteri DHL ürününü görmez. Fiyat varsayılan para biriminde hesaplanır, yuvarlanır ve ardından müşterinin sepet para biriminde gösterilir.

Her teklif, paket ve rota başına 1 saat önbelleğe alınır. Başarısız bir istek 10 dakika önbelleğe alınır, böylece ödeme sayfası her yenilemede DHL'yi beklemez. API zaman aşımı 12 saniyedir. DHL bir hata döndürürse, hizmet vermezse veya kullanılamaz bir para biriminde yanıt verirse, müşteri hata görmez: yedek fiyat kullanılır veya taşıyıcı gizlenir. Nedeni hata ayıklama günlüğüne yazılır.

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

Modül yalnızca tarifeleri hesaplar. DHL gönderisi oluşturmaz, etiket veya ticari fatura basmaz, kurye randevusu almaz, kargo takibi yapmaz, DHL servis noktaları sunmaz, müşterinin DHL ürünleri arasında seçim yapmasına izin vermez, birden fazla kutu paketlemez, sigorta eklemez ve gümrük vergilerini ve vergileri hesaplamaz. Teklif yalnızca kargo içindir. Gümrük vergileri ve ithalat vergileri alıcı tarafından ödenir.

Siparişler

Sipariş verildiğinde modül, sepeti için hesaplanan tarifeyi saklar. Yönetim panelindeki sipariş sayfası bu durumda, DHL'de ne rezerve edeceğinizi bilmeniz için bir DHL Express Africa bloğu gösterir:

DHL product: anlık tarifenin DHL Express ürünü, örneğin "EXPRESS WORLDWIDE (P)". Yalnızca anlık tarifeler için gösterilir.

Price source: Live DHL rate, Fallback price (no live rate) veya Free shipping threshold.

Calculated price (excl. tax): mağazanızın varsayılan para birimindeki fiyat.

Sepetin sonraki yeniden hesaplamaları, örneğin sipariş yönetim panelinde düzenlendiğinde, bu değerleri değiştirmez. Hiçbir zaman siparişe dönüşmeyen sepetlerin tarifeleri 30 gün sonra kaldırılır.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox DHL Africa lisans bloğu, Modules > Module Manager > VibeFox DHL Africa > 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-africa 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 Express taşıyıcısı ödeme sırası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 sırası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 veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

DHL Express ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable DHL Express Africa 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üşterinin grubunu kapsadığını kontrol edin (veya Ignore shipping zones seçeneğini açın ve Countries bölümünü kontrol edin). Ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Anlık tarife olmadan taşıyıcı yalnızca bir ülke fiyatı veya yedek ücret ayarlıysa görünür. Ürünler ayrıca ürün sayfasında belirli taşıyıcılarla sınırlandırılmış olabilir.

Anlık tarifeler görünmüyor: modül sayfasının üstündeki uyarıları kontrol edin (eksik kimlik bilgileri veya gönderici). Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. MyDHL API'den gelen HTTP hatası, rota için ürün bulunmaması veya para birimi sorunu gibi DHL hataları her zaman kaydedilir. Test mode seçeneğinin kimlik bilgilerinizle eşleştiğini ve müşteri adresinde bir şehir bulunduğunu kontrol edin.

DHL tarifeyi ZAR, NGN veya KES cinsinden döndürüyor ama mağazam başka bir para birimi kullanıyor: günlükte DHL quote not usable yazar. DHL quote currency değerini bu para birimine ayarlayın ve Exchange rate değerini girin. Bu olmadan anlık tarife kullanılmaz ve yedek fiyatlar uygulanır.

Eski DHL XML Services kimlik bilgilerim var: DHL API altında XML Services (legacy) seçeneğini seçin. MyDHL kimlik bilgilerini aldığınızda MyDHL API'ye geçin.

Kargoda vergi iki kez alınıyor: DHL tarifesinin DHL'nin KDV'si çıkarılarak alınması için Tax altında bir vergi kuralı ayarlayın veya DHL tutarının teklif edildiği gibi tahsil edilmesi için No tax seçin.

Bir değişiklikten sonra tarifeler eski görünüyor: modül sayfasındaki Save düğmesine tıklayın. Bu, önbelleğe alınmış DHL tekliflerini temizler.

Sayfa DHL Express 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.

Geliştiriciler için modül, API adresini, gümrük beyanını, kutuyu ve DHL isteklerini değiştirmek üzere actionVfdDhlaApiUrl, actionVfdDhlaIsDutiable, actionVfdDhlaPackageBox, actionVfdDhlaRestRequest ve actionVfdDhlaXmlRequest kancalarını sağlar.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox DHL Africa yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu ve önbelleğe alınmış DHL teklifleri her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar, siparişlerin kayıtlı DHL ürünleri ve günlük kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve ayarlar ile verilmiş siparişlerin DHL ürünleri korunur. Modülü yeniden kurmak, taşıyıcının daha önceki durumunu geri yükler.

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