VibeFox Delhivery for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

Delhivery API token'ı (yalnızca canlı ücretler için): Delhivery One'a giriş yapın ve Settings > API setup bölümünü açın. Delhivery yardım makalesi «API token generation» adımları açıklar. Test token'ları staging ortamıyla çalışır. Ayrıca çıkış noktanızın 6 haneli PIN kodu gerekir. Yalnızca sabit fiyat kullanıyorsanız token gerekmez.

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 bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_delhivery 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 Delhivery, veya 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. API token'ını ve çıkış PIN kodunuzu girin, Express veya Surface ile Pre-paid veya COD seçeneğini belirleyin. Mağaza para biriminiz INR değilse dönüşüm oranını girin. İsteğe bağlı olarak sabit fiyatları girin (bkz. Yapılandırma).

6. VibeFox Delhivery yöntemini WooCommerce > Settings > Shipping > Shipping zones bölümünde bir kargo bölgesine (örneğin Hindistan) ekleyin veya Ignore zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Shipping > VibeFox Delhivery. Tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölge için müşterilerin gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Ayarları her kaydettiğinizde önbellekteki Delhivery ücretleri temizlenir. Fiyatlar ve tutarlar "9.99" ve "9,99" biçimlerini kabul eder.

Genel

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

Method title: ödeme sayfasında gösterilen kargo yöntemi adı. Varsayılan: Delhivery. Bir bölge bunu kendi Title değeriyle değiştirebilir.

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

Delhivery API hesabı (yalnızca canlı ücretler için gerekli)

Environment: Production (track.delhivery.com) (varsayılan) veya Staging / test account (staging-express.delhivery.com). Staging'i yalnızca Delhivery test token'ıyla kullanın.

API token: Delhivery API token'ınız. Yalnızca yetkilendirme başlığında gönderilir ve hiçbir zaman loglara yazılmaz.

Origin pincode: çıkış noktanızın veya deponuzun 6 haneli PIN kodu, örneğin 110001.

Canlı ücretler

Canlı ücret, geçerli 6 haneli PIN koduna sahip Hindistan adresleri için, ileri (teslim edilen) gönderi için istenir.

Shipping mode: ücret için kullanılan Delhivery faturalama modu: Express (varsayılan) veya Surface.

Payment type: Delhivery'ye gönderilen ödeme türü: Pre-paid (varsayılan) veya COD (kapıda ödeme; Delhivery kendi COD ücretini ekler). Eklenti, müşterinin seçtiği ödeme yöntemine göre bunu değiştirmez.

Rate amount: Delhivery, ücreti GST dahil ve GST hariç olarak döndürür.

INR to (store currency) conversion rate: Delhivery ücretleri Hint rupisi cinsindendir. Mağaza para biriminiz INR değilse, bir rupinin para biriminizden kaç birime denk geldiğini girin, örneğin 0.011. Boş bırakırsanız canlı ücretler kullanılmaz, sabit fiyatlar uygulanır ve ayarların üstünde bir uyarı gösterilir. Mağaza para biriminiz INR ise gerekli değildir.

Sabit fiyatlar (canlı ücret olmadığında kullanılır)

Sabit fiyatlar; henüz token veya PIN kodu yoksa, hedef Hindistan dışındaysa, PIN kodu hizmet verilmiyorsa veya API hata döndürürse kullanılır. Mağaza para biriminizdedir.

Prices per country: her satırda bir tane, COUNTRY_CODE:price biçiminde, örneğin IN:120. Yedek fiyattan önce kontrol edilir.

Fallback price: ne canlı ücret ne de ülke fiyatı uygulanmadığında kullanılır. Yöntemi gizlemek için boş bırakın. 0 ücretsiz anlamına gelir.

Fixed price is charged: Per order fiyatı bir kez alır. Per item (price × quantity) fiyatı sepetteki ürün sayısıyla çarpar. Canlı Delhivery ücreti her zaman paketin toplam ağırlığı içindir.

Koşullar

Free shipping from: sepet ara toplamı bu tutara eşit veya üzerindeyse teslimat ücretsizdir. Delhivery'ye istek gönderilmez. Kapatmak için boş bırakın.

Show from subtotal: yöntem, yalnızca sepet ara toplamı bu tutara eşit veya üzerindeyse gösterilir. Her zaman göstermek için boş bırakın.

Min weight (kg): yöntemin gösterilmesi için gereken minimum sepet ağırlığı. 0 sınır olmadığı anlamına gelir.

Max weight (kg): sepet bundan ağırsa yöntemi gizler. Varsayılan: 30. 0 sınır olmadığı anlamına gelir.

Ürün ağırlıkları, mağazanızın ağırlık biriminden kg'a çevrilir. Ücret, gerçek sepet ağırlığını (ürün ağırlıklarının toplamı) kullanır; hacimsel ağırlık ve kutular dikkate alınmaz.

Excluded shipping classes: sepetteki herhangi bir ürün bu WooCommerce kargo sınıflarından birine aitse yöntemi gizler.

Kargo bölgesi olmadan kullanılabilirlik

Ignore zones: Delhivery'yi bir kargo bölgesine eklemeden, 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 zones açıkken kullanılır.

Gelişmiş

Debug log: ücret hesaplamalarını WooCommerce > Status > Logs bölümüne, vfd_delhivery kaynağıyla kaydeder. API hataları, bu seçenek kapalı olsa bile her zaman kaydedilir. Token'lar ve müşterilerin tam PIN kodları hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek, tüm ayarlarını, bölge yöntemlerini ve önbellekteki ücretleri siler. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez.

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

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

Geçerli 6 haneli PIN koduna sahip bir Hindistan adresi için eklenti, Delhivery'ye çıkış ve varış PIN kodlarını, sepet ağırlığını gram cinsinden, kargo modunu ve ödeme türünü gönderir; dönen tutarı mağaza para biriminize çevirerek gösterir. Her yanıt 1 saat önbellekte tutulur. Başarısız bir istek 10 dakika önbelleğe alınır; böylece ödeme sayfası her yenilemede Delhivery'yi beklemez. API zaman aşımı 10 saniyedir.

Canlı ücret yoksa ülke fiyatı veya yedek fiyat kullanılır. İkisi de ayarlanmamışsa yöntem gizlenir. Müşteri hiçbir zaman bir API hatası görmez.

Yöntem, klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. WooCommerce Yüksek Performanslı Sipariş Depolama (HPOS) ile uyumludur.

Eklenti ücretleri hesaplar ve bir takip bağlantısı gösterir. Gönderi veya kargo belgesi oluşturmaz, etiket yazdırmaz, kurye veya manifesto talebi oluşturmaz, PIN kodu hizmet kapsamını denetlemez, teslimat tarihleri tahmin etmez, takip durumlarını senkronize etmez ve Delhivery'nin uluslararası ücretlerini hesaplamaz. Hindistan dışında yalnızca sabit fiyatlar kullanılır.

Siparişler ve takip

Sipariş ekranında, teslimat adresinin altında, Delhivery bloğu kargo modunu (Express veya Surface) ve fiyat kaynağını gösterir: canlı Delhivery ücreti, sabit fiyat veya ücretsiz kargo eşiği.

Gönderiyi Delhivery One'da oluşturun, ardından AWB numarasını Delhivery AWB / tracking number alanına yapıştırın ve siparişi kaydedin. Yönetim panelinde Track on delhivery.com bağlantısı belirir. Müşteri, Hesabım bölümünde ve sipariş e-postalarında (HTML ve düz metin) sipariş sayfasındaki Delhivery tracking bağlantısını görür. AWB, sipariş durumundan önce kaydedilir; bu nedenle aynı kayıtta siparişi tamamlarsanız "Tamamlanan sipariş" e-postası AWB'yi zaten içerir.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Delhivery 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, 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ın bir siteden kaldırılması, alan adı hakkını serbest bırakmaz. Bunu vibefox.net hesabınızdan yapın.

Etkin bir anahtar olmadan Delhivery, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de (unlicensed — visible to admins only) ibaresiyle görür; böylece bir 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

Delhivery ö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 (ya da Ignore zones açık olmalı ve ülke izinli olmalıdır). Ağırlık sınırlarını, Show from subtotal ve Excluded shipping classes ayarlarını inceleyin. Canlı ücret yoksa bir ülke fiyatı veya Fallback price gerekir.

Canlı ücretler görünmüyor: API token'ını, geçerli bir Origin pincode değerini ve INR dışı bir mağazada dönüşüm oranını kontrol edin. Müşteri geçerli 6 haneli bir Hint PIN kodu girmelidir. Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümünde vfd_delhivery kaynağına bakarak API hatalarını görün; örneğin hizmet verilmeyen bir PIN kodu.

GST iki kez alınıyor: Delhivery'nin toplam tutarı zaten GST içerir. Rate amount değerini Gross amount (excluding GST) olarak ayarlayın veya Tax status değerini None yapın.

Test: Environment olarak Staging seçin ve bir Delhivery test token'ı kullanın.

Bir değişiklikten sonra ücretler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki Delhivery ücretlerini temizler.

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 hak serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, yeni alan adı için anahtarı etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri ve önbellekteki ücretler yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde, daha sonra yeniden kurulmak üzere saklanır. AWB numaraları siparişlerde kalır ve mevcut siparişler kargo satırlarını korur.

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