VibeFox The Courier Guy for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

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

ShipLogic API anahtarı (anlık tarifeler ve locker'lar için): The Courier Guy, ShipLogic platformu üzerinde çalışır. The Courier Guy kurye portalınızda Settings > API Keys altında bir API anahtarı oluşturun (kurumsal hesap). Anahtar olmadan yalnızca fiyat tablosu kullanılır ve locker taşıyıcısı sunulmaz.

Güney Afrika'ya gönderim: anlık tarifeler ve locker'lar yalnızca Güney Afrika adresleri içindir. Güney Afrika, mağazanın aktif bir ülkesi olmalıdır (International > Locations > Countries).

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

1. Yönetici 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 ya da daha sonra modül listesinde VibeFox The Courier Guy öğesini bulup Configure düğmesine tıklayın.

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

4. ShipLogic API key alanını doldurun. Anlık tarifeler için gönderici adresini (cadde, şehir, il, posta kodu) ve mağaza para biriminiz ZAR değilse ZAR conversion rate değerini girin.

5. Fiyat tablosunu ve/veya yedek ücreti doldurun ve Save düğmesine tıklayın.

6. Anlık kurye tarifeleri için, sayfa Güney Afrika adreslerinde il bulunmadığını belirtiyorsa Advanced bölümündeki Add South African provinces düğmesine tıklayın.

Kurulumda modül iki taşıyıcı oluşturur: The Courier Guy (teslimat süresi metni The Courier Guy courier delivery to your door) ve The Courier Guy locker (Delivery to a TCG locker of your choice). İkisi de aktiftir, Güney Afrika bölgesine ve tüm müşteri gruplarına bağlıdır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu ve boyut sınırlarını Shipping > Carriers içinde 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 The Courier Guy > Configure. 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ış tarifeleri, locker'ları ve son ShipLogic hatasını temizler. Sayfanın üstündeki uyarılar; Güney Afrika'nın aktif bir ülke olmadığını, API anahtarının, ZAR dönüşüm kurunun veya gönderici adresinin eksik olduğunu, ne fiyat tablosu ne de yedek ücret bulunduğunu, Güney Afrika adreslerinde il olmadığını, mağazanın ağırlık veya boyut biriminin modül tarafından tanınmadığını ya da son ShipLogic isteğinin (tarih ve hatasıyla birlikte) başarısız olduğunu size bildirir. Geçersiz bir sayı (örneğin negatif) kaydedilmez: sayfa alanı belirtir ve önceki değeri korur.

Genel

Courier to the door: kurye taşıyıcısını açar veya kapatır. Bu, Shipping > Carriers içindeki taşıyıcı durumuyla aynı anahtardır.

Courier carrier name: ödeme sayfasındaki kurye taşıyıcısının adı. Varsayılan: The Courier Guy. Zorunlu.

TCG locker: locker taşıyıcısını açar veya kapatır. Müşteri ödeme sayfasında bir locker seçer. Yalnızca Güney Afrika adresleri için ve yalnızca ShipLogic API anahtarıyla sunulur.

Locker carrier name: ödeme sayfasındaki locker taşıyıcısının adı. Varsayılan: The Courier Guy locker. Zorunlu.

Tax status: her iki taşıyıcının vergi kuralı. Taxable: <tax rule>: anlık tarifeler KDV'siz alınır ve PrestaShop seçili kuralın kargo vergisini ekler. None: anlık tarifeler KDV dahil alınır.

ShipLogic API (anlık tarifeler ve locker'lar)

API key: The Courier Guy portalındaki ShipLogic API anahtarınız. Müşterilere asla 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. Kayıtlı API anahtarını kaldırmak için Remove the saved API key kutusunu işaretleyin ve kaydedin.

Account ID: isteğe bağlı. ShipLogic hesap kimliği (sayısal); yalnızca anahtarınız birden fazla hesaba erişebiliyorsa. Sayı olmayan bir değer kaydedilmez.

Anlık tarifeler (Güney Afrika adresleri için; anlık tarife yoksa fiyat tablosu kullanılır)

Price source: fiyatın kaynağı.

ZAR conversion rate: ShipLogic, Güney Afrika randı (ZAR) cinsinden fiyat verir. Mağazanızın varsayılan para birimi ZAR değilse, 1 ZAR'ın para biriminizde ne kadar olduğunu girin, örneğin 0.05. Bu değer olmadan anlık tarifeler kullanılmaz ve fiyat tablosu uygulanır. Mağaza para biriminiz ZAR ise alanı boş bırakın. Kur otomatik olarak güncellenmez.

Gönderici adresi (anlık tarifeler için) (The Courier Guy'ın Güney Afrika'da paketleri topladığı yer; anlık tarifeler için cadde, şehir, il ve posta kodu gerekir)

Sender company: şirketinizin adı.

Sender street address: örneğin 12 My Road.

Sender suburb: gönderici adresinin semti.

Sender city: gönderici adresinin şehri.

Sender province: listeden Güney Afrika ilini seçin.

Sender postal code: gönderici adresinin posta kodu.

Fiyat tablosu (mağazanın varsayılan para biriminde, KDV hariç kendi fiyatlarınız: Price table only ile, Güney Afrika dışında ve anlık tarife olmadığında kullanılır; ondalık virgül veya nokta kabul edilir)

Calculation type: yalnızca fiyat tablosuna uygulanır. Anlık tarife her zaman tüm sipariş içindir.

Prices by weight: Price sütunu ve XS (1 kg'a kadar), S (2 kg'a kadar), M (3 kg'a kadar), L (5 kg'a kadar) ve XL (5 kg üzeri) ağırlık aralıkları olan bir ülke tablosu. Satır eklemek için Add row düğmesine (yeni satır Güney Afrika ile başlar), satır silmek için çöp kutusu simgesine tıklayın. Boş veya 0 olan aralık Price sütununu kullanır. 0 fiyat ücretsiz kargo anlamına gelir. * Any country satırı, kendi satırı olmayan ülkelere ve hiç fiyatı olmayan bir ülke satırına uygulanır. Sayı olmayan bir fiyat silinir ve sayfa bunları listeler.

Fallback cost: ne anlık tarife ne de tablo fiyatı varsa kullanılır. Bu durumda taşıyıcıları gizlemek için boş bırakın.

Koşullar (her iki taşıyıcı)

Min weight (kg): sepet ağırlığı bu değerin altındaysa taşıyıcıları gizler. 0, sınır olmadığı anlamına gelir.

Max weight (kg): sepet ağırlığı bu değerin üzerindeyse taşıyıcıları gizler. Varsayılan: 30. 0, sınır olmadığı, boş ise 30 kg anlamına gelir. Min weight (kg) değeri Max weight (kg) değerinden büyükse sayfa bir uyarı gösterir ve her iki sınır önceki değerlerini korur.

Minimum order amount: taşıyıcıları yalnızca bu sepet ara toplamından itibaren gösterir (kargo gerektiren ürünler, KDV hariç, indirimlerden sonra). Her zaman göstermek için boş bırakın.

Free shipping from: teslimatın ücretsiz olduğu sepet ara toplamı. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın. Ara toplam bu değere ulaştığında taşıyıcılar 0 fiyatla gösterilir ve tarife için ShipLogic'e istek gönderilmez.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde taşıyıcılar, Shipping > Carriers içinde bağlı oldukları kargo bölgelerinde sunulur.

Ignore shipping zones: aşağıda belirtilen teslimat türünün taşıyıcısını, bölgeleri bu ülkeleri içermese bile, aşağıda belirtilen ülkeler için sunar. Taşıyıcı her aktif bölgeye bağlanır, sonradan oluşturulanlara da. Seçeneği tekrar kapattığınızda, daha önce sahip olduğu bölgeleri geri alır.

Delivery type without zones: Courier to the door veya TCG locker (customer chooses a locker). Yalnızca Ignore shipping zones ile kullanılır.

Countries: bu mod için hedef ülkeler. Tüm ülkelere izin vermek için boş bırakın. Locker'lar yalnızca Güney Afrika'da sunulur.

Gelişmiş

South African provinces: PrestaShop'ta Güney Afrika illeri yoktur, ancak anlık kurye tarifesi adresin ilini gerektirir. Add South African provinces, 9 ili (EC, FS, GP, KZN, LP, MP, NC, NW, WC) Güney Afrika'nın eyaletleri olarak ekler ve Güney Afrika adreslerinde eyalet alanını gösterir. Zaten var olan iller tekrar eklenmez. O zamana kadar kurye fiyat tablosunu alır.

Debug log: hata ayıklama mesajlarını modül klasöründeki logs/vfd_tcgr_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarı ve müşteri verileri hiçbir zaman günlüğe yazılmaz.

Log: günlüğün boyutunu ve son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa modülü kaldırdığınızda ayarları ve taşıyıcıları siler. Kapalıysa kaldırma yalnızca taşıyıcıları kapatır. Siparişlerde kaydedilen locker'lar her zaman korunur.

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

Kargo adımında PrestaShop, modülden her taşıyıcının fiyatını 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ı kontrol eder: sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0'dır.

Courier to the door: modül, gönderici adresinizden müşterinin adresine en ucuz hizmeti ShipLogic'ten ister. Adreste cadde, şehir, il ve posta kodu bulunmalıdır. O zamana kadar fiyat tablosu kullanılır.

TCG locker: anlık tarife, müşterinin şehrine en yakın locker'a kadar olan en ucuz kapıdan-locker'a hizmetidir. Müşterinin seçtiği locker için yeniden hesaplanmaz. Locker taşıyıcısı yalnızca Güney Afrika adresleri için ve yalnızca API anahtarıyla görünür.

Tüm sipariş tek bir paket olarak fiyatlandırılır: toplam ağırlık, en uzun uzunluk ve genişlik ile üst üste konan yükseklikler. Boyutu olmayan ürünler 10 cm'lik küp sayılır. Ağırlıklar ve boyutlar mağazanızın birimlerinden dönüştürülür. Rand tutarı varsayılan para biriminize çevrilir ve ardından müşterinin sepet para biriminde gösterilir.

ShipLogic istekleri 12 saniye sonra zaman aşımına uğrar. Tarifeler 1 saat, locker'lar 6 saat ve hatalar 10 dakika önbelleğe alınır; böylece yavaş bir API her ödeme sayfası yenilemesini yavaşlatmaz. Anlık tarife yoksa fiyat tablodan, ardından Fallback cost değerinden alınır. Hiçbiri geçerli değilse taşıyıcı gizlenir. API hataları müşteriye hiçbir zaman gösterilmez.

Taşıyıcılar Classic ve Hummingbird temalarında çalışır. Bir taşıyıcının siparişleri olduktan sonra Shipping > Carriers içinde düzenlerseniz, PrestaShop onu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül gönderi oluşturmaz, taşıma belgesi veya etiket üretmez ve takibi otomatik olarak güncellemez. Bir locker haritası yoktur: locker'lar bir listeden seçilir. Anlık tarifeler ve locker'lar yalnızca Güney Afrika içindir. Diğer ülkeler fiyat tablosunu alır. Taşıyıcı başına yalnızca bir tarife (en ucuz hizmet seviyesi) gösterilir; ödeme sayfasında hizmet seviyesi, sigorta veya ek hizmet seçimi yoktur.

Teslim noktaları

Müşteri locker taşıyıcısını seçtiğinde, onun altında bir locker seçici görünür. Teslimat adresinin şehri için ShipLogic'in döndürdüğü locker'ları, en yakından başlayarak listeler. Müşteri başka bir şehir, semt veya posta kodu yazabilir ve Search düğmesine tıklayabilir. Müşteri devam edebilmek için bir locker seçmelidir; aksi halde kargo adımı Please choose a The Courier Guy locker. uyarısını gösterir.

Locker, sipariş verildiğinde de ShipLogic'in listesine karşı sunucuda yeniden doğrulanır. Adı ve sağlayıcısı tarayıcıdan değil, ShipLogic'ten alınır. Seçim sepet için tutulur ve teslimat adresi değiştiğinde sıfırlanır.

ShipLogic'e ulaşılamazsa seçici, locker'ların yüklenemediğini ve mağazanın locker konusunda müşteriyle iletişime geçeceğini belirtir. Sipariş bu durumda locker olmadan verilebilir. Sipariş, yönetici sipariş sayfasında işaretlenir: Not chosen - ShipLogic was unavailable at checkout. Agree the locker with the customer.

Siparişler

Seçilen locker (ad, kimlik ve sağlayıcı) siparişle birlikte kaydedilir. Yönetici sipariş sayfasındaki The Courier Guy bloğunda, sipariş onay sayfasında, müşterinin sipariş ayrıntılarında ve sipariş onay e-postasında gösterilir. Mağazanın "yeni sipariş" e-postası (Mail alerts modülü) da locker kimliğini veya ShipLogic kullanılamadığı için locker seçilmediğini gösterir.

The Courier Guy takip referansı: paketi The Courier Guy portalınızda rezerve edin ve referansı siparişin Shipping bloğunda (Edit) gönderinin takip numarası olarak girin. The Courier Guy bloğu bunu gösterir. Müşteri bunu sipariş ayrıntılarında görür ve PrestaShop'tan "yolda" e-postasını alır.

Lisans anahtarı

Modül, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox The Courier Guy lisans bloğu, Modules > Module Manager > VibeFox The Courier Guy > Configure sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı) 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üğmelerini içerir. Bunların altında Product: presta-shipping-the-courier-guy 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 belirtir, ö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ı 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 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ı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan The Courier Guy taşıyıcılarından hiçbiri (courier to the door veya TCG locker) ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. PrestaShop vitrini, yönetici paneline giriş yaptığınızı bilmez; bu yüzden taşıyıcılar sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager altı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. Yönetici panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Modülü kaldırmak her zaman lisans anahtarını ve lisans durumunu siler. Bu modülün Reset işlemi verileri silmez, bu nedenle anahtar ve durum korunur.

Sorun giderme

The Courier Guy ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve taşıyıcının açık olduğunu kontrol edin (Courier to the door veya TCG locker). Shipping > Carriers içinde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin (veya Ignore shipping zones açık ve ülke izinli olmalı). Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Tablonun veya Fallback cost değerinin bir fiyatı olduğunu doğrulayın. Locker taşıyıcısı yalnızca Güney Afrika adresleri için ve API anahtarıyla görünür. Ayrıca ürün sayfasında ürünler belirli taşıyıcılarla sınırlandırılmış olabilir.

Müşteriler locker listesini görmüyor: locker'lar API anahtarını, açık TCG locker taşıyıcısını ve Güney Afrika'da bir teslimat adresini gerektirir. Ayarlar sayfası, varsa son ShipLogic hatasını gösterir; örneğin reddedilen bir anahtar.

Fiyat her zaman tablo fiyatı: ayarlar sayfasındaki uyarıları kontrol edin. Anlık tarife için API anahtarı, eksiksiz gönderici adresi ve rand dışı para birimli mağazalar için ZAR dönüşüm kuru gerekir. Kurye teslimatı için müşterinin adresinde cadde, şehir, il ve posta kodu olmalıdır: Advanced bölümüne Güney Afrika illerini ekleyin. Locker'lar için ShipLogic, müşterinin şehrine yakın bir locker bulmalıdır. Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve modül sayfasındaki Log alanına bakın.

ShipLogic çalışmıyor: tablo veya yedek fiyat gösterilir. Locker'lı siparişler locker olmadan verilebilir ve siparişte işaretlenir.

Bir değişiklikten sonra tarifeler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış tarifeleri ve locker'ları temizler.

Sayfa bir The Courier Guy taşıyıcısının bulunamadığını bildiriyor: taşıyıcı Shipping > Carriers içinde silinmiş. Yeniden oluşturmak için Modules > Module Manager içinde modülü sıfırlayın. Sıfırlama, ayarlarınızı ve mevcut taşıyıcıların açık/kapalı durumunu korur.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox The Courier Guy 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ış tarifeler ve locker'lar ile son ShipLogic hatası her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcılar silinir (siparişler geçmişini korur) ve ayarlar, günlük ile siparişi olmayan sepetlerin locker'ları kaldırılır. Kapalıysa taşıyıcılar yalnızca kapatılır ve tüm ayarlar korunur. Modülü yeniden kurmak, taşıyıcılara sahip oldukları durumu geri verir. Siparişlerde kaydedilmiş locker'lar hiçbir zaman kaldırılmaz.

The Courier Guy ve ShipLogic, ilgili sahiplerinin ticari markalarıdır. Bu modül The Courier Guy veya ShipLogic ile bağlantılı değildir ve onlar tarafından onaylanmamıştır.