VibeFox Delhivery for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Delhivery API belirteci (yalnızca canlı tarifeler 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. Her iki bağlantı da eklenti sayfasındadır. Test belirteçleri staging ortamıyla çalışır. Ayrıca çıkış yaptığınız konumun 6 haneli pincode'una ihtiyacınız vardır. Yalnızca sabit fiyatları kullanıyorsanız belirteç gerekmez.

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

Kurulum

Bu, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi vfd_delhivery-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_delhivery.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze ait paketi kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_delhivery-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Installer yerine, bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve eklenti türü olarak Shipping seçin. VibeFox Delhivery'yi bulun ve Install düğmesine tıklayın (yeşil + düğmesi).

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgeli düğme) tıklayın.

4. VibeFox lisans anahtarınızı, Edit sayfasının üstündeki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

5. API belirtecini ve çıkış pincode'unuzu girin, Express veya Surface ile Pre-paid veya COD seçeneklerini seçin. Mağaza varsayılan para biriminiz INR değilse dönüşüm oranını girin. İsteğe bağlı olarak sabit fiyatları girin (bkz. Yapılandırma). Enable Delhivery seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_delhivery.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

2. Paket, aynı sayfada yüklü eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve eklenti türü olarak Shipping seçin. VibeFox Delhivery'yi bulun, Install düğmesine (yeşil + düğmesi) tıklayın, ardından Edit düğmesine (kalem simgeli düğme) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4. ve 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları her iki sürümde de aynıdır.

Kurulumdan sonra, Enable Delhivery seçeneğini açıp kaydedene kadar yöntem kapalıdır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız Delhivery ayarları tekrar kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Delhivery > Edit. Bölümler solda listelenir. Tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt, önbelleğe alınmış Delhivery tarifelerini de temizler. Tutarlar "9.99" ve "9,99" kabul eder. Bir değer yanlışsa hiçbir şey kaydedilmez ve sayfa nedenini gösterir; örneğin Enter a valid method title (without < > ; = # { })., bir alanın negatif olmayan bir sayı olması gerektiğini bildiren bir mesaj veya Sort order must be a whole number. Ayarları yalnızca bu eklenti için değiştirme yetkisine sahip yönetici kullanıcılar kaydedebilir.

Mağaza varsayılan para biriminiz INR değilse, bir API belirteci kaydedilmişse ve dönüşüm oranı ayarlanmamışsa, sayfanın üst kısmındaki bir uyarı, oranı girene kadar canlı tarifelerin kullanılmadığını hatırlatır. Mağazada kilogram ağırlık sınıfı yoksa ve ağırlık birimi standart bir birim değilse (kg, g, lb veya oz), bir uyarı ürün ağırlıklarının kilogram olarak okunduğunu belirtir. System > Localisation > Weight Classes bölümünde standart bir birim ayarlayın.

Genel

Ayarlar her coğrafi bölge için geçerlidir. Yöntemi Availability bölümünde sınırlayabilirsiniz.

Enable Delhivery: ödeme sırasında Delhivery'yi sunar. Varsayılan: kapalı.

Method title: sepette ve ödeme sırasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: Delhivery. Zorunlu, en fazla 64 karakter; < > ; = # { } karakterleri olmadan.

Tax class: kargo ücretinin vergi sınıfı veya No tax (varsayılan). Bir sınıf seçildiğinde OpenCart, kargo ücretinin üzerine vergi ekler.

Sort order: ödeme sırasında Delhivery'nin kargo yöntemleri arasındaki konumu. Tam sayı.

Delhivery API hesabı (yalnızca canlı tarifeler için gereklidir)

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

API token: Delhivery API belirteciniz. Yalnızca yetkilendirme başlığında gönderilir ve günlüklere asla yazılmaz. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek için yeni bir değer girin.

Remove saved token: kayıtlı belirteci silmek için açın ve kaydedin. Bundan sonra yalnızca sabit fiyatlar kullanılır.

Origin pincode: çıkış yaptığınız konumun veya deponuzun 6 haneli pincode'u, örneğin 110001. 6 haneli değilse, ayarlar The origin pincode must have 6 digits — live rates are not requested until it is fixed. uyarısıyla kaydedilir.

Canlı tarifeler

Canlı tarife, geçerli 6 haneli pincode'a sahip Hindistan varış noktaları için, bir gidiş (teslim edilen) gönderi için istenir.

Shipping mode: tarife için kullanılan Delhivery faturalandırma modu: Express (varsayılan) veya Surface.

Payment type: Delhivery'ye gönderilen ödeme türü: Pre-paid (varsayılan) veya COD (cash on delivery — Delhivery adds its COD charge). 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: etiket, mağazanızın varsayılan para birimini gösterir. Delhivery tarifeleri Hint rupisi cinsindendir. Varsayılan para biriminiz INR değilse, bir rupinin paranızdan kaç birime eşit olduğunu girin, örneğin 0.011. Oran 0'dan büyük olmalıdır. Boş bırakırsanız canlı tarifeler kullanılmaz ve sabit fiyatlar uygulanır. Varsayılan para biriminiz INR ise gerekli değildir.

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

Sabit fiyatlar, henüz belirteç veya pincode yoksa, varış noktası Hindistan dışındaysa, pincode'a hizmet verilmiyorsa veya API bir hata döndürürse kullanılır. Mağazanızın varsayılan para biriminde ve vergi hariç olarak girilirler.

Prices per country: her satırda bir tane, KOD_ÜLKE:fiyat biçiminde, örneğin IN:120. Yedek fiyattan önce kontrol edilir. Başka biçimdeki satırlar kaydedilirken silinir ve bir uyarı bunları listeler.

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

Fixed price is charged: Per order (varsayılan) fiyatı bir kez alır. Per item (price × quantity) ise sepetteki ürün sayısıyla çarpar. Delhivery canlı tarifesi her zaman tüm paketin ağırlığı içindir.

Koşullar

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupondan sonra, vergi öncesi) bu tutardan az değilse teslimat ücretsizdir. Delhivery'ye istek gönderilmez. Kapatmak için boş bırakın.

Show from subtotal: yöntemi yalnızca bu ara toplam bu tutardan az değilse gösterir. 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 (varsayılan).

Max weight (kg): sepet daha ağırsa yöntemi gizler. Varsayılan: 30. 0, sınır olmadığı anlamına gelir; boş alan 30 kg anlamına gelir. Min weight değeri Max weight değerinden büyük olamaz: sayfa bir hata gösterir ve hiçbir şey kaydedilmez.

Ürün ağırlıkları, OpenCart ağırlık sınıflarından kg'a çevrilir. Tarife, gerçek sepet ağırlığını (ürün ağırlıklarının toplamı) kullanır; hacimsel ağırlık veya kutular dahil değildir.

Kullanılabilirlik

Geo zone: Delhivery'yi yalnızca bu coğrafi bölgedeki adresler için sunar. All zones (varsayılan) sınır olmadığı anlamına gelir. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde yönetilir. Ignore zones açıkken kontrol edilmez.

Ignore zones: açıkken coğrafi bölge kontrol edilmez ve yöntem aşağıdaki ülkeler için sunulur (liste boşsa tüm ülkeler için).

Countries: bu mod için hedef ülkeler. Yalnızca Ignore zones açıkken kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını storage/logs/vfd_dlv_debug.log.php dosyasına yazar (OpenCart 4'te system/storage/logs/vfd_dlv_debug.log.php). Dosya web üzerinden okunamaz. Bu kapalı olsa bile API hataları her zaman kaydedilir. Belirteçler ve müşterilerin tam pincode'ları asla günlüğe yazılmaz. Dosya 5 MB'a ulaştığında vfd_dlv_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log: günlüğü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 eklentiyi kaldırmak Delhivery ayarlarını, önbelleğe alınmış tarifeleri ve günlüğü siler. Kapalıyken (varsayılan), yeniden kurulum için saklanırlar. Sipariş verileri (mod, fiyat kaynağı, AWB numaraları) asla silinmez.

İçe / Dışa Aktarma

Export: ayarları bir JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. API belirteci dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın; örneğin başka bir mağazada. Değerler normal bir kayıtta olduğu gibi denetlenir. Kaydedilmiş API belirteci değiştirilmez.

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

OpenCart kargo yöntemlerini gösterdiğinde, eklentiden Delhivery fiyatını ister. Bir Geo zone ayarlıysa (ve Ignore zones kapalıysa) ve adres bunun dışındaysa, Delhivery sunulmaz. Yalnızca Requires Shipping değeri Yes olan ürünler sayılır: diğerleri ağırlık eklemez ve ara toplama dahil edilmez. Ardından eklenti ülkeleri (Ignore zones açıksa), sepet ağırlığını ve Show from subtotal değerini denetler. Ara toplam, kupon indiriminden sonra ve vergi öncesi, kargo gerektiren ürünlerin fiyatıdır. Hediye çekleri, puan ödülleri ve mağaza kredisi dikkate alınmaz. Ücretsiz kargo geçerliyse fiyat 0 olur ve Delhivery'ye istek gönderilmez.

Geçerli 6 haneli pincode'a sahip (adresin posta kodu) bir Hindistan adresi için eklenti, Delhivery'ye çıkış ve varış pincode'larını, sepet ağırlığını gram cinsinden, kargo modunu ve ödeme türünü gönderir. Dönen tutar INR'den mağaza varsayılan para birimine çevrilir, ondalık basamaklarına yuvarlanır ve seçilen Tax class vergisiyle birlikte müşteriye kendi para biriminde gösterilir. Her yanıt 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 Delhivery'yi beklemez. API zaman aşımı 10 saniyedir.

Canlı tarife yoksa, ülke fiyatı veya yedek fiyat kullanılır. İkisi de ayarlı değilse yöntem gizlenir. Müşteri asla bir API hatası görmez. Neden günlüğe yazılır.

Eklenti tarifeleri hesaplar ve müşterilere bir takip bağlantısı verir. Gönderi veya taşıma senedi oluşturmaz, etiket basmaz, kurye veya manifesto talebinde bulunmaz, pincode hizmet kapsamını kontrol etmez, teslimat tarihlerini tahmin etmez, takip durumlarını senkronize etmez ve uluslararası Delhivery tarifelerini hesaplamaz. Hindistan dışında yalnızca sabit fiyatlar kullanılır.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde Delhivery'yi seçer. Yöntem, OpenCart 3'tekiyle aynı şekilde çalışır.

Siparişler ve takip

Delhivery ile bir sipariş verildiğinde eklenti, kargo modunu ve fiyat kaynağını siparişle birlikte saklar. Sales > Orders bölümünde siparişi açın: sipariş geçmişinin üstündeki Delhivery paneli Mode: (Express veya Surface), Price: (Delhivery canlı tarifesi, sabit fiyat veya ücretsiz kargo eşiği) ve Delhivery AWB / tracking number değerini ya da Not entered yet. ifadesini gösterir.

OpenCart 4'te ödeme süreci tek bir sipariş tutar ve müşteri her onayladığında bu siparişi günceller. Yöntem ve fiyat kaynağı onunla birlikte güncellenir. AWB girilmeden önce müşteri başka bir kargo yöntemine geçerse, bu sipariş için Delhivery paneli artık gösterilmez.

Gönderiyi Delhivery One'da oluşturun, ardından AWB numarasını panele girin ve Save düğmesine tıklayın. Sayfa yeniden yüklenmez. Harfler, rakamlar ve kısa çizgiler korunur (en fazla 64 karakter). AWB'yi kaldırmak için alanı boş kaydedin. Bir AWB olduğunda panel bir Track on delhivery.com bağlantısı gösterir. AWB kaydetmek, siparişleri değiştirme yetkisi gerektirir. Bu yetki olmadan panel salt okunur olur.

Kayıtlı bir müşteri, hesabındaki sipariş sayfasında AWB'nin Delhivery takip sayfasına bağlantısı olarak Delhivery tracking: satırını görür. Sipariş geçmişine bir kayıt eklediğinizde ve müşteriye bildirim gönderdiğinizde, sipariş durumu e-postası aynı bağlantılı satırı alır. Yeni sipariş e-postasında takip bağlantısı yoktur, çünkü AWB daha sonra girilir. Eklenti kapalıyken de paneldeki ve takip bağlantısındaki bilgiler eski siparişler için çalışır.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Eklentinin Extensions > Extensions > Shipping > VibeFox Delhivery > Edit sayfasının en üstünde, ayarların üstünde yer alan ilk blok License — VibeFox Delhivery lisans bloğudur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarihi ve alan adınızı), Check now düğmesini (durumu yeniden kontrol etmek için), Change key düğmesini (başka bir anahtar girmek için) ve Remove key düğmesini (anahtarı bu mağazadan kaldırmak için) gösterir. Bunların altında Product: opencart-shipping-delhivery 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 bu eklenti için Modify yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloktaki metinler yönetici 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 License expired on ve bir tarih. 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 eklenti, son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak, alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Delhivery kargo yöntemi ödeme sırasında müşterilere gösterilmez ve tarife hesaplanmaz. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi mağazada (unlicensed — visible to admins only) işaretiyle yine görür; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin anahtar olmadan yöntem herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim panelinin Dashboard sayfasında bir hatırlatma belirir. Onu × ile kapatın; 7 gün gizlenir. Mevcut siparişler etkilenmez.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim panelinin Dashboard sayfasını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak, lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Delhivery ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Delhivery seçeneğinin açık olduğunu kontrol edin. Geo zone seçeneğini veya Ignore zones ve Countries seçeneklerini, ağırlık sınırlarını ve Show from subtotal seçeneğini denetleyin. Canlı tarife yoksa bir ülke fiyatı veya Fallback price gerekir. Ürünlerde Requires Shipping değerinin Yes olduğunu kontrol edin.

Canlı tarifeler görünmüyor: API belirtecini, geçerli bir Origin pincode değerini ve mağaza varsayılan para biriminiz INR değilse dönüşüm oranını kontrol edin. Müşteri, posta kodu olarak geçerli 6 haneli bir Hint pincode'u girmelidir. Debug log seçeneğini açın, ödeme sayfasını yenileyin ve eklenti sayfasındaki Log alanına bakın. Burada nedeni görürsünüz; örneğin hizmet verilmeyen bir pincode veya Delhivery'den bir HTTP hatası.

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

Test: Environment değerini Staging olarak ayarlayın ve bir Delhivery test belirteci kullanın.

Bir değişiklikten sonra tarifeler eski görünüyor: eklenti sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış Delhivery tarifelerini temizler.

AWB kaydedilemiyor: You do not have permission to modify orders. iletisi, yönetici kullanıcı grubunuzun System > Users > User Groups bölümünde sale/order için değiştirme yetkisine ihtiyacı olduğu anlamına gelir.

Sayfa "Warning: You do not have permission to modify VibeFox Delhivery!" diyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebiliyor olabilir. Gruba System > Users > User Groups bölümünde extension/shipping/vfd_delhivery (OpenCart 3) veya extension/vfd_delhivery/shipping/vfd_delhivery (OpenCart 4) için değiştirme yetkisi verin.

Geliştiriciler için: eklenti, API adresini ve zaman aşımını değiştirebilen catalog/vfd_delhivery/api_url ve catalog/vfd_delhivery/api_timeout OpenCart olaylarını tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox Delhivery'nin yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable Delhivery, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Önbelleğe alınmış tarifeler ve eklentinin olayları her zaman kaldırılır. Remove data on uninstall açıksa, Delhivery ayarları ve hata ayıklama günlüğü de silinir. Kapalıysa, diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Siparişlerdeki Delhivery verileri (mod, fiyat kaynağı ve AWB numaraları) asla silinmez. Mevcut siparişler kargo yöntemini ve maliyetini korur.

OpenCart 4'te, eklentinin dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, yüklü eklentiler listesinde VibeFox Delhivery'nin yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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