VibeFox Australia Post for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde kurulmayı reddeder.

Australia Post PAC API anahtarı (yalnızca gerçek zamanlı tarifeler için): gerçek zamanlı tarifeler, Australia Post Postage Assessment Calculator (PAC) API'sini kullanır. Anahtar ücretsizdir: Australia Post Developer Centre (developers.auspost.com.au) üzerinden bir PAC API anahtarı için kaydolun. Modül sayfası kayıt sayfasına bağlantı verir. Ayrıca gönderdiğiniz yerin 4 haneli Avustralya posta kodunu da girmeniz gerekir. Yalnızca ülke başına sabit fiyat kullanıyorsanız API anahtarına ihtiyacınız yoktur.

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

Kurulum

1. Yönetim panelinde Modules > Module Manager bölümüne gidin ve Upload a module seçeneğine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure seçeneğine tıklayın ya da daha sonra modül listesinde VibeFox Australia Post modülünü bulup Configure seçeneğine tıklayın.

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

4. Rate source seçeneğini belirleyin. Gerçek zamanlı tarifeler için PAC API anahtarını, gönderim posta kodunuzu ve mağazanızın varsayılan para birimi AUD değilse AUD dönüşüm oranını girin (bkz. Yapılandırma). Save seçeneğine tıklayın.

Kurulumda modül, Australia Post parcel delivery teslimat süresi metniyle birlikte Australia Post taşıyıcısını oluşturur. Taşıyıcı tüm bölgelere ve tüm müşteri gruplarına atanır. Bölgeleri, müşteri gruplarını, teslimat süresini, logoyu, boyut sınırlarını ve vergi kuralını Shipping > Carriers sayfasında 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 Australia Post > Configure. Ayarlar tüm bölgeler için geçerlidir. Sayfanın üst kısmında Shipping > Carriers içindeki taşıyıcının adı ve kimliği gösterilir. Her bölümün kendi Save düğmesi vardır ve bu düğme sayfanın tamamını kaydeder. Her kayıt, önbellekteki Australia Post tarifelerini de temizler.

Gerçek zamanlı tarife kaynağı seçilmiş ama API anahtarı, 4 haneli gönderim posta kodu veya AUD dönüşüm oranı eksikse, kaydettikten sonra bir uyarı gösterilir. Uyarı ayrıca siz düzeltene kadar ne olacağını da belirtir: taşıyıcı ödeme sırasında gizlenir veya yedek modda ülke başına sabit fiyatlar kullanılır.

Sayısal alanlar ondalık ayracı olarak nokta veya virgül kabul eder. Sayı olmayan ya da negatif bir değer kaydedilmez: bir uyarı alanı belirtir ve önceki değer korunur. Mağazanın ağırlık veya boyut birimi (International > Localization) modülün tanımadığı bir birimse sayfa da uyarı verir. Bu durumda ürün ağırlıkları kg, boyutlar ise cm olarak okunur.

Genel

Enable Australia Post: taşıyıcıyı tüm bölgelerde birlikte kapatır. Bu, Shipping > Carriers içindeki taşıyıcı durumuyla aynı anahtardır.

Method title: ödeme sırasında müşteriye gösterilen taşıyıcı adıdır. Aynı zamanda Shipping > Carriers içindeki taşıyıcı adıdır ve taşıyıcıyı orada yeniden adlandırmak bu alanı günceller. Varsayılan: Australia Post. En fazla 64 karakter: daha uzun bir başlık reddedilir ve hiçbir şey kaydedilmez. Alan boşsa veya PrestaShop'un taşıyıcı adında izin vermediği karakterler içeriyorsa bir uyarı gösterilir ve Australia Post kullanılır.

Tax status: vergilerin kargo ücretine nasıl uygulanacağıdır.

Rate source: fiyatın nasıl hesaplanacağıdır.

Hata ayrıntıları günlüğe yazılır, müşteriye asla gösterilmez.

Australia Post API (live rates) (sabit fiyatlar için gerekli değildir)

PAC API key: Australia Post'tan ücretsiz aldığınız PAC API anahtarınız. AUTH-KEY başlığında Australia Post'a gönderilir. 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.

Remove the saved API key: kayıtlı anahtarı silmek için etkinleştirin ve kaydedin. Bundan sonra gerçek zamanlı tarifeler durur.

Ship-from postcode: paketlerin gönderildiği 4 haneli Avustralya posta kodu, örneğin 2000.

Domestic service: Avustralya içindeki teslimatlar için kullanılır (en fazla 22 kg, her kenarı 105 cm): Parcel Post (varsayılan) veya Express Post.

International service: Avustralya dışındaki teslimatlar için kullanılır (en fazla 20 kg): International Standard (varsayılan), International Express veya International Courier.

Remove GST: yurt içi API fiyatlarını 1,1 ile böler. Australia Post'un yurt içi fiyatları %10 GST içerir. PrestaShop kargoya vergiyi kendisi eklediğinde bunu açın (Tax status = Taxable ve taşıyıcıda bir vergi kuralı varken), böylece GST iki kez alınmaz. Uluslararası posta GST'den muaftır ve hiçbir zaman değiştirilmez.

AUD → (your currency) rate: etiket, mağazanızın varsayılan para birimini gösterir. Australia Post fiyatları AUD cinsindendir. Varsayılan para biriminiz AUD değilse, bir AUD'nin kaç birim sizin para biriminize eşit olduğunu girin, örneğin 0.61. Oran 0'dan büyük olmalıdır. Bu olmadan gerçek zamanlı tarifeler kullanılmaz. Varsayılan para biriminiz AUD ise sayfa dönüşüm gerekmediğini belirtir: alanı boş bırakın. Ondalık ayracı olarak hem nokta hem virgül kabul edilir.

Gerçek zamanlı tarifeler için paket

Sepet tek bir paket olarak gönderilir. Ürün ağırlıkları ve boyutları mağazanızın birimlerinden kg ve cm'ye dönüştürülür. Aşağıdaki değerler ağırlığı ya da boyutu olmayan ürünler için kullanılır.

Default product weight (kg): ağırlığı olmayan her ürün için kullanılır; Australia Post isteğinde ve Min cart weight (kg) / Max cart weight (kg) kontrolünde. Varsayılan: 1.

Default parcel length (cm): sepetteki hiçbir ürünün boyutu yoksa kullanılır. Varsayılan: 22.

Default parcel width (cm): sepetteki hiçbir ürünün boyutu yoksa kullanılır. Varsayılan: 16.

Default parcel height (cm): sepetteki hiçbir ürünün boyutu yoksa kullanılır. Varsayılan: 8.

Ürünlerin boyutları olduğunda paket, bunlar arasındaki en büyük uzunluk ve genişliği alır; yükseklik ise tüm ürünlerin hacmini sığdıracak kadar artar.

Sabit fiyatlar (sabit fiyatlarla birlikte ve gerçek zamanlı tarifelerin yedeği olarak kullanılır)

Country prices: 2 harfli ülke kodlarının (AU, NZ, US vb.) ve mağazanızın varsayılan para birimindeki fiyatların tablosu, vergiler hariç. Bir ülke eklemek için Add row seçeneğine, birini kaldırmak için × bağlantısına tıklayın. Diğer tüm ülkeler için * kullanın. Fiyatı olmayan bir ülkenin (ve * satırının da olmadığı durumda) sabit tarifesi yoktur, bu yüzden taşıyıcı o ülke için gizlenir. Geçersiz ülke kodu olan veya fiyatı olmayan satırlar kaydetme sırasında silinir. Fiyat eklemeden tablo boş kalır.

Fixed price per: Order ücreti bir kez alır. Item (price × quantity) ise ücreti sepetteki ürün sayısıyla çarpar. Bu yalnızca sabit fiyatlar için geçerlidir. Gerçek zamanlı tarifeler her zaman tüm paket için hesaplanır.

Koşullar

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

Max cart weight (kg): sepet ağırlığı bu değerin üzerindeyse taşıyıcıyı gizler. Varsayılan: 22. 0, sınır olmadığı anlamına gelir; boş alan 22 kg anlamına gelir. Australia Post paketleri: yurt içinde 22 kg, uluslararası 20 kg. Min cart weight (kg) maksimumdan büyükse taşıyıcı hiç gösterilmez: bir uyarı çıkar ve iki ağırlık da önceki değerlerini korur.

Minimum order amount: taşıyıcıyı yalnızca ürün ara toplamı (indirimlerden sonra, vergiler hariç) mağazanızın varsayılan para biriminde bu tutara ulaştığında gösterir. Her zaman göstermek için alanı boş bırakın.

Free shipping: aşağıda belirtilen tutardan itibaren ücretsiz kargoyu etkinleştirir.

Free shipping from: ürün ara toplamı (indirimlerden sonra, vergiler hariç) ücretsiz kargonun başladığı tutar. Bu durumda API'ye istek gönderilmez. Yalnızca Free shipping açıkken kullanılır.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde taşıyıcı, Shipping > Carriers içinde kendisi için seçilen bölgelerde sunulur.

Ignore shipping zones: taşıyıcıyı, hangi bölge eşleşirse eşleşsin, aşağıda belirtilen ülkeler için sunar. Kaydederken taşıyıcı tüm bölgelere bağlanır ve daha sonra oluşturduğunuz bölgeler otomatik olarak bağlanır. Seçeneği kapatmak, taşıyıcıya daha önce sahip olduğu bölgeleri geri verir.

Countries: bu mod için hedef ülkeler. Tüm etkin ülkelere izin vermek için boş bırakın. Birden fazla seçmek için Ctrl tuşunu (Mac'te Cmd) basılı tutarak tıklayın. Yalnızca Ignore shipping zones ile kullanılır.

Gelişmiş

Debug log: tarife hesaplamalarını modules/vfd_australia_post/logs/vfd_ap.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API hataları her zaman kaydedilir. API anahtarı ve müşteri posta kodları kaydedilmez. İşiniz bittiğinde günlüğü kapatın.

Log: günlüğün boyutunu ve en son girişlerini gösterir. Temizlemek için Clear log seçeneğine tıklayın.

Remove data on uninstall: açıksa modülü kaldırmak ayarları, önbellekteki tarifeleri ve günlüğü siler. Taşıyıcı kaldırma sırasında her zaman silinir. Veriler korunduysa yeniden kurulumda geri yüklenir.

Ödeme sırasında nasıl çalışır

Kargo adımında PrestaShop, modülden Australia 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: Countries listesi (Ignore shipping zones ile birlikte), sepet ağırlığı ve Minimum order amount. Ücretsiz kargo uygulanıyorsa fiyat 0 olur ve Australia Post'a hiçbir istek gönderilmez.

Sabit fiyat modunda fiyat tablodan alınır. Gerçek zamanlı tarife modlarında modül, Australia Post'a paketin ağırlığını ve Avustralya içi teslimatlar için gönderim ile teslimat posta kodlarını ve paket boyutunu gönderir; uluslararası teslimatlar için hedef ülkeyi gönderir. Yurt içi gerçek zamanlı tarife yalnızca teslimat adresinde 4 haneli bir posta kodu varsa istenir. Paket Australia Post sınırlarını aşarsa (yurt içinde 22 kg veya 105 cm, uluslararasında 20 kg) hiçbir istek gönderilmez. AUD fiyatı kendi oranınızla dönüştürülür ve Remove GST açıksa yurt içi fiyatlardan GST çıkarılır. Fiyat mağazanızın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Başarılı her yanıt 1 saat önbellekte tutulur, böylece aynı sepet yeni bir istek tetiklemez. Başarısız bir istek 10 dakika önbellekte tutulur, böylece ödeme sayfası her yenilemede Australia Post'u beklemez. API zaman aşımı 10 saniyedir. API hataları müşteriye asla gösterilmez: taşıyıcı gizlenir veya yedek modda sabit fiyat kullanılır. Nedeni günlüğe yazılır.

Taşıyıcıda siparişler olduktan sonra Shipping > Carriers içinde düzenlerseniz PrestaShop bunu taşıyıcının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca tarifeleri hesaplar. Kargo etiketleri, eParcel veya MyPost Business gönderileri ya da manifestolar oluşturmaz, paketleri takip etmez ve müşterilerin paket dolapları veya Postane şubeleri seçmesine izin vermez. Sepet her zaman tek bir paket olarak fiyatlandırılır. Mektuplar, zarflar ve sözleşmeli (eParcel) tarifeler dahil değildir.

Lisans anahtarı

Modül, vibefox.net adresinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Australia Post lisans bloğu, Modules > Module Manager > VibeFox Australia Post > Configure sayfasında ayarların üstünde yer alan 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 geçerli olduğu son tarih 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üğmeleri görünür. Bunların altında Product: presta-shipping-australia-post satırı ile Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip personel değiştirebilir. Bloktaki metinler yönetim 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 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 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 Australia Post taşıyıcısı ödeme sırasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu nedenle taşıyıcı sizin için de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme sırasında test edemezsiniz. Modules > Module Manager sayfasındaki 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önetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Australia Post ödeme sırasında görünmüyor: lisansın etkin olduğunu ve Enable Australia Post seçeneğinin açık olduğunu kontrol edin (taşıyıcı Shipping > Carriers içinde etkin olmalıdır). Shipping > Carriers içinde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin (ya da Ignore shipping zones açık olmalı ve ülke Countries içinde izinli olmalıdır). Sepet ağırlığı sınırlarını ve Minimum order amount değerini kontrol edin. Sabit fiyat modunda ülkenin ya da * satırının bir fiyatı olup olmadığına bakın. Ürünler ayrıca ürün sayfasında belirli taşıyıcılarla da sınırlandırılmış olabilir.

Gerçek zamanlı tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve modül sayfasındaki Log alanına bakın. Nedeni gösterir: API anahtarı veya gönderim posta kodu yok, henüz 4 haneli teslimat posta kodu yok, paket sınırların üzerinde, AUD dönüşüm oranı yok veya Australia Post hata mesajı. Live rates, fixed price if the API gives no rate seçeneğiyle, siz sorunu düzeltirken müşteriler yine sabit fiyatı görür.

Mağazam AUD cinsinden değil: dönüşüm oranını (varsayılan para biriminizin kaç birimi bir AUD'ye eşittir) AUD → (your currency) rate alanına girin. Sabit fiyatlar her zaman varsayılan para biriminizdedir.

Kargoda GST iki kez alınıyor: Australia Post'un yurt içi fiyatları %10 GST içerir. Tax status Taxable ise ve taşıyıcının bir vergi kuralı varsa Remove GST seçeneğini açın veya Tax status değerini None yapın.

Kargoya vergi eklenmiyor: Tax status = Taxable iken vergi, taşıyıcının vergi kuralından gelir. Bunu Shipping > Carriers içinde seçin. Taşıyıcının vergi kuralı olmadığı sürece modül sayfası bir uyarı gösterir.

Fiyat çok yüksek ya da çok düşük: ürün ağırlıklarını ve boyutlarını ile Gerçek zamanlı tarifeler için paket bölümündeki varsayılan değerleri kontrol edin. Item (price × quantity) seçildiğinde sabit fiyatlar ürün sayısıyla çarpılır.

Bir değişiklikten sonra tarifeler güncel görünmüyor: modül sayfasında Save seçeneğine tıklayın. Bu, önbellekteki Australia Post tarifelerini temizler.

Sayfa Australia Post taşıyıcısının silindiğini bildiriyor: taşıyıcı Shipping > Carriers içinde silinmiş. Yeniden oluşturmak için modül sayfasında Save seçeneğine tıklayın ya da Modules > Module Manager içinde modülü sıfırlayın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Australia Post yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Taşıyıcı her zaman kaldırılır (siparişler geçmişini korur) ve önbellekteki tarifeler temizlenir. Remove data on uninstall açıksa ayarlar, tarife önbellek tablosu ve günlük de silinir. Kapalıysa ayarlar korunur ve modülü yeniden kurmak, taşıyıcıyı bölgeleri, grupları ve logosuyla birlikte geri yükler.

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