VibeFox FedEx for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

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 değerlerini 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. Eklenti FedEx REST API'sini OAuth 2.0 ile kullanır; meter number veya web services şifresi gerekmez. 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. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_fedex 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 FedEx 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. API Key, Secret Key, 9 haneli FedEx hesap numarası ve Ship from adresini girin (posta kodu ve ABD ile Kanada için 2 harfli eyalet kodu). Canlı anahtarları kullanırken Sandbox seçeneğini kapatın.

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

7. İsteğe bağlı olarak yedek olarak sabit fiyatlar girin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Shipping > VibeFox FedEx. Bunlar 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 seçeneğin ödeme sayfasındaki adı. Genel Name değerini kullanmak için boş bırakın.

Sayfanın üstünde eklenti uyarılar gösterir: üç API kimlik bilgisinden yalnızca bazıları doldurulmuştur, API anahtarı ya da sabit fiyat yoktur (bu durumda yöntem hiçbir zaman gösterilmez), gönderici posta kodu yoktur, ABD veya Kanada için gönderici eyalet kodu yoktur ya da mağaza para birimi, döviz kuru olmadan FedEx hesap para biriminden farklıdır. Ayarları her kaydettiğinizde önbelleğe alınmış FedEx jetonu ve ücretler temizlenir. Sayı alanları ondalık nokta veya virgül kabul eder. Geçersiz bir sayı kaydedilmez ve bildirilir.

General

Enable/Disable: FedEx kargosunu tüm bölgelerde aynı anda açar veya kapatır. Varsayılan: açık.

Name: ödeme sırasında müşteriye gösterilen kargo yönteminin adı. Varsayılan: FedEx.

Tax status: Taxable seçeneğinde WooCommerce kargo ücretine vergi ekler, bu nedenle vergisiz FedEx ücreti kullanılır. None seçeneğinde FedEx net ücreti olduğu gibi kullanılır. Varsayılan: Taxable.

FedEx API (canlı ücretler)

Anahtarlar girilmemişse sabit fiyatlar kullanılır. Bölümde Clear cached FedEx token and rates bağlantısı bulunur.

Sandbox: test anahtarlarıyla FedEx sandbox'ını kullanır. Canlı anahtarlarla gerçek ücretler almak için 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.

FedEx account number: projeye bağlı 9 haneli FedEx kargo hesabı.

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 ek ücreti). Ağırlıklı olarak işletmelere gönderim yapıyorsanız kapatın. Varsayılan: açık.

Box size: mağaza boyut biriminizde isteğe bağlı kutu boyutları, örneğin 30x20x15. Bu durumda FedEx hacimsel ağırlığı uygular. Yalnızca ağırlığa göre fiyat vermek için boş bırakın.

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

Exchange rate: yalnızca FedEx ücretleri yalnızca hesap para biriminde döndürdüğünde ve mağaza para biriminiz farklı olduğunda gerekir: hesap para biriminin 1 biriminin mağaza para biriminizdeki fiyatı, örneğin 0.92. Bu değer olmadan 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'in ücret vermesi için gereklidir.

Sabit fiyatlar

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

Country prices: hedef ülke başına mağaza para biriminde fiyat; her satırda bir ülke, CC=FİYAT biçiminde, örneğin US=12.99 veya CA=19,99. Diğer tüm ülkeler için * kullanın, örneğin *=29.99. Başka biçimdeki satırlar yoksayılır ve kaydederken bildirilir.

Fallback cost: hiçbir ülke fiyatı eşleşmediğinde kullanılan sabit fiyat. Yöntemi gizlemek için boş bırakın.

Fixed price is: Per order fiyatı bir kez tahsil eder. Per item (price x number of items) fiyatı ürün adediyle çarpar. Bu yalnızca sabit fiyatlar için geçerlidir. FedEx canlı ücretleri her zaman sepetin toplam ağırlığı için verilir.

Koşullar

Free shipping from: bu yöntemin ücretsiz olduğu sepet ara toplamı. Hiç ücretsiz kargo vermemek için boş bırakın.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı bu tutarın en az olduğunda gösterir. Her zaman göstermek için boş bırakın.

Min weight (kg): yöntemin görünmesi için gereken en düşük sepet ağırlığı. 0 sınır olmadığı anlamına gelir.

Max weight (kg): en yüksek sepet ağırlığı. Aşılırsa yöntem gizlenir. 0 sınır olmadığı anlamına gelir.

Default product weight (kg): ağırlığı olmayan ürünler için, FedEx ücretleri için ve yukarıdaki ağırlık sınırları için kullanılan ağırlık. Varsayılan: 0.5.

Excluded shipping classes: sepette bu WooCommerce kargo sınıflarından birine ait bir ürün varsa yöntemi gizler.

Kargo bölgeleri olmadan kullanılabilirlik

Ignore shipping zones: yöntem bir kargo bölgesine eklenmemiş olsa bile aşağıdaki ülkeler için sunar. Bölgesinde kapalı olan bir bölge yöntemi kapalı kalır.

Countries: bu mod için hedef ülkeler. Mağazanın tüm kargo ü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ı WooCommerce > Status > Logs altına, kaynak vfd-fedex olarak kaydeder. API hataları her zaman kaydedilir. Anahtarlar, jetonlar ve müşteri adresleri asla kaydedilmez.

Remove data on uninstall: açıksa eklentiyi silmek tüm eklenti ayarlarını ve bölge yöntemlerini kaldırır. Eklentiyi devre dışı bırakmak ayarları asla silmez.

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

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir ücret ister. Eklenti önce sepet ağırlığını, minimum ara toplamı ve hariç tutulan kargo sınıflarını kontrol eder. Ücretsiz kargo uygulanıyorsa müşteri yöntemi FedEx (Free) olarak görür ve FedEx'e istek gönderilmez.

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

FedEx kullanılabilir hizmetleri döndürür. Her hizmet için eklenti, sizin seçtiğiniz hesap veya liste ücretini alır, mağaza para biriminde bir ücreti tercih eder, FedEx hesap para birimindeki bir ücreti döviz kurunuzla çevirir ve çeviremediği ücretleri atar. En ucuz hizmet yönteminizin adının altında gösterilir ve adı siparişin kargo satırına kaydedilir.

Jeton ortam ve anahtar bazında önbelleğe alınır ve 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 bir hata görmez: sabit fiyat kullanılır ya da yöntem gizlenir.

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

Eklenti 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 kutulara paketleme yoktur: sepet tek bir paket olarak fiyatlandırılır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox FedEx sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu 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 bir alan adında çalışır. Anahtarı bir siteden kaldırmak, alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa FedEx, ödeme sayfasında müşterilere gösterilmez. Oturum açmış mağaza yöneticileri yine de yöntemi (unlicensed — visible to admins only) işaretiyle görür; böylece bir 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.

Bir 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

FedEx ö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). Ayarlar sayfasının üstündeki uyarıları, ağırlık sınırlarını, Minimum subtotal ve Excluded shipping classes seçeneklerini kontrol edin. Canlı ücret yoksa yöntemin bir ülke fiyatına, bir * satırına veya bir Fallback cost değerine ihtiyacı vardır.

Canlı ücretler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve WooCommerce > Status > Logs sayfasını, kaynak vfd-fedex olacak şekilde açın. Yanlış anahtarlar, yanlış ortam (Sandbox kapalıyken test anahtarları veya açıkken canlı anahtarlar) ve FedEx hata kodları orada kaydedilir.

Mağazam USD kullanmıyor: FedEx'ten mağaza para biriminde ücret 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 yoksa bu tür ücretler yoksayılır ve sabit fiyat kullanılır; böylece USD tutarı asla euro 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: anahtarları değiştirdikten sonra önbellek otomatik olarak temizlenir. Clear cached FedEx token and rates bağlantısına da tıklayabilirsiniz.

Yalnızca bazı hizmetler sunulmalı: geliştiriciler vfd_fdx_allowed_services filtresiyle hizmetleri kısıtlayabilir.

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 hak serbest bırakı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 ayarları korur ve yalnızca önbelleğe alınmış jetonları ve ücretleri temizler. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbelleğe alınmış jetonlar ve ücretler ile eski günlük dosyaları her zaman kaldırılır. Ayarlar ve bölge yöntemleri yalnızca Remove data on uninstall seçeneği açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler kargo satırlarını korur.

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