VibeFox Canada Post 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.

Canada Post Developer Program (yalnızca anlık tarifeler için): anlık tarifeler Canada Post Rating API'yi kullanır. Canada Post web sitesinden Canada Post Developer Program'a katılmak, API anahtarını ve müşteri numarasını kopyalamak gerekir. API anahtarı username:password biçimindedir ve Canada Post, geliştirme (sandbox) ve canlı ortamlar için ayrı anahtarlar verir. Ayrıca kargonun gönderileceği Kanada posta kodu da gereklidir. Yalnızca sabit fiyat kullanılıyorsa API anahtarlarına ihtiyaç yoktur.

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 gidilir ve Upload a module düğmesine tıklanır. Modülün ZIP dosyası seçilir.

2. Yükleme tamamlandığında Configure düğmesine tıklanır; ya da daha sonra modül listesinde VibeFox Canada Post bulunup Configure düğmesine tıklanır.

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

4. Anlık tarifeler için API kullanıcı adı ve şifresi, müşteri numarası ve gönderici posta kodu girilir. Mağazanın varsayılan para birimi CAD değilse CAD kuru girilir. Sabit fiyat ya da yedek fiyat isteniyorsa Country prices doldurulur (bkz. Yapılandırma). Save düğmesine tıklanır.

Kurulumda modül, Canada Post parcel delivery taşıma süresi metniyle Canada Post kargo firmasını oluşturur. Kargo firması tüm bölgelere ve tüm müşteri gruplarına atanır. Bölgeler, müşteri grupları, taşıma süresi, logo ve boyut sınırları Shipping > Carriers üzerinden değiştirilebilir. Fiyatlar burada ayarlanmamalıdır: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Canada Post > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbellekteki Canada Post tarifelerini de temizler. Kaydetmek için modül için yapılandırma izni gerekir.

Bir değer hatalıysa sayfa hata gösterir ve hiçbir şey kaydedilmez: sayısal bir alan ya da Country prices içindeki, 0 veya daha büyük bir sayı olmayan bir fiyat (örneğin -1 veya 12abc), 0 olan bir CAD kuru, Max cart weight (kg) değerinden büyük bir Min cart weight (kg), ya da 64 karakterden uzun bir Method title. Mağazanın ağırlık ya da boyut birimi modül tarafından bilinmiyorsa sayfa, ağırlıkların kg (boyutların cm) olarak okunacağı konusunda uyarır. International > Localization bölümünde, Local units kısmında kg, g, lb ya da oz (cm, mm, m ya da in) seçilir.

Kaydettikten sonra, ayarlar amaçlandığı gibi çalışamıyorsa sayfa bir uyarı gösterir: API kullanıcı adı ve API şifresinden yalnızca biri doldurulmuştur, gönderici posta kodu Kanada posta kodu değildir (A1A 1A1 biçimi), farklı para birimli bir mağaza için CAD kuru eksiktir ya da ne API kimlik bilgisi ne de sabit fiyat vardır. Uyarı ayrıca bu sırada ne olacağını da belirtir: ülke bazlı sabit fiyatlar kullanılır ya da Country prices tablosu boşsa kargo firması ödeme sayfasında gizlenir.

Genel

Enable Canada Post: kargo firmasını açar ya da kapatır. Bu, Shipping > Carriers içindeki kargo firması durumuyla aynı anahtardır.

Method title: ödeme sayfasında müşteriye gösterilen kargo firması adı. Varsayılan: Canada Post; alan boş bırakıldığında da bu kullanılır. En fazla 64 karakter; PrestaShop'un kargo firması adlarında izin vermediği karakterler kullanılamaz.

Tax: PrestaShop'un kargo ücretine eklediği vergi kuralı ya da No tax (vergilendirilmez).

Canada Post API (anlık tarifeler)

API kullanıcı adı ve şifresi doldurulduğunda fiyat Canada Post Rating API'den gelir. API bir tarife döndürmezse (API çalışmıyor, posta kodu yanlış, hizmet mevcut değil), Country prices içindeki sabit fiyat kullanılır; sabit fiyat yoksa kargo firması gizlenir. Bu bölüm, API anahtarlarınızın ve müşteri numaranızın bulunduğu Canada Post Developer Program'a bağlantı verir. Hata ayrıntıları günlüğe yazılır, müşteriye asla gösterilmez.

API username: API anahtarının iki noktadan önceki kısmı. Geliştirme anahtarını Sandbox ile, canlı mağazada ise üretim anahtarını kullanın.

API password: API anahtarının iki noktadan sonraki kısmı. Kaydettikten sonra alan boş kalır ve A password is saved. Leave empty to keep it; clear the username and save to remove both. ibaresini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Şifre yazıldığı gibi kaydedilir ve günlüğe asla yazılmaz.

Customer number: bir müşteri numarasıyla Canada Post, hesabınızın ticari (indirimli) tarifelerini döndürür. Perakende (mağaza) tarifeleri için boş bırakın. Boşluklar kaldırılır.

Contract number: isteğe bağlı; sözleşmeli müşteriler içindir. Yalnızca müşteri numarasıyla birlikte kullanılır.

Sandbox: geliştirme anahtarıyla test yapmak için Canada Post geliştirme ortamını kullanır. Fiyatlar test verisidir. Canlı bir mağazada kapatın.

Ship-from postal code: paketlerin gönderildiği Kanada posta kodu, örneğin K1A 0B1. Anlık tarifeler bunu gerektirir.

Service in Canada: Kanada adresleri için hizmet: Cheapest available, Regular Parcel (DOM.RP, varsayılan), Expedited Parcel (DOM.EP), Xpresspost (DOM.XP) veya Priority (DOM.PC).

Service to the USA: Cheapest available (varsayılan), Expedited Parcel USA (USA.EP), Tracked Packet USA (USA.TP), Small Packet USA Air (USA.SP.AIR), Xpresspost USA (USA.XP) veya Priority Worldwide parcel USA (USA.PW.PARCEL).

International service: Cheapest available (varsayılan), International Parcel Surface (INT.IP.SURF), International Parcel Air (INT.IP.AIR), Tracked Packet International (INT.TP), Small Packet International Surface (INT.SP.SURF), Small Packet International Air (INT.SP.AIR), Xpresspost International (INT.XP) veya Priority Worldwide parcel International (INT.PW.PARCEL).

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

Use Canada Post prices without GST/HST/PST: Kanada adresleri için Canada Post fiyatı bu vergileri içerir. PrestaShop kargoya kendi vergisini ekliyorsa (yukarıdaki Tax) bunu açın; böylece vergi iki kez alınmaz.

CAD to … rate: alan adı, mağazanın varsayılan para birimini gösterir; örneğin CAD to USD rate. Canada Post fiyatları CAD cinsindendir. Varsayılan para biriminiz CAD değilse, bir CAD'nin kaç birim kendi para biriminize denk geldiğini girin; örneğin 0.68. Bu olmadan anlık tarifeler kullanılmaz. Varsayılan para biriminiz CAD ise alanı boş bırakın. Kur 0'dan büyük olmalıdır. Ondalık ayırıcı olarak nokta ve virgül ikisi de kabul edilir.

Default product weight (kg): ağırlığı olmayan her ürün için Canada Post'a gönderilir. Varsayılan: 0.5. Ürün ağırlıkları (mağazanızın ağırlık biriminde) ve boyutlar dönüştürülür; sepet tek bir paket olarak tarifelendirilir.

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

Country prices: Base fiyatı ve mağazanın varsayılan para biriminde, vergi hariç sepet ağırlığına göre fiyatlar içeren bir ülke tablosu: XS 1 kg'a kadar, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL 5 kg'dan fazla. Boş ya da sıfır olan bir boyut fiyatı Base fiyatını kullanır. Bir satır eklemek için Add country düğmesine, bir satırı silmek için çarpı simgesine tıklanır. * Default (all other countries) satırı, kendi satırı olmayan tüm ülkeler için fiyatları belirler. Satırı olmayan (ve * de olmayan) bir ülke sabit fiyat almaz. 0 olan bir taban fiyat, o ülke için ücretsiz kargo anlamına gelir. Hiçbir fiyatı olmayan bir satır kaydedilmez.

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

Koşullar

Min cart weight (kg): bu sepet ağırlığının altında kargo firmasını gizler. 0 sınır olmadığı anlamına gelir.

Max cart weight (kg): bu sepet ağırlığının üzerinde kargo firmasını gizler. Varsayılan: 25; alan boş olsa da bu geçerlidir. 0 sınır olmadığı anlamına gelir. Canada Post paketleri 30 kg'a kadar olabilir. Min cart weight (kg) değerinden düşük olamaz.

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

Free shipping: aşağıdaki tutardan itibaren ücretsiz teslimatı açar.

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Bu durumda API'ye istek gönderilmez. Yalnızca Free shipping açıkken kullanılır.

Kargo bölgeleri olmadan kullanılabilirlik

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

Ignore shipping zones: kargo firmasını, hangi bölge eşleşirse eşleşsin, aşağıdaki ülkeler için sunar. Kaydedildiğinde kargo firması tüm bölgelere eklenir; daha sonra oluşturacağınız bölgelere de eklenir. Seçeneği kapatıp kaydettiğinizde, modülün eklediği bölgeler yeniden kaldırılır ve kargo firması kendi bölgelerini korur.

Countries: bu mod için hedef ülkeler. Birden fazla seçmek için Ctrl (Cmd) tuşunu basılı tutun. Tüm aktif ülkelere izin vermek için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını var/logs/vfd_canada_post.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında döndürülür. API hataları, bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarları, müşteri numaraları ve müşteri posta kodları kaydedilmez.

Remove data on uninstall: açıksa modülün kaldırılması ayarları, kaydedilmiş sipariş hizmetlerini, önbellekteki tarifeleri ve günlüğü siler. Kargo firması kaldırmada her zaman ödeme sayfasından çıkarılır. Siparişlere asla dokunulmaz.

Log: ayarların altındaki panel dosya adını ve son 50 kaydı gösterir. Silmek için Clear log düğmesine tıklanır.

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

Kargo adımında PrestaShop, modülden Canada Post fiyatını ister. Yalnızca fiziksel ürünler sayılır: sanal ürünler ağırlık eklemez ve sipariş tutarına dahil edilmez. 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 Canada Post'a istek gönderilmez.

API kimlik bilgileriyle modül, Canada Post'a gönderici posta kodunu, hedefi, paket ağırlığını ve her ürünün boyutu varsa tahmini paket boyutunu gönderir. Kanada için hedef posta kodudur; ABD için ZIP kodudur; diğer tüm ülkeler için yalnızca ülke gönderilir. Anlık tarife yalnızca bir Kanada veya ABD adresi geçerli bir posta veya ZIP koduna sahipse istenir. Canada Post paket için tüm hizmetleri döndürür. Modül, hedef grubun seçili hizmetini ya da en ucuzunu seçer; Use Canada Post prices without GST/HST/PST açıksa Kanada satış vergilerini (GST/HST/PST) çıkarır ve CAD fiyatını kendi kuruyla dönüştürür. Fiyat mağazanın varsayılan para biriminde hesaplanır, ardından müşterinin sepet para biriminde gösterilir.

Her yanıt 1 saat önbelleğe alınır; böylece aynı sepet ve adres yeni bir istek tetiklemez. Başarısız bir istek 10 dakika önbelleğe alınır; böylece bir Canada Post kesintisi her ödeme sayfası yenilemesini yavaşlatmaz. API zaman aşımı 10 saniyedir. 30 kg'ı aşan paketler API'ye gönderilmez.

API tarife döndürmezse sabit fiyat kullanılır; sabit fiyat yoksa kargo firması gizlenir. Müşteri API hata ayrıntılarını asla görmez; bunlar günlüğe yazılır.

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

Modül yalnızca tarife hesaplar. Gönderi oluşturmaz, etiket basmaz, manifesto veya iade oluşturmaz ve paketleri takip etmez. Müşteriler postane ya da teslim noktası seçemez. Teslimat tarihi, sigorta ya da imza seçenekleri olmadan tek bir Canada Post tarifesi gösterir. Sepet her zaman tek bir paket olarak tarifelendirilir ve döviz kurları otomatik olarak güncellenmez.

Siparişler

Sipariş Canada Post kargo firmasıyla verildiğinde modül, fiyatının nasıl hesaplandığını kaydeder. Yönetici panelindeki sipariş sayfasında (Orders > Orders, bir siparişi açın) bir Canada Post bloğu şunları gösterir:

Canada Post service: anlık tarifenin hizmet adı ve kodu, örneğin Regular Parcel (DOM.RP).

Price source: Live rate (Canada Post Rating API), Fixed price veya Free shipping.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Canada Post lisans bloğu, Modules > Module Manager > VibeFox Canada Post > 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-canada-post 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 Canada Post kargo firması ödeme sayfasında müşterilere gösterilmez ve tarife hesaplanmaz. PrestaShop vitrini, yönetici paneline giriş yaptığınızı bilmez; bu nedenle kargo firması 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

Canada Post ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Canada Post seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers içinde kargo firmasının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin (ya da Ignore shipping zones açık ve ülke izinli olmalıdır). Ağırlık sınırlarını ve Minimum order amount değerini kontrol edin. Bir tarife olmalıdır: API kimlik bilgileri varken adreste geçerli bir posta kodu (Kanada) ya da ZIP kodu (ABD) olmalıdır; aksi halde ülke veya * için bir sabit fiyat bulunmalıdır. Ayrıca ürün sayfasında ürünler belirli kargo firmalarıyla sınırlandırılmış olabilir.

Anlık tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log paneline bakın. Nedeni gösterir: eksik API kullanıcı adı ya da şifresi, geçersiz gönderici ya da hedef posta kodu, eksik CAD kuru, 30 kg'ı aşan bir paket ya da Canada Post hata mesajı. Bu sırada, varsa, müşteriler sabit fiyatı alır.

Tarife Canada Post web sitesindekinden farklı: müşteri numarasıyla hesabınızın ticari (indirimli) tarifelerini alırsınız; müşteri numarası olmadan perakende (mağaza) tarifelerini. Kanada adresleri için Canada Post fiyatı GST/HST/PST içerir. Fiyatlar CAD kurunuzla dönüştürülür.

Kargoda vergi iki kez alınıyor: Use Canada Post prices without GST/HST/PST seçeneğini açın ya da Tax değerini No tax olarak ayarlayın.

Canlı bir mağazada fiyatları test etme: Sandbox seçeneğini kapatın ve üretim API anahtarını kullanın.

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

Sayfa Canada Post kargo firmasının eksik olduğunu söylüyor: kargo firması Shipping > Carriers içinde silinmiştir. Yeniden oluşturmak için Modules > Module Manager içinde modülü sıfırlayın.

Bu modülü yapılandırma izniniz yok: çalışan profiliniz modül sayfasını açabilir ama kaydedemez. Bir yöneticiden profilinize modül için yapılandırma izni vermesini isteyin.

Kaldırma

Modules > Module Manager bölümüne gidilir, VibeFox Canada Post yanındaki menü açılır ve Uninstall seçilir. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Kargo firması ödeme sayfasından her zaman kaldırılır (siparişler kendi kargo firmasını ve geçmişini korur). Remove data on uninstall açıksa ayarlar, kaydedilmiş sipariş hizmetleri, önbellekteki tarifeler ve günlük silinir. Kapalıysa yalnızca önbellekteki tarifeler kaldırılır ve tüm ayarlar korunur. Modül yeniden kurulursa (ya da Reset kullanılırsa) önceki kargo firması önceki durumuyla geri yüklenir: devre dışı bıraktığınız bir kargo firması devre dışı kalır.

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