VibeFox iMile for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 - 9.x.

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

iMile tarifesi: iMile satış ekibiyle kararlaştırdığınız fiyatlar. Bunları fiyat tablosuna, mağazanızın varsayılan para biriminde girersiniz.

iMile API hesabı (yalnızca canlı tahmin için): canlı tahmin, iMile OpenAPI "Estimated order delivery costs" yöntemini kullanır. Bir Customer ID ve bir Secret key'e ihtiyacınız vardır (iMile'ın Customer ID ile birlikte verdiği API anahtarı). Test istemcisi için iMile geliştirici portalına (developer.imile.com) kaydolun. Üretim 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. 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 bittiğinde Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox iMile modülünü bulup Configure düğmesine tıklayın.

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

4. iMile fiyatlarınızı Price table bölümüne girin. İsteğe bağlı olarak Live rates (API) bölümünü doldurun ve Live estimate seçeneğini açın (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, Courier delivery teslimat süresi metniyle iMile taşıyıcısını oluşturur. Taşıyıcı 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ünde 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 iMile > Configure. Taşıyıcının her bölgesi 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, önbelleğe alınmış iMile tahminlerini ve erişim belirteçlerini de temizler.

Live estimate açıkken çalışamıyorsa ayarların üstünde uyarılar görünür: Customer ID ya da Secret key boştur, gönderim şehri ya da ülkesi eksiktir (ya da ülke bir iMile pazarı değildir), döviz kuru yoktur veya fiyat tablosu boştur ve diğer ülkeler için fiyat yoktur. Mağazanın ağırlık birimini modül tanımıyorsa da uyarı görünür: ürün ağırlıkları o zaman kilogram kabul edilir, bu yüzden birimi International > Localization (Local units) bölümünde ayarlayın. Kaydettiğinizde modül, Method title alanının geçerli olduğunu (en fazla 64 karakter), tutar ve ağırlık alanlarının 0 veya daha büyük sayılar olduğunu, Minimum weight değerinin Maximum weight değerinden büyük olmadığını ve vergi kuralının var olduğunu denetler. Aksi halde hata gösterir ve hiçbir şey kaydetmez.

Genel

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

Method title: sepette ve ödeme sayfasında gösterilen taşıyıcı adı. Varsayılan: iMile. Zorunlu.

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 ücretini 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 sunucusunda çalışır ve test fiyatları verir.

Customer ID: iMile'ın verdiği müşteri kodu (customerId), örneğin C2102192601. Bunu temizlemek, kayıtlı Secret key değerini de temizler.

Secret key: iMile'ın Customer ID ile birlikte verdiği gizli anahtar (API anahtarı). İstekleri imzalar. 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.

Signature: isteklerin nasıl imzalandığı.

Ship-from country: gönderim yaptığınız ülke. Varsayılan olarak mağazanızın ülkesidir (Shop country). Listede yalnızca modülün iMile ülke kodlarına sahip olduğu ülkeler bulunur.

Ship-from city: paketlerinizin gönderildiği şehir; iMile şehir listesindeki gibi yazılır (örneğin Dubai, Riyadh). Mağaza şehrini Shop Parameters > Contact > Stores 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 etkinleştirilmiş 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 tahminlerini hedef ülkenin para biriminde yapar. Her para birimi için bir satır girin; mağazanızın varsayılan para birimindeki 1 birimin fiyatını yazın, örneğin "AED = 0.25" veya "SAR = 0.24". Ondalık ayracı olarak nokta ya da virgül kabul edilir. Mağazanın kendi para birimi için kur gerekmez. Kur olmadan o para birimindeki tahminler kullanılmaz ve bunun yerine fiyat tablosu kullanılır. Aynı kur, iMile'a bildirilen sepet değerini de çevirir. Geçersiz satırlar kaydederken silinir.

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

iMile tarifenizi mağazanın varsayılan para biriminde, vergi hariç girin. AED, SAR veya başka bir para birimindeyse önce çevirin.

Price table: hedef ülke başına bir satır. Satır eklemek için Add country düğmesine, silmek için çöp kutusu simgesine 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ş (ya da 0) bir ağırlık sütunu temel fiyatı kullanır. 0 temel fiyat, o ülkeye ücretsiz kargo anlamına gelir. Hem "9.99" hem de "9,99" kabul edilir. Hiçbir fiyatı olmayan satırlar ve negatif fiyatlar kaydederken silinir. Her ülke için yalnızca bir satır tutulur.

Price for countries not in the table: mağazanın varsayılan 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 taşıyıcıyı 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 koli gönderir; ürün başına her farklı koli için tahmin ister ve birim sayısıyla çarpar. Sepette 5'ten fazla farklı koli varsa fiyat tablosu kullanılır.

Ürün ağırlıkları ve boyutları mağazanızın birimlerinden kilogram ve santimetreye çevrilir.

Koşullar

Minimum weight: sepet bundan az tartıyorsa taşıyıcıyı gizler (kg cinsinden). 0 sınır yok anlamına gelir.

Maximum weight: sepet bundan fazla tartıyorsa taşıyıcıyı gizler (kg cinsinden). Varsayılan: 30. 0 sınır yok anlamına gelir.

Minimum order amount: taşıyıcıyı 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). Asla ücretsiz kargo sunmamak için boş bırakın.

Tax: taşıyıcının vergi kuralı ya da No tax. Tablodaki fiyatlar ve iMile tahminleri KDV'yi zaten içeriyorsa No tax seçin.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: eşleşen bölgeden bağımsız olarak aşağıdaki ülkeler için iMile'ı sunar. Kaydederken taşıyıcı tüm bölgelere eklenir ve sonradan oluşturulan bölgeler de onu alır. Seçeneği kapatmak eklenen bölgeleri kaldırır, böylece taşıyıcı önceden sahip olduğu bölgeleri geri alır.

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

Gelişmiş

Debug log: ücret hesaplamalarını modül klasöründeki logs/vfd_imle_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hiçbir anahtar ve müşteri adresi kaydedilmez. Başarısız iMile istekleri, hata ayıklama günlüğü kapalı olsa bile her zaman kaydedilir. İşiniz bittiğinde günlüğü 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 iMile ayarlarını, taşıyıcıyı, önbelleğe alınmış tahminleri ve günlükleri siler. Kapalıyken yeniden kurulum için her şey saklanır.

Ödeme sayfasında nasıl çalışır

Kargo adımında PrestaShop, iMile fiyatını modülden ister. Yalnızca fiziksel ürünler dikkate alınır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Modül önce koşulları denetler: izin verilen ülkeler (Ignore shipping zones açıksa), sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0 olur ve iMile'a hiçbir istek gönderilmez.

Canlı tahmin açıkken modül iMile'a; gönderim ülkesini, eyaletini ve şehrini, hedef ülkeyi, eyaleti, şehri ve posta kodunu, sepet ağırlığını kg cinsinden, boyutu cm³ cinsinden (ürün boyutlarından), sepet değerini, iMile servisini ve mal kategorisini gönderir. Tahmin her zaman kapıda ödeme ücretleri hariç olacak şekilde peşin ödemeli olarak istenir. Canlı tahmin, müşteri şehir içeren bir teslimat adresi girdikten sonra ve sepetteki her ürünün 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ı ya da sunucu hatasından sonra iMile 2 dakika sorgulanmaz; reddedilen anahtarlardan sonra 5 dakika sorgulanmaz, böylece ödeme sayfası her yenilemede iMile'ı beklemez. API zaman aşımı 12 saniyedir. Süresi dolmuş erişim belirteci otomatik olarak yenilenir.

Tahmin, döviz kurlarınızla mağazanın varsayılan 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 taşıyıcı gizlenir. Nedeni günlüğe yazılır. Fiyat varsayılan para biriminizde hesaplanır ve ardından müşterinin sepet para birimiyle gösterilir.

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

Modül yalnızca tarifeleri hesaplar. iMile gönderisi oluşturmaz, AWB etiketi yazdırmaz, kurye talep etmez, paketleri takip etmez, kapıda ödeme tahsilatlarını mutabakat yapmaz ve teslim noktası ya da dolap sunmaz. Gönderimler için iMile portalını kullanın.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox iMile lisans bloğu, Modules > Module Manager > VibeFox iMile > 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 tarihi ve alan adınızı) ve Check now düğmesini (durumu yeniden kontrol etmek için), Change key düğmesini (başka bir anahtar girmek için) ve Remove key düğmesini (anahtarı bu mağazadan kaldırmak için) gösterir. Bunların altında Product: presta-shipping-imile satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri arka ofis dilini takip eder (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedeni gösterir, örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. 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ızdan serbest bırakın.

Etkin bir anahtar olmadan iMile taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret hesaplanmaz. PrestaShop vitrini arka ofise giriş yaptığınızı bilmez, bu yüzden taşıyıcı sizden de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında 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 için yenileme gerekir. Arka ofiste ç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

iMile ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable iMile 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üşterinin grubunu kapsadığını kontrol edin ya da Ignore shipping zones seçeneğini açıp Countries alanını kontrol edin. Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Ülkenin ya da * satırının Price table içinde bir satırı olduğunu, ya da Price for countries not in the table değerinin ayarlandığını kontrol edin. Ürünler ürün sayfasında belirli taşıyıcılarla da sınırlandırılmış olabilir.

iMile tahmini yerine tablo fiyatı görünüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Yaygın nedenler: Live estimate kapalıdır, anahtarlar eksiktir, müşteri henüz bir şehir girmemiştir, iMile şehir yazımını tanımıyordur, ürünlerin ağırlığı yoktur, hedef para birimi için döviz kuru yoktur ya da bir API hatası vardır. Ayarların üstündeki uyarıları da kontrol edin.

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

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

Şehir adları eşleşmiyor: şehir adları iMile şehir listesiyle eşleşmelidir. Geliştiriciler bunları actionVfdImileLiveRequest kancasıyla, ülke kodlarını ise actionVfdImileLiveCountryCode kancasıyla eşleyebilir.

Fiyatlar yanlış para biriminde: fiyat tablosu mağazanın varsayılan para birimindedir. AED, SAR veya MXN tarifesini girerken çevirin. Canlı tahminler Exchange rates ile çevrilir.

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

Bir değişiklikten sonra tahminler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış iMile tahminlerini temizler.

Sayfa iMile taşıyıcısının bulunamadığını söylüyor: taşıyıcı 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.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox iMile 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ış tahminler ve erişim belirteçleri her zaman silinir. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar ile 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 kurmak, taşıyıcının daha önceki durumunu geri yükler.

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