VibeFox Purolator for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri. 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ı anahtarlar ve parolalar 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. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. vfd_purolator klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox Purolator veya 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 ücretler için Purolator API (live rates) bölümünü doldurun. Test için Development environment seçeneğini geliştirme anahtarıyla açın. Sabit fiyat veya yedek fiyat istiyorsanız Country prices veya Fallback price alanlarını doldurun (bkz. Yapılandırma).

6. WooCommerce > Settings > Shipping > Shipping zones bölümünde bir kargo bölgesine VibeFox Purolator ekleyin ya da Ignore shipping zones seçeneğini açıp ülkeleri seçin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox Purolator. 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üşterinin gördüğü ad. Genel Method title değerini kullanmak için boş bırakın.

Ayarları her kaydettiğinizde önbellekteki Purolator ücretleri temizlenir. Kaydedilmiş değerlerle anlık ücretler çalışamıyorsa (anahtar, parola veya hesap eksik, Kanada gönderici posta kodu yoksa, CAD kuru yoksa) ya da ne API kimlik bilgileri ne de sabit fiyat varsa, ayarların üstünde bir uyarı görünür.

Genel

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

Method title: sepette ve ödeme sayfasında görünen kargo yöntemi adı. Bir bölge bunu değiştirebilir. Varsayılan: Purolator.

Tax status: Taxable kargo ücretine WooCommerce vergisini ekler, None eklemez. Aşağıdaki Canadian sales taxes bölümüne de bakın.

Purolator API (anlık ücretler)

API anahtarı, parola ve fatura hesabı doldurulduğunda fiyat Purolator E-Ship Estimating web servisinden gelir. Purolator bir ücret döndürmezse sabit fiyat kullanılır; sabit fiyat da yoksa yöntem gizlenir.

API key: seçilen ortam için E-Ship Web Services anahtarınız.

API password: anahtara ait parola.

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.

Development environment: Purolator geliştirme ortamını (devwebservices.purolator.com) geliştirme anahtarıyla 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 en ucuz kullanılabilir hizmet kullanılır.

Canadian sales taxes: Kanada adresleri için Purolator toplamı GST/HST/PST/QST içerir. Tax status Taxable olduğunda, vergi iki kez alınmasın diye Use Purolator prices without GST/HST/PST/QST seçeneğini açın.

CAD → (store currency) rate: Purolator fiyatları CAD cinsindendir. Mağaza para biriminiz CAD değilse, 1 CAD'nin kaç birim sizin paranıza eşit olduğunu girin, örneğin 0.68. Bu değer olmadan anlık ücretler kullanılmaz. Mağaza para biriminiz CAD ise alanı boş bırakın.

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

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

Country prices: mağaza para biriminde, ülke ve sepet ağırlığına göre fiyat. Satır eklemek için + Add country düğmesine, satır silmek için çarpı işaretine tıklayın. Kendi satırı olmayan tüm ülkeleri kapsayan bir satır için * Default (all other countries) 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'dan fazla. Boş veya sıfır boyut fiyatı Base değerini kullanır. Base değeri 0 ise veya Base boş bırakılmışsa, kendi boyut fiyatı olmayan ağırlıklar için ücretsiz kargo anlamına gelir. Hiç fiyatı olmayan satırlar ve geçersiz ülke kodları kaydedildiğinde silinir. Her ülke için yalnızca bir satır tutulur.

Fallback price: Country prices içinde satırı olmayan ve * satırı da bulunmayan bir ülke için fiyat. Bu ülkeler için yöntemi gizlemek üzere boş bırakın.

Fixed price per: Order fiyatı bir kez alır. Item (price × quantity) ise 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): sepet bundan hafifse yöntemi gizler. 0 sınır yok anlamına gelir.

Max cart weight (kg): sepet bundan ağırsa yöntemi gizler. Varsayılan: 30. 0 sınır yok anlamına gelir.

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: sepette bu WooCommerce kargo sınıflarından herhangi birine ait bir ürün varsa yöntemi gizler.

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı. Yalnızca yöntemin bir fiyatı olduğu yerlerde geçerlidir: ülke fiyatı veya yedek fiyat (bu durumda Purolator'a istek gönderilmez) ya da anlık ücret. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.

Bu koşullar için sepet ağırlığı, ağırlığı olmayan ürünleri 0 sayar. Fiyatlar ve ağırlıklar ondalık ayracı olarak virgül veya nokta kabul eder.

Kargo bölgesi olmadan kullanılabilirlik

Ignore shipping zones: yöntem hiçbir kargo bölgesine eklenmemiş olsa bile Purolator'ı aşağıdaki ülkeler için sunar.

Countries: bu mod için hedef ülkeler. Gönderim yaptığınız 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: ücret hesaplamalarını WooCommerce > Status > Logs sayfasına yazar (kaynak "vfd-purolator"). 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.

Remove data on uninstall: açıksa eklentiyi silmek ayarlarını, bölge yöntemlerini ve önbellekteki ücretleri kaldırır. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir ücret ister. Eklenti önce koşulları kontrol eder: teslimat ülkesi, sepet ağırlığı, minimum sipariş tutarı ve hariç tutulan kargo sınıfları. Ardından bir fiyat arar: önce Purolator anlık ücreti, sonra ülke tablosu, en son yedek fiyat. Hiçbir fiyat yoksa yöntem gizlenir. Ücretsiz kargo uygulanıyorsa müşteri yöntemi ücretsiz görür.

API kimlik bilgileri varsa eklenti Purolator'a bir Quick Estimate isteği gönderir: fatura hesabınız, gönderim posta kodu, müşterinin şehri, il veya eyaleti, ülkesi ve posta kodu, ayrıca tam pound cinsinden toplam sepet 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 tüm hizmetlerin ücretlerini döndürür; eklenti seçtiğiniz hizmeti ya da en ucuzunu alır, ayarlandıysa Kanada satış vergilerini çıkarır ve fiyatı CAD'den dönüştürür. Hizmet, siparişle birlikte Purolator service olarak kaydedilir ve yönetici sipariş ekranında görünür.

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 bir ücret döndürmezse (API çalışmıyorsa, kimlik bilgileri veya posta kodu hatalıysa, hizmet kullanılamıyorsa, CAD kuru yoksa) müşteri hata görmez. Sabit fiyat kullanılır; sabit fiyat yoksa yöntem gizlenir. Nedeni günlüğe yazılır.

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

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

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox Purolator 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 aktif olduğu ve alan adınız. Check now ile durumu yeniden kontrol edin, Change key ile başka bir anahtar girin ve Remove key ile anahtarı bu siteden kaldırın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

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

Etkin bir anahtar olmadan Purolator ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de onu (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Purolator ö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. Purolator ücret döndürmezse yöntem yalnızca bir ülke fiyatı, bir * satırı veya bir Fallback price ile gösterilir.

Anlık ücretler görünmüyor: WooCommerce > Status > Logs sayfasını, kaynak "vfd-purolator" olacak şekilde açın. API hataları burada her zaman bulunur. Ayrıntılar için Debug log seçeneğini açın. API anahtarlarıyla adresin geçerli bir posta kodu (Kanada) veya ZIP kodu (ABD) içermesi gerekir.

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

Ücret Purolator web sitesinden farklı: Quick Estimate, fatura hesabınızın ücretlerini ve toplam ağırlığı tam pound'a yukarı yuvarlayarak kullanır; hacimsel ağırlık kullanılmaz. Kanada adreslerinde toplam satış vergilerini içerir; WooCommerce kargoya vergi ekliyorsa Canadian sales taxes seçeneğini kullanın. Fiyatlar CAD → (store currency) rate ile dönüştürülür.

Bir değişiklikten sonra ücretler eski görünüyor: ayarlar sayfasını kaydedin. Bu, önbellekteki Purolator ücretlerini 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şılamıyorsa 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 önbellekteki ücretler yalnızca Remove data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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