VibeFox Shippo for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

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 belirtecini Shippo > Settings > Advanced > API bölümünden kopyalayın. Shippo, satın alınan etiketler için ücret alır, tarife sorguları için değil. Yeni Shippo hesapları, canlı tarifeler döndürülmeden önce Shippo tarafından doğrulanmak zorunda kalabilir. Belirteç olmadan yalnızca yedek fiyatlar kullanılır.

Ürünler: ürünlerin ağırlığı ve boyutları olmalıdır. Boyutu 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

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi vfd_shippo-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_shippo.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_shippo-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişiklikleri eklemez, bu nedenle Extensions > Modifications sayfasını yenilemeniz gerekmez. Installer yerine, paketin upload klasöründeki içeriği mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Shippo eklentisini bulun ve Install düğmesine tıklayın (yeşil + düğmesi).

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgesi) tıklayın.

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

5. Shippo API belirtecinizi yapıştırın ve Ship from adresini doldurun. Canlı tarifeler için posta kodu zorunludur.

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

7. İsteğe bağlı olarak yedek fiyatları girin, Enable Shippo shipping seçeneğini etkinleştirin ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_shippo.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions sayfasına gidin ve eklenti türü olarak Shipping seçin. VibeFox Shippo eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 4 ila 7 adımlarındaki gibi girin. Ayarlar sayfası ve alanları her iki sürümde de aynıdır.

Kurulumdan sonra, Enable Shippo shipping seçeneğini etkinleştirip kaydedene kadar yöntem kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız Shippo ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox Shippo > Edit. Bölümler solda listelenir. Tek bir Save düğmesi tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt, önbellekteki Shippo tarifelerini de temizler. Ayarları yalnızca bu eklenti için değiştirme izni olan yöneticiler kaydedebilir.

Sayfanın üstündeki uyarılar, yöntemin hiçbir zaman gösterilemeyeceğini veya canlı tarifelerin kullanılamayacağını bildirir: API belirteci yok, gönderici posta kodu veya ülkesi yok, döviz kuru eksik veya mağazanın ağırlık ya da uzunluk birimi eklenti tarafından bilinmiyor (System > Settings bölümünün Local sekmesinde kg, g, lb veya oz ile cm, mm, m veya in kullanın). Test belirteci ayarlandığında bir bildirim hatırlatır. Kaydettiğinizde; geçersiz bir ad, sayı olmayan bir değer, negatif bir sayı veya fiyat hücresi, Maximum weight (kg) değerinden büyük bir Minimum weight (kg) ya da tam sayı olmayan bir sıralama değeri hata olarak bildirilir ve siz düzeltene kadar hiçbir şey kaydedilmez.

Genel

Enable Shippo shipping: ödeme sayfasında yöntemi sunar. Bu, Extensions > Extensions > Shipping bölümündeki eklenti durumudur.

Name: ödeme sayfasında müşteriye gösterilen kargo yöntemi adı. Varsayılan: Shippo Shipping. Zorunlu, en fazla 64 karakter, < > ; = # { } karakterleri olmadan.

Tax class: kargo maliyetinin vergi sınıfı veya No tax. Shippo tarifeleri satış vergisi içermez. No tax bunları teklif edildiği gibi gösterir; bir vergi sınıfı ise vergi kurallarınıza göre kargoya vergi ekler.

Sort order: ödeme sayfasındaki kargo yöntemleri arasında yöntemin konumu. Tam sayı.

Shippo hesabı

API token: Shippo API belirteciniz. Canlı mağazada gerçek tarifeler için canlı belirteci (shippo_live_...) ya da Shippo test tarifeleri için bir test belirteci (shippo_test_...) kullanın. Belirteç 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. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Remove the saved API token: kayıtlı belirteci silmek için bunu etkinleştirip kaydedin.

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 düzeyi belirtecini (usps_priority, ups_ground). İzin verilen en ucuz tarife gösterilir. Herhangi bir kargo firmasının en ucuz tarifesini göstermek için boş bırakın.

Ship from (paketlerinizin gönderildiği adres)

Gönderim ülkesi mağazanızın ülkesi olduğunda, boş bırakılan gönderici adı ve il, System > Settings bölümündeki mağaza adı ve bölgesinden alınır. OpenCart'ta mağaza için yapılandırılmış bir cadde, şehir veya posta kodu yoktur, bu nedenle bunları burada girin.

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 caddesi.

City: göndericinin şehri.

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

Postal / ZIP code: canlı tarifeler için zorunlu, örneğin 94105.

Country: gönderim yaptığınız ülke. Varsayılan: Amerika Birleşik Devletleri.

Tarifeler

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

Default box size: mağazanızın uzunluk biriminde (alan adında gösterilir) uzunluk x genişlik x yükseklik, örneğin 30 x 20 x 10. Shippo kutu boyutuna ihtiyaç duyar. Sepetteki bir ürünün boyutu 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 ve diğer ayarlar kaydedilir.

Shippo rate currency: Shippo'nun kargo firmalarınızı teklif ettiği para birimi; yani gönderim ülkesinin para birimi: 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üğü tarifeler her zaman olduğu gibi kullanılır.

Exchange rate: Shippo tarife para birimindeki 1 birimin, mağazanızın varsayılan para birimindeki fiyatı, örneğin 0.92. İkisi aynıysa gerekmez. Bu olmadan diğer para birimindeki tarifeler kullanılmaz ve yedek fiyatlar geçerli olur. Eklenti para birimlerini otomatik olarak dönüştürmez.

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

Country prices: ülkeye ve sepet ağırlığına göre bir fiyat tablosu. Satır eklemek için Add country düğmesine tıklayın. Sütunlar Price ve XS (1 kg'a kadar), S (1 ila 2 kg), M (2 ila 3 kg), L (3 ila 5 kg) ve XL (5 kg'ın üzeri) ağırlık kademeleridir. Boş veya 0 olan bir kademe Price sütununu kullanır. * Default satırı, kendi satırı olmayan ülkelere uygulanır. Tüm hücreleri boş olarak kaydedilen bir satır 0 tahsil eder; bu nedenle doldurmayacağınız satırları silin.

Other countries: yukarıdaki tabloda yer almayan ülkeler için fiyat (* Default satırı yoksa). Bu ülkeler için yöntemi gizlemek üzere boş bırakın.

Koşullar

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi) bu tutara ulaştığında kargo ücretsiz olur. Bu durumda Shippo'ya istek gönderilmez. Kapatmak için boş bırakın.

Minimum subtotal: yöntemi yalnızca kargo gerektiren ürünlerin ara toplamı (kupon sonrası, vergi öncesi) en az bu tutar olduğunda gösterir. Her zaman göstermek için boş bırakın.

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

Maximum weight (kg): sepet ağırlığı bu değerin üzerindeyse yöntem gizlenir. Varsayılan: 30. 0 sınır olmadığı anlamına gelir. Boş bir alan 30 olarak kaydedilir.

Kargo bölgeleri olmadan kullanılabilirlik

Normalde yöntemin nerede sunulacağına geo bölgesi karar verir. Alternatif olarak geo bölgesinden bağımsız olarak ülkeye göre sunulabilir.

Geo zone: yöntemi yalnızca bu geo bölgesindeki adresler için sunar. All zones (varsayılan) sınır olmadığı anlamına gelir. Ignore shipping zones açıkken kullanılmaz. Geo bölgeleri System > Localisation > Geo Zones bölümünde yönetilir.

Ignore shipping zones: yöntemi, geo bölgesinde olup olmadıklarına bakılmaksızın aşağıdaki ülkeler için sunar.

Countries: bu mod için hedef ülkeler. Mağazanın etkin tüm ü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 storage/logs/vfd_shpo_debug.log.php (OpenCart 4'te system/storage/logs/vfd_shpo_debug.log.php) dosyasına kaydeder. Dosya web üzerinden okunamaz. Bu seçenek kapalı olsa bile API hataları her zaman kaydedilir. API belirteci ve müşteri adresleri asla kaydedilmez. Dosya 5 MB'a ulaştığında vfd_shpo_debug.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır.

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

Remove data on uninstall: açıkken eklentiyi kaldırmak Shippo ayarlarını ve günlüğü siler. Kapalıyken (varsayılan) yeniden kurulum için saklanırlar. Önbellekteki tarifeler her zaman kaldırılır. Siparişlerle kaydedilen kargo firması ve hizmet, sipariş geçmişinin parçasıdır ve korunur.

İçe / Dışa Aktarma

Export: ayarları JSON dosyası olarak kaydetmek için Download JSON düğmesine tıklayın. API belirteci dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve örneğin başka bir mağazada ayarları geri yüklemek için Import düğmesine tıklayın. Değerler normal bir kayıt gibi denetlenir. Kayıtlı API belirteci değiştirilmez.

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

OpenCart kargo yöntemlerini gösterdiğinde, eklentiden Shippo fiyatını ister. Bir Geo zone ayarlıysa (ve Ignore shipping zones kapalıysa) ve adres bunun dışındaysa yöntem sunulmaz. Yalnızca Requires Shipping değeri Yes olan ürünler dikkate alınır: diğerleri ağırlık eklemez ve ara toplama dahil edilmez. Ardından eklenti koşulları denetler: Ignore shipping zones ülkeleri, sepet ağırlığı ve minimum ara toplam. Hediye sertifikaları, puanlar ve mağaza kredisi dikkate alınmaz. Ücretsiz kargo uygulanırsa fiyat 0 olur ve Shippo'ya istek gönderilmez.

Eklenti daha sonra Shippo'ya mağazanın gönderim adresini, müşterinin adresini ve paketi gönderir. OpenCart'ın posta kodu istediği ülkelerde istek, müşteri posta kodunu girene kadar bekler. Uluslararası gönderiler için, ürün adlarını (seçilen seçeneklerle), adetleri, ağırlıkları ve değerleri içeren bir gümrük beyannamesi eklenir. Shippo kargo firmalarınızın tarifelerini döndürür ve eklenti izin verilen en ucuz tarifeyi kullanır. Fiyat, mağazanızın varsayılan para biriminde hesaplanır, ondalık basamaklarına yuvarlanır ve seçilen Tax class vergisiyle birlikte müşteriye kendi 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ı toplanır. Herhangi bir ürünün boyutu yoksa tüm paket için varsayılan kutu boyutu kullanılır. Ürün başına modda her ürün kendi paketi olarak tarifelendirilir ve tarife adedi ile çarpılır.

Her yanıt, adres ve paket başına 1 saat önbelleğe alınır. Shippo kullanılabilir bir tarife olmadan yanıt verirse adres 10 dakika hatırlanır. Zaman aşımı, reddedilen belirteç, sunucu hatası veya istek sınırı sonrasında eklenti istekleri 5 dakika duraklatır ve yedek fiyatları kullanır. İstek zaman aşımı 10 saniyedir.

Canlı tarife yoksa fiyat, yedek fiyat tablosundan ve ardından Other countries değerinden alınır. İkisi de geçerli değilse yöntem gizlenir. Müşteri hiçbir zaman bir hata görmez. Nedeni hata ayıklama günlüğüne yazılır.

Eklenti yalnızca tarifeleri hesaplar. Etiket satın almaz, paketleri takip etmez, adresleri doğrulamaz, teslim alma veya bırakma noktası, sigorta, imza seçenekleri veya iade etiketleri sunmaz. Yalnızca izin verilen en ucuz tarife gösterilir, tüm hizmetlerin bir listesi gösterilmez. Yukarıda açıklanan istifleme dışında kutuya paketleme yoktur; tarife zammı veya işlem ücreti de yoktur.

OpenCart 4'te müşteri, ödeme sayfasındaki kargo yöntemi bloğunda Choose düğmesine tıklar ve Shipping method options penceresinde Shippo'yu seçer. Yöntem, OpenCart 3'teki ile aynı şekilde çalışır.

Siparişler

Canlı bir Shippo tarifesiyle bir sipariş verildiğinde eklenti, seçilen Carrier / service bilgisini ve sipariş başına tek paket için Estimated delivery days değerini saklar. Siparişi Sales > Orders bölümünde açın: bunlar sipariş geçmişinin üstündeki Shippo panelinde görünür, böylece Shippo'da ilgili etiketi satın alabilirsiniz. Veriler siparişle birlikte kaydedilir: sepetteki veya ayarlardaki sonraki değişiklikler bunları değiştirmez. Yöntemi kapattıktan sonra da panel gösterilmeye devam eder. Yedek fiyatlı veya ücretsiz kargolu siparişlerde Shippo paneli bulunmaz.

OpenCart 4, ödeme için tek bir sipariş tutar ve müşteri her onayladığında onu günceller. Kaydedilmiş Shippo tarifesi bununla birlikte güncellenir. Müşteri başka bir kargo yöntemine geçerse veya şimdi yedek fiyat uygulanıyorsa, kaydedilmiş tarife siparişten kaldırılır.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Shippo lisans bloğu, Extensions > Extensions > Shipping > VibeFox Shippo > Edit 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 tarih ve alan adınızı) ve Check now düğmesini gösterir: durumu yeniden kontrol eder; Change key başka bir anahtar girmenizi sağlar; Remove key ise anahtarı bu mağazadan kaldırır. Bunların altında Product: opencart-shipping-shippo 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 eklenti için Modify izni olan yöneticiler değiştirebilir. Bloğun metinleri yönetici 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 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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. 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 yoksa Shippo kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. Aynı tarayıcıda yönetici paneline giriş yapmış bir yönetici, yöntemi mağazada yine görür; yöntem (unlicensed — visible to admins only) işaretiyle gösterilir. Böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu yüzden etkin anahtar yoksa yöntem herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez.

Lisans süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici Dashboard sayfasını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtarı girdikten sonraki ilk 14 gün her gün, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman 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. Geo zone ayarını (veya Ignore shipping zones açıksa Countries ayarını), ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Canlı tarife yoksa ülkenin, * Default veya Other countries değerinin bir fiyatı olduğunu kontrol edin. Ürünlerde Requires Shipping değerinin Yes olduğunu kontrol edin.

Canlı tarifeler görünmüyor: Debug log seçeneğini açın, ödeme sayfasını yenileyin ve eklenti sayfasındaki Log alanına bakın. Yaygın nedenler: API belirteci veya gönderim posta kodu yok; mağazanın varsayılan para birimi, döviz kuru olmadan Shippo tarife para biriminden farklı; müşteri henüz posta kodunu girmedi; Shippo hesabınızdaki hiçbir kargo firması adrese hizmet vermiyor; veya Shippo hesabı henüz doğrulanmadı.

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

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

Yanlış ağırlıklar veya kutu boyutları: sayfa bilinmeyen bir ağırlık veya uzunluk birimi konusunda uyarıyorsa, System > Settings bölümünün Local sekmesinde kg, g, lb veya oz cinsinden bir ağırlık sınıfı ve cm, mm, m veya in cinsinden bir uzunluk sınıfı ayarlayın.

Bir değişiklikten sonra tarifeler eski görünüyor: eklenti sayfasında Save düğmesine tıklayın. Bu, önbellekteki Shippo tarifelerini temizler.

Sayfada "Warning: You do not have permission to modify VibeFox Shippo!" yazıyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebilir. Gruba, System > Users > User Groups altında extension/shipping/vfd_shippo (OpenCart 3) veya extension/vfd_shippo/shipping/vfd_shippo (OpenCart 4) için değiştirme iznini verin.

Geliştiriciler için: Shippo API adresi vfd_shpo_api_url ayarıyla değiştirilebilir (testler için); ayarlar sayfasında bunun için bir alan yoktur.

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox Shippo yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman Enable Shippo shipping, Sort order, Tax class ve Geo zone ayarlarını sıfırlar. Önbellekteki tarifeler her zaman kaldırılır. Remove data on uninstall açıksa Shippo ayarları ve hata ayıklama günlüğü de silinir. Kapalıysa diğer ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Mevcut siparişler kargo yöntemini, maliyetini ve Shippo kargo firması ile hizmet verilerini korur.

OpenCart 4'te, eklentinin dosyalarını da kaldırmak için kaldırdıktan sonra Extensions > Installer sayfasına gidin ve kurulu eklentiler listesinde VibeFox Shippo yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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