VibeFox Shippo for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x arası.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerinde kurulmayı reddeder.

Shippo hesabı: bir Shippo hesabı oluşturun, kargo firmalarını (USPS, UPS, FedEx, DHL ve diğerleri) bağlayın veya etkinleştirin ve API token'ını Shippo > Settings > Advanced > API bölümünden kopyalayın. Shippo, satın alınan etiketler için ücret alır, ücret isteklerine değil. Yeni Shippo hesaplarının canlı ücretlerin döndürülmesinden önce Shippo tarafından doğrulanması gerekebilir. Token olmadan yalnızca yedek fiyatlar kullanılır.

Ürünler: ürünlerin ağırlık ve ölçülere sahip olması gerekir. Ölçüsü olmayan ürünler varsayılan kutu boyutunu kullanır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. Back Office'te 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 daha sonra modül listesinde VibeFox Shippo öğesini bulup Configure düğmesine tıklayın.

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

4. Shippo API token'ınızı yapıştırın ve Ship from adresini doldurun. Canlı ücretler için posta kodu zorunludur.

5. Shippo rate currency seçeneğini belirleyin (ABD'den gönderiyorsanız USD) ve mağazanızın varsayılan para birimi farklıysa Exchange rate değerini girin.

6. İsterseniz ülke ve ağırlık tablosuna yedek fiyatlar girin, ardından Save düğmesine tıklayın.

Kurulumda modül, Shippo carriers (USPS, UPS, FedEx, DHL) teslimat süresi metniyle Shippo Shipping kargo firmasını oluşturur. Kargo firması 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. Orada fiyat belirlemeyin: fiyat her zaman modülden gelir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Shippo > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Her kayıt, önbellekteki Shippo ücretlerini de temizler.

Sayfanın üstündeki uyarılar; kargo firmasının hiçbir zaman gösterilemeyeceğini veya canlı ücretlerin kullanılamayacağını bildirir: API token'ı yoksa, gönderen posta kodu veya ülkesi yoksa, döviz kuru eksikse, ya da mağazanın ağırlık veya ölçü birimi modül tarafından tanınmıyorsa (International > Localization bölümünde Yerel birimler için kg, g, lb veya oz ile cm, mm, m veya in ayarlayın). Test token'ı ayarlandığında bir bildirim hatırlatır. Kaydederken sayı olmayan, negatif bir sayı veya Maximum weight (kg) değerinden büyük bir Minimum weight (kg) hata olarak bildirilir ve siz düzeltene kadar hiçbir şey kaydedilmez.

Genel

Enable Shippo shipping: kargo firmasını açar veya kapatır. Bu, Shipping > Carriers bölümündeki kargo firması durumuyla aynı anahtardır.

Name: ödeme sayfasında müşteriye gösterilen kargo firması adı. Varsayılan: Shippo Shipping. Zorunlu, en fazla 64 karakter.

Tax: kargo firmasının vergi kuralı veya No tax. Shippo ücretleri satış vergisi içermez. No tax bunları teklif edildiği gibi gösterir; bir vergi kuralı ise vergi kurallarınıza göre kargoya vergi ekler.

Shippo hesabı

API token: Shippo API token'ınız. Canlı mağazada gerçek ücretler için canlı token'ı (shippo_live_...) kullanın ya da Shippo test ücretleri için test token'ı (shippo_test_...) kullanın. Token yalnızca Shippo'ya gönderilir ve asla günlüğe yazılmaz. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it metnini gösterir. Yalnızca değiştirmek için yeni bir değer girin veya silmek için Remove the saved API token kutusunu işaretleyin.

Allowed carriers / services: isteğe bağlı, virgülle ayrılmış. Bir kargo firmasını Shippo'nun adlandırdığı şekilde girin (USPS, UPS, FedEx, DHL Express) veya bir Shippo hizmet seviyesi token'ı girin (usps_priority, ups_ground). İzin verilen en ucuz ücret gösterilir. Herhangi bir kargo firmasının en ucuz ücretini göstermek için boş bırakın.

Gönderici adresi (paketlerinizin gönderildiği adres; boş alanlar, aynı ülkedeyse Shop Parameters > Contact > Stores bölümündeki mağaza adresinden doldurulur)

Sender name / company: gönderici adı. Gümrük beyannamesini imzalamak için de kullanılır. Boşsa mağaza adı kullanılır.

Street address: göndericinin sokak adresi.

City: göndericinin şehri.

State / province: iki harfli eyalet kodu, örneğin CA veya NY. Bazı kargo firmaları bunu gerektirir.

Postal / ZIP code: canlı ücretler için zorunludur.

Country: gönderdiğiniz ülke. Varsayılan: Amerika Birleşik Devletleri.

Ücretler

Parcels: sepetin Shippo'ya nasıl gönderileceği.

Default box size: mağazanızın ölçü biriminde uzunluk x genişlik x yükseklik (alan adında gösterilir), örneğin 30 x 20 x 10. Shippo kutu boyutunu gerektirir. Sepetteki bir ürünün ölçüsü yoksa kullanılır. 30 x 20 x 10 cm kullanmak için boş bırakın. Okunamayan bir değer, kaydettikten sonra bir bildirimle yok sayılır.

Shippo rate currency: Shippo'nun kargo firmalarınızı fiyatlandırdığı para birimi; gönderen ülkenin para birimidir: USD (ABD), CAD (Kanada), GBP (Birleşik Krallık), EUR (euro bölgesi) veya AUD (Avustralya). Varsayılan: USD. Shippo'nun mağazanızın varsayılan para biriminde döndürdüğü ücretler her zaman olduğu gibi kullanılır.

Exchange rate: Shippo ücret para biriminin 1 biriminin, mağazanızın varsayılan para biriminde fiyatı, örneğin 0.92. İki para birimi aynıysa gerekmez. Bu olmadan diğer para birimindeki ücretler kullanılmaz ve yedek fiyatlar uygulanır. Modül para birimlerini otomatik olarak çevirmez.

Yedek fiyatlar (canlı ücret olmadığında kullanılır: API token'ı yok, Shippo'ya ulaşılamıyor, token reddedildi veya adres için kargo firması ücreti yok; mağazanızın varsayılan para biriminde, vergi hariç fiyatlar; bu durumda kargo firmasını gizlemek için iki alanı da boş bırakın)

Country prices: ülke ve sepet ağırlığına göre bir fiyat tablosu. Satır eklemek için Add country düğmesine, satır silmek için çöp kutusu simgesine tıklayın. Sütunlar Price ve ağırlık dilimleri XS (1 kg'a kadar), S (2 kg'a kadar), M (3 kg'a kadar), L (5 kg'a kadar) ve XL (5 kg'dan fazla). Boş veya 0 olan dilim, Price sütununu kullanır. * Default satırı, kendi satırı olmayan ülkeler için geçerlidir. Yeni bir satır * Default olarak başlar. Tüm hücreleri boş kaydedilen bir satır 0 ücret alır, bu yüzden doldurmayacağınız satırları silin.

Other countries: yukarıdaki tabloda olmayan ülkeler için fiyat (* Default satırı yoksa). Bu ülkeler için kargo firmasını gizlemek üzere boş bırakın.

Koşullar

Free shipping from: ücretsiz kargonun başladığı sepet ara toplamı (indirimlerden sonra, vergiden önce). Bu durumda Shippo'ya istek gönderilmez. Kapatmak için boş bırakın.

Minimum subtotal: kargo firmasını yalnızca sepet ara toplamı (indirimlerden sonra, vergiden önce) bu tutarın en az olduğu durumda gösterir. Her zaman göstermek için boş bırakın.

Minimum weight (kg): kargo firmasını göstermek için gereken minimum sepet ağırlığı. 0, sınır olmadığı anlamına gelir.

Maximum weight (kg): bu sepet ağırlığının üzerinde kargo firması gizlenir. Varsayılan: 30. 0, sınır olmadığı anlamına gelir. Boş alan 30 olarak kaydedilir.

Kargo bölgesi olmadan kullanılabilirlik

Normalde kargo firması, Shipping > Carriers bölümündeki kargo bölgelerinde sunulur. Alternatif olarak, bölgelerden bağımsız olarak ülkeye göre sunulabilir.

Ignore shipping zones: kargo firmasını, aşağıdaki ülkeler için, bölgeleri atanmış olsun veya olmasın sunar. Bu açıkken kargo firması, sonradan oluşturulan bölgeler dahil tüm bölgelere eklenir. Kapatıldığında eklenen bu bölgeler kaldırılır ve kargo firması kendi bölgelerini korur.

Countries: bu mod için hedef ülkeler. Mağazanı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: Shippo isteklerini modül klasöründeki logs/vfd_shpo_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API token'ı ve müşteri adresleri asla kaydedilmez.

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

Remove data on uninstall: açıkken modülü kaldırmak modül ayarlarını, kargo firmasını ve günlüğü siler. Kapalıyken her şey yeniden kurulum için saklanır. Önbelleğe alınmış ücretler her zaman kaldırılır. Siparişlerle kaydedilen kargo firması ve hizmet sipariş geçmişinin parçasıdır ve korunur.

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

Kargo adımında PrestaShop, modülden Shippo fiyatını ister. Yalnızca fiziksel ürünler sayılı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 Shippo'ya istek gönderilmez.

Ardından modül, Shippo'ya gönderen adresini, müşterinin adresini ve paketi gönderir. PrestaShop'un posta kodu istediği ülkelerde istek, müşteri posta kodunu girene kadar bekler. Uluslararası gönderilerde ürün adları, adetleri, ağırlıkları ve değerleri içeren bir gümrük beyannamesi eklenir. Shippo kargo firmalarınızın ücretlerini döndürür ve modül izin verilen en ucuz ücreti kullanır. Fiyat, mağazanızın varsayılan para biriminde hesaplanır ve ardından müşterinin sepet para biriminde gösterilir.

Sipariş başına modda ürünler tek bir kutuya yerleştirilir: en büyük ürünlerin en uzun ve orta kenarları ile tüm birimlerin en kısa kenarlarının toplamı. Bir ürünün ölçüsü yoksa tüm paket için varsayılan kutu kullanılır. Ürün başına modda her ürün kendi paketi olarak ücretlendirilir ve ücret adetiyle çarpılır.

Her yanıt, adres ve paket başına 1 saat önbelleğe alınır. Shippo kullanılabilir bir ücret olmadan yanıt verirse adres 10 dakika hatırlanır. Zaman aşımı, reddedilen token, sunucu hatası veya istek sınırından sonra modül istekleri 5 dakika duraklatır ve yedek fiyatları kullanır. İstek zaman aşımı 10 saniyedir.

Canlı ücret yoksa fiyat yedek tablodan, ardından Other countries değerinden alınır. Hiçbiri geçerli değilse kargo firması gizlenir. Müşteri asla bir hata görmez. Neden, hata ayıklama günlüğüne yazılır.

Siparişleri olan bir kargo firmasını Shipping > Carriers bölümünde düzenlerseniz PrestaShop bunu kargo firmasının yeni bir sürümü olarak kaydeder. Modül yeni sürümü otomatik olarak izler.

Modül yalnızca ücretleri hesaplar. Etiket satın almaz, paketleri takip etmez, adresleri doğrulamaz; teslim alma veya bırakma noktaları, sigorta, imza seçenekleri veya iade etiketleri sunmaz. Yalnızca izin verilen en ucuz ücret gösterilir, tüm hizmetlerin listesi gösterilmez. Yukarıda açıklanan yerleştirmenin ötesinde kutu paketleme yoktur; ücrete kâr payı veya işlem ücreti eklenmez.

Siparişler

Canlı bir Shippo ücretiyle sipariş verildiğinde modül, seçilen Carrier / service bilgisini ve sipariş başına bir paket için Estimated delivery days bilgisini saklar. Bunlar, Back Office sipariş sayfasındaki Shippo bloğunda görünür; böylece Shippo'da eşleşen etiketi satın alabilirsiniz. Veriler siparişle birlikte dondurulur: sepetteki sonraki değişiklikler bunları değiştirmez. Yedek fiyatlı veya ücretsiz kargolu siparişlerde Shippo bloğu yoktur.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Shippo lisans bloğu, Modules > Module Manager > VibeFox Shippo > Configure sayfasında, ayarların üstünde 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 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 ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-shipping-shippo satırı ve 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. Bloğun metinleri back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir, örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. 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 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 Shippo kargo firması ödeme sırasında müşterilere gösterilmez ve ücret hesaplanmaz. PrestaShop vitrini back office'e giriş yaptığınızı bilmez, bu yüzden kargo firması 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ın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonra 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

Shippo ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable Shippo shipping seçeneğinin açık olduğunu kontrol edin. Shipping > Carriers bölümünde kargo firmasının müşterinin ülkesinin bölgesini ve müşterinin grubunu kapsadığını kontrol edin (ya da Ignore shipping zones açık ve ülke izinliyse). Ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Canlı ücret yoksa ülkenin, * Default veya Other countries değerinin bir fiyatı olduğunu kontrol edin. Ürünler, ürün sayfasında belirli kargo firmalarıyla da sınırlandırılabilir.

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. Yaygın nedenler: API token'ı veya gönderen posta kodu yok, mağazanın varsayılan para birimi döviz kuru olmadan Shippo ücret para biriminden farklı, müşterinin posta kodu henüz girilmedi, Shippo hesabınızın hiçbir kargo firması adrese hizmet vermiyor ya da Shippo hesabı henüz doğrulanmadı.

Canlı mağazada test ücretleri: bir test token'ı (shippo_test_...) Shippo test ücretleri döndürür. Canlı token'ı (shippo_live_...) kullanın.

Beklenmeyen ülkeler için ücretsiz kargo: fiyat tablosunda boş bir satır olup olmadığını kontrol edin, özellikle boş bir * Default satırı. Tüm hücreleri boş olan bir satır 0 ücret alır.

Değişiklikten sonra ücretler eski görünüyor: modül sayfasında Save düğmesine tıklayın. Bu, önbelleğe alınmış Shippo ücretlerini temizler.

Sayfa Shippo kargo firmasının bulunamadığını söylüyor: kargo firması 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.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Shippo yanındaki menüyü açın ve Uninstall seçeneğini seçin. Lisans anahtarı ve lisans durumu her zaman silinir. Önbelleğe alınmış ücretler her zaman kaldırılır. Remove data on uninstall açıksa kargo firması silinir (siparişler geçmişini korur) ve ayarlar ile günlük kaldırılır. Kapalıysa kargo firması yalnızca devre dışı bırakılır ve tüm ayarlar korunur. Modülü yeniden kurmak, kargo firmasına önceki durumunu geri verir. Mevcut siparişler Shippo kargo firması ve hizmet verilerini korur.

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