VibeFox Purolator for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül daha eski PHP sürümlerine kurulmaz. PHP SOAP uzantısı gerekmez.

Purolator E-Ship Web Services (yalnızca anlık ücretler için): Purolator web sitesindeki Purolator E-Ship Resource Centre üzerinden E-Ship Web Services'e kaydolun. Purolator, geliştirme ve canlı ortamlar için ayrı anahtar ve şifreler verir. Ayrıca Purolator fatura hesap numaranıza ve gönderim yaptığınız Kanada posta koduna ihtiyacınız olur. Yalnızca sabit fiyat kullanıyorsanız API anahtarlarına ihtiyacınız yoktur.

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 ya da daha sonra modül listesinde VibeFox Purolator öğ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. Anlık ücretler için Purolator API (live rates) bölümünü doldurun. Test için geliştirme anahtarıyla Development environment seçeneğini açın. Sabit fiyat ya da yedek fiyat istiyorsanız Country prices veya Fallback price alanlarını doldurun (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, Purolator courier teslimat süresi metniyle Purolator kargo firmasını oluşturur. Kargo firması 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 içinde değiştirebilirsiniz. Burada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Purolator > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme sayfanın tamamını kaydeder. Her kayıt, önbellekteki Purolator ücretlerini de temizler.

Kayıtlı değerlerle anlık ücretler çalışamıyorsa (anahtar, şifre veya fatura hesabı eksik, Kanada gönderim posta kodu yok, CAD kuru yok) ya da ne API kimlik bilgisi ne de sabit fiyat varsa, ayarların üstünde bir uyarı görünür. Mağazanın ağırlık birimi modülün tanıdığı birimlerden biri değilse (kg, g, lb, oz ve benzerleri) de uyarı görünür. Bu durumda ürün ağırlıkları kg olarak alınır. Ağırlık birimini International > Localization (Local units) bölümünde ayarlayın.

0 veya daha büyük bir sayı içermeyen bir sayı alanı kaydedilmez. Uyarı alanı ve değeri belirtir. Alan boş kalır veya ağırlık alanlarında varsayılan değerini alır. Country prices içindeki hatalı bir değer 0 olarak kaydedilir ve uyarı ülkeyi ve sütunu listeler. Min cart weight, Max cart weight değerinden büyükse hiçbir şey kaydedilmez ve bir hata gösterilir.

Genel

Enable Purolator: kargo firmasını açar veya kapatır. Bu, Shipping > Carriers içindeki kargo firması durumuyla aynı anahtardır.

Method title: sepette ve ödeme sayfasında gösterilen kargo firması adı. Varsayılan: Purolator. Zorunlu, en fazla 64 karakter.

Tax: kargo firmasının vergi kuralı veya No tax. Mağazanın kargo ücretine vergi ekleyip eklemeyeceğini belirler. Kanada adresleri için Purolator toplamı GST/HST/PST/QST'yi zaten içerir. Aşağıdaki Canadian sales taxes bölümüne bakın.

Purolator API (anlık ücretler)

API anahtarı, şifre ve fatura hesabı doldurulduğunda fiyat Purolator E-Ship Estimating web servisinden gelir. Purolator ücret döndürmezse sabit fiyat kullanılır ya da hiç yoksa kargo firması gizlenir. Bu bölümde, kayıt olup anahtarları alacağınız Purolator E-Ship Resource Centre'a bir bağlantı vardır.

API key: seçili ortam için E-Ship Web Services anahtarınız. 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.

API password: anahtara ait şifre. Anahtar gibi, kaydettikten sonra tekrar gösterilmez.

Billing account number: Purolator hesap numaranız. Tahminler bu hesabın ücretlerini kullanır. Geliştirme ortamı, Purolator dokümantasyonundaki test hesabını kabul eder. Bu alanı boşaltmak, kayıtlı API anahtarını ve şifresini de siler.

Development environment: geliştirme anahtarıyla Purolator geliştirme ortamını (devwebservices.purolator.com) kullanır. Fiyatlar test verisidir. Canlı bir mağazada kapatın.

Ship-from postal code: paketlerin gönderildiği Kanada posta kodu, örneğin L4W 5M8.

Service in Canada: Cheapest available (varsayılan), Purolator Ground, Purolator Ground 9AM, Purolator Ground 10:30AM, Purolator Ground Evening, Purolator Express, Purolator Express 9AM, Purolator Express 10:30AM, Purolator Express 12PM veya Purolator Express Evening.

Service to the USA: Cheapest available (varsayılan), Purolator Ground U.S., Purolator Express U.S., Purolator Express U.S. 9AM, Purolator Express U.S. 10:30AM veya Purolator Express U.S. 12:00.

International service: Cheapest available (varsayılan), Purolator Express International, Purolator Express International 9AM, Purolator Express International 10:30AM veya Purolator Express International 12:00.

Seçilen hizmet adres için sunulmuyorsa mevcut en ucuz hizmet kullanılır.

Canadian sales taxes: Purolator fiyatlarını GST/HST/PST/QST olmadan kullanır. Kanada adresleri için Purolator toplamı bu vergileri içerir. Kargo firmasının Tax içinde bir vergi kuralı olduğunda açın; böylece vergi iki kez alınmaz.

CAD → (shop currency) rate: Purolator fiyatları CAD cinsindendir. Mağazanızın varsayılan para birimi CAD değilse, bir CAD'nin kaç birim sizin para biriminize eşit olduğunu girin, örneğin 0.68. Bu değer olmadan anlık ücretler kullanılmaz. Varsayılan para biriminiz CAD ise alanı boş bırakın.

Default product weight: kg cinsinden, ağırlığı olmayan her ürün için kullanılır. Varsayılan: 0.5. Ağırlıklar mağazanın ağırlık biriminden dönüştürülür ve Purolator'a tam pound cinsinden, yukarı yuvarlanmış toplam ağırlık olarak gönderilir.

Sabit fiyatlar (API kimlik bilgileri olmadan ve API ücret döndürmediğinde yedek olarak kullanılır)

Country prices: mağazanızın varsayılan para biriminde, vergi hariç, ülke ve sepet ağırlığına göre fiyat. 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 ülkeleri kapsayan bir satır için * Default (all other countries) seçeneğini seçin. Her satırda bir Base fiyatı ve boyut sütunları vardır: XS 1 kg'a kadar, S 1–2 kg, M 2–3 kg, L 3–5 kg ve XL 5 kg'ın üzeri. Boş veya sıfır olan bir boyut fiyatı Base kullanır. Base değeri 0 ise ya da Base boşsa, kendi boyut fiyatı olmayan ağırlıklar için ücretsiz kargo anlamına gelir. Hem 9.99 hem 9,99 kabul edilir. Hiç fiyatı olmayan satırlar kaydedilmez ve her ülke için yalnızca bir satır tutulur.

Fallback price: Country prices içinde satırı ya da * satırı olmayan bir ülke için fiyat. Bu ülkelerde kargo firmasını gizlemek için boş bırakın.

Fixed price per: Order fiyatı bir kez alır. Item (price × quantity) fiyatı sepetteki ürün adediyle çarpar. Bu yalnızca sabit fiyatlar için geçerlidir. Anlık ücretler her zaman tüm gönderi için hesaplanır.

Koşullar

Min cart weight: kg cinsinden; sepet bundan hafifse kargo firmasını gizler. 0 sınır yok anlamına gelir.

Max cart weight: kg cinsinden; sepet bundan ağırsa kargo firmasını gizler. Varsayılan: 30. 0 sınır yok anlamına gelir.

Minimum order amount: kargo firmasını yalnızca sepet ara toplamı (indirimlerden sonra, vergiden önce) bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Free shipping from: sepet ara toplamı (indirimlerden sonra, vergiden önce) bu tutara ulaştığında teslimat ücretsizdir. Bu durumda Purolator'a istek gönderilmez. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.

Bu koşullar için sepet ağırlığında ağırlığı olmayan ürünler 0 sayılır.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde kargo firması, Shipping > Carriers içinde atandığı bölgelerde sunulur.

Ignore shipping zones: hangi bölgenin eşleştiğine bakılmaksızın, aşağıdaki ülkeler için Purolator'u sunar. Kaydederken kargo firması tüm bölgelere eklenir ve sonradan oluşturulan bölgelere de eklenir. Seçenek kapatıldığında bu bölgeler yeniden kaldırılır.

Countries: bu mod için hedef ülkeler. Mağazanın tüm aktif ülkelerini 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_prlr_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. API hataları, hata ayıklama günlüğü kapalı olsa bile her zaman kaydedilir. API anahtarları, fatura hesabı ve müşteri posta kodları kaydedilmez. İşiniz bittiğinde günlüğü kapatın.

Log: günlüğü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çıksa modülü kaldırmak ayarları, kargo firmasını, önbellekteki ücretleri ve günlükleri siler. Kapalıysa yeniden kurulum için her şey saklanır.

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

Kargo adımında PrestaShop modülden Purolator fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. Müşteri bir adres girmeden önce fiyat, mağazanın tahminler için kullandığı ülke için hesaplanır. Modül önce koşulları kontrol eder: izin verilen ülkeler (Ignore shipping zones ile), sepet ağırlığı ve minimum sipariş tutarı. Ücretsiz kargo geçerliyse fiyat 0 olur ve Purolator'a istek gönderilmez. Sonra bir fiyat arar: önce Purolator anlık ücreti, sonra ülke tablosu, en sonunda yedek fiyat. Fiyat yoksa kargo firması gizlenir.

API kimlik bilgileriyle modül Purolator'a bir Quick Estimate isteği gönderir: fatura hesabınız, gönderim posta kodu, müşterinin şehri, il veya eyaleti, ülke ve posta kodu ile sepetin tam pound cinsinden toplam ağırlığı. Kanada için geçerli bir posta kodu, ABD için geçerli bir ZIP kodu gerekir; diğer ülkeler girilen posta koduyla gönderilir. Boyutlar (hacimsel ağırlık) gönderilmez. Purolator, müşterinin diline göre Fransızca veya İngilizce yanıt verir. Purolator tüm hizmetlerin ücretlerini döndürür; modül seçtiğiniz hizmeti veya en ucuzunu alır, ayarlıysa Kanada satış vergilerini çıkarır ve fiyatı CAD'den dönüştürür. Fiyat mağazanızın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Her yanıt 1 saat önbellekte tutulur. Başarısız bir istek 10 dakika önbellekte tutulur; böylece bir Purolator kesintisi her ödeme sayfası yenilemesini yavaşlatmaz. API zaman aşımı 10 saniyedir.

Purolator ücret döndürmezse (API kapalı, hatalı kimlik bilgisi veya posta kodu, hizmet kullanılamıyor, CAD kuru yok), müşteri hata görmez. Sabit fiyat kullanılır ya da sabit fiyat yoksa kargo firması gizlenir. Nedeni günlüğe yazılır.

Shipping > Carriers içinde kargo firmasını siparişleri olduktan sonra düzenlerseniz, PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca ücret hesaplar. Purolator gönderisi oluşturmaz, etiket yazdırmaz, kurye alımı randevusu vermez, iadeleri yönetmez ve kolileri takip etmez. Full Estimate'i (boyutlar, birden fazla parça, imza veya tehlikeli madde gibi seçenekler) kullanmaz, teslimat tarihlerini göstermez, birden fazla hizmeti ayrı kargo firmaları olarak göstermez ve döviz kurlarını otomatik olarak almaz.

Siparişler

Anlık Purolator ücretiyle bir sipariş verildiğinde hizmet siparişle birlikte kaydedilir. Sepetin sonraki yeniden hesaplamaları bunu değiştirmez. Yönetim panelindeki sipariş sayfasında (Orders > Orders, siparişi açın) bir Purolator bloğu, Purolator service (ad ve kod) ile Live rate (excl. tax) değerini gösterir. Sabit fiyatla veya ücretsiz kargoyla verilen siparişlerde bu blok bulunmaz.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Purolator lisans bloğu, Modules > Module Manager > VibeFox Purolator > 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ı maskelenmiş olarak, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-shipping-purolator 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 yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetici panelinin 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 bir tarihle birlikte License expired on. 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 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ızda serbest bırakın.

Etkin bir anahtar olmadan Purolator kargo firması ödeme sayfasında müşterilere gösterilmez ve hiçbir ücret istenmez ya da hesaplanmaz. PrestaShop vitrini yönetici paneline giriş yaptığınızı bilmez, bu yüzden kargo firması sizden de gizlenir: modülü 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. 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 ya da sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Purolator ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Purolator seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers içinde kargo firmasının müşterinin ülkesinin bölgesini ve müşteri grubunu kapsadığını kontrol edin (ya da Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Purolator ücret döndürmezse kargo firması yalnızca ülke fiyatı, * satırı veya Fallback price ile gösterilir. Ürün sayfasında ürünler belirli kargo firmalarıyla da sınırlandırılabilir.

Anlık ücretler görünmüyor: modül sayfasındaki Log alanına bakın. API hataları her zaman orada görünür. Ayrıntı için Debug log seçeneğini açın ve ödeme sayfasını yeniden yükleyin. API anahtarlarıyla adresin geçerli bir posta kodu (Kanada) veya ZIP kodu (ABD) içermesi gerekir. Ayarların üstündeki uyarıları da kontrol edin.

Günlükte HTTP 401: API anahtarı veya şifre seçilen ortamla eşleşmiyor. Geliştirme anahtarları yalnızca Development environment açıkken, canlı anahtarlar yalnızca kapalıyken çalışır.

Ücret Purolator web sitesindekinden farklı: Quick Estimate, fatura hesabınızın ücretlerini ve hacimsel ağırlık olmadan tam pound'a yukarı yuvarlanmış toplam ağırlığı kullanır. Kanada adresleri için toplam satış vergilerini içerir; kargo firmasının bir vergi kuralı varsa Canadian sales taxes seçeneğini kullanın. Fiyatlar CAD → (shop currency) rate değerinizle dönüştürülür.

Kaydettikten sonra bir değer kayboldu: Save sonrasında gösterilen uyarıyı okuyun. Değer 0 veya daha büyük bir sayı değildi, bu yüzden kaydedilmedi. Düz bir sayı olarak tekrar girin.

Bir değişiklikten sonra ücretler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbellekteki Purolator ücretlerini temizler.

Sayfada Purolator kargo firması bulunamadı yazıyor: kargo firması Shipping > Carriers içinde silinmiş. 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 Purolator 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 ücretler her zaman silinir. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişini korur), ayarlar, siparişlerdeki kayıtlı Purolator hizmetleri ve günlük kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar korunur; verilen siparişler Purolator hizmetlerini korur. Modülü yeniden kurmak ya da bir Reset yapmak, kargo firmasına daha önceki durumunu geri verir.

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