VibeFox DHL Africa for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin olmalı. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

DHL Express hesabı (yalnızca anlık tarifeler için): anlık tarifeler MyDHL API'sini kullanır. DHL Express hesap numaranıza ve MyDHL API kimlik bilgilerine ihtiyacınız var: 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 bunun yerine bunları kullanabilir. Yalnızca yedek fiyat kullanıyorsanız DHL kimlik bilgilerine ihtiyacınız yoktur.

VibeFox lisans anahtarı: vibefox.net'ten satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_dhl_africa klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > DHL Express Africa yolunu izleyin veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. DHL API'yi seçin, API anahtarını, API gizli anahtarını ve DHL hesap numaranızı girin. Test kimlik bilgilerini kullanırken Test mode seçeneğini açık tutun. Ship from adresini girin. DHL hesabınız mağaza para biriminizle faturalandırılmıyorsa DHL quote currency ve Exchange rate ayarlarını yapın. İsteğe bağlı olarak ülke fiyatlarını ve yedek ücreti ayarlayın (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde DHL Express Africa yöntemini gönderim bölgelerinize ekleyin veya Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > DHL Express Africa. Tüm gönderim bölgelerinde geçerlidir. Yöntemi bir bölgeye eklediğinizde, bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölge için ödeme sayfasında bu seçeneğin adı. Boş bırakırsanız genel Name kullanılır.

Ayarların üstündeki uyarılar, kimlik bilgileri veya çıkış noktası eksik olduğu için anlık tarifelerin kapalı olduğunu ve kur bilgisi olmadan teklif para birimi ayarlandığını size bildirir. Ayarları her kaydettiğinizde önbellekteki DHL teklifleri temizlenir. Fiyatlarda ve ağırlıklarda ondalık virgül veya nokta kabul edilir.

Genel

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

Name: ödeme sayfasında gösterilen gönderim yöntemi adı. Varsayılan: DHL Express.

Tax status: Taxable (WooCommerce vergileri açıkken) DHL'nin teklifindeki vergi çıkarılmış DHL tarifesini alır ve WooCommerce kendi vergisini ekler. None ise DHL'nin teklif ettiği ücreti, vergi dahil olarak alır.

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

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ı).

XML Site ID: DHL XML Services Site ID'niz (yalnızca eski API).

XML password: DHL XML Services parolanız (yalnızca eski API).

DHL account number: DHL Express hesap numaranız (9 haneli). MyDHL API bunu gerektirir. XML Services ile yayınlanmış tarifeler yerine hesabınıza özel tarifeleri 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.

Gönderim yeri

DHL'nin kolileri topladığı adres. Ücret 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 (örneğin Kenya, Nijerya, Gana) boş bırakın.

Tarifeler

Tüm fiyatlar mağaza para biriminizdedir. Anlık tarife, koli için en ucuz DHL Express ürünüdür. DHL yapılandırılmamışsa, hata verirse veya rota için hizmet yoksa ülke fiyatı, ardından yedek ücret kullanılır. İkisi de yoksa yöntem gizlenir.

DHL quote currency: DHL, DHL hesabınızın ülke para biriminde teklif verir (örneğin ZAR, NGN veya KES). DHL mağaza para biriminizde 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.

Exchange rate: 1 birim DHL teklif para biriminin mağaza para biriminizde ne kadar olduğu, örneğin 1 ZAR = 0.05. Dönüşüm yapılmayacaksa boş bırakın. Kur manuel bir ayardır.

Fallback cost: anlık tarife ve ülke fiyatı yokken uygulanan sabit ücret. Yöntemi gizlemek için boş bırakın.

Country prices: hedef ülke başına yedek fiyat, her satırda bir tane: CC:Fiyat, örneğin ZA:25.00. Anlık tarife olmadığında kullanılır.

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

Free shipping from: bu yöntemin ücretsiz olduğu sepet ara toplamı. DHL'ye sorulmaz. Hiçbir zaman ücretsiz olmaması için boş bırakın.

Koşullar

Minimum weight (kg): sepet ağırlığı bunun altındaysa yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet ağırlığı bunun üstündeyse yöntemi gizler. Varsayılan: 70. 0 sınır olmadığı anlamına gelir.

Minimum subtotal: yöntem yalnızca sepet ara toplamı en az bu tutarsa gösterilir. Her zaman göstermek için boş bırakın.

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

Gönderim bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: eşleşen gönderim bölgesi bu yöntemi içermese bile yöntemi aşağıdaki ülkeler için sunar.

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

Gelişmiş

Debug log: tarife hesaplamalarını WooCommerce > Status > Logs bölümünde, kaynak vfd-dhl-africa olarak kaydeder. DHL hataları bu seçenek kapalı olsa bile her zaman kaydedilir. Kimlik bilgileri ve müşteri adresleri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak hiçbir veriyi silmez.

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

Müşteri teslimat adresini girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti önce sepet ağırlığını, minimum ara toplamı ve hariç tutulan gönderim sınıflarını kontrol eder. Ücretsiz kargo geçerliyse müşteri ücretsiz teslimat alır ve DHL'ye istek gönderilmez.

Aksi halde eklenti DHL'ye çıkış ve varış noktasını (ülke, şehir, posta kodu), sepet ağırlığını kg'a çevrilmiş olarak (en az 0,5 kg) ve ürün ölçülerinden cm cinsinden oluşturulmuş 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ünde ölçü yoksa 10 x 10 x 10 cm'lik bir kutu kullanılır. Uluslararası gönderiler, sepet ara toplamı beyan edilen değer olacak şekilde mal olarak beyan edilir; böylece DHL koli ürünleri için teklif verir. Yurt içi gönderiler beyan edilmez. Anlık tarife ancak müşteri bir şehir girdikten sonra istenir (XML Services ile bir şehir veya posta kodu).

En ucuz DHL Express ürünü, sizin başlığınızla tek bir tarife olarak gösterilir. Müşteri DHL ürününü veya teslimat süresini görmez. Ürün adı (örneğin "EXPRESS WORLDWIDE (P)") siparişin kargo satırına DHL product olarak kaydedilir; böylece gönderiyi hangi ürünle oluşturacağınızı bilirsiniz.

Her teklif, koli 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 hata verirse veya hizmet yoksa müşteri hata görmez: yedek fiyat kullanılır veya yöntem gizlenir.

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

Eklenti yalnızca tarife 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 veya 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.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Shipping > DHL Express Africa sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm 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 düğmesini 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 alan adı hakkını serbest bırakmaz. Bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan DHL Express ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de görür; ancak (unlicensed — visible to admins only) etiketiyle işaretlenir. Böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

DHL Express ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve yöntemin müşterinin ülkesinin bölgesine eklendiğini kontrol edin (veya Ignore shipping zones açık olmalı ve ülkeye izin verilmiş olmalı). Ağırlık sınırlarını, Minimum subtotal ve Excluded shipping classes ayarlarını kontrol edin. Anlık tarife olmadan yöntem yalnızca bir ülke fiyatı veya yedek ücret ayarlıysa görünür.

Anlık tarifeler görünmüyor: ayarlar sayfasının üstündeki uyarıları kontrol edin (eksik kimlik bilgisi veya çıkış noktası). Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümünde vfd-dhl-africa kaynağını açın. Hatalı kimlik bilgileri, rota için hizmet olmaması veya para birimi sorunu gibi DHL hataları her zaman kaydedilir. Test mode ayarının kimlik bilgilerinizle eşleştiğini kontrol edin.

DHL tarifeyi ZAR, NGN veya KES olarak döndürüyor ama mağazam başka bir para birimi kullanıyor: DHL quote currency alanını 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 içinden XML Services (legacy) seçin. MyDHL kimlik bilgilerinizi aldığınızda MyDHL API'ye geçin.

Kargo ücretinden iki kez vergi alınıyor: Tax status alanını, DHL tarifesinin DHL KDV'si olmadan alınması için Taxable, ya da DHL tutarını teklif edildiği gibi almak için None olarak ayarlayın.

Bir değişiklikten sonra tarifeler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış DHL tekliflerini temizler.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir hak 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 ayarları korur. Yalnızca önbelleğe alınmış DHL tekliflerini temizler. Eklentiyi kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır; önbelleğe alınmış teklifler de öyle. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki yeniden kurulum için kalırlar. Siparişler hiçbir zaman değiştirilmez ve mevcut siparişler kargo satırlarını korur.

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