VibeFox EasyPost 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: cURL ile 8.0 veya üzeri.

EasyPost hesabı (yalnızca canlı tarifeler için): EasyPost web sitesinde bir hesap oluşturun, kargo firma hesaplarınızı (USPS, UPS, FedEx ve diğerleri) EasyPost panelinde bağlayın ve API anahtarını EasyPost Dashboard > Account Settings > API Keys bölümünden kopyalayın. EasyPost, tarife isteklerinden değil, satın alınan etiketlerden ücret alır. Yalnızca yedek fiyatları kullanıyorsanız EasyPost hesabına ihtiyacınız yoktur.

Ürünler: ürünlerin ağırlığı, tercihen ebatları da olmalıdı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ünün paketlerini içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi vfd_easypost-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_easypost.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_easypost-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Installer yerine, paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin, eklenti türü olarak Shipping seçin. VibeFox EasyPost 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 düğmesi) tıklayın.

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

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

6. Varsayılan para biriminiz USD değilse USD exchange rate değerini girin. İsteğe bağlı olarak yedek fiyatları girin (bkz. Yapılandırma). Enable EasyPost shipping seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve vfd_easypost.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 bölümüne gidin, eklenti türü olarak Shipping seçin. VibeFox EasyPost eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

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

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

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox EasyPost > Edit. Bölümler solda listelenir. Tek bir Save düğmesi, tüm sayfayı yeniden yüklemeden kaydeder. Her kayıt, önbelleğe alınmış EasyPost tarifelerini de temizler. Yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar ayarları kaydedebilir veya günlüğü temizleyebilir.

Sayfanın üst kısmında eklenti, canlı tarifeler kullanılamadığında uyarılar gösterir: API anahtarı yoksa (yedek fiyatlarla veya fiyatsız), gönderim posta kodu veya ülkesi yoksa ya da varsayılan para birimi döviz kuru olmadan USD dışındaysa. Bir test API anahtarı ayarlandığında bir not, mağazanızın ağırlık veya uzunluk birimi (System > Settings > Option) eklentinin tanıdığı birimlerden biri değilse (kg, g, lb, oz; cm, mm, m, in) bir uyarı görünür.

Kaydederken 64 karakterden uzun bir ad, tam sayı olmayan bir Sort order veya bilinmeyen bir vergi sınıfı ya da coğrafi bölge kaydetmeyi engeller ve bu durumda hiçbir şey kaydedilmez. Sayı olmayan (veya negatif) bir değer kaydedilmez: bir uyarı alanı belirtir ve önceki değer korunur, diğer ayarlar ise kaydedilir. USD exchange rate 0 olduğunda veya Minimum weight değeri Maximum weight değerinden büyük olduğunda da aynı şey olur.

Genel

Enable EasyPost shipping: ödeme sayfasında yöntemi sunar. Bu, eklentinin Extensions > Extensions > Shipping bölümündeki durumudur. Varsayılan: kapalı.

Name: müşterinin ödeme sayfasında gördüğü kargo yöntemi adı, en fazla 64 karakter. Varsayılan: EasyPost Shipping. Ad boşsa varsayılan ad kullanılır. < > ; = # { } karakterlerini içeren bir ad, bir uyarıyla varsayılan adla değiştirilir.

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

EasyPost hesabı

API key: EasyPost Dashboard > Account Settings > API Keys bölümündeki EasyPost API anahtarınız. Canlı anahtar (EZAK ile başlar) gerçek tarifeler döndürür. Test anahtarı (EZTK ile başlar) EasyPost test tarifeleri döndürür; yalnızca test için kullanın. Kaydettikten sonra alan boş kalır ve kayıtlı anahtarı maskeli olarak gösterir, örneğin Saved key: EZAK******abcd. Leave the field empty to keep it. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Anahtar olmadan yalnızca yedek fiyatlar kullanılır.

Remove the saved API key: açıp Save düğmesine tıklayarak kayıtlı anahtarı silin.

Allowed carriers / services: isteğe bağlı, virgülle ayrılmış. EasyPost'un adlandırdığı şekilde bir kargo firması (USPS) veya bir kargo firması ve hizmet (USPS:Priority, UPS:Ground) girin. İzin verilen en ucuz tarife gösterilir. Herhangi bir kargo firmasının en ucuz tarifesini göstermek için boş bırakın.

Gönderici adresi

Paketlerinizin gönderildiği adres. Country mağazanızın ülkesiyse, boş Sender name / company alanı mağaza adından, boş State alanı ise mağazanızın bölgesinden (System > Settings) doldurulur. OpenCart'ta mağaza posta kodu yoktur, bu nedenle posta kodu burada girilmelidir.

Sender name / company: gönderici adı veya şirket. Boş bırakılırsa mağaza adı kullanılır (yalnızca aynı ülke için).

Street address: gönderici adresinin sokağı.

City: gönderici adresinin şehri.

State: iki harfli eyalet kodu, örneğin CA veya NY.

ZIP code: gönderici adresinin posta kodu, örneğin 94105. Canlı tarifeler için zorunludur.

Country: gönderim yaptığınız ülke. Varsayılan: United States.

Tarifeler

Parcels: sepetin EasyPost'a nasıl gönderileceği.

Ağırlıklar mağazanızın ağırlık biriminden ons'a (en az 1 oz), ebatlar ise mağazanızın uzunluk biriminden inç'e çevrilir. Bir ürünün ebatı yoksa paket yalnızca ağırlığa göre tarifelendirilir.

USD exchange rate: EasyPost tarifeleri USD cinsindendir. Mağazanızın varsayılan para biriminde 1 USD'nin fiyatını girin, örneğin 0.92. Bu olmadan canlı tarifeler kullanılmaz, yalnızca yedek fiyatlar kullanılır. Varsayılan para birimi USD ise gerekli değildir. USD ve CAD mağazaları EasyPost'tan kendi para biriminde teklif ister. Ondalık ayırıcı olarak hem nokta hem virgül kabul edilir.

Tax class: kargoya uygulanan vergi sınıfı veya No tax. EasyPost tarifeleri satış vergisi içermez.

Yedek fiyatlar

Canlı tarife olmadığında kullanılır: API anahtarı yoksa, EasyPost'a ulaşılamıyorsa, anahtar reddedilmişse veya hiçbir kargo firmasının adres için tarifesi yoksa. Fiyatlar mağazanızın varsayılan para biriminde ve vergi hariçtir. Bu durumda yöntemi gizlemek için iki alanı da boş bırakın.

Country prices: ülke başına bir satır: iki harfli ülke kodu, iki nokta üst üste ve fiyat, örneğin US:9.99. Başka biçimdeki satırlar yok sayılır ve kaydederken bir uyarıda listelenir.

Other countries: yukarıdaki listede olmayan ülkeler için fiyat. Bu ülkeler için yöntemi gizlemek üzere boş bırakın.

Koşullar

Free shipping from: kargonun ücretsiz olduğu sepet ara toplamı (gönderilecek ürünler, kupondan sonra, vergiden önce, varsayılan para biriminde). Bu durumda EasyPost'a istek gönderilmez. Kapatmak için boş bırakın.

Minimum subtotal: yöntemi yalnızca sepet ara toplamı (gönderilecek ürünler, kupondan sonra, vergiden önce) en az bu tutar olduğunda gösterir. Her zaman göstermek için boş bırakın.

Minimum weight: sepet daha hafif olduğunda yöntemi gizler; mağazanızın ağırlık birimindedir (alan etiketinde gösterilir). 0, sınır olmadığı anlamına gelir (varsayılan).

Maximum weight: sepet daha ağır olduğunda yöntemi gizler; mağazanızın ağırlık birimindedir. 0, sınır olmadığı anlamına gelir (varsayılan).

Kullanılabilirlik

Genellikle yöntemin nerede sunulacağına coğrafi bölge karar verir. Alternatif olarak, coğrafi bölgeden bağımsız olarak ülkeye göre de sunulabilir.

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

Ignore shipping zones: yöntemi, coğrafi bölgede olsun veya olmasın, aşağıdaki ülkeler için sunar.

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

Gelişmiş

Debug log: EasyPost isteklerini storage/logs/vfd_ep.log.php (OpenCart 4'te system/storage/logs/vfd_ep.log.php) dosyasına yazar. Dosya web üzerinden okunamaz. 5 MB'a ulaştığında vfd_ep.old.log.php dosyasına taşınır ve yeni bir günlük başlatılır. API hataları ve uyarıları, bu seçenek kapalı olsa bile her zaman kaydedilir. API anahtarı ve müşteri adresleri hiçbir zaman kaydedilmez.

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

Remove data on uninstall: açık olduğunda, eklentiyi kaldırmak ayarlarını ve günlüğü siler. Verilmiş siparişlerin EasyPost verileri korunur. Yöntemi kapatmak hiçbir zaman ayarları silmez.

İçe / Dışa Aktarma

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

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

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

OpenCart kargo yöntemlerini gösterirken eklentiden EasyPost fiyatını ister. Bir Geo zone ayarlıysa (ve Ignore shipping zones kapalıysa) ve adres bu bölgenin dışındaysa yöntem sunulmaz. Yalnızca Requires Shipping değeri Yes olarak ayarlanmış ürünler sayılır: diğer ürünler ağırlık eklemez ve ara toplama dahil edilmez. Eklenti önce koşulları kontrol eder: hedef ülke (Ignore shipping zones ile), sepet ağırlığı ve minimum ara toplam. Ara toplam, kupon indiriminden sonra ve vergiden önce, kargo gerektiren ürünlerin fiyatıdır. Hediye kartları, sadakat puanları ve mağaza kredisi dikkate alınmaz. Ücretsiz kargo uygulanıyorsa fiyat 0 olur ve EasyPost'a istek gönderilmez.

Aksi halde eklenti EasyPost'a gönderici adresini, teslimat adresini ve paketi gönderir; tüm kargo firma hesaplarınızın tarifelerini alır. İzin verilen en ucuz tarifeyi seçer, mağazanızın varsayılan para birimine çevirir ve seçilen Tax class vergisiyle müşterinin para biriminde gösterir. System > Localisation > Countries bölümünde Postcode Required olarak işaretlenmiş ülkeler için istek yalnızca teslimat adresinde posta kodu varsa yapılır. OpenCart'ın standart verilerinde bu işaret Amerika Birleşik Devletleri için kapalıdır, bu nedenle posta kodu olmayan bir ABD adresi de gönderilir; EasyPost bu durumda hata döndürür ve yedek fiyat kullanılır.

Her yanıt, aynı adres ve aynı paket için 1 saat önbellekte tutulur. Kullanılabilir tarifesi olmayan bir adres 10 dakika hatırlanır. Zaman aşımı, reddedilen anahtar, istek sınırı veya EasyPost sunucu hatasından sonra 5 dakika boyunca istek yapılmaz. API zaman aşımı 10 saniyedir. Bu durumların hepsinde müşteri bir hata görmez: yedek fiyat kullanılır veya yedek fiyat yoksa yöntem gizlenir. Nedeni günlüğe yazılır.

Eklenti yalnızca tarifeleri hesaplar. Etiket satın almaz, kargoları takip etmez, adresleri doğrulamaz, teslim alma veya bırakma noktaları sunmaz ve sigorta ya da imza seçenekleri eklemez. Tek bir seçenek (izin verilen en ucuz tarife) gösterir, hizmetlerin listesini değil. Ürünleri tek bir pakete yerleştirmenin ötesinde kutu optimizasyonu yoktur; tarifeye kâr marjı veya işlem ücreti eklenmez.

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

Siparişler

EasyPost yöntemiyle bir sipariş verildiğinde, ödeme sayfasında gösterilen tarife siparişle birlikte saklanır. Yönetici sipariş sayfasında (Sales > Orders), geçmişin üstünde EasyPost shipping paneli gösterilir:

Carrier / service: tarifenin EasyPost kargo firması ve hizmeti, örneğin USPS Priority. Ürün başına bir paket modunda kullanılan tüm hizmetler listelenir.

Estimated delivery days: EasyPost'un döndürdüğü teslimat günleri (yalnızca sipariş başına bir paket modunda ve EasyPost bunları döndürdüğünde).

Price source: Live EasyPost rate, Fallback price (no live rate) veya Free shipping threshold.

Calculated price (excl. tax): mağazanızın varsayılan para birimindeki fiyat.

Eklenti daha sonra kapatılsa bile panel gösterilir. Siparişte yönetici tarafından yapılan sonraki değişiklikler bu değerleri değiştirmez. Etiketi EasyPost hesabınızda satın almak için bunları kullanın. OpenCart, ödeme sayfası onay adımına ulaştığında her seferinde bir sipariş kaydı oluşturur; tamamlanmamış bu siparişlerin kayıtlı tarifeleri 30 gün sonra silinir.

OpenCart 4'te ödeme sayfası tek bir siparişi tutar ve müşteri her yeniden onayladığında onu günceller. Kayıtlı tarife onunla birlikte güncellenir: müşterinin ödeme sayfasında gördüğü tarifedir. Müşteri başka bir kargo yöntemine geçerse, bu sipariş için panel artık gösterilmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox EasyPost lisans bloğu, Extensions > Extensions > Shipping > VibeFox EasyPost > Edit sayfasında, ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarihi ve alan adınızı) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: opencart-shipping-easypost 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 bu eklenti için Modify yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloktaki metinler yönetici paneli 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 tarihli 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 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ızdan serbest bırakın.

Etkin bir anahtar olmadan EasyPost kargo yöntemi ödeme sayfasında müşterilere gösterilmez ve hiçbir tarife hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, yöntemi yine de mağazada (unlicensed — visible to admins only) işaretiyle görür; 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 nedenle etkin anahtar olmadan yöntem herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra, yönetici Dashboard sayfasında bir hatırlatma görünür. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

EasyPost ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable EasyPost shipping seçeneğinin açık olduğunu kontrol edin. Geo zone (veya Ignore shipping zones ve Countries), ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Canlı tarife olmadan yöntemin, ülke için veya Other countries için bir yedek fiyata ihtiyacı vardır. Ürünlerin Requires Shipping değerinin Yes olduğunu kontrol edin.

Canlı tarifeler görünmüyor: eklenti sayfasının üst kısmındaki uyarıları okuyun, ardından Debug log seçeneğini açın, ödeme sayfasını yeniden yükleyin ve Log alanına bakın. Yaygın nedenler: API anahtarı veya gönderim posta kodu yok, USD exchange rate olmadan USD dışı bir mağaza, teslimat adresinin henüz posta kodu yok, EasyPost hesabınızdaki hiçbir kargo firması adrese hizmet vermiyor veya Allowed carriers / services tüm tarifeleri eliyor.

Tarifeler test fiyatları gibi görünüyor: bir test anahtarı (EZTK...) ayarlı. Canlı mağazada bir üretim anahtarı (EZAK...) kullanın.

Tarifeler birkaç dakika durdu: zaman aşımı, reddedilen bir anahtar veya bir EasyPost sunucu hatasından sonra eklenti istekleri 5 dakika duraklatır ve yedek fiyatları kullanır. API anahtarını ve günlüğü kontrol edin.

Vergi dahil mi? EasyPost tarifeleri satış vergisi içermez. Kargoya vergi eklemek için Tax class bölümünden vergi sınıfını seçin.

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

Sayfa "Warning: You do not have permission to modify VibeFox EasyPost!" diyor: yönetici kullanıcı grubunuz ayarları yalnızca görüntüleyebiliyor olabilir. Gruba, System > Users > User Groups bölümünde extension/shipping/vfd_easypost (OpenCart 3) veya extension/vfd_easypost/shipping/vfd_easypost (OpenCart 4) için değiştirme yetkisi verin.

Geliştiriciler için: diğer eklentiler, OpenCart olayları vfd_easypost/shipment_request, vfd_easypost/selected_rate ve vfd_easypost/api_url ile istek gövdesini, seçilen tarifeyi ve API temel URL'sini değiştirebilir.

Kaldırma

Extensions > Extensions bölümüne gidin, Shipping türünü seçin ve VibeFox EasyPost 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 EasyPost shipping, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Eklenti her zaman kendi olaylarını ve önbelleğe alınmış tarifeleri kaldırır. Remove data on uninstall açıksa, diğer ayarlar ve günlük de silinir. Kapalıysa ayarlar korunur ve eklentiyi yeniden kurduğunuzda tekrar kullanılır. Verilmiş siparişlerin EasyPost verileri hiçbir zaman silinmez ve mevcut siparişler kargo yöntemlerini ve maliyetlerini korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox EasyPost yanındaki Uninstall düğmesine (turuncu − düğmesi) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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