VibeFox Ninja Van 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.

Ninja Van tarifesi: Ninja Van gönderici hesabınızdaki veya Ninja Van satış ekibinden aldığınız fiyatlar, fiyat tablosuna girilir. API anahtarı 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 bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin sayfasına gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_ninja_van klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Ninja Van 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. Ninja Van fiyatlarınızı fiyat tablosuna girin. Endonezya için isterseniz Live rates seçeneğini açın (bkz. Yapılandırma).

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

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox Ninja Van. Bu ayarlar 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): müşterilerin bu bölge için gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Genel

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

Method title: sepette ve ödeme sayfasında gösterilen kargo yönteminin adı. Bir bölge bunu geçersiz kılabilir. Varsayılan: Ninja Van.

Fiyatlar (mağaza para biriminizde)

Ninja Van tarifenizin fiyatlarını mağaza para biriminizde girin. Tarifeniz SGD, MYR, IDR, PHP, THB veya VND cinsindeyse, ö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 çarpı işaretine 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ı bulunur: 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 olan) bir ağırlık sütunu temel fiyatı kullanır. Temel fiyat 0 ise o ülkeye ücretsiz kargo anlamına gelir. "9.99" ve "9,99" ikisi de kabul edilir. Fiyatı olmayan satırlar kaydedilirken kaldırılır.

Price for countries not in the table: tabloda hedef ülke için satır yoksa (ve * satırı da yoksa) veya satırda bu ağırlık için fiyat yoksa kullanılır. Bu durumda yöntemi gizlemek için boş bırakın.

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

Canlı oranlar (API) — Endonezya

Ninja Van Tariff API, Endonezya içinden 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, bu bölümdeki durum satırları gönderici bölgesini, eksik dönüşüm oranını ve son Tariff API yanıtını gösterir.

Live rates: Endonezya içindeki teslimatlar için canlı Ninja Van fiyatlarını alır. Varsayılan: kapalı. Bu seçenek kapalıyken ö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 vermiyorsa fiyat tablosu kullanılır.

Ship-from zone code L1 ve Ship-from zone code L2: gönderdiğiniz ilçenin L1 ve L2 kademe kodları, örneğin ID_A00007_01 ve ID_B00069_01; ayarlar sayfasındaki bağlantılı Ninja Van bölge kodu eşlemesinden (CSV). İkisini de girin veya ikisini de boş bırakarak WooCommerce > Settings > General bölümündeki mağaza adresinden algılanmasını sağlayın: Endonezya, il, şehir ve şehirde birden fazla bölge varsa adres satırındaki ilçe (Kecamatan). Yanlış biçimdeki kod hata mesajıyla temizlenir.

IDR conversion rate: Tariff API ücreti Endonezya rupiahı (IDR) cinsinden döndürür. Mağaza para biriminiz IDR ise boş bırakın. Aksi halde 1 IDR'nin mağaza para biriminizde ne kadar olduğunu girin, örneğin 0.000058. Bu değer olmadan canlı fiyatlar kullanılmaz, fiyat tablosu kullanılır.

Koşullar

Minimum weight (kg): sepet bundan hafifse yöntemi gizler. 0, sınır olmadığı anlamına gelir.

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

Minimum order amount: yöntemi yalnızca sepet ara toplamı (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 teslimatının ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergilerden önce). Ücretsiz kargo yoksa boş bırakın.

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

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez. Tablodaki fiyatlar vergileri (GST, SST, KDV) zaten içeriyorsa None seçin.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: yöntem hiçbir kargo bölgesine eklenmemiş olsa bile Ninja Van'ı aşağıdaki ülkeler için sunar.

Countries: bu mod için hedef ülkeler. Teslimat 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: tarife hesaplamalarını WooCommerce > Status > Logs bölümüne kaydeder (kaynak vfd_ninja_van). Müşteri adresleri kaydedilmez. Bu seçenek kapalı olsa bile başarısız Tariff API istekleri kaydedilir. İşiniz bittiğinde kapatın.

Remove data on uninstall: açıkken eklentiyi silmek tüm Ninja Van ayarlarını ve bölge yöntemlerini kaldırır. 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 tarife ister. Eklenti önce koşulları kontrol eder: teslimat ülkesi, sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Ücretsiz kargo geçerliyse müşteri yöntemi ücretsiz görür ve Ninja Van'a hiçbir istek gönderilmez.

Fiyat, ülke satırından (veya * satırından) gelir: ağırlık sütunu, yoksa temel fiyat, yoksa Price for countries not in the table. Ürün ağırlıkları, mağaza ağırlık biriminden kilograma çevrilir. Fiyat yoksa yöntem gizlenir.

Live rates açıksa, Endonezya içindeki bir teslimat önce Ninja Van tarafından fiyatlandırılır. Eklenti, gönderici ve teslimat adreslerini Ninja Van bölge kodlarına çevirir: il, şehir veya ilçe (regency) ve birden fazla bölgesi olan şehirler için adres satırında yazan ilçe (Kecamatan). Kodları, ağırlığı ve hizmet seviyesini gönderir ve ücreti IDR'den mağaza para birimine çevirir. Per item seçiliyken her farklı ürün ağırlığı için bir istek gönderilir; sepet başına en fazla 5 istek.

Tariff API dakikada 20 isteğe izin verir, bu nedenle yanıtlar 6 saat, hatalar 5 dakika ve "bu rota için fiyat yok" durumu 1 saat önbelleğe alınır. Eklenti dakikada 18 istekten fazlasını asla göndermez 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 tablo fiyatı kullanılır. Hatalar günlüğe yazılır, müşteriye asla gösterilmez.

Yöntem klasik ödeme sayfasında ve Cart ile Checkout bloklarında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca fiyat hesaplar. Ninja Van siparişleri oluşturmaz, hava kargo irsaliyesi (AWB) basmaz, kurye alımı ayarlamaz, kargoları takip etmez veya COD işlemi yapmaz. Bunlar için Ninja Van Dashboard'u kullanın. Teslim noktası (Ninja Points) seçici yoktur: yöntem kapıya teslimattır. Canlı fiyatlar Endonezya dışında kullanılamaz.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Ninja Van sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum görünür; örneğin lisansın hangi tarihe kadar etkin olduğu ve alan adınız. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key 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ı bir siteden kaldırmak, alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

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

Ninja Van ö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 ülkesine ait bölgeye eklendiğini kontrol edin (veya Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını ve ülke, * satırı veya Price for countries not in the table için bir fiyat olup olmadığını kontrol edin.

Bazı adresler için canlı fiyat kullanılmıyor: hedefin bir Ninja Van bölgesiyle eşleşmesi gerekir: Endonezya, il, şehir veya ilçe (regency) ve birden fazla bölgesi olan şehirler için adres satırındaki ilçe (Kecamatan). Aksi halde tablo fiyatı kullanılır. Nedenini görmek için Debug log seçeneğini açın ve Canlı oranlar (API) — Endonezya altındaki durum satırlarını kontrol edin.

Canlı fiyatlar hiç istenmiyor: durum satırları nedenini gösterir: mağaza adresi Endonezya'da değil ya da gönderici bölgesi algılanamadı (her iki bölge kodunu girin) veya IDR conversion rate eksik.

İ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.

Fiyatlar hangi para biriminde: tablo mağaza para biriminizdedir. Canlı fiyatlar rupiah (IDR) cinsindedir ve mağaza para biriminiz IDR değilse IDR conversion rate ile çevrilir.

Geliştiriciler: ödeme sayfasında kendi ilçe (Kecamatan) alanı olan bir site, bölge kodlarını vfd_njvn_tariff_zone filtresiyle sağlayabilir.

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

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri, son Tariff API durumu ve önbelleğe alınmış canlı fiyatlar yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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