VibeFox UPS for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

UPS Developer Portal uygulaması (yalnızca canlı tarifeler için): UPS Developer Portal'a (developer.ups.com) giriş yapın, "Rating" ürünüyle bir uygulama oluşturun, UPS hesabınızı bağlayın ve Client ID ile Client Secret bilgilerini kopyalayın. Eklenti OAuth 2.0 kullanır. Access Key, kullanıcı adı veya şifre gerekmez. Pazarlıklı tarifeler için 6 karakterli UPS hesap numaranız da gerekir. Kimlik bilgileri olmadan yalnızca sabit fiyatlar kullanılır.

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, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca vfd_ups klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Shipping > VibeFox UPS ya da Eklentiler 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. Client ID ve Client Secret bilgilerini, UPS hesap numaranızı (pazarlıklı tarifeler için) ve Ship from adresini girin: posta kodu ve ABD ile Kanada için 2 harfli eyalet kodu.

6. UPS hesabınızın para birimi mağaza para biriminden farklıysa UPS account currency ve Exchange rate alanlarını doldurun.

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

8. İsterseniz yedek olarak sabit fiyatları girin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Shipping > VibeFox UPS. 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 alanını kullanmak için boş bırakın.

Ayarları her kaydettiğinizde önbellekteki UPS jetonu ve tarifeler temizlenir. UPS API bölümündeki Clear cached UPS token and rates düğmesine de tıklayabilirsiniz. Ayarların üstündeki uyarılar; Client ID ve Client Secret'tan yalnızca birinin girili olduğunu, hiç kimlik bilgisi ve sabit fiyat bulunmadığını, gönderen posta kodu veya eyaletinin eksik olduğunu, hesap numarası olmadan hesap tarifelerinin seçildiğini ya da döviz kurunun eksik olduğunu bildirir.

General

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

Name: ödeme sayfasında gösterilen kargo yöntemi adı. Varsayılan: UPS.

Tax status: Taxable seçilirse WooCommerce kendi kargo vergisini ekler, None seçilirse eklemez. UPS tarifeleri vergisiz verilir, bu nedenle vergi iki kez alınmaz.

UPS API (canlı tarifeler)

Test mode: UPS test ortamını kullanır. Test tarifeleri gerçek fiyat değildir. Canlı tarifeler için kapatın. Varsayılan: kapalı.

Client ID: UPS Developer Portal'daki uygulamanızın Client ID değeri.

Client Secret: aynı uygulamanın Client Secret değeri.

UPS account number: 6 karakterli UPS gönderici numaranız, örneğin A1B2C3. Hesap (pazarlıklı) tarifeleri için gereklidir, genel tarifeler için isteğe bağlıdır.

Rates: hangi UPS fiyatlarının kullanılacağı.

Measurement units: UPS'e gönderilen birimler. Mağazanızdaki ağırlık ve boyutlar dönüştürülür.

Residential delivery: müşteri adreslerini UPS konut ek ücretiyle konut adresi olarak hesaplar. Ağırlıklı olarak 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 UPS hacimsel ağırlığı uygular. Yalnızca ağırlığa göre hesaplamak için boş bırakın.

UPS account currency: UPS, gönderici hesabının ülkesinin para biriminde hesaplar; örneğin ABD için USD, Kanada için CAD veya Euro bölgesi için EUR. Varsayılan: USD.

Exchange rate: yalnızca UPS hesabının para birimi mağaza para biriminden farklıysa gereklidir. Hesap para biriminin 1 biriminin mağaza para biriminizdeki fiyatını girin, örneğin 0.92. Bu alan boşsa bu tarifeler kullanılmaz ve sabit fiyatlar geçerli olur. Döviz kurları otomatik güncellenmez.

Gönderici adresi (UPS'in paketleri aldığı veya sizin paketleri bıraktığınız adres; canlı tarifeler için kullanılır)

Country: gönderim yaptığınız ülke. Varsayılan olarak mağazanızın ülkesidir.

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

City: gönderim yaptığınız şehir.

ZIP / postal code: gönderim yaptığınız posta kodu. UPS tarifeleri hesaplamak için buna ihtiyaç duyar.

Sabit fiyatlar (API kimlik bilgileri girilmediğinde ve UPS tarife döndürmediğinde yedek olarak kullanılır; bu durumda yöntemi gizlemek için ikisini de boş bırakın)

Country prices: hedef ülkeye göre mağaza para biriminde fiyatlar. Satır eklemek için + Add country düğmesine, satır silmek için çarpı işaretine tıklayın. * Default satırı diğer tüm ülkeler için geçerlidir. Bir ağırlık sütunu (XS 1 kg'a kadar, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL 5 kg üzeri), sepetin o ağırlığı için Price değerinin yerine geçer. Boş hücreler Price değerini kullanır. 0, ücretsiz kargo anlamına gelir. Hiçbir fiyatı olmayan satırlar kaydedildiğinde silinir, sayı olmayan değerler bir mesajla reddedilir.

Fallback cost: hiçbir ülke fiyatı eşleşmediğinde mağaza para biriminde sabit bir fiyat. Bu durumda yöntemi gizlemek için boş bırakın.

Fixed price is: Per order fiyatı bir kez tahsil eder. Per item (each item priced by its own weight x quantity) her ürünü kendi ağırlığına göre (ağırlığı yoksa varsayılan ağırlığa göre) fiyatlandırır ve adetle çarpar. UPS canlı tarifeleri her zaman sepetin toplam ağırlığı için hesaplanır.

Koşullar

Free shipping from: bu yöntemin ücretsiz olduğu sepet ara toplamı. Müşteri yöntem adını "(Free)" ifadesiyle görür ve UPS'e istek gönderilmez. Ücretsiz kargo hiçbir zaman sunulmasın istiyorsanız 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): bu 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): bu sepet ağırlığının üzerinde yöntem gizlenir. Varsayılan: 70, UPS'in paket başına sınırı (70 kg / 150 lbs). 0 sınır olmadığı anlamına gelir.

Default product weight (kg): ağırlığı olmayan ürünler için kullanılan ağırlık; UPS tarifelerinde, ağırlık sütunlarında ve ağırlık sınırlarında kullanılır. 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ölgesi olmadan kullanılabilirlik

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

Countries: bu mod için hedef ülkeler. Mağazanın tüm kargo ülkelerini kullanmak için boş bırakın. Bu alan yalnızca Ignore shipping zones açıkken kullanılır.

Gelişmiş

Debug log: API isteklerini ve tarife hesaplamasını WooCommerce > Status > Logs bölümünde, kaynak vfd-ups olarak günlüğe kaydeder. API hataları bu seçenek kapalı olsa bile her zaman günlüğe yazılır. Kimlik bilgileri, jetonlar ve müşteri adresleri asla günlüğe yazılmaz.

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 sayfasında nasıl çalışır

Müşteri bir teslimat adresi girdiğinde WooCommerce eklentiden bir tarife ister. Eklenti önce koşulları kontrol eder: sepet ağırlığı, minimum ara toplam ve hariç tutulan kargo sınıfları. Ücretsiz kargo geçerliyse yöntem ücretsiz olarak gösterilir ve UPS'e istek gönderilmez.

Eklenti UPS'ten bir OAuth jetonu alır ve süresi dolana kadar saklar. UPS'in reddettiği bir jeton otomatik olarak yenilenir. Ardından eklenti, gönderici adresinizden müşterinin adresine kadar tüm hizmetler için, sepeti tek bir paket olarak kabul eden bir istek UPS Rating API'sine gönderir. Posta kodu kullanılan ülkelerde, istek müşteri bir posta kodu girene kadar bekler. ABD'den Kanada veya Porto Riko'ya yapılan gönderilerde UPS'in gerektirdiği şekilde malın değeri iletilir.

Müşteri, en ucuz UPS hizmetini içeren ve mağazanızın para birimine çevrilmiş tek bir seçenek görür. Eklenti bir Access Point adresi toplamadığı için UPS Access Point Economy tarifelendirilmez.

Her tarife 1 saat önbellekte tutulur. Başarısız bir istek 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. HTTP zaman aşımı 15 saniyedir. Eklentiyi devre dışı bırakmak, önbellekteki jetonu ve tarifeleri temizler.

UPS tarife vermezse (API çalışmıyor, hatalı kimlik bilgileri, hizmet yok), fiyat önce Country prices, ardından Fallback cost alanından alınır. İkisi de geçerli değilse yöntem gizlenir. Müşteri UPS hata metinlerini asla görmez.

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

Eklenti yalnızca tarife hesaplar. UPS Access Point seçimi sunmaz, kargo etiketi veya UPS gönderisi oluşturmaz, kurye talebi açmaz ve paketleri izlemez. Birden fazla UPS hizmeti değil, tek bir seçenek gösterir. Kutuya yerleştirme yapılmaz: sepet tek paket olarak hesaplanır. Döviz kurları otomatik değildir.

Siparişler

Canlı tarife için siparişin kargo satırı UPS service bilgisini saklar, örneğin UPS Ground. Mağaza yöneticisi bunu yönetici panelindeki sipariş ekranında görür.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Shipping > VibeFox UPS 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 ve anahtarı bu siteden kaldırmak için Remove key düğmesini kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar yalnızca bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o sitenin alan adı hakkını serbest bırakmaz. Bunu vibefox.net hesabınızdan serbest bırakın.

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

UPS ö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çıksa ve ülke izinliyse). Ağırlık sınırlarını, Minimum subtotal ve Excluded shipping classes ayarlarını kontrol edin. Çalışan UPS kimlik bilgileri yoksa yöntem sabit bir fiyata ihtiyaç duyar (Country prices veya Fallback cost).

Canlı tarifeler görünmüyor: ayarlar sayfasının üstündeki uyarıları kontrol edin. Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasını, kaynak vfd-ups olacak şekilde açın. Burada OAuth hatalarını (Client ID, Client Secret ve Test mode ayarını kontrol edin), UPS hata mesajlarını ve para birimi sorunlarını görürsünüz.

Tarife USD'de ama mağaza farklı para biriminde: UPS tarifeleri gönderici hesabının para biriminde döndürür. UPS account currency ve Exchange rate alanlarını ayarlayın. Döviz kuru olmadan bu tarifeler yok sayılır ve sabit fiyat kullanılır.

"This measurement system is not valid for the selected country": Measurement units seçeneğini Automatic bırakın veya gönderim yaptığınız ülke için UPS'in beklediği birimleri seçin.

Bir değişiklikten sonra tarifeler eski görünüyor: ayarlar sayfasını kaydedin veya Clear cached UPS token and rates düğmesine tıklayın.

Geliştiriciler için: vfd_upsx_allowed_services ve vfd_upsx_excluded_services filtreleri gösterilebilecek UPS hizmetlerini sınırlar. vfd_upsx_rate_request tarife isteğini, vfd_upsx_api_base_url API adresini değiştirir ve vfd_upsx_currency_codes UPS'in döndürdüğü para birimi kodlarını eşler.

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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak ayarları korur ve yalnızca önbellekteki jetonu ve tarifeleri temizler. Eklentiyi kaldırmak için devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbellekteki jeton ve tarifeler 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.

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