VibeFox Ninja Van for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 ile test edildi) veya 4.0.2 ve üzeri (4.1.0.3 ile test edildi).

PHP: 8.0 veya üzeri.

Ninja Van tarife çizelgesi: Ninja Van gönderici hesabınızın fiyatları ya da Ninja Van satış ekibinden alınan fiyatlar; fiyat tablosuna girilir. Ninja Van API anahtarları gerekmez. Endonezya içindeki isteğe bağlı canlı fiyatlar, herkese açık ve kimlik doğrulama 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

İndirme dosyası, 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_ninja_van-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_ninja_van.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

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

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

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

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

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

OpenCart 4

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

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

3. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Ninja Van eklentisini bulun, Install düğmesine (yeşil +) ve sonra Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3'teki 4. ve 5. adımlarda olduğu gibi girin. Ayar sayfası ve alanları iki sürümde de aynıdır.

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

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Ninja Van > Edit. Bölümler solda listelenir. Sayfanın altındaki tek bir Save düğmesi, tüm sayfayı yeniden yüklemeden kaydeder. Method title boşsa, 64 karakterden uzunsa veya < > ; = # { } içeriyorsa, bir sayı alanı metin ya da negatif bir sayı içeriyorsa, IDR conversion rate 0 ise, Minimum weight (kg) değeri Maximum weight (kg) değerinden büyükse ya da Sort order tam sayı değilse hiçbir şey kaydedilmez ve bir hata gösterilir. Mağazanızda kg birimine sahip bir ağırlık sınıfı yoksa ve varsayılan ağırlık sınıfının birimi eklenti tarafından bilinmiyorsa, ürün ağırlıklarının kilogram olarak alındığını bildiren bir uyarı görünür: System > Localisation > Weight Classes bölümüne bir kg ağırlık sınıfı ekleyin. Ayarları yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar kaydedebilir.

Genel

Ayarlar tüm coğrafi bölgeler için geçerlidir. Yöntemi Conditions bölümünde bir coğrafi bölgeyle sınırlayabilir ya da Ignore shipping zones seçeneğini kullanabilirsiniz.

Enable Ninja Van: Ninja Van'ı ödeme sırasında gösterir veya gizler. Varsayılan: kapalı.

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

Tax class: kargo ücretinin vergi sınıfı veya No tax (varsayılan). Tablodaki fiyatlar zaten vergi içeriyorsa (GST, SST, VAT) No tax seçin.

Sort order: ödeme sırasında Ninja Van'ın kargo yöntemleri arasındaki konumu. Tam sayı.

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

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

Price table: hedef ülke başına bir satır. Satır eklemek için Add country düğmesine, satır silmek için × düğmesine tıklayın. Kendi satırı olmayan tüm ülkeler için * All other countries seçin. Her satırın bir Base fiyatı ve ağırlık sütunları vardır: XS 1 kg'a kadar, S 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar ve XL 5 kg üzeri. Boş (veya 0) bir ağırlık sütunu temel fiyatı kullanır. Temel fiyat 0 ise o ülkeye kargo ücretsizdir. 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ırın bu ağırlık için fiyatı yoksa kullanılır. Bu durumda yöntemi gizlemek için boş bırakın. 0 ücretsiz kargo anlamına gelir.

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

Canlı oranlar (API) — Endonezya

Ninja Van Tariff API, Endonezya içinde gönderilen paketler 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önderim bölgesini, eksik bir dönüşüm oranını ve son Tariff API yanıtını (ortam, zaman ve sonuç) gösterir. Her kaydetmeden sonra güncellenirler.

Live rates: Endonezya içindeki teslimatlar için Ninja Van'dan canlı 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'ın rota ve hizmet için bir fiyatı yoksa fiyat tablosu kullanılır.

Ship-from zone code L1 ve Ship-from zone code L2: gönderim yaptığınız ilçenin L1 ve L2 kademe kodları; örneğin ID_A00007_01 ve ID_B00069_01. Bunlar, adresi alanın altında gösterilen Ninja Van bölge kodu eşlemesinden (CSV) alınır. İkisini de girin: OpenCart mağaza adresinde ayrı bir şehir veya cadde bulunmadığından, gönderim bölgesi bu adresten belirlenemez. Kodlar büyük harfe çevrilir. Yanlış biçimdeki bir kod uyarıyla silinir. Yalnızca bir kod girilirse, ikisini de girmeniz için bir uyarı çıkar ve bir durum satırı canlı fiyatların istenmediğini gösterir. Bir durum satırı ayrıca iki kodun bölge kodu eşlemesinde çift oluşturmadığında uyarır.

IDR conversion rate: Tariff API ücreti Endonezya rupiahı (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. 0'dan büyük olmalıdır. Bu değer olmadan canlı fiyatlar kullanılmaz ve fiyat tablosu kullanılır.

Koşullar

Minimum weight (kg): sepet bundan hafifse yöntemi gizler. Ürün ağırlıkları OpenCart ağırlık sınıflarından kilograma çevrilir. 0 sınır olmadığı anlamına gelir (varsayılan).

Maximum weight (kg): sepet bundan ağırsa yöntemi gizler. Varsayılan: 30. 0 veya boş alan sınır olmadığı anlamına gelir. Minimum weight (kg) değerinden düşük olamaz.

Minimum order amount: yöntemi yalnızca kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi); bu tutardan itibaren Ninja Van kargosu ücretsizdir. Ücretsiz kargo olmaması için boş bırakın.

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

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: Ninja Van'ı Geo zone ne olursa olsun aşağıdaki ülkeler için sunun. Kapalıyken (varsayılan) coğrafi bölge belirler ve ülke listesi kullanılmaz.

Countries: bu mod için hedef ülkeler. Tüm ülkelere izin vermek için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını storage/logs/vfd_njvn_debug.log.php dosyasına yazar (OpenCart 4'te system/storage/logs/vfd_njvn_debug.log.php). Dosya web üzerinden okunamaz. Müşteri adresleri veya bölge kodları kaydedilmez. Başarısız Tariff API istekleri bu seçenek kapalıyken de kaydedilir. İşiniz bittiğinde kapatın. Dosya 5 MB'a ulaştığında vfd_njvn_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

Log: hata ayıklama günlüğünün boyutunu ve en son girişlerini gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Remove data on uninstall: açıkken eklentiyi kaldırmak Ninja Van ayarlarını ve günlüğü siler. Kapalıyken (varsayılan) yeniden kurulum için saklanırlar. Önbellekteki fiyatlar her zaman silinir.

İçe Aktarma / Dışa Aktarma

Export: ayarları JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. Eklentinin gizli anahtarı yoktur, bu nedenle her şey dışa aktarılır.

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 kaydetme işlemindeki gibi denetlenir.

Ödemede nasıl çalışır

OpenCart kargo yöntemlerini gösterirken, eklentiden Ninja Van fiyatını ister. Bir Geo zone tanımlıysa (ve Ignore shipping zones kapalıysa) ve adres bunun dışındaysa Ninja Van sunulmaz. Yalnızca Requires Shipping değeri Yes olan ürünler dikkate alınır: diğer ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Ardından eklenti koşulları denetler: Ignore shipping zones seçeneğinin ülke listesi (açıksa), sepet ağırlığı ve en düşük sipariş tutarı. Sipariş tutarı, kupon indiriminden sonra ve vergi öncesi, kargo gerektiren ürünlerin fiyatıdır. Hediye sertifikaları, ödül puanları ve mağaza kredisi hesaba katılmaz. Ücretsiz kargo geçerliyse fiyat 0 olur ve Ninja Van'a istek gönderilmez.

Fiyat, ülkenin satırından (veya * satırından) gelir: önce ağırlık sütunu, yoksa temel fiyat, yoksa Price for countries not in the table. Fiyat yoksa yöntem bu sepet için gizlenir. Fiyat, mağazanızın varsayılan para biriminde hesaplanır, ondalık basamaklarına yuvarlanır ve seçili Tax class vergisiyle müşteriye kendi para biriminde gösterilir.

Live rates açıkken, Endonezya içindeki bir teslimat önce Ninja Van tarafından fiyatlandırılır. Eklenti teslimat adresini Ninja Van bölge kodlarına çevirir: adresin bölgesi (il), City alanı (şehir veya regency) ve birden fazla bölgesi olan şehirler için Address 1 veya Address 2 içinde yazılan ilçe (Kecamatan). Gönderim çıkış kodlarınızı, teslimat kodlarını, ağırlığı ve hizmet düzeyini gönderir ve ücreti IDR'den mağazanızın para birimine çevirir. Per item seçeneğinde her farklı ürün ağırlığı için bir istek gönderilir; sepet başına en fazla 5 istek. Farklı ağırlık sayısı daha fazlaysa fiyat tablosu kullanılır.

Tariff API dakikada 20 isteğe izin verir, bu nedenle yanıtlar eklentinin bir tablosunda önbelleğe alınır: fiyatlar 6 saat, "bu rota için fiyat yok" 1 saat ve hatalar 5 dakika. Ayarları kaydetmek bu önbelleği temizlemez. Eklenti dakikada 18 isteğin üzerine asla çıkmaz ve bir 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 tablodaki fiyat kullanılır. Hatalar müşteriye değil günlüğe yazı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 Ninja Van seçeneğini seçer. Yöntem OpenCart 3'tekiyle aynı şekilde çalışır.

Eklenti yalnızca fiyat hesaplar. Ninja Van siparişi oluşturmaz, kargo etiketi (AWB) basmaz, kurye randevusu almaz, paketleri takip etmez veya COD yönetmez. Bunun için Ninja Van Dashboard'unu kullanın. Teslim noktası (Ninja Points) seçici yoktur: yöntem kapıya teslimattır. Siparişlere hiçbir şey eklemez: sipariş, diğer tüm OpenCart kargo yöntemleri gibi yöntem adını ve kargo ücretini gösterir. Canlı fiyatlar Endonezya dışında kullanılamaz.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Ninja Van lisans bloğu, Extensions > Extensions > Shipping > VibeFox Ninja Van > Edit 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ı gizli olarak, durumu (örneğin lisansın geçerli olduğu tarihi ve alan adınızı) gösterir; ayrıca 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 düğmeleri bulunur. Bunların altında Product: opencart-shipping-ninja-van satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı yer alır. Anahtarı yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri 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 tarihiyle birlikte License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca tek 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Ninja Van ödeme sayfasında müşterilere gösterilmez ve tarife hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi yine de mağazada görür; yöntem (unlicensed — visible to admins only) ile işaretlenir. Böylece anahtarı satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar yoksa yöntem herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. 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, yönetici Dashboard ekranı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

Ninja Van ödeme sırasında görünmüyor: lisansın etkin olduğunu ve Enable Ninja Van seçeneğinin açık olduğunu kontrol edin. Geo zone (veya Ignore shipping zones ve Countries), ağırlık sınırlarını ve Minimum order amount değerini kontrol edin; ülkenin, * satırının veya Price for countries not in the table seçeneğinin bir fiyatı olduğundan emin olun. Ürünlerde Requires Shipping değerinin Yes olduğunu doğrulayın.

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

Canlı fiyatlar hiç istenmiyor: Canlı oranlar (API) — Endonezya başlığının altındaki durum satırları nedenini gösterir: gönderim bölge kodları eksiktir, iki koddan yalnızca biri girilmiştir, girilen kodlar bölge kodu eşlemesinde çift oluşturmuyordur veya IDR conversion rate eksiktir.

İstek sınırına ulaşıldı (HTTP 429): canlı istekler bir saat duraklatılır ve bu sürede fiyat tablosu kullanılır. Ayarları kaydetmek duraklatmayı sona erdirmez.

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

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

Geliştiriciler için: kendi ilçe (Kecamatan) alanı olan bir mağaza, bölge kodlarını OpenCart vfd_ninja_van/tariff_zone olayı (tetikleyici catalog/vfd_ninja_van/tariff_zone) ile sağlayabilir; gönderim bölgesi için de geçerlidir. Tariff API adresi vfd_njvn_api_url ayarıyla değiştirilebilir (testler için); ayarlar sayfasında bunun bir alanı yoktur.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox Ninja Van 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 Ninja Van, Sort order, Tax class ve Geo zone ayarlarını sıfırlar. Önbellekteki fiyatlar her zaman kaldırılır. Remove data on uninstall açıksa Ninja Van ayarları, son Tariff API durumu ve hata ayıklama günlüğü de silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Mevcut siparişler kargo yöntemlerini ve ücretlerini korur.

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

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