VibeFox Ninja Van for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Ninja Van tarifesi: Ninja Van gönderici hesabınızın veya Ninja Van satış ekibinin fiyatları, fiyat tablosuna girilir. API anahtarı gerekmez. Endonezya içindeki isteğe bağlı canlı fiyatlar, herkese açık ve kimlik doğrulaması gerektirmeyen Ninja Van Tariff API'sini kullanır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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 bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Ninja Van öğesini bulup Configure düğmesine tıklayın.

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

4. Ninja Van fiyatlarınızı fiyat tablosuna girin. Endonezya için isteğe bağlı olarak Live rates seçeneğini açabilirsiniz (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, Courier delivery teslimat süresi metniyle Ninja Van taşıyıcısını oluşturur. Taşıyıcı açıktır, tüm bölgelere ve tüm müşteri gruplarına atanır ve vergi kuralı yoktur. 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 ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Ninja Van > Configure. Ayarlar taşıyıcının tüm bölgeleri için geçerlidir. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Bir sayısal alan metin ya da negatif bir sayı içerdiğinde, IDR conversion rate 0 olduğunda, Minimum weight (kg) değeri Maximum weight (kg) değerinden büyük olduğunda veya Method title 64 karakterden uzun olduğunda hiçbir şey kaydedilmez ve bir hata gösterilir. Mağazanızın ağırlık birimi modülün bildiklerinden biri değilse, kaydettikten sonra ürün ağırlıklarının kilogram olarak alındığını belirten bir uyarı görünür.

Genel

Enable Ninja Van: taşıyıcıyı açar veya kapatır. Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır.

Method title: sepette ve ödeme sayfasında müşteriye gösterilen taşıyıcı adı. Varsayılan: Ninja Van. Zorunlu, en fazla 64 karakter.

Tax: taşıyıcının vergi kuralı veya No tax (varsayılan). Tablodaki fiyatlar vergileri (GST, SST, VAT) zaten içeriyorsa No tax seçin.

Fiyatlar (mağazanızın varsayılan para biriminde, vergi hariç)

Ninja Van tarifenizin fiyatlarını mağazanızın varsayılan para biriminde girin. Tarifeniz SGD, MYR, IDR veya başka bir para birimindeyse önce çevirin. Bu tablo, Endonezya dışındaki tüm hedefler için ve canlı fiyat kullanılamadığında kullanılır.

Price table: her hedef ülke için bir satır. Satır eklemek için Add country düğmesine, satır silmek için çöp kutusu simgesine tıklayın. Kendi satırı olmayan tüm ülkeler için * All other countries seçin. Her satırda bir Base price ve ağırlık sütunları vardır: 1 kg'a kadar XS, 2 kg'a kadar S, 3 kg'a kadar M, 5 kg'a kadar L ve 5 kg üzeri XL. Boş (veya 0) bir ağırlık sütunu temel fiyatı kullanır. Temel fiyat 0, o ülkeye ücretsiz kargo anlamına gelir. Hem «9.99» hem de «9,99» kabul edilir. Fiyatı olmayan satırlar kaydedilirken silinir ve her ülke için yalnızca ilk satır tutulur.

Price for countries not in the table: tabloda hedef ülke için satır yoksa (ve * satırı da yoksa) ya da satırda bu ağırlık için fiyat yoksa kullanılır. Bu durumda taşıyıcıyı gizlemek için boş bırakın. 0, ücretsiz kargo demektir.

Price applies: fiyatların hesaplanma şekli. Bu, canlı fiyatlar için de geçerlidir.

Canlı fiyatlar (API) — Endonezya

Ninja Van Tariff API, Endonezya içinde gönderilen koliler için ek ücret ve indirim olmadan standart teslimat ücretini döndürür. Ninja Van bunu yalnızca Endonezya için sunar. Live rates açıkken, bölüm başlığının altındaki durum satırları gönderici bölgesini, eksik dönüşüm oranını ve son Tariff API yanıtını (ortam, zaman ve sonuç) gösterir.

Live rates: Endonezya içindeki teslimatlar için canlı Ninja Van fiyatları alın. Varsayılan: kapalı. Bu seçenek olmadan ödeme sırasında Ninja Van'a hiçbir şey gönderilmez.

Environment: Production (api.ninjavan.co) (varsayılan) veya Sandbox — testing only (api-sandbox.ninjavan.co).

Service level: fiyatın istendiği hizmet: Standard (varsayılan), Express, Same day veya Next day. Ninja Van rota ve hizmet için fiyat vermezse fiyat tablosu kullanılır.

Ship-from zone code L1 ve Ship-from zone code L2: gönderdiğiniz ilçenin L1 ve L2 seviye kodları, örneğin ID_A00007_01 ve ID_B00069_01; alanın altında adresi gösterilen Ninja Van bölge kodu eşlemesinden (CSV) alınır. İkisini birden girin ya da ikisini de boş bırakarak Shop Parameters > Contact > Stores bölümündeki mağaza adresinden algılanmasını sağlayın: Endonezya, il (state), şehir ve şehirde birden fazla bölge varsa adres satırındaki ilçe (Kecamatan). Yanlış biçimdeki bir kod uyarıyla silinir. Yalnızca bir kod girilirse, uyarı ikisini de girmenizi ister ve bir durum satırı canlı fiyatların istenmediğini gösterir.

IDR conversion rate: Tariff API ücreti Endonezya rupisi (IDR) cinsinden döndürür. Mağazanızın varsayılan para birimi IDR ise boş bırakın. Aksi halde 1 IDR'nin mağaza para biriminizde ne kadar olduğunu girin, örneğin 0.000058. Değer 0'dan büyük olmalıdır. Bu olmadan canlı fiyatlar kullanılmaz, tablo kullanılır.

Koşullar

Minimum weight (kg): sepet bundan hafif olduğunda taşıyıcıyı gizler. Ürün ağırlıkları mağazanızın ağırlık biriminden kilograma çevrilir. 0, sınır olmadığı anlamına gelir.

Maximum weight (kg): sepet bundan ağır olduğunda taşıyıcıyı gizler. Varsayılan: 30. 0, sınır olmadığı anlamına gelir. Minimum weight (kg) değerinden düşük olamaz.

Minimum order amount: taşıyıcıyı yalnızca sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergilerden önce) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: Ninja Van kargosunun ücretsiz olduğu sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergilerden önce). Ücretsiz kargo olmaması için boş bırakın.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: taşıyıcı bölgelerine bağlı olmasa bile aşağıdaki ülkeler için Ninja Van sunar. Açıkken taşıyıcı, daha sonra oluşturacaklarınız dahil tüm etkin bölgelere bağlanır. Kapattığınızda taşıyıcı, daha önce sahip olduğu bölgeleri geri alır.

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

Gelişmiş

Debug log: hesaplamaları modül klasöründeki logs/vfd_njvn_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Müşteri adresleri kaydedilmez. Başarısız Tariff API istekleri, bu seçenek kapalı olsa bile kaydedilir. İşiniz bitince kapatın.

Log: hata ayıklama günlüğünü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 modül ayarlarını, taşıyıcıyı, önbelleğe alınmış fiyatları ve günlüğü siler. Kapalıyken, yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop, Ninja Van fiyatını modülden ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül önce koşulları kontrol eder: Ignore shipping zones ülke listesi (açıksa), sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0 olur ve Ninja Van'a istek gönderilmez.

Fiyat, ülkenin satırından (ya da * satırından) gelir: ağırlık sütunu, yoksa temel fiyat, o da yoksa Price for countries not in the table. Fiyat yoksa taşıyıcı o sepet için gizlenir. Fiyat mağazanın varsayılan para biriminde hesaplanır ve sonra müşterinin sepet para biriminde gösterilir.

Live rates açıkken Endonezya içindeki bir teslimat önce Ninja Van tarafından fiyatlandırılır. Modül gönderici ve teslimat adreslerini Ninja Van bölge kodlarına dönüştürür: il (state), şehir veya bölge (regency) ve birden fazla bölgesi olan şehirler için bir adres satırında yazılan ilçe (Kecamatan). Kodları, ağırlığı ve hizmet seviyesini gönderir ve ücreti IDR'den mağazanızın para birimine çevirir. Per item ile her farklı ürün ağırlığı için bir istek gönderilir; sepet başına en fazla 5. Daha fazla farklı ağırlık varsa fiyat tablosu kullanılır.

Tariff API dakikada 20 isteğe izin verir; bu nedenle yanıtlar 6 saat, hatalar 5 dakika ve «bu rota için fiyat yok» yanıtı 1 saat önbelleğe alınır. Modül dakikada 18 isteği asla aşmaz; HTTP 429 yanıtından sonra bir saat duraklar. API zaman aşımı 12 saniyedir. Ninja Van yanıt vermezse, hata döndürürse, rota için fiyatı yoksa veya adres eşleştirilemezse fiyat tablosu kullanılır. Hatalar günlüğe gider, asla müşteriye gösterilmez.

Siparişleri olduktan sonra taşıyıcıyı Shipping > Carriers bölümünde 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 fiyat hesaplar. Ninja Van siparişleri oluşturmaz, hava kargo irsaliyesi (AWB) basmaz, kurye alımı ayarlamaz, kargoları takip etmez ya da kapıda ödeme (COD) işlemi yapmaz. Bunlar için Ninja Van Dashboard'u kullanın. Teslim noktası (Ninja Points) seçici yoktur: taşıyıcı kapıya teslimattır. Canlı fiyatlar Endonezya dışında kullanılamaz.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Ninja Van lisans bloğu, Modules > Module Manager > VibeFox Ninja Van > Configure sayfasındaki ilk bloktur ve ayarların üstündedir. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarihi 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. Altında Product: presta-shipping-ninja-van satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisi olan ç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 tarihle birlikte 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 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 olmadan Ninja Van taşıyıcısı ödeme sırasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu yüzden taşıyıcı sizden de gizlenir: modülü anahtarı satın almadan önce ayarlayabilirsiniz, 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 sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim panelinde çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında 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

Ninja Van ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Ninja Van 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üşteri grubunu kapsadığını kontrol edin (ya da Ignore shipping zones seçeneğini açıp Countries alanına bakın). Ağırlık sınırlarını ve Minimum order amount değerini, ayrıca ülkenin, * satırının veya Price for countries not in the table seçeneğinin bir fiyatı olduğunu kontrol edin. Ürün sayfasında ürünler belirli taşıyıcılarla da sınırlanmış olabilir.

Bazı adresler için canlı fiyat kullanılmıyor: hedefin bir Ninja Van bölgesiyle eşleşmesi gerekir: Endonezya, il (state), şehir veya bölge (regency) ve birden fazla bölgesi olan şehirlerde bir adres satırındaki ilçe (Kecamatan). Aksi halde fiyat tablosu kullanılır. Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın.

Canlı fiyatlar hiç istenmiyor: Canlı fiyatlar (API) — Endonezya başlığının altındaki durum satırları nedeni gösterir: mağaza adresi Endonezya'da değil ya da gönderici bölgesi algılanamadı (her iki bölge kodunu girin), iki koddan yalnızca biri girilmiş, girilen kodlar bölge kodu eşlemesinde bir çift oluşturmuyor ya da IDR conversion rate eksik.

İstek sınırına ulaşıldı (HTTP 429): canlı istekler bir saat duraklatılır ve bu sırada fiyat tablosu kullanılır.

Fiyatlar hangi para biriminde: tablo ve koşullar mağazanızın varsayılan para birimindedir. Canlı fiyatlar rupi (IDR) cinsindendir ve mağaza para biriminiz IDR değilse IDR conversion rate ile çevrilir.

Sayfa Ninja Van taşıyıcısının bulunamadığını söylüyor: 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: kendi ilçe (Kecamatan) alanı olan bir mağaza, bölge kodlarını actionVfdNjvnTariffZone kancasıyla sağlayabilir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Ninja Van yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbelleğe alınmış fiyatlar her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar, son Tariff API durumu ve günlük kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurduğunuzda kayıtlı taşıyıcı, kaldırılmadan önceki durumunu geri alır.

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