VibeFox Delhivery for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

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. Her iki bağlantı da modül sayfasındadır. Test token'ları staging ortamıyla çalışır. Ayrıca alım noktanızın 6 haneli PIN kodunu da bilmeniz gerekir. Yalnızca sabit fiyatları kullanıyorsanız token'a ihtiyacınız yoktur.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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 Delhivery öğesini bulup Configure düğmesine tıklayın.

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

4. API token'ınızı ve çıkış PIN kodunuzu girin, Express veya Surface ile Pre-paid veya COD seçeneğini belirleyin. Mağazanızın varsayılan para birimi INR değilse dönüşüm oranını girin. İsterseniz sabit fiyatları girin (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, Courier delivery (India) teslimat süresi metniyle Delhivery kargo firmasını ve takip URL'si olarak Delhivery takip sayfasını oluşturur. Kargo firması 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. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Delhivery > Configure. Tüm bölgeler 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 ayrıca önbellekteki Delhivery ücretlerini temizler. Tutarlar "9.99" ve "9,99" biçimlerini kabul eder. Bir sayısal alan negatif olmayan bir sayı içermiyorsa bir hata gösterilir ve hiçbir şey kaydedilmez.

Mağazanızın varsayılan para birimi INR değilse, bir API token'ı kayıtlıysa ve dönüşüm oranı girilmemişse, formun üstündeki bir uyarı, dönüşüm oranını girene kadar canlı ücretlerin kullanılmadığını hatırlatır. Mağazanızın ağırlık birimi standart bir birim değilse (kg, g, lb veya oz), bir uyarı bunu International > Localization (Local units) bölümünde ayarlamanızı ister; aksi halde ürün ağırlıkları kilogram olarak okunur.

Genel

Enable Delhivery: kargo firmasını açar veya kapatır. Bu, Shipping > Carriers bölümündeki kargo firması durumuyla aynı anahtardır.

Method title: sepette ve ödeme sayfasında gösterilen kargo firması adı. Varsayılan: Delhivery. Zorunlu, en fazla 64 karakter.

Tax: kargo firmasının vergi kuralı veya No tax. Bir kural varsa PrestaShop, kargo ücretinin üzerine vergi ekler.

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

Environment: Production (track.delhivery.com) (varsayılan) veya Staging / test account (staging-express.delhivery.com). Staging'i yalnızca bir 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 günlüklere yazılmaz. 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.

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

Origin pincode: alım noktanızın veya deponuzun 6 haneli PIN kodu, örneğin 110001. 6 haneli değilse bir uyarı gösterilir ve düzeltilene kadar canlı ücret istenmez.

Canlı ücretler

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

Shipping mode: ücret 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). Modül, müşterinin seçtiği ödeme yöntemine göre bunu değiştirmez.

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

INR to (shop currency) conversion rate: etiket, mağazanızın varsayılan para birimini gösterir. Delhivery ücretleri Hint rupisi cinsindendir. Varsayılan para biriminiz INR değilse, bir rupinin kaç birim sizin paranıza karşılık geldiğini girin, örneğin 0.011. Oran 0'dan büyük olmalıdır. Boş bırakırsanız canlı ücretler kullanılmaz ve sabit fiyatlar uygulanır. Varsayılan para biriminiz INR ise gerekli değildir.

Sabit fiyatlar (canlı ücret yokken kullanılır)

Sabit fiyatlar, henüz bir token veya PIN kodu yokken, hedef Hindistan dışındayken, PIN kodu hizmet verilmeyen bir bölgedeyken veya API bir hata döndürdüğünde kullanılır. Mağazanızın varsayılan para biriminde, vergi hariç olarak belirtilir.

Prices per country: her satıra bir tane, COUNTRY_CODE:price biçiminde, örneğin IN:120. Yedek fiyattan önce kontrol edilir. Farklı biçimdeki satırlar kaydedilirken atılır ve bir uyarı bunları listeler.

Fallback price: ne canlı ücret ne de ülke fiyatı uygulanabildiğinde kullanılır. Kargo firmasını 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) ise fiyatı sepetteki ürün sayısıyla çarpar. Delhivery canlı ücreti her zaman paketin toplam ağırlığı içindir.

Koşullar

Free shipping from: sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergilerden önce) bu tutara ulaşıyorsa teslimat ücretsizdir. Delhivery'ye istek gönderilmez. Kapatmak için boş bırakın.

Show from subtotal: kargo firmasını yalnızca sepet ara toplamı bu tutara ulaşıyorsa gösterir. Her zaman göstermek için boş bırakın.

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

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

Ü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 hesaba katılmaz.

Kargo bölgesi olmadan kullanılabilirlik

Ignore zones: kapalıyken ülkeler, Shipping > Carriers bölümündeki kargo firmasının bölgeleriyle belirlenir. Açıkken kargo firması tüm bölgelere bağlanır (daha sonra oluşturacağınız bölgeler dahil) ve aşağıdaki ülkeler için sunulur. Kapatmak, kargo firmasının önceki bölgelerini geri verir.

Countries: bu mod için hedef ülkeler, etkin ülkelerinizden seçilir. 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ı modül klasöründeki logs/vfd_dlv_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. Token'lar ve müşterilerin tam PIN kodları hiçbir zaman kaydedilmez.

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

Remove data on uninstall: açıkken modülü kaldırmak Delhivery ayarlarını, kargo firmasını, önbellekteki ücretleri, sipariş verilerini ve günlükleri siler. Kapalıyken yeniden kurulum için her şey saklanır. Siparişlerin AWB numaraları hiçbir zaman silinmez.

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

Kargo adımında PrestaShop, modülden Delhivery 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 ülkeleri (Ignore zones açıkken), sepet ağırlığını ve Show from subtotal değerini kontrol eder. Ücretsiz kargo uygulanıyorsa fiyat 0 olur ve Delhivery'ye istek gönderilmez.

Geçerli 6 haneli PIN koduna sahip bir Hindistan adresi için modül, Delhivery'ye çıkış ve varış PIN kodlarını, sepet ağırlığını gram cinsinden, gönderim modunu ve ödeme türünü gönderir. Dönen tutar INR'den mağazanızın varsayılan para birimine çevrilir ve ardından müşterinin sepet para biriminde gösterilir. Her yanıt 1 saat önbellekte tutulur. Başarısız bir istek 10 dakika önbellekte tutulur, 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 kargo firması gizlenir. Müşteri hiçbir zaman bir API hatası görmez. Neden günlüğe yazılır.

Shipping > Carriers bölümünde kargo firmasını siparişleri olduktan sonra düzenlerseniz PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül ücretleri hesaplar ve müşterilere bir takip bağlantısı sağlar. Gönderi veya kargo belgesi oluşturmaz, etiket yazdırmaz, kurye veya manifesto talebi oluşturmaz, PIN kodu hizmet kapsamını kontrol etmez, teslim tarihlerini 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

Bir sipariş Delhivery ile verildiğinde modül, gönderim modunu ve fiyat kaynağını siparişle birlikte kaydeder. Yönetici sipariş sayfasında Delhivery bloğu Mode: (Express veya Surface), Price: (Delhivery canlı ücreti, sabit fiyat veya ücretsiz kargo eşiği) ve Delhivery AWB / tracking number bilgisini ya da Not entered yet. ifadesini gösterir.

Gönderiyi Delhivery One'da oluşturun, ardından AWB numarasını sipariş sayfasındaki Carriers bloğunda (Edit) siparişin takip numarası olarak girin. Delhivery bloğu bunun ardından bir Track on delhivery.com bağlantısı gösterir. Müşteri sipariş geçmişinde bir takip bağlantısı görür ve PrestaShop'tan "Yolda" durumlu e-postayı alır.

Lisans anahtarı

Modül, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Delhivery lisans bloğu, Modules > Module Manager > VibeFox Delhivery > 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ı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-delhivery satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri 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 ya da 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 tek 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ızda serbest bırakın.

Etkin bir anahtar yoksa Delhivery kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu yüzden kargo firması sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfası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 yenileme gerektirir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca 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

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. Shipping > Carriers bölümünde kargo firmasının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin ya da Ignore zones seçeneğini açıp Countries değerini kontrol edin. Ağırlık sınırlarını ve Show from subtotal değerini kontrol edin. Canlı ücret yoksa bir ülke fiyatı veya bir Fallback price gerekir. Ürünler, ürün sayfasında belirli kargo firmalarıyla da sınırlandırılabilir.

Canlı ücretler görünmüyor: API token'ını, geçerli bir Origin pincode değerini ve varsayılan para biriminiz INR değilse 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, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Nedeni gösterir; örneğin hizmet verilmeyen bir PIN kodu 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 ayarlayın veya Tax değerini No tax olarak ayarlayın.

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

Bir değişiklikten sonra ücretler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbellekteki Delhivery ücretlerini temizler.

Sayfa Delhivery kargo firmasının bulunamadığını söylüyor: kargo firması Shipping > Carriers bölümünde silinmiştir. 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 ve zaman aşımını değiştirebilen actionVfdDlvApiUrl ve actionVfdDlvApiTimeout hook'larını çalıştırır.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Delhivery yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı, lisans durumu ve önbellekteki ücretler her zaman kaldırılır. Remove data on uninstall açıksa kargo firması önceki bölgelerini geri alır ve silinir (siparişler geçmişlerini korur); ayarlar, günlük ve siparişlerin Delhivery verileri (mod ve fiyat kaynağı) kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak, kargo firmasını önceki durumuyla geri yükler. AWB numaraları siparişlerde kalır.

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