VibeFox iMile for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

iMile tarifesi: iMile satış ekibiyle kararlaştırdığınız fiyatlar. Bunları fiyat tablosuna mağaza para biriminizle girersiniz.

iMile API hesabı (yalnızca canlı tahmin için): canlı tahmin, iMile OpenAPI "Estimated order delivery costs" servisini kullanır. Bir Customer ID ve bir Secret key gerekir (iMile'ın Customer ID ile birlikte verdiği API anahtarı). Test istemcisi için iMile geliştirici portalına (developer.imile.com) kaydolun. Canlı anahtarlar iMile hesap yöneticinizden alınır. Yalnızca fiyat tablosunu kullanıyorsanız API anahtarlarına 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. WordPress'te Plugins > Add New > Upload Plugin yoluna gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_imile klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox iMile ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. iMile fiyatlarınızı Price table bölümüne girin. İsterseniz Live rates (API) bölümünü doldurup Live estimate seçeneğini açın (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde bir kargo bölgesine VibeFox iMile ekleyin (örneğin "United Arab Emirates") ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox iMile. 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.

Ayarları her kaydettiğinizde, önbelleğe alınmış iMile tahminleri ve erişim jetonları temizlenir. Canlı tahmin açık olduğu halde çalışamıyorsa (anahtar yok, gönderim şehri veya ülkesi yok, döviz kuru yok, fiyat tablosu boş), ayarların üstünde uyarılar görünür.

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öntemi adı. Bir bölge bunu geçersiz kılabilir. Varsayılan: iMile.

Canlı tarifeler (API) (isteğe bağlı)

iMile bir tahmin döndürmezse (anahtar yok, şehir henüz girilmedi, hata, zaman aşımı, döviz kuru yok), fiyat tablosu kullanılır.

Live estimate: iMile'dan kargo maliyeti almak için açın. Varsayılan: kapalı. Canlı tahmin kapalıyken ödeme sırasında iMile'a hiçbir şey gönderilmez.

Environment: Production (openapi.imile.com) (varsayılan) veya Test (test-openapi.52imile.cn). Test anahtarları yalnızca test sunucusuyla çalışır ve test fiyatları verir.

Customer ID: iMile'ın verdiği müşteri kodu (customerId), örneğin C2102192601.

Secret key: iMile'ın Customer ID ile birlikte verdiği gizli anahtar (API anahtarı). İstekleri imzalar.

Signature: isteklerin nasıl imzalanacağı.

Ship-from country: gönderim yaptığınız ülke. Varsayılan olarak mağazanızın ülkesidir. Listede, eklentinin iMile ülke kodlarına sahip olduğu ülkeler yer alır.

Ship-from city: paketlerinizin gönderildiği şehir; iMile şehir listesindeki gibi yazılmalıdır (örneğin Dubai, Riyadh). Mağaza şehrini WooCommerce > Settings > General bölümünden kullanmak için boş bırakın.

Ship-from province: isteğe bağlı, örneğin Dubai veya Riyadh Province.

iMile service: iMile'a gönderilen sipariş türü: Delivery order (100) (varsayılan) veya Express order (1100). Express, hesabınız ve ülkeniz için etkin olmalıdır.

Goods category: iMile'a gönderilen mal türü: Normal goods (varsayılan), Sensitive (cosmetics, liquids...), With battery, Batteries / power banks, Documents veya Parcel.

Exchange rates: iMile tahminleri hedef ülkenin para biriminde yapar. Her para birimi için bir satır girin; 1 birimin mağaza para birimindeki fiyatını yazın, örneğin "AED = 0.25" veya "SAR = 0.24". Ondalık ayracı olarak virgül ya da nokta kabul edilir. Mağaza para biriminin kendisi için kur gerekmez. Kur yoksa o para birimindeki tahminler kullanılmaz ve bunun yerine fiyat tablosu uygulanır. Aynı kur, iMile'a bildirilen sepet değerini de çevirir. Geçersiz satırlar kaydedilirken silinir.

Fiyatlar (canlı tahmin kapalıyken ve iMile tahmin döndürmediğinde yedek olarak kullanılır)

iMile tarifenizi mağaza para biriminde girin. AED, SAR veya başka bir para birimindeyse önce dönüştürün.

Price table: hedef ülke başına bir satır. Satır eklemek için + Add country, silmek için çarpıya tıklayın. Kendi satırı olmayan tüm ülkeleri kapsayan bir satır için * All other countries seçin. Her satırda bir Base price ve isteğe bağlı ağırlık sütunları vardır: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg ve XL >5 kg. Boş (veya 0) bir ağırlık sütunu temel fiyatı kullanır. 0 olan temel fiyat, o ülkeye ücretsiz kargo anlamına gelir. Hem "9.99" hem de "9,99" kabul edilir. Fiyatı olmayan satırlar, geçersiz ülke kodları ve negatif fiyatlar kaydedilirken silinir. Her ülke için yalnızca bir satır tutulur.

Price for countries not in the table: mağaza para biriminde bir fiyat. 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 yöntemi gizlemek için boş bırakın.

Price applies: tablo fiyatının nasıl tahsil edileceği.

Aynı seçim canlı tahmin için de geçerlidir: sipariş başına, tüm sepeti içeren tek bir paket gönderir; ürün başına, her farklı paket için ayrı istekte bulunur ve birim sayısıyla çarpar. Sepette 5'ten fazla farklı paket varsa fiyat tablosu kullanılır.

Ürün ağırlıkları, mağaza ağırlık biriminden kilograma çevrilir.

Koşullar

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

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

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

Free shipping from: iMile teslimatının ücretsiz olduğu sepet ara toplamı (indirimler sonrası, vergi öncesi). Hiçbir zaman ücretsiz kargo sunmamak için 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 ve iMile tahminleri KDV'yi 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 iMile'ı aşağıda belirtilen ülkeler için sunar.

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: fiyat hesaplamalarını WooCommerce > Status > Logs bölümüne ("vfd_imile" kaynağı) yazar. Anahtarlar ve müşteri adresleri günlüğe yazılmaz. Başarısız iMile istekleri, hata ayıklama günlüğü kapalı olsa bile her zaman kaydedilir. İşiniz bittiğinde günlüğü kapatın.

Remove data on uninstall: açıksa eklentiyi silmek tüm iMile ayarlarını, bölge yöntemlerini ve önbelleğe alınmış tahminleri kaldırır. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir fiyat ister. Eklenti önce koşulları kontrol eder: teslimat ülkesi, sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Ücretsiz kargo uygulanıyorsa müşteri yöntemi ücretsiz görür ve iMile'a istek gönderilmez.

Canlı tahmin açıkken eklenti iMile'a gönderim ülkesini, bölgesini ve şehrini; hedef ülkeyi, eyaleti, şehri ve posta kodunu; sepet ağırlığını kg cinsinden; boyutu cm³ cinsinden (ürün ölçülerinden); sepet değerini; iMile servisini ve mal kategorisini gönderir. Tahmin her zaman peşin olarak istenir, bu nedenle kapıda ödeme ücretleri dahil edilmez. Canlı tahmin yalnızca müşteri bir şehir girdikten sonra ve her paketin ağırlığı olduğunda istenir. Her yanıt 1 saat önbelleğe alınır. Başarısız bir istek 5 dakika önbelleğe alınır. Zaman aşımı veya sunucu hatasından sonra 2 dakika, reddedilen anahtarlardan sonra 5 dakika boyunca iMile'a istek gönderilmez; böylece ödeme sayfası her yenilemede iMile'ı beklemez. API zaman aşımı 12 saniyedir. Süresi dolmuş bir erişim jetonu otomatik olarak yenilenir.

Tahmin, döviz kurlarınızla mağaza para birimine çevrilir. iMile kullanılabilir bir tahmin vermezse (anahtarlar ayarlanmamış, şehir henüz girilmemiş, bilinmeyen şehir, hata, zaman aşımı, döviz kuru yok), müşteri hata görmez ve tablodaki fiyat kullanılır. Tabloda da fiyat yoksa yöntem gizlenir. Nedeni günlüğe yazılır.

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

Eklenti yalnızca fiyat hesaplar. iMile gönderileri oluşturmaz, AWB etiketi yazdırmaz, kurye talep etmez, paketleri takip etmez, kapıda ödeme tahsilatlarını mutabakata bağlamaz ve teslim noktası ya da dolap sunmaz. Gönderiler için iMile portalını kullanın.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox iMile 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, 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 tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan iMile, ö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 anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

iMile ö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 ülkesinin bölgesine eklendiğini kontrol edin (ya da Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını kontrol edin. Ülkenin veya * satırının Price table bölümünde bir satırı olduğunu ya da Price for countries not in the table alanının doldurulmuş olduğunu doğrulayın.

iMile tahmini yerine tablo fiyatı gösteriliyor: WooCommerce > Status > Logs sayfasını açın, kaynak "vfd_imile" olsun ve ayrıntılar için Debug log seçeneğini açın. Yaygın nedenler: Live estimate kapalı, anahtarlar eksik, müşteri henüz şehir girmedi, iMile şehir yazımını tanımıyor, ürünlerin ağırlığı yok, hedef para birimi için döviz kuru yok ya da bir API hatası var. Ayarların üstündeki uyarıları da kontrol edin.

Günlükte "sign is invalid": Secret key değerini kontrol edin, ardından Signature = SimpleKey seçeneğini deneyin.

Anahtarlar reddediliyor: Customer ID, Secret key ve Environment değerlerini kontrol edin. Test anahtarları yalnızca test sunucusuyla çalışır.

Şehir adları eşleşmiyor: şehir adları iMile şehir listesiyle eşleşmelidir. Geliştiriciler bunları vfd_imile_live_request filtresiyle, ülke kodlarını ise vfd_imile_live_country_code filtresiyle eşleştirebilir.

Fiyatlar yanlış para biriminde: fiyat tablosu mağaza para birimindedir (WooCommerce > Settings > General). AED, SAR veya MXN tarifesini girerken dönüştürün. Canlı tahminler Exchange rates ile çevrilir.

Kargoda vergi iki kez alınıyor: fiyatlarınız KDV'yi zaten içeriyorsa Tax status değerini None olarak ayarlayın.

Bir değişiklikten sonra tahminler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış iMile tahminlerini temizler.

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

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri ve önbelleğe alınmış tahminler 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.

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