VibeFox UPS for PrestaShop — Yardım
Gereksinimler
PrestaShop: 8.0 – 9.x.
PHP: cURL uzantılı 8.0 veya üzeri. Modül, eski PHP sürümlerinde veya cURL olmadan kurulmaz.
UPS Developer Portal uygulaması (yalnızca canlı tarifeler için): UPS Developer Portal'a (developer.ups.com) giriş yapın, "Rating" ürünü ile bir uygulama oluşturun, UPS hesabınızı bağlayın ve Client ID ile Client Secret değerlerini kopyalayın. Modül OAuth 2.0 kullanır. Access Key, kullanıcı adı veya şifre gerekmez. Pazarlık edilmiş tarifeler için 6 karakterli UPS hesap numaranız da gerekir. Kimlik bilgisi olmadan yalnızca sabit fiyatlar kullanılır.
VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.
Kurulum
1. Yönetim panelinde Modules > Module Manager sayfasına gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.
2. Yükleme bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox UPS'i bulup Configure düğmesine tıklayın.
3. Configure sayfasının üstündeki lisans bölümündeki License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).
4. Client ID ve Client Secret değerlerini, UPS hesap numaranızı (pazarlık edilmiş tarifeler için) ve Ship from adresini girin: posta kodu ve ABD ile Kanada için 2 harfli eyalet kodu.
5. UPS hesap para biriminiz mağazanızın varsayılan para biriminden farklıysa UPS account currency ve Exchange rate alanlarını girin.
6. İsterseniz yedek olarak sabit fiyatları girin ve Save düğmesine tıklayın.
Kurulumda modül, UPS delivery teslimat süresi metniyle UPS 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 içinden değiştirebilirsiniz. Orada fiyat tanımlamayın: fiyat her zaman modülden gelir.
Yapılandırma
Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox UPS > Configure. Ayarlar taşıyıcının tüm bölgelerinde geçerlidir. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbellekteki UPS jetonunu ve tarifeleri temizler. UPS API bölümündeki Clear cached UPS token and rates düğmesine de tıklayabilirsiniz.
Ayarların üstündeki uyarılar şunları bildirir: Client ID ve Client Secret'tan yalnızca biri girilmişse, kimlik bilgisi ve sabit fiyat yoksa (bu durumda taşıyıcı hiç gösterilmez), gönderici posta kodu veya eyalet eksikse, hesap numarası olmadan hesap tarifesi seçilmişse, döviz kuru eksikse veya mağazanın ağırlık ya da boyut birimi modül tarafından tanınmıyorsa. Geçersiz sayılar, yanlış kutu boyutu ve Max weight değerinin üzerindeki bir Min weight kaydedilirken bildirilir ve eski değer korunur.
Genel
Enable UPS shipping: taşıyıcıyı açar veya kapatır. Bu, Shipping > Carriers içindeki taşıyıcı durumuyla aynı anahtardır.
Name: ödeme sırasında müşteriye gösterilen taşıyıcı adı. Varsayılan: UPS. Zorunlu, en fazla 64 karakter.
Tax status: taşıyıcının vergi kuralı veya None. UPS tarifeleri vergisiz verilir. Bir vergi kuralı varsa mağaza kendi kargo vergisini üstüne ekler.
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: off.
Client ID: UPS Developer Portal'daki uygulamanızın Client ID değeri. Silinmesi, kayıtlı Client Secret'ı da kaldırır.
Client Secret: aynı uygulamanın 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.
UPS account number: 6 karakterli UPS gönderici numaranız, örneğin A1B2C3. Hesap (pazarlık edilmiş) tarifeleri için gereklidir, yayımlanmış tarifeler için isteğe bağlıdır.
Rates: kullanılacak UPS fiyatları.
Measurement units: UPS'e gönderilen birimler. Mağaza ağırlıkları ve boyutları dönüştürülür.
Residential delivery: müşteri adreslerini UPS konut ek ücretiyle konut adresi olarak hesaplar. Çoğunlukla işletmelere gönderim yapıyorsanız kapatın. Varsayılan: on.
Box size: mağazanızın boyut biriminde isteğe bağlı kutu boyutları, ö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 fiyat verir; ö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 hesap para birimi mağazanızın varsayılan para biriminden farklıysa gereklidir. Hesap para biriminden 1 birimin, varsayılan para biriminizdeki fiyatını girin, örneğin 0.92. Bu alan olmadan bu tarifeler kullanılmaz ve sabit fiyatlar uygulanır. Döviz kurları otomatik güncellenmez.
Gönderici adresi (UPS'in paketi aldığı veya sizin paketleri teslim ettiğiniz 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 bunu gerektirir.
Sabit fiyatlar (API kimlik bilgileri girilmediğinde ve UPS tarife döndürmediğinde yedek olarak kullanılır; bu durumda taşıyıcıyı gizlemek için iki alanı da boş bırakın)
Country prices: mağazanızın varsayılan para birimindeki, vergisiz ve varış ülkesine göre fiyatlar. Satır eklemek için Add country düğmesine, satır silmek için kaldırma düğmesine tıklayın. * ülkesi 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'dan fazla) o ağırlık 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 kaydedilirken silinir ve sayı olmayan değerler bir mesajla reddedilir.
Fallback cost: hiçbir ülke fiyatı eşleşmediğinde mağazanızın varsayılan para biriminde sabit bir fiyat. Bu durumda taşıyıcıyı gizlemek için boş bırakın.
Fixed price is: Per order fiyatı bir kez, tüm sepetin ağırlığı için alır. 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ık) fiyatlandırır ve adetle çarpar. Bir üründe sabit fiyat yoksa taşıyıcı gizlenir. UPS canlı tarifeleri her zaman tüm sepet ağırlığı için verilir.
Koşullar
Free shipping from: bu taşıyıcının ücretsiz olduğu sepet ara toplamı (kargo gerektiren ürünler, indirimlerden sonra, vergiden önce). Bu durumda UPS'e istek gönderilmez. Hiçbir zaman ücretsiz kargo sunmamak için boş bırakın.
Minimum subtotal: taşıyıcıyı yalnızca sepet ara toplamı bu tutarın en az üzerindeyse gösterir. Her zaman göstermek için boş bırakın.
Min weight: bu taşıyıcının görünmesi için gereken en düşük sepet ağırlığı (kg). 0 sınır olmadığı anlamına gelir.
Max weight: taşıyıcı, sepet ağırlığı bu değerin (kg) üzerindeyse gizlenir. Varsayılan: 70, UPS'in paket başına sınırı (70 kg / 150 lbs). 0 sınır olmadığı, boş ise 70 anlamına gelir. Min weight, Max weight değerinden büyük olamaz.
Default product weight: ağırlığı olmayan ürünler için UPS tarifelerinde, ağırlık sütunlarında ve ağırlık sınırlarında kullanılan ağırlık (kg). Varsayılan: 0.5.
Kargo bölgeleri olmadan kullanılabilirlik
Normalde taşıyıcı, Shipping > Carriers içinde atandığı bölgelerde sunulur.
Ignore shipping zones: hangi bölgenin eşleştiğine bakmaksızın taşıyıcıyı aşağıdaki ülkeler için sunar. Kaydedildiğinde taşıyıcı tüm bölgelere, sonradan oluşturulan bölgelere de eklenir. Kapatıldığında bu bölgeler yeniden kaldırılır.
Countries: bu mod için varış ülkeleri. Mağazanın tüm aktif ü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ı modül klasöründeki logs/vfd_upsx_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. Kimlik bilgileri, 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 ayarları, taşıyıcıyı, önbellekteki jetonları ve tarifeleri, günlüğü ve siparişlerle kaydedilmiş UPS hizmetlerini siler. Siparişlerin kendisi korunur. Kapalıysa, yeniden kurulum için her şey korunur.
Ödemede nasıl çalışır
Kargo adımında PrestaShop, UPS fiyatını modülden ister. 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: Ignore shipping zones ülkeleri, sepet ağırlığı ve minimum ara toplam. Ücretsiz kargo geçerliyse fiyat 0 olur ve UPS'e istek gönderilmez.
Modül UPS'ten bir OAuth jetonu alır ve süresi dolana kadar saklar. UPS'in reddettiği bir jeton otomatik olarak yenilenir. Ardından UPS Rating API'sinden, gönderici adresinizden müşterinin adresine kadar tüm hizmetleri ister; sepet tek bir paket olarak değerlendirilir. Posta kodu olan ülkelerde istek, müşteri posta kodunu girene kadar bekler. ABD'den Kanada'ya veya Porto Riko'ya gönderimlerde UPS'in gerektirdiği şekilde malın değeri gönderilir.
Müşteri, en ucuz UPS hizmetini içeren tek bir seçenek görür. Fiyat mağazanızın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir. UPS Access Point Economy fiyatlandırılmaz, çünkü modül bir Access Point adresi toplamaz.
Her teklif 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 güncellemesini yavaşlatmaz. HTTP zaman aşımı 15 saniyedir.
UPS tarife döndürmezse (API çalışmıyor, hatalı kimlik bilgileri, hizmet yok, döviz kuru olmayan başka bir para birimi), fiyat önce Country prices, sonra Fallback cost alanından alınır. İkisi de geçerli değilse taşıyıcı gizlenir. Müşteri UPS hata metinlerini asla görmez.
Taşıyıcıyı siparişleri 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 takip eder.
Modül yalnızca tarifeleri 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 yoktur: sepet tek bir paket olarak fiyatlandırılır. Döviz kurları otomatik değildir.
Siparişler
Canlı bir UPS tarifesiyle sipariş verildiğinde UPS hizmeti siparişle birlikte kaydedilir. Yönetim paneli sipariş sayfasında, UPS service (örneğin UPS Ground) ve Live rate (excl. tax) bilgilerini içeren bir UPS bloğu gösterilir. Yönetim panelinde sonradan yapılan sepet değişiklikleri bunu değiştirmez. Sabit fiyatlı veya ücretsiz kargolu siparişlerde bu blok bulunmaz.
Lisans anahtarı
Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox UPS lisans bölümü, Modules > Module Manager > VibeFox UPS > Configure sayfasındaki ilk bölümdür ve ayarların üstündedir. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra bölüm anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-ups satırı ile vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı yer alır. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bölümün metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).
Anahtar kabul edilmezse bölüm 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 tek bir alan adında çalışır: ana mağazanın alan adında, çok mağazalı kurulumda 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 UPS taşıyıcısı ödeme sırasında müşterilere gösterilmez ve tarife hesaplanmaz. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu yüzden taşıyıcı sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sırası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 lisans anahtarını ve lisans durumunu her zaman siler.
Sorun giderme
UPS ödeme sırasında görünmüyor: lisansın etkin olduğunu ve Enable UPS shipping seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers içinde taşıyıcının müşterinin ülkesinin bölgesini ve müşteri grubunu kapsadığını kontrol edin ya da Ignore shipping zones seçeneğini açıp Countries alanını kontrol edin. Ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Çalışan UPS kimlik bilgileri yoksa taşıyıcının sabit bir fiyata ihtiyacı vardır (Country prices veya Fallback cost). Ayrıca ürün sayfasından ürünler belirli taşıyıcılarla sınırlandırılabilir.
Canlı tarifeler görünmüyor: Configure sayfasının üstündeki uyarıları kontrol edin. Debug log seçeneğini açın, ödeme sayfasını yenileyin ve modül sayfasındaki Log alanına bakın. Burada OAuth hataları (Client ID, Client Secret ve Test mode değerlerini kontrol edin), UPS hata mesajları ve para birimi sorunları görünür.
Tarife USD'de, mağaza ise değil: 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 değerini Automatic bırakın veya gönderim yaptığınız ülke için UPS'in beklediği birimleri seçin.
Sayfa, mağazanın ağırlık ya da boyut biriminin bilinmediğini uyarıyor: bu durumda ağırlıklar kg, kutu boyutu ise cm olarak okunur. International > Localization bölümündeki Local units alanında standart bir birim (kg, g, lb veya oz; cm, mm, m veya in) seçin.
Bir değişiklikten sonra tarifeler eski görünüyor: modül sayfasındaki Save düğmesine veya Clear cached UPS token and rates düğmesine tıklayın.
Sayfa UPS taşıyıcısının bulunamadığını bildiriyor: taşıyıcı Shipping > Carriers içinde silinmiş. Yeniden oluşturmak için Modules > Module Manager üzerinden modülü Reset ile sıfırlayın.
Geliştiriciler için: actionVfdUpsxAllowedServices ve actionVfdUpsxExcludedServices hook'ları gösterilebilecek UPS hizmetlerini sınırlar. actionVfdUpsxRateRequest tarife isteğini değiştirir, actionVfdUpsxApiBaseUrl API adresini, actionVfdUpsxCurrencyCodes ise UPS'in döndürdüğü para birimi kodlarını eşler.
Kaldırma
Modules > Module Manager sayfasına gidin, VibeFox UPS yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman kaldırılır. Önbellekteki UPS jetonu ve tarifeler her zaman kaldırılır. Remove data on uninstall açıksa taşıyıcı silinir (siparişler geçmişini korur), ayarlar, günlük ve siparişlerle kaydedilmiş UPS hizmetleri kaldırılır. Kapalıysa taşıyıcı yalnızca devre dışı bırakılır ve ayarlar korunur. Modülü yeniden kurmak veya Reset yapmak, taşıyıcıya daha önceki durumunu geri verir.
UPS, ilgili sahibinin ticari markasıdır. Bu modül UPS ile bağlantılı değildir ve UPS tarafından onaylanmamıştır.