VibeFox Cargoson for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Cargoson hesabı (yalnızca canlı fiyatlar için): canlı fiyatlar, Cargoson'un fiyat API'sini kullanır. Taşıma ücreti fiyat sorguları, API erişimi olan bir Cargoson aboneliği gerektirir (yazım tarihi itibarıyla Advanced planı veya üzeri). API anahtarı Cargoson hesabınızda verilir; planınız API ayarlarını göstermiyorsa Cargoson destek ekibine başvurun. Fiyatlar, bu hesaba bağlı taşıyıcılardan ve fiyat listelerinden gelir. Yalnızca sabit fiyat kullanıyorsanız Cargoson hesabı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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Cargoson modülünü bulup Configure düğmesine tıklayın.

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

4. Kargo ücretinin nasıl hesaplanacağını seçin ve ilgili bölümleri doldurun: sabit fiyatlar ve canlı fiyatlar için API anahtarı ile toplama posta kodu (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, Delivery by the cheapest Cargoson carrier teslimat süresi metniyle Cargoson 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ünden 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 Cargoson > Configure. Ayarlar taşıyıcının tüm bölgeleri için geçerlidir. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Kaydettikten sonra Settings saved. Cached Cargoson prices were cleared. mesajını görürsünüz. Ondalık sayılar nokta veya virgülle girilebilir. Bir sayı alanı metin veya negatif bir sayı içeriyorsa, Currency conversion rate 0 ise, Minimum weight değeri Maximum weight değerinden büyükse, Method title 64 karakterden uzunsa, Price currency 3 harfli bir para birimi kodu değilse ya da fiyat tablosunun bir satırında geçersiz ülke kodu veya fiyat varsa hiçbir şey kaydedilmez ve sayfa bir hata gösterir. Modül mağazanın ağırlık birimini tanımıyorsa, kaydettikten sonra ürün ağırlıklarının kilogram olarak alındığını belirten bir uyarı çıkar; birimi International > Localization (Local units) bölümünde ayarlayın.

General

Enable Cargoson: taşıyıcıyı açar veya kapatır. 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: Cargoson. Zorunlu. Shipping > Carriers bölümündeki taşıyıcı adı da budur.

Shipping cost: fiyatın nasıl hesaplanacağı.

Canlı fiyatın eksik olmasının nedeni modül günlüğüne yazılır. Müşteriye hiçbir zaman gösterilmez.

Cargoson API (yalnızca canlı fiyatlar için gerekli)

API key: Cargoson hesabınızdaki API anahtarı. Yalnızca Cargoson'a gönderilir; müşterilere hiçbir zaman gösterilmez ve 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.

Remove the saved API key: kayıtlı bir anahtar olduğunda görünür. Seçeneği açın ve kaydedin; anahtar silinir.

Carrier: hangi fiyatların kullanılacağı. Müşteri tek bir ücret görür.

Package type code: fiyat sorgusuyla gönderilen Cargoson paket tipi kodu. Varsayılan: CLL. Cargoson API örnekleri EUR (EUR paleti) ve FIN (FIN paleti) kullanır. Koliler için Cargoson hesabınızın paket kodunu kullanın. Sipariş, toplam sepet ağırlığıyla tek bir paket olarak gönderilir.

Price currency: Cargoson hesabınızdaki fiyatların para birimi, 3 harfli kod olarak. Varsayılan: EUR. API, para birimi kodu olmadan tutarlar döndürür.

Currency conversion rate: yalnızca fiyat para birimi mağazanızın varsayılan para biriminden farklıysa gerekir: Cargoson para biriminden 1 birim = varsayılan para biriminizden X birim. Bu fiyatları reddetmek için boş bırakın; böylece müşteri hiçbir zaman yanlış para biriminde ödeme yapmaz.

Şuradan gönder (toplama adresi) (canlı fiyatlar için kullanılır)

Collection country: gönderdiğiniz ülke. Varsayılan olarak mağazanızın ülkesidir.

Collection postcode: gönderdiğiniz posta kodu. Cargoson bunu zorunlu tutar. Boşsa ve toplama ülkesi mağazanızın ülkesiyse, Shop Parameters > Contact > Stores bölümündeki mağaza posta kodu kullanılır.

Cargoson'a gönderilen toplama tarihi, mağaza saat dilimine göre bugündür; hafta sonlarında ise izleyen Pazartesi günüdür.

Sabit fiyatlar (Shipping cost Fixed prices olduğunda ve canlı fiyatlar için yedek olarak kullanılır)

Price per country and size: Country sütunu (2 harfli kod), Price sütunu ve mağazanızın varsayılan para biriminde, vergi hariç, sepet ağırlığına göre fiyatlar içeren bir tablo: XS 1 kg'a kadar, S 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar, XL 5 kg üzeri. Boş veya 0 olan bir boyut fiyatı Price sütununu kullanır; boş bir Price, o boyut için sabit fiyat olmadığı anlamına gelir. 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 ülke kodu olarak * kullanın. Satırı olmayan ülkeler (* satırı yoksa) sabit fiyat almaz, bu nedenle taşıyıcı onlar için gizlenir. Fiyatlar 0 veya daha büyük sayılar olmalıdır. Boş satırlar yok sayılır.

Fixed price applies: Per order fiyatı bir kez alır. Per item (price × quantity) fiyatı sepetteki ürün adediyle çarpar. Cargoson canlı fiyatları her zaman gönderi başınadır.

Koşullar

Minimum weight: taşıyıcıyı bu sepet ağırlığının altında gizler (kg cinsinden). 0, sınır olmadığı anlamına gelir.

Maximum weight: taşıyıcıyı bu sepet ağırlığının üzerinde gizler (kg cinsinden). Varsayılan: 25. 0, sınır olmadığı anlamına gelir.

Minimum order amount: taşıyıcıyı yalnızca sepet ara toplamı (indirimlerden sonra, vergilerden önce) bu tutarın en az üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Free shipping: aşağıda belirtilen sipariş tutarına ulaşıldığında ücretsiz teslimatı açar.

Free shipping from: ücretsiz teslimatın başladığı sepet ara toplamı (indirimlerden sonra, vergilerden önce). Yalnızca Free shipping açıkken kullanılır.

Tax: taşıyıcının vergi kuralı veya No tax. Cargoson'daki taşıma fiyatları genellikle vergisizdir (KDV hariç). Fiyatlarınız zaten vergi içeriyorsa No tax seçin.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde taşıyıcı, Shipping > Carriers bölümünde kendisine atanan bölgelerde sunulur.

Ignore shipping zones: taşıyıcıya hangi bölgelerin atanmış olduğuna bakmaksızın, aşağıdaki ülkeler için Cargoson'u sunar. Açıp kaydettiğinizde taşıyıcı tüm bölgelere atanır; daha sonra oluşturulan bölgeler de atanır. Kapatıp kaydettiğinizde taşıyıcı önceki bölgelerini geri alır.

Countries: bu mod için hedef ülkeler. Teslimat yaptığınız tüm ülkeleri (etkin ülkeler) kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: her fiyat hesaplamasını modül klasöründeki logs/vfd_cgs_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API hataları ve reddedilen fiyatlar bu seçenek kapalıyken bile her zaman kaydedilir. API anahtarı ve müşterinin posta kodu hiçbir zaman kaydedilmez.

Log: günlüğü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ırdığınızda Cargoson ayarları, taşıyıcı, önbellekteki fiyatlar, sipariş teklifleri ve günlükler silinir. Kapalıysa yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop, Cargoson fiyatını modülden ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Ürün ağırlıkları mağazanızın birimden kilograma çevrilir. Modül önce koşulları kontrol eder: teslimat ülkesi, sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0 olur ve Cargoson'a istek gönderilmez.

Sabit modda fiyat tablodan alınır. Canlı modlarda modül Cargoson'a toplama tarihini, toplama ülkesini ve posta kodunu, teslimat ülkesini ve posta kodunu ile paket tipi kodu ve toplam sepet ağırlığını içeren tek bir paket gönderir (en az 0,1 kg). Canlı fiyat yalnızca teslimat adresinde posta kodu varsa istenir. Cargoson taşıyıcılarınızın fiyatlarını döndürür; modül en ucuzunu seçer (seçili taşıyıcı varsa onun arasından) ve gerekirse mağazanızın varsayılan para birimine çevirir. Fiyat varsayılan para biriminizde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Her yanıt 1 saat önbelleğe alınır; böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 10 dakika önbelleğe alınır; böylece ödeme sayfası her yenilemede Cargoson'u beklemez. API zaman aşımı 10 saniyedir. Cargoson bir hata döndürürse, rota için fiyat döndürmezse veya dönüşüm kuru olmadan başka bir para biriminde fiyat döndürürse müşteri hiçbir hata görmez. Taşıyıcı gizlenir veya yedek modda sabit fiyat kullanılır.

Siparişleri olan bir taşıyıcıyı Shipping > Carriers bölümünde düzenlerseniz, PrestaShop bunu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca fiyat hesaplar. Cargoson'da gönderi veya rezervasyon oluşturmaz, etiket yazdırmaz ve paketleri takip etmez; müşteriler paket noktası veya teslim noktası seçemez. Sepet, toplam ağırlıklı tek bir paket olarak fiyatlandırılır; paket boyutları gönderilmez. Yalnızca en düşük fiyat gösterilir, taşıyıcı listesi gösterilmez.

Siparişler

Bir Cargoson siparişinin sayfasında, ödeme sayfasında hesaplanan fiyatı gösteren bir Cargoson shipping bloğu bulunur:

Carrier, Service ve Cargoson service ID: canlı fiyat kullanıldığında gösterilen, teklif edilen Cargoson taşıyıcısı ve hizmeti.

Price source: Cargoson live price, Fixed price veya Free shipping threshold.

Calculated price (excl. tax): mağazanızın varsayılan para birimindeki fiyat.

Teklif, sipariş verildiğinde kaydedilir ve sonradan değişmez. Gönderiyi Cargoson'da veya Cargoson'un kendi entegrasyonlarıyla rezerve edin.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Cargoson lisans bloğu, Modules > Module Manager > VibeFox Cargoson > Configure sayfasındaki ilk bloktur ve ayarların üstündedir. 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 tarih ve alan adınız) ve şu düğmeleri gösterir: 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. Bunların altında Product: presta-shipping-cargoson satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri yönetici paneli 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ı 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 Cargoson taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve tarife hesaplanmaz. PrestaShop vitrini, yönetici paneline giriş yaptığınızı bilmez; bu nedenle taşıyıcı sizin için de gizlenir: modülü anahtar satın almadan önce ayarlayabilirsiniz, 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 sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici panelinde çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, ardından haftada bir. Bir cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Cargoson ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Cargoson 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 (veya Ignore shipping zones açık olup ülke Countries içinde olmalıdır). Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Sabit modda, ülkenin veya * satırının sepet boyutu için bir fiyatı olduğunu kontrol edin. Ürünler, ürün sayfasında belirli taşıyıcılarla da sınırlandırılmış olabilir.

Canlı fiyatlar görünmüyor: modül sayfasındaki Log alanına bakın. API hataları her zaman kaydedilir; her hesaplamayı görmek için Debug log seçeneğini açın. Yaygın nedenler: henüz teslimat posta kodu girilmemiş, toplama posta kodu yok, API anahtarı reddedilmiş (yanlış veya süresi dolmuş anahtar ya da Cargoson planınızda API erişimi yok), rota veya ağırlık için taşıyıcı yok ya da başka bir para biriminde fiyat var. Cargoson live prices, fixed prices if the API fails seçeneğiyle, siz sorunu düzeltirken müşteriler yine sabit fiyatı görür.

Cargoson paket tipini reddediyor: Cargoson hesabınızın Package type code alanında kullandığı paket kodunu kullanın. Neden günlükte görünür.

Başka bir para birimindeki fiyat reddediliyor: Price currency değerini Cargoson fiyatlarınızın para birimine ayarlayın ve Currency conversion rate değerini girin.

Kargo üzerinden vergi iki kez alınıyor: Cargoson fiyatlarınız zaten KDV içeriyor. Tax değerini No tax olarak ayarlayın.

Bir değişiklikten sonra fiyatlar güncel görünmüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbellekteki Cargoson fiyatlarını temizler.

Sayfa Cargoson taşıyıcısının bulunamadığını söylüyor: taşıyıcı Shipping > Carriers bölümünde silinmiş. 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 Cargoson yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbellekteki fiyatlar her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur) ve ayarlar, sipariş teklifleri ile günlük kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır, ayarlar ve verilmiş siparişlerin teklifleri saklanır, yalnızca siparişi olmayan sepetlerin teklifleri kaldırılır. Modülü yeniden kurmak, kayıtlı taşıyıcıya önceki durumunu geri verir; bu nedenle Reset, devre dışı bıraktığınız bir taşıyıcıyı yeniden açmaz.

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