VibeFox Canada Post for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 5.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

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ılın ve API anahtarınızı ile müşteri numaranızı kopyalayın. API anahtarı kullanıcı adı:parola biçimindedir; Canada Post geliştirme (sandbox) ve canlı ortamlar için ayrı anahtarlar verir. Ayrıca gönderim yaptığınız Kanada posta koduna da ihtiyacınız vardır. Yalnızca sabit fiyat kullanıyorsanız API anahtarlarına gerek yoktur.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Eklenti klasörünü vfd_canada_post olarak FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Canada Post ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Anlık tarifeler için API kullanıcı adını ve parolasını, müşteri numaranızı ve gönderi posta kodunu girin. Mağaza para biriminiz CAD değilse CAD kurunu girin. Sabit fiyat veya yedek fiyat istiyorsanız Country prices alanını doldurun (bkz. Yapılandırma).

6. VibeFox Canada Post yöntemini WooCommerce > Settings > Shipping > Shipping zones altındaki kargo bölgelerinize ekleyin ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox Canada Post. Ayarlar tüm kargo bölgeleri için geçerlidir. Yöntemi bir bölgeye eklediğinizde bölge penceresinde yalnızca bir alan bulunur:

Title (zone): bu bölge için müşteriye gösterilen ad. Genel Method title değerini kullanmak için boş bırakın.

Ayarları her kaydettiğinizde önbelleğe alınmış Canada Post tarifeleri temizlenir. Ayarlar çalışamadığında sayfa bir hata da gösterir: API kullanıcı adı ve parolasından yalnızca biri doldurulmuşsa, gönderi posta kodu Kanada posta kodu değilse, farklı para birimli bir mağaza için CAD kuru eksikse ya da ne API anahtarı ne de sabit fiyat varsa.

Genel

Enable/Disable: yöntemi tüm bölgelerde aynı anda açar veya kapatır.

Method title: sepette ve ödeme sayfasında gösterilen kargo yöntemi adı. Varsayılan: Canada Post. Bir bölge kendi başlığını kullanabilir.

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez.

Canada Post API (anlık tarifeler)

API kullanıcı adı ve parola doldurulduğunda fiyat Canada Post Rating API'den gelir. API tarife döndürmezse (API kullanılamıyor, yanlış posta kodu, hizmet mevcut değil), Country prices içindeki sabit fiyat kullanılır ya da hiç yoksa yöntem gizlenir.

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

API password: API anahtarının iki noktadan sonraki kısmı. Günlüğe asla yazılmaz.

Customer number: müşteri numarasıyla Canada Post, hesabınızın ticari (indirimli) tarifelerini döndürür. Perakende (tezgâh) tarifeler için boş bırakın.

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 API anahtarıyla test yapmak için Canada Post geliştirme ortamını kullanır. Fiyatlar test verisidir. Canlı 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 (varsayılan), Expedited Parcel, Xpresspost veya Priority.

Service to the USA: Cheapest available (varsayılan), Expedited Parcel USA, Tracked Packet USA, Small Packet USA Air, Xpresspost USA veya Priority Worldwide parcel USA.

International service: Cheapest available (varsayılan), International Parcel Surface, International Parcel Air, Tracked Packet International, Small Packet International Surface, Small Packet International Air, Xpresspost International veya Priority Worldwide parcel International.

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

Canadian sales taxes: Canada Post fiyatlarını GST/HST/PST olmadan kullanır. Kanada adresleri için Canada Post fiyatı bu vergileri içerir. WooCommerce kargo ücretine vergiyi kendisi eklediğinde (Tax status = Taxable) bunu açın; böylece vergi iki kez alınmaz.

CAD → store currency rate: alan adı mağaza para biriminizi gösterir. Canada Post fiyatları CAD cinsindendir. Mağaza para biriminiz CAD değilse, bir CAD'nin kaç birim sizin paranıza eşit olduğunu girin, örneğin 0.68. Bu olmadan anlık tarifeler kullanılmaz. Mağaza para biriminiz CAD ise alanı boş bırakın. Ondalık ayırıcı olarak hem nokta hem virgül 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ı ve boyutları mağaza biriminizden dönüştürülür ve sepet tek paket olarak hesaplanır.

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ğaza para biriminde sepet ağırlığına göre fiyatlar içeren ülke tablosu: XS 1 kg'a kadar, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL 5 kg üzeri. Boş veya sıfır olan beden fiyatı Base fiyatını kullanır. Satır eklemek için Add country'ye, silmek için çarpıya tıklayın. * Default (all other countries) satırı, kendi satırı olmayan tüm ülkelerin fiyatlarını belirler. Satırı olmayan (ve * de olmayan) bir ülkenin sabit fiyatı yoktur. 0 temel fiyat, o ülke için ücretsiz kargo anlamına gelir.

Fixed price per: Order fiyatı bir kez alır. Item (price × quantity) ise sepetteki ürün sayısıyla ç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 yöntemi gizler. 0 sınır olmadığı anlamına gelir.

Max cart weight (kg): bu sepet ağırlığının üzerinde yöntemi gizler. Varsayılan: 25. 0 sınır olmadığı anlamına gelir. Canada Post paketleri 30 kg'a kadar olabilir.

Minimum order amount: yöntemi yalnızca sepet ara toplamı bu tutara ulaştığında gösterir. Her zaman göstermek için boş bırakın.

Excluded shipping classes: sepetteki herhangi bir üründe bu WooCommerce kargo sınıflarından biri varsa yöntemi gizler.

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

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Bu durumda API'ye istek gönderilmez.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: eşleşen bölgeden bağımsız olarak yöntemi aşağıdaki ülkeler için sunar.

Countries: bu mod için hedef ülkeler. Mağazanın gönderim yaptığı tüm ülkeleri kullanmak 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ı WooCommerce > Status > Logs altında, kaynak vfd-canada-post olarak kaydeder. 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 eklentiyi silmek ayarlarını, bölge yöntemlerini ve önbelleğe alınmış tarifeleri siler. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez.

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

Müşteri teslimat adresini girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti önce koşulları kontrol eder: sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Ücretsiz kargo geçerliyse müşteri ücretsiz tarife alır ve Canada Post'a istek gönderilmez.

API anahtarlarıyla eklenti Canada Post'a gönderim posta kodunu, hedefi, paket ağırlığını ve tüm ürünlerin boyutları 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 ülkedir. Anlık tarife yalnızca bir Kanada veya ABD adresinin geçerli bir posta veya ZIP kodu olduğunda istenir. Canada Post paket için tüm hizmetleri döndürür; eklenti hedef grubu için seçilen hizmeti ya da en ucuzunu seçer, Canadian sales taxes açıksa Kanada satış vergilerini çıkarır ve CAD fiyatını sizin kurunuzla dönüştürür. Hizmet adı siparişle birlikte kaydedilir ve yönetici sipariş ekranında Canada Post service olarak 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 Canada Post kesintisi her ödeme sayfası yenilemesini yavaşlatmaz. API zaman aşımı 10 saniyedir. 30 kg'dan ağır paketler API'ye gönderilmez.

API tarife döndürmezse sabit fiyat kullanılır ya da sabit fiyat yoksa yöntem gizlenir. Müşteri API hata ayrıntılarını asla görmez; bunlar WooCommerce günlüğüne gider.

Yöntem klasik ödeme sayfasında ve Sepet ile Ödeme bloklarında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca tarife hesaplar. Gönderi oluşturmaz, etiket basmaz, manifesto veya iade oluşturmaz ve paketleri takip etmez. Müşteriler postane veya teslim noktası seçemez. Teslimat tarihi, sigorta veya imza seçeneği olmadan tek bir Canada Post tarifesi gösterir. Sepet her zaman tek paket olarak hesaplanır ve para birimi kurları otomatik olarak güncellenmez.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Canada Post sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum görünür; örneğin lisansın hangi tarihe kadar etkin olduğu ve alan adınız. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarın bir siteden kaldırılması alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar yoksa Canada Post ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri ise onu (unlicensed — visible to admins only) etiketiyle görmeye devam eder; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Canada Post ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve yöntemin müşterinin ülkesinin bölgesine eklendiğini kontrol edin (ya da Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını, Minimum order amount ve Excluded shipping classes ayarlarını kontrol edin. Bir tarife olmalıdır: API anahtarlarıyla adresin geçerli bir posta kodu (Kanada) ya da ZIP kodu (ABD) olmalıdır; aksi halde ülke için ya da * için bir sabit fiyat bulunmalıdır.

Anlık tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını, kaynak vfd-canada-post olarak açın. Nedeni gösterir: eksik API kullanıcı adı veya parola, geçersiz gönderim ya da hedef posta kodu, eksik CAD kuru, 30 kg'ı aşan paket veya Canada Post hata mesajı. Bu sırada müşteriler varsa 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 (tezgâh) tarifeler gelir. 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: Canadian sales taxes seçeneğini açın veya Tax status değerini None olarak ayarlayın.

Canlı mağazada fiyatları test edin: Sandbox seçeneğini kapatın ve canlı API anahtarını kullanın.

Bir değişiklikten sonra tarifeler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbelleğe alınmış Canada Post tarifelerini temizler.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir yuva boşaltın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ayarlar, bölge yöntemleri ve önbelleğe alınmış tarifeler yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için kalırlar. Siparişlere asla dokunulmaz.

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