VibeFox FedEx for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: cURL uzantılı 8.0 veya üzeri. Bunlar olmadan modül kurulmaz.

FedEx hesabı ve API anahtarları (yalnızca canlı ücretler için): FedEx Developer Portal'da (developer.fedex.com) Rate API'li bir proje oluşturun, FedEx kargo hesabınızı bağlayın ve API Key ile Secret Key'i kopyalayın. Ayrıca 9 haneli FedEx hesap numaranıza ihtiyacınız olacak. Test anahtarları yalnızca Sandbox açıkken, canlı anahtarlar yalnızca kapalıyken çalışır. Modül OAuth 2.0 ile FedEx REST API'sini kullanır; meter number veya web services şifresi gerektirmez. Yalnızca sabit fiyat kullanıyorsanız FedEx 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. 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 veya VibeFox FedEx modülünü daha sonra modül listesinde bulup Configure düğmesine tıklayın.

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

4. API Key, Secret Key, 9 haneli FedEx hesap numarası ve Ship from adresini (posta kodu ve ABD ile Kanada için 2 harfli eyalet kodu) girin. Canlı anahtar kullanıyorsanız Sandbox seçeneğini kapatın. İsterseniz yedek olarak sabit fiyatları girin. Save düğmesine tıklayın.

Kurulumda modül, FedEx delivery teslimat süresi metniyle FedEx 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ı orada ayarlamayın: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox FedEx > Configure. Ayarlar taşıyıcının tüm bölgeleri için geçerlidir. 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ış FedEx jetonunu ve ücretlerini temizler.

Sayfanın üstünde modül uyarılar gösterir: üç API kimlik bilgisinden yalnızca bazıları doldurulmuş, API anahtarı ve sabit fiyat yok (bu durumda taşıyıcı hiç gösterilmez), gönderici posta kodu yok, ABD veya Kanada için gönderici eyalet kodu yok, mağaza para birimi döviz kuru olmadan FedEx hesabının para biriminden farklı, mağazanın ağırlık birimi (ya da kutu boyutu varsa boyut birimi) modül tarafından tanınmıyor ya da bir taşıyıcı silinmiş. Sayısal alanlar ondalık nokta veya virgül kabul eder. Geçersiz bir sayı veya kutu boyutu, 0 döviz kuru, 3 harfli kod olmayan bir hesap para birimi ve 64 karakterden uzun bir ad kaydedilmez ve hata olarak bildirilir; alan önceki değerini korur, diğer alanlar kaydedilir. Minimum ağırlığın maksimum ağırlıktan büyük olması da bildirilir ve iki ağırlık da önceki değerlerini korur.

Genel

Enable/Disable: FedEx ile kargoyu açar veya kapatır. Bu, Shipping > Carriers bölümündeki taşıyıcı durumuyla aynı anahtardır.

Name: müşterinin ödeme sırasında gördüğü kargo yöntemi adı (taşıyıcı adı). Varsayılan: FedEx. Zorunlu.

Tax status: taşıyıcının vergi kuralı veya No tax. Bir vergi kuralı varsa (ve mağazada vergiler açıksa) PrestaShop kargo ücretine vergi ekler, bu yüzden vergisiz FedEx ücreti kullanılır. No tax seçildiğinde FedEx net ücreti olduğu gibi kullanılır.

FedEx API (canlı ücretler)

Anahtar girilmezse aşağıdaki sabit fiyatlar kullanılır. Bu bölümde Clear cached FedEx token and rates düğmesi bulunur.

Sandbox: test anahtarlarıyla FedEx sandbox'ını (apis-sandbox.fedex.com) kullanır. Canlı ücretler (apis.fedex.com) için canlı anahtarlarla kapatın. Varsayılan: açık.

API Key: FedEx Developer Portal projenizin API Key (client_id) değeri.

Secret Key: aynı projenin Secret Key (client_secret) değeri. 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. API Key'i temizlemek kayıtlı Secret Key'i de siler.

FedEx account number: projeye bağlı 9 haneli FedEx kargo hesap numarası. Hesap (pazarlıklı) ücretleri bu hesap için teklif edilir.

Rates: Account rates (your negotiated FedEx prices) (varsayılan) veya List rates (FedEx published prices).

Residential delivery: müşteri adreslerini konut adresi olarak fiyatlandırır (FedEx Home Delivery, konut teslimat ek ücreti). Çoğunlukla işletmelere gönderim yapıyorsanız kapatın. Varsayılan: açık.

Box size: mağazanızın boyut biriminde isteğe bağlı kutu ölçüleri, örneğin 30x20x15. Bu durumda FedEx hacimsel ağırlığı uygular. Yalnızca ağırlığa göre fiyat almak için boş bırakın.

FedEx account currency: FedEx hesabınızın para birimi; örneğin ABD hesapları için USD, Kanada için CAD. Varsayılan: USD. FedEx'ten her zaman mağazanın varsayılan para biriminde de fiyat istenir.

Exchange rate: yalnızca FedEx ücretleri yalnızca hesap para biriminde döndürdüğünde ve mağazanızın varsayılan para birimi farklı olduğunda gereklidir: 1 birim hesap para biriminin varsayılan para biriminizdeki fiyatı, örneğin 0.92. Girilmezse bu tür ücretler kullanılmaz.

Gönderici adresi

FedEx'in paketleri aldığı veya sizin paketleri bıraktığınız adres. Canlı ücretler için kullanılır.

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

State / province code: ABD ve Kanada için zorunlu olan 2 harfli kod, örneğin TN, CA veya ON.

City: gönderici şehri.

ZIP / postal code: gönderici posta kodu. FedEx ücret teklifi için bunu gerektirir.

Sabit fiyatlar

API anahtarı girilmediğinde ve FedEx hiçbir ücret döndürmediğinde (API kullanılamıyor, yanlış anahtarlar, uygun hizmet yok) yedek olarak kullanılır. Bu durumda taşıyıcıyı gizlemek için iki alanı da boş bırakın.

Country prices: hedef ülke kodları (2 harfli) ve mağazanızın varsayılan para biriminde, vergi hariç fiyatlardan oluşan bir tablo. Ülke eklemek için Add row düğmesine, bir ülkeyi silmek için çöp kutusu simgesine tıklayın. Diğer tüm ülkeler için ülke kodu olarak * kullanın. Ülke kodu (veya *) ve fiyatı olmayan satırlar yok sayılır ve kaydederken bildirilir.

Fallback cost: hiçbir ülke fiyatı eşleşmediğinde uygulanan sabit fiyat. Taşıyıcıyı gizlemek için boş bırakın.

Fixed price is: Per order fiyatı bir kez uygular. Per item (price x number of items) ise fiyatı sepetteki ürün sayısıyla çarpar. Bu yalnızca sabit fiyatlar için geçerlidir. FedEx canlı ücretleri her zaman sepetin toplam ağırlığı için teklif edilir.

Koşullar

Free shipping from: bu taşıyıcının ücretsiz olduğu sepet ara toplamı (indirimlerden sonra, vergiden önce). Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.

Minimum subtotal: taşıyıcıyı yalnızca sepet ara toplamı bu tutara eşit veya üzerindeyse gösterir. Her zaman göstermek için boş bırakın.

Min weight: taşıyıcının görünmesi için sepetin kg cinsinden minimum ağırlığı. 0 sınır olmadığı anlamına gelir.

Max weight: sepetin kg cinsinden maksimum ağırlığı. Aşılırsa taşıyıcı gizlenir. 0 sınır olmadığı anlamına gelir.

Default product weight: ağırlığı olmayan ürünler, FedEx ücretleri ve yukarıdaki ağırlık sınırları için kullanılan kg cinsinden ağırlık. Varsayılan: 0.5. Ürün ağırlıkları, International > Localization (Local units) bölümünde ayarlanan mağaza ağırlık biriminden (kg, g, lb veya oz) dönüştürülür.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: aşağıdaki ülkeler için, bölgeleri taşıyıcıya atanmamış olsa bile taşıyıcıyı sunar. Kaydedildiğinde taşıyıcı, sonradan oluşturulanlar dahil tüm bölgelere bağlanır. Kapatıldığında taşıyıcı önceki bölgelerini geri alır.

Countries: bu mod için hedef ülkeler. Mağazanın tüm ülkeleri için boş bırakın. Yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: API isteklerini ve ücret hesaplamasını modül klasöründeki logs/vfd_fdx_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API hataları her zaman kaydedilir. Anahtarlar, jetonlar ve müşteri adresleri asla kaydedilmez.

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa modülü kaldırmak tüm modül ayarlarını, taşıyıcıyı ve siparişlerde saklanan FedEx hizmetlerini siler. Kapalıysa yeniden kurulum için her şey korunur.

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

Kargo adımında PrestaShop, FedEx fiyatı için modüle istekte bulunur. Yalnızca fiziksel ürünler dikkate alınır: sanal ürünler ağırlık eklemez ve ara toplama dahil edilmez. Modül önce izin verilen ülkeleri (Ignore shipping zones ile birlikte), sepet ağırlığını ve minimum ara toplamı kontrol eder. Ücretsiz kargo uygulanırsa fiyat 0 olur ve FedEx'e istek gönderilmez.

Aksi halde modül bir OAuth jetonu alır ve FedEx Rate API'sine gönderici adresini, teslimat adresini, sepet ağırlığını (kg olarak veya lb ya da oz kullanan mağazalar için lb olarak), varsa kutu boyutunu ve tercih edilen para birimi olarak varsayılan para biriminizi gönderir. Posta kodu gerektiren ülkelerde istek, müşteri bir posta kodu girdikten sonra gönderilir. Uluslararası gönderilerde sepetin gümrük değeri iletilir. Eyalet kodları yalnızca ABD ve Kanada için gönderilir.

FedEx kullanılabilir hizmetleri döndürür. Modül her hizmet için seçtiğiniz hesap veya liste ücretini alır, varsayılan para biriminizdeki bir ücreti tercih eder, FedEx hesap para birimindeki bir ücreti döviz kurunuzla çevirir ve çeviremediği ücretleri atar. Fiyat için en ucuz hizmet kullanılır ve fiyat müşterinin sepet para biriminde gösterilir.

Jeton ortam ve anahtara göre önbelleğe alınır; FedEx reddettiğinde otomatik olarak yeniden istenir. Fiyatlar 1 saat önbelleğe alınır. Başarısız bir ücret isteği 10 dakika, başarısız bir jeton isteği 5 dakika hatırlanır; böylece bir kesinti her ödeme sayfası güncellemesini yavaşlatmaz. API zaman aşımı 15 saniyedir. FedEx yanıt vermezse müşteri hata görmez: sabit fiyat kullanılır veya taşıyıcı gizlenir. Nedeni hata ayıklama günlüğüne yazılır.

Shipping > Carriers bölümünde taşıyıcıda sipariş olduktan sonra 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 ücret hesaplar. FedEx gönderisi oluşturmaz, etiket yazdırmaz, kargo alımı ayırtmaz, paketleri takip etmez ve müşterinin bir FedEx noktası seçmesine izin vermez. Birden fazla değil, tek bir seçenek (en ucuz hizmet) gösterir ve kutu paketleme yoktur: sepet tek bir paket olarak fiyatlandırılır.

Siparişler

Yönetim panelindeki sipariş sayfasında FedEx taşıyıcılı siparişlerde bir FedEx shipping bloğu bulunur. Bu blok ücretin FedEx service değerini (canlı ücretler için), Price source değerini (FedEx live rate, Fixed price (no live rate) veya Free shipping threshold) ve mağazanızın varsayılan para birimindeki Calculated price (excl. tax) değerini gösterir. Değerler sipariş verildiğinde sabitlenir: ayarlardaki sonraki değişiklikler bunları değiştirmez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox FedEx lisans bloğu, Modules > Module Manager > VibeFox FedEx > 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-fedex satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri 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 tarihli License expired on. Mağaza adresi değiştiğinde veya hesabınızda bir alan adı yuvasını serbest bıraktığınızda 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ızda serbest bırakın.

Etkin bir anahtar olmadan FedEx taşıyıcısı ödeme sırasında müşterilere gösterilmez ve hiçbir fiyat hesaplanmaz. PrestaShop mağazası yönetim paneline giriş yaptığınızı bilmez, bu yüzden taşıyıcı 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. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

FedEx ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable/Disable seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde taşıyıcının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin (veya Ignore shipping zones seçeneğini açıp Countries bölümünü kontrol edin). Modül sayfasının üstündeki uyarıları, ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Canlı ücret yoksa taşıyıcının bir ülke fiyatına, bir * satırına veya bir Fallback cost değerine ihtiyacı vardır. Ayrıca ürün sayfasında ürünler belirli taşıyıcılarla sınırlandırılmış olabilir.

Canlı ücretler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Yanlış anahtarlar, yanlış ortam (Sandbox kapalıyken test anahtarları veya açıkken canlı anahtarlar), eksik teslimat posta kodu ve FedEx hata kodları burada kaydedilir.

Mağazam USD kullanmıyor: FedEx'ten ücret mağazanızın varsayılan para biriminde istenir. Hesabınız yalnızca kendi para birimini döndürüyorsa FedEx account currency ve Exchange rate değerlerini ayarlayın. Döviz kuru olmadan bu ücretler yok sayılır ve sabit fiyat kullanılır, böylece bir USD tutarı asla TL olarak gösterilmez.

"Per item" FedEx ücretini çarpar mı? Hayır. Per item yalnızca sabit fiyatlar için geçerlidir.

Bir değişiklikten sonra ücretler eski görünüyor: modül sayfasını kaydetmek önbelleği temizler. Ayrıca Clear cached FedEx token and rates düğmesine de tıklayabilirsiniz.

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

Yalnızca bazı hizmetler sunulmalı: geliştiriciler, actionVfdFdxAllowedServices kancasıyla hizmetleri sınırlayabilir. actionVfdFdxRateRequest ve actionVfdFdxApiBaseUrl kancaları ücret isteğini ve API adresini değiştirir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox FedEx yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbelleğe alınmış jetonlar ve ücretler her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişlerini korur), ayrıca ayarlar, günlük ve siparişlerde saklanan FedEx hizmetleri kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak (veya Reset) kayıtlı taşıyıcıya kaldırılmadan önceki durumunu geri verir.

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