VibeFox EasyPost for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: cURL uzantısıyla birlikte 8.0 veya üzeri. Modül bunlar olmadan kurulmayı reddeder.

EasyPost hesabı (yalnızca canlı tarifeler için): EasyPost web sitesinde bir hesap oluşturun, taşıyıcı hesaplarınızı (USPS, UPS, FedEx ve diğerleri) EasyPost panelinde bağlayın ve API anahtarını EasyPost Dashboard > Account Settings > API Keys yolundan kopyalayın. EasyPost, tarife isteklerinden değil, satın alınan etiketlerden ücret alır. Yalnızca yedek fiyatları kullanıyorsanız EasyPost hesabına ihtiyacınız yoktur.

Ürünler: ürünlerin ağırlığı olmalıdır; boyutları da varsa daha iyidir.

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 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 EasyPost öğesini bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının en üstündeki lisans bölümündeki License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. EasyPost API anahtarınızı yapıştırın ve Ship from adresini doldurun. Canlı tarifeler için posta kodu zorunludur.

5. Varsayılan para biriminiz USD değilse USD exchange rate alanına kurunuzu girin. İsterseniz yedek fiyatları da girin (bkz. Yapılandırma). Save düğmesine tıklayın.

Kurulumda modül, Live carrier rate (EasyPost) teslimat süresi metniyle EasyPost Shipping 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 ve boyut sınırlarını Shipping > Carriers bölümünden değiştirebilirsiniz. Fiyatları burada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox EasyPost > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt ayrıca önbelleğe alınmış EasyPost tarifelerini temizler.

Sayfanın üstünde modül, canlı tarifeler kullanılamadığında uyarılar gösterir: API anahtarı yoksa (yedek fiyatlar olsun veya olmasın), gönderen posta kodu veya ülkesi yoksa ya da varsayılan para birimi kur girilmeden USD dışındaysa. Ayrıca test API anahtarı ayarlandığında bir not, modülün taşıyıcısı silindiğinde bir hata, mağazanızın ağırlık veya boyut birimi (International > Localization) modülün tanıdığı birimlerden biri değilse (kg, g, lb, oz; cm, mm, m, in) bir uyarı görünür.

Kaydederken sayı olmayan (veya negatif) bir değer kaydedilmez: bir uyarı alanı belirtir ve önceki değer korunur. Aynı durum USD exchange rate değeri 0 olduğunda ya da Minimum weight değeri Maximum weight değerinden büyük olduğunda da geçerlidir.

Genel

Enable EasyPost shipping: taşıyıcıyı açar veya kapatır. Bu, Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır. Varsayılan: on.

Name: ödeme sayfasında müşteriye gösterilen taşıyıcı adı; en fazla 64 karakter (daha uzun ad reddedilir ve hiçbir şey kaydedilmez). Varsayılan: EasyPost Shipping. Ad boşsa ya da PrestaShop'un taşıyıcı adında izin vermediği karakterler içeriyorsa varsayılan ad kullanılır.

EasyPost hesabı

API key: EasyPost Dashboard > Account Settings > API Keys bölümündeki EasyPost API anahtarınız. Üretim anahtarı (EZAK ile başlar) gerçek tarifeler döndürür. Test anahtarı (EZTK ile başlar) EasyPost test tarifeleri döndürür; yalnızca test için kullanın. Kaydettikten sonra alan boş kalır ve kayıtlı anahtarı maskelenmiş olarak gösterir, örneğin EZAK******abcd. Anahtarı korumak için alanı boş bırakın. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Remove the saved API key: kayıtlı anahtarı silmek için bu kutuyu işaretleyip Save düğmesine tıklayın.

Allowed carriers / services: isteğe bağlı, virgülle ayrılmış. EasyPost'un adlandırdığı şekliyle bir taşıyıcı (USPS) ya da bir taşıyıcı ve hizmet (USPS:Priority, UPS:Ground) girin. İzin verilen en ucuz tarife gösterilir. Herhangi bir taşıyıcının en ucuz tarifesini göstermek için boş bırakın.

Gönderen adresi

Paketlerinizin gönderildiği adres. Country mağazanızın ülkesiyse, boş alanlar Shop Parameters > Contact > Stores bölümündeki mağaza adresinden doldurulur (gönderen adı da mağaza adından alınır).

Sender name / company: gönderenin adı veya şirket adı.

Street address: gönderen adresinin cadde veya sokağı.

City: gönderen adresinin şehri.

State: iki harfli eyalet kodu, örneğin CA veya NY.

ZIP code: gönderen adresinin posta kodu. Canlı tarifeler için zorunludur.

Country: gönderim yaptığınız ülke. Varsayılan: United States.

Tarifeler

Parcels: sepetin EasyPost'a nasıl gönderileceği.

Ağırlıklar mağazanızın biriminden ons'a (en az 1 oz) ve boyutlar inç'e dönüştürülür. Herhangi bir ürünün boyutu yoksa paket yalnızca ağırlığa göre tarifelendirilir.

USD exchange rate: EasyPost tarifeleri USD cinsindedir. Varsayılan para biriminizde 1 USD'nin fiyatını girin, örneğin 0.92. Bu değer olmadan canlı tarifeler kullanılmaz, yalnızca yedek fiyatlar kullanılır. Varsayılan para birimi USD ise gerekmez. USD ve CAD mağazaları, EasyPost'tan kendi para biriminde teklif ister. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Tax: taşıyıcının vergi kuralı veya No tax. EasyPost tarifeleri satış vergisi içermez. Kargoya uygulanacak vergi kurallarını seçin.

Yedek fiyatlar

Canlı tarife olmadığında kullanılır: API anahtarı yoksa, EasyPost'a ulaşılamıyorsa, anahtar reddedilmişse ya da hiçbir taşıyıcının adres için tarifesi yoksa. Fiyatlar varsayılan para biriminizde ve vergi hariç verilir. Bu durumda taşıyıcıyı gizlemek için iki alanı da boş bırakın.

Country prices: ülke başına bir satır: iki harfli ülke kodu, iki nokta üst üste ve fiyat, örneğin US:9.99. Başka biçimdeki satırlar yok sayılır ve kaydederken bir uyarıda listelenir.

Other countries: yukarıdaki listede bulunmayan ülkeler için fiyat. Bu ülkeler için taşıyıcıyı gizlemek üzere boş bırakın.

Koşullar

Free shipping from: bu tutarın üzerindeki sepet ara toplamı (gönderilecek ürünler, indirimler sonrası, vergi öncesi, varsayılan para biriminizde) için kargo ücretsizdir. Bu durumda EasyPost'a istek gönderilmez. Kapatmak için boş bırakın.

Minimum subtotal: taşıyıcıyı yalnızca sepet ara toplamı (gönderilecek ürünler, indirimler sonrası, vergi öncesi) bu tutarın en az üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Minimum weight: sepet bundan hafifse taşıyıcıyı gizler; ağırlık, mağazanızın ağırlık biriminde girilir (alan etiketinde gösterilir). 0 sınır olmadığı anlamına gelir.

Maximum weight: sepet bundan ağırsa taşıyıcıyı gizler; ağırlık, mağazanızın ağırlık biriminde girilir. 0 sınır olmadığı anlamına gelir.

Bölge olmadan kullanılabilirlik

Normalde taşıyıcı, Shipping > Carriers bölümünde kendisine atanan bölgelerde sunulur. Alternatif olarak bölgelerden bağımsız olarak ülkeye göre de sunulabilir.

Ignore shipping zones: aşağıda belirtilen ülkeler için, bu ülkelerin bölgesi taşıyıcıya atanmış olsun veya olmasın taşıyıcıyı sunar. Bu seçenek açıkken kaydettiğinizde taşıyıcı, sonradan oluşturulanlar dahil tüm bölgelere atanır. Kapattığınızda taşıyıcı önceki bölgelerini geri alır.

Countries: bu mod için hedef ülkeler. Birden fazla seçmek için Ctrl+tık kullanın. Mağazanızın tüm etkin ülkelerini kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: EasyPost isteklerini modules/vfd_easypost/logs/vfd_ep.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'ta döndürülür. API hataları bu seçenek kapalıyken bile her zaman kaydedilir. API anahtarı ve müşteri adresleri hiçbir zaman kaydedilmez.

Remove data on uninstall: açıksa, modül kaldırıldığında ayarları, tabloları ve günlüğü silinir. Modülü devre dışı bırakmak ayarları hiçbir zaman silmez.

Log: ayarların altındaki panel günlüğün son 100 satırını gösterir. Temizlemek için Clear log düğmesine tıklayın.

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

Kargo adımında PrestaShop, EasyPost fiyatı için modüle sorar. Yalnızca fiziksel ürünler dikkate alınır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül önce koşulları kontrol eder: hedef ülke (Ignore shipping zones ile birlikte), sepet ağırlığı ve minimum ara toplam. Ücretsiz kargo uygulanıyorsa fiyat 0'dır ve EasyPost'a istek gönderilmez.

Aksi takdirde modül EasyPost'a gönderen adresini, teslimat adresini ve paketi gönderir; tüm taşıyıcı hesaplarınızın tarifelerini alır. İzin verilen en ucuz tarifeyi seçer, varsayılan para biriminize çevirir ve müşterinin sepet para biriminde gösterir. Posta kodu gerektiren ülkeler için istek yalnızca teslimat adresinde posta kodu varsa gönderilir. Müşteri bir adres girmeden önce yalnızca ziyaretçinin ülkesi bilinir; bu nedenle posta kodu gerektiren ülkeler, adres girilene kadar yedek fiyatı alır.

Her yanıt aynı adres ve aynı paket için 1 saat önbelleğe alınır. Kullanılabilir tarifesi olmayan bir adres 10 dakika hatırlanır. Zaman aşımı, reddedilen anahtar, istek sınırı veya EasyPost sunucu hatasından sonra 5 dakika boyunca istek gönderilmez. API zaman aşımı 10 saniyedir. Tüm bu durumlarda müşteri hata görmez: yedek fiyat kullanılır ya da yedek fiyat yoksa taşıyıcı gizlenir. Neden günlüğe yazılır.

Siparişleri olan bir taşıyıcıyı Shipping > Carriers bölümünde 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. Etiket satın almaz, paketleri takip etmez, adresleri doğrulamaz, teslim alma veya bırakma noktaları sunmaz ve sigorta ya da imza seçenekleri eklemez. Tek bir seçenek (izin verilen en ucuz tarife) gösterir, hizmet listesi göstermez. Ürünleri tek bir pakette birleştirmenin ötesinde kutu paketleme yoktur; tarifeye kâr marjı ya da işlem ücreti eklenmez.

Siparişler

EasyPost taşıyıcısıyla bir sipariş verildiğinde, ödeme sayfasında gösterilen tarife siparişle birlikte saklanır. Yönetim panelindeki sipariş sayfası EasyPost shipping bloğunu gösterir:

Carrier / service: tarifenin EasyPost taşıyıcısı ve hizmeti, örneğin USPS Priority. Ürün başına bir paket modunda kullanılan tüm hizmetler listelenir.

Estimated delivery days: EasyPost'un döndürdüğü teslimat günleri (yalnızca sipariş başına bir paket modunda ve EasyPost bunları döndürdüğünde).

Price source: Live EasyPost rate, Fallback price (no live rate) veya Free shipping threshold.

Calculated price (excl. tax): varsayılan para biriminizde fiyat.

Yönetim panelinde sepette sonradan yapılan değişiklikler bu değerleri değiştirmez. Etiketi EasyPost hesabınızda satın almak için bunları kullanın. Terk edilmiş sepetlerin tarifeleri 30 gün sonra silinir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox EasyPost lisans bloğu, Modules > Module Manager > VibeFox EasyPost > 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 geçerli olduğu tarih 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-easypost satırı ile 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. Bloktaki metinler back office 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 yalnızca 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 EasyPost taşıyıcısı ödeme sayfasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop vitrini back office'e giriş yaptığınızı bilmediği için taşıyıcı sizden de gizlenir: modülü bir 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ın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Back office'te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün içinde günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

EasyPost ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable EasyPost shipping seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde taşıyıcının etkin olduğunu ve müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin (ya da Ignore shipping zones açık ve ülke seçili olmalıdır). Ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Canlı tarife olmadan taşıyıcının, ülke için ya da Other countries için bir yedek fiyata ihtiyacı vardır. Ürün sayfasında ürünler belirli taşıyıcılarla da sınırlandırılabilir.

Canlı tarifeler görünmüyor: modül sayfasının üstündeki uyarıları okuyun, ardından Debug log seçeneğini açın, ödeme sayfasını yenileyin ve Log panelini inceleyin. Yaygın nedenler: API anahtarı veya gönderen posta kodu yok, USD dışında bir mağaza ve USD exchange rate girilmemiş, teslimat adresinde henüz posta kodu yok, EasyPost hesabınızdaki hiçbir taşıyıcı adrese hizmet vermiyor veya Allowed carriers / services tüm tarifeleri eliyor.

Tarifeler test fiyatlarına benziyor: bir test anahtarı (EZTK...) ayarlı. Canlı mağazada üretim anahtarı (EZAK...) kullanın.

Tarifeler birkaç dakikalığına durdu: zaman aşımı, reddedilen anahtar veya bir EasyPost sunucu hatasından sonra modül istekleri 5 dakika duraklatır ve yedek fiyatları kullanır. API anahtarını ve günlüğü kontrol edin.

Vergi dahil mi? EasyPost tarifeleri satış vergisi içermez. Kargoya vergi eklemek için Tax bölümünde vergi kuralını seçin.

Bir değişiklikten sonra tarifeler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış EasyPost tarifelerini temizler.

Sayfa modülün taşıyıcısının bulunamadığını söylüyor: taşıyıcı Shipping > Carriers bölümünde silinmiştir. Yeniden oluşturmak için Modules > Module Manager bölümünde modülü sıfırlayın.

Geliştirici kancaları: actionVfdEpShipmentRequest (istek gövdesi), actionVfdEpSelectedRate (seçilen tarife) ve actionVfdEpApiUrl (API temel URL'si) kancaları modülü özelleştirir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox EasyPost 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ı ödeme sayfasından kaldırılır (siparişler geçmişlerini korur) ve önbelleğe alınmış tarifeler her zaman silinir. Remove data on uninstall açıksa ayarlar, kaydedilmiş sipariş tarifeleri ve günlük de silinir. Kapalıysa, yeniden kurulum için ayarlar ve verilmiş siparişlerin EasyPost verileri korunur. Modülü kurmak veya sıfırlamak yeni bir taşıyıcı oluşturur. Ayarlar korunduysa taşıyıcı, önceki taşıyıcının durumunu (etkin veya devre dışı) alır.

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