VibeFox GIG Logistics for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

GIG Logistics API kimlik bilgileri (yalnızca canlı fiyatlar için): canlı fiyatlar, GIG Logistics üçüncü taraf API'sini kullanır. GIG Logistics, ticari müşterilerine bir API kullanıcı adı (genellikle bir e-posta adresi) ve şifre verir. Bunları GIG Logistics geliştirici sayfasından (giglogistics.com/developer) talep edin. Test kimlik bilgileri yalnızca test API'siyle çalışır. Yalnızca fiyat tablosunu ve yedek ücreti kullanıyorsanız API kimlik bilgilerine ihtiyacınız yoktur.

Mağazanızda Nijerya: canlı fiyatlar yalnızca Nijerya'daki teslimat adresleri için istenir; bu nedenle Nijerya ülkesi International > Locations > Countries altında mevcut ve etkin olmalıdır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox GIG Logistics modülünü bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üstündeki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Fiyat tablosunu ve/veya yedek ücreti doldurun. Canlı fiyatlar için ayrıca API kullanıcı adı ve şifresini, alım telefonunu, şehri ve eyaleti, varsayılan para biriminiz NGN değilse para birimi dönüşüm oranını girin (bkz. Yapılandırma). Save düğmesine tıklayın.

5. Nigerian states alanında Add Nigerian states düğmesi görünüyorsa üzerine tıklayın (bkz. Yapılandırma).

Kurulumda modül, Courier delivery teslimat süresi metniyle GIG Logistics taşıyıcısını oluşturur. Taşıyıcı Nijerya bölgesine (varsayılan bir mağazada Afrika) ve tüm müşteri gruplarına bağlanır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers altında değiştirebilirsiniz. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox GIG Logistics > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt ayrıca önbelleğe alınmış GIG Logistics fiyatlarını, API jetonlarını ve adres koordinatlarını temizler.

Bölümlerin üstünde, canlı fiyatlar kullanılamadığında sayfa uyarılar gösterir: API kullanıcı adı ve şifresinden yalnızca biri girilmiştir, Sender phone veya alım şehri ve eyaleti eksiktir ya da varsayılan para biriminiz NGN değildir ve Currency conversion rate ayarlanmamıştır. Ayrıca GIG Logistics taşıyıcısı bulunamadığında ve mağazanızın ağırlık birimi (International > Localization > Local units) modülün bilmediği bir birimse uyarır; bu durumda ürün ağırlıkları kg olarak okunur. Kaydederken hatalı bir sayı (negatif bir tutar, 0 olan bir Currency conversion rate, -90 ile 90 aralığının dışında bir enlem, -180 ile 180 aralığının dışında bir boylam), Max weight (kg) değerinden büyük bir Min weight (kg), boş veya geçersiz bir Method title ya da bilinmeyen bir vergi kuralı bildirilir ve hiçbir şey kaydedilmez.

General

Bu sayfadaki ayarlar taşıyıcının tüm bölgeleri için geçerlidir.

Enable/Disable: taşıyıcıyı açar veya kapatır. Shipping > Carriers içindeki taşıyıcı durumuyla aynı anahtardır.

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

Tax: taşıyıcının vergi kuralı veya No tax. Bir vergi kuralı, kargo vergisinizi maliyetin üzerine ekler. GIG fiyatı tahsil etmek istediğiniz her şeyi zaten içeriyorsa No tax seçin.

GIG Logistics API (live prices) (isteğe bağlı)

API kimlik bilgileriyle, her Nijerya adresi için fiyat GIG Logistics'ten istenir. Kimlik bilgileri yoksa veya API fiyat vermezse fiyat tablosu ve yedek ücret kullanılır.

API username: GIG Logistics üçüncü taraf API kullanıcı adınız; genellikle e-posta adresiniz.

API password: GIG Logistics üçüncü taraf API şifreniz. Yalnızca API'ye giriş yapmak için kullanılır ve asla günlüğe yazılmaz. 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. Şifreyi kaldırmak için API username alanını temizleyip kaydedin.

Test mode: GIG Logistics test (dev) API'sini kullanır. Test kimlik bilgileri yalnızca test API'siyle çalışır. Gerçek fiyatlar için kapatın. Varsayılan: kapalı.

Currency conversion rate: GIG Logistics fiyatları NGN cinsinden verir. Mağazanızın varsayılan para birimi NGN değilse, bir NGN'nin varsayılan para biriminizle değerini girin (1 NGN = ? para biriminiz, örneğin 0.0006). Oran 0'dan büyük olmalıdır. Bu oran olmadan GIG canlı fiyatları kullanılmaz. Varsayılan para biriminiz NGN ise alan bunu belirtir ve gerekmez. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Pickup (sender) address

GIG Logistics'in Nijerya'da paketleri aldığı yer. Mağazanız Nijerya'daysa boş bırakılan cadde, şehir ve eyalet alanları Shop Parameters > Contact > Stores altındaki mağaza adresini kullanır.

Sender name: GIG Logistics'e gönderilen gönderici adı. Boşsa mağaza adı kullanılır.

Sender phone: telefon numaranız, örneğin 08030000000. GIG Logistics, canlı fiyatlar için bunu zorunlu tutar.

Street address: alım cadde adresi.

City / area: alım şehri veya bölgesi, örneğin Victoria Island. Canlı fiyatlar için zorunludur.

State: alım adresinin Nijerya eyaleti; 37 eyalet arasından seçilir. Varsayılan seçenek Shop state (Shop parameters > Contact > Stores), mağaza adresinin eyaletini kullanır. Canlı fiyatlar için zorunludur.

Pickup latitude: alım noktasının isteğe bağlı harita enlemi, örneğin 6.4281. GIG Logistics fiyatları mesafeye göre belirler. Boşsa koordinatlar adresten aranır.

Pickup longitude: alım noktasının isteğe bağlı harita boylamı, örneğin 3.4219.

Address lookup: adreslerin harita koordinatlarını OpenStreetMap (Nominatim) ile bulur. GIG Logistics fiyatı alım ve teslimat koordinatlarından hesaplar. Müşterinin cadde, şehir ve eyaleti nominatim.openstreetmap.org adresine gönderilir ve sonuçlar 30 gün önbelleğe alınır. Bu seçenek olmadan yalnızca adres metni gönderilir ve GIG Logistics fiyat vermeyebilir. Varsayılan: açık.

Nigerian states: teslimat adresinin eyaleti GIG Logistics'e ve adres aramasına gönderilir. PrestaShop'ta varsayılan olarak Nijerya eyaleti yoktur; bunlar olmadan yalnızca cadde ve şehir kullanılır. Add Nigerian states düğmesi 37 eyaleti (LA, FC vb. kodlarla) ekler, Nijerya için Contains states seçeneğini açar ve Nijerya adres formuna eyalet alanını ekler. Zaten var olan eyaletler (kod veya ada göre) iki kez eklenmez. Her şey hazır olduğunda alan, Nijerya adresleri için kaç eyalet bulunduğunu gösterir. Düğmeye tıklayana kadar hiçbir şey değişmez.

Price table and fallback

Diğer ülkeler için, canlı fiyatlar yapılandırılmadığında veya GIG Logistics fiyat vermediğinde kullanılır. Fiyatlar mağazanızın varsayılan para biriminde ve vergi hariçtir.

Country prices: ülke başına bir temel fiyat içeren bir tablo. 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 * Any other country seçin. XS (1 kg'a kadar), S (2 kg'a kadar), M (3 kg'a kadar), L (5 kg'a kadar) ve XL (5 kg'ın üzeri) sütunları isteğe bağlı ağırlık kademesi fiyatlarıdır: 0'dan büyük bir kademe fiyatı, o kademedeki sepetler için temel fiyatın yerini alır. 0 fiyat ücretsiz kargo anlamına gelir. Boş fiyat hücreleri 0 olarak kaydedilir; bu yüzden eklediğiniz her satıra temel fiyatı girin. Bir ülke iki kez görünürse sonraki satır tutulur. Düzeltilen değerler kaydettikten sonra bir uyarıda listelenir. Satırı olmayan ülkeler (* satırı yoksa) tablodan fiyat almaz.

Fallback cost: GIG Logistics da tablo da fiyat vermediğinde kullanılır. Boşsa taşıyıcı bu durumda gizlenir.

Table / fallback price is: Per order fiyatı bir kez tahsil eder. Per item (multiplied by the number of items) fiyatı sepetteki ürün sayısıyla çarpar. Canlı GIG fiyatları her zaman tüm sipariş içindir.

Conditions

Free shipping from: bu tutardan itibaren kargonun ücretsiz olduğu sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergi hariç). Boşsa hiçbir zaman ücretsiz değildir.

Minimum subtotal: taşıyıcıyı yalnızca sepet ara toplamı bu tutara ulaştığında gösterir. Boşsa her zaman gösterilir.

Min weight (kg): kg cinsinden minimum sepet ağırlığı. Ürün ağırlıkları mağazanızın ağırlık biriminden dönüştürülür. 0 sınır olmadığı anlamına gelir.

Max weight (kg): kg cinsinden maksimum sepet ağırlığı. Varsayılan: 30. 0 sınır olmadığı anlamına gelir.

Availability without shipping zones

Ignore shipping zones: taşıyıcının bölgeleri içermese bile, aşağıdaki ülkeler için taşıyıcıyı sunar. Açtığınızda taşıyıcı tüm etkin bölgelere bağlanır ve daha sonra oluşturulan bölgeler de bağlanır. Kapattığınızda taşıyıcı önceki bölgelerini geri alır.

Countries: bu mod için hedef ülkeler. Boşsa, gönderim yaptığınız tüm ülkeler geçerlidir. Yalnızca Ignore shipping zones ile kullanılır.

Advanced

Debug log: fiyat hesaplamalarını modül klasöründeki logs/vfd_gigl_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları, günlük kapalı olsa bile her zaman kaydedilir. Şifreler, jetonlar veya müşteri adresleri yazılmaz.

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

Remove data on uninstall: açıksa modül kaldırıldığında modül ayarları, taşıyıcı, önbellekler ve günlükler silinir. Kapalıysa, yeniden kurulum için her şey saklanır. Siparişler her zaman saklanır.

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

Kargo adımında PrestaShop, modülden GIG Logistics fiyatını ister. Yalnızca kargo gerektiren ürünler sayılır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül önce koşulları kontrol eder: teslimat ülkesi (Ignore shipping zones ile), sepet ağırlığı ve minimum ara toplam. Ara toplam Free shipping from değerine ulaşırsa fiyat 0 olur ve GIG Logistics'e hiçbir istek gönderilmez.

Ardından fiyat, fiyat veren ilk kaynaktan alınır. Önce canlı GIG Logistics fiyatı: API kimlik bilgileri girilmişse, adres Nijerya'daysa, adreste şehir veya eyalet varsa, alım telefonu, şehri ve eyaleti ayarlanmışsa ve varsayılan para birimi NGN olmayan mağazalar için bir dönüşüm oranı tanımlıysa. Modül GIG Logistics API'sine giriş yapar; alım ve teslimat adreslerini ve koordinatlarını, ayrıca adları, miktarları, ağırlıkları ve değerleriyle sepet ürünlerini gönderir. Ağırlığı olmayan ürünler 1 kg olarak gönderilir. Fiyat, bisikletle teslimat için istenir. İkinci olarak Country prices tablosu. Üçüncü olarak Fallback cost. Hiçbiri fiyat vermezse taşıyıcı o sepet için gizlenir. Fiyat varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Her GIG yanıtı 1 saat önbelleğe alınır, bu yüzden aynı sepet yeni bir istek tetiklemez. Başarısız bir istek veya başarısız bir giriş 10 dakika önbelleğe alınır, böylece ödeme sayfası her yenilemede GIG Logistics'i beklemez. Giriş jetonu 30 dakika tutulur ve GIG reddettiğinde otomatik olarak yenilenir. API zaman aşımı 10 saniye, adres arama zaman aşımı 5 saniyedir.

GIG Logistics bir hata veya sıfır fiyat döndürürse müşteri hiçbir hata görmez. Tablo veya yedek ücret kullanılır ve hata hata ayıklama günlüğüne yazılır.

Shipping > Carriers içinde taşıyıcıyı siparişleri olduktan sonra düzenlerseniz PrestaShop onu yeni bir taşıyıcı sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca fiyat hesaplar. GIG Logistics gönderileri, sevk belgeleri veya etiketleri oluşturmaz, kurye alımı ayarlamaz, paketleri takip etmez ve müşterilerin bir hizmet merkezi seçmesine izin vermez. Siparişler her zamanki gibi GIG Logistics hesabınız üzerinden gönderilir. Canlı fiyatlar yalnızca Nijerya adresleri için istenir. Diğer ülkeler için fiyat tablosunu kullanın.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox GIG Logistics lisans bloğu, Modules > Module Manager > VibeFox GIG Logistics > Configure bölümünde ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve domaininiz) 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: presta-shipping-gig-logistics 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 modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri back office 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 tarihli License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir domain hakkı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 yalnızca bir domainde çalışır: ana mağazanın domaini, çoklu mağaza kurulumunda da dahil. Anahtarı mağazadan kaldırmak domain hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan GIG Logistics taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop vitrini, back office'e 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 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, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

GIG Logistics ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers içinde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını doğrulayın; ya da Ignore shipping zones seçeneğini açıp Countries alanını kontrol edin. Ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Tablonun (ülke veya *) ya da Fallback cost değerinin ülke için bir fiyat verdiğinden emin olun. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlandırılabilir.

Fiyat GIG Logistics'ten değil, tablodan geliyor: canlı fiyatlar için API kullanıcı adı ve şifresi, Sender phone, alım şehri ve eyaleti, şehir veya eyalet içeren Nijerya teslimat adresi ve varsayılan para birimi NGN olmayan mağazalar için Currency conversion rate gerekir. Yapılandırma sayfasının üstündeki uyarılara bakın. Debug log seçeneğini açın, ödeme sayfasını yenileyin ve nedenini görmek için modül sayfasındaki Log alanına bakın. Başarısız bir istek 10 dakika sonra yeniden denenir.

Günlükte Login failed: GIG Logistics API kullanıcı adını veya şifreyi reddetti. Bunları kontrol edin ve Test mode seçeneğini doğrulayın: test kimlik bilgileri yalnızca test API'siyle çalışır. Hemen yeniden denemek için ayarları kaydedin.

GIG Logistics fiyat döndürmüyor: GIG fiyatları mesafeye göre belirler. Address lookup seçeneğini açık tutun veya Pickup latitude ve Pickup longitude değerlerini girin. Teslimat eyaletinin de gönderilmesi için Add Nigerian states düğmesine tıklayın. Canlıya geçmeden önce fiyatları GIG Logistics hesabınızla doğrulayın.

Alım şehri ve eyaleti uyarısı kalmaya devam ediyor: State alanından bir eyalet seçin ve City / area alanını doldurun. Mağaza adresi yalnızca mağaza ülkesi Nijerya olduğunda kullanılır; mağazanın eyaleti ise Nijerya eyaletleri eklenip Shop Parameters > Contact > Stores altında seçildikten sonra bilinir.

GIG fiyatının üzerine vergi ekleniyor: GIG fiyatı tahsil etmek istediğiniz her şeyi zaten içeriyorsa Tax seçeneğini No tax olarak ayarlayın.

Bir değişiklikten sonra fiyatlar eski görünüyor: modül sayfasındaki Save düğmesine tıklayın. Bu, önbelleğe alınmış fiyatları, jetonları ve koordinatları temizler.

Sayfa GIG Logistics taşıyıcısının bulunamadığını söylüyor: taşıyıcı Shipping > Carriers içinde silinmiştir. Yeniden oluşturmak için Modules > Module Manager içinde modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox GIG Logistics 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, jetonlar ve adres koordinatları her zaman kaldırılır. 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, kaydedilmiş taşıyıcıya önceki durumunu geri verir. Add Nigerian states ile eklenen Nijerya eyaletleri her iki durumda da mağazanızda kalır.

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