VibeFox ShipStation 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.

ShipStation hesabı: kargo firmalarınızı ShipStation'da bağlayın (Settings > Shipping > Carriers), ardından API Key ve API Secret değerlerini ShipStation > Settings > Account > API Settings sayfasından kopyalayın. API erişimi ShipStation planınıza bağlıdır. Eklenti ShipStation API V1'i kullanır (API Key ve API Secret). Anahtarlar olmadan yalnızca yedek fiyatlar kullanılı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_shipstation-oc3-(version).ocmod.zip ve OpenCart 4 paketi vfd_shipstation.ocmod.zip bulunur. Yalnızca OpenCart sürümünüzün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_shipstation-oc3-(version).ocmod.zip dosyasını seçin. Eklenti OCMOD değişikliği eklemez, bu yüzden Extensions > Modifications sayfasını yenilemeniz gerekmez. Installer yerine bu paketteki upload klasörünün içeriğini 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 ShipStation 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. License key alanına, Edit sayfasının en üstündeki lisans bloğunda VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

5. API Key ve API Secret değerlerini yapıştırın, gönderici posta kodunu girin ve Save düğmesine tıklayın. Sayfa artık hesabınızın kargo firması kodlarını listeler. İstediğiniz kodları Carrier codes alanına girin ve yeniden kaydedin.

6. Mağazanızın varsayılan para birimi ShipStation hesabınızın para birimi değilse Exchange rate değerini ayarlayın. İsterseniz yedek fiyatları doldurun.

7. Enable ShipStation shipping seçeneğini açın ve Save düğmesine tıklayın.

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve vfd_shipstation.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ştirilen paket çalışmaz.

2. Paket, aynı sayfada 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 ShipStation 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ımlardaki gibi girin. Ayarlar sayfası ve alanları her iki sürümde de aynıdır.

Kurulumdan sonra yöntem, siz açıp kaydedene kadar kapalı kalır. Eklentiyi kaldırdıktan sonra yeniden kurarsanız, sakladığınız ShipStation ayarları yeniden kullanılır.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Shipping > VibeFox ShipStation > 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ış ShipStation tarifelerini temizler ve API Key ile API Secret değerlerini kontrol eder. Sayfa ardından hesabınıza bağlı kargo firmalarını kodlarıyla gösterir; örneğin "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)". Ayarları yalnızca bu eklenti için değiştirme yetkisi olan yönetici kullanıcılar kaydedebilir.

Sayfanın üstündeki uyarılar, anlık tarifelerin ne zaman çalışamayacağını bildirir: anahtar yoksa, kargo firması kodu yoksa, gönderici posta kodu yoksa, döviz kuru yoksa, bağlantı kontrolü başarısızsa veya kargo firması kodları hesabınıza bağlı değilse. Mağazanın ağırlık veya uzunluk birimi eklentinin dönüştüremeyeceği bir birimse de uyarı görünür. kg, g, lb veya oz ile cm, mm, m veya in kullanın (System > Settings > Option). Geçersiz bir ad, sayısal bir alan veya negatif değer ya da sayı yerine metin içeren bir fiyat hücresi, Maximum weight değerinden büyük bir Minimum weight ya da tam sayı olmayan bir sıralama hata olarak bildirilir ve hiçbir şey kaydedilmez.

Genel

Enable ShipStation shipping: yöntemi ödeme sayfasında gösterir veya gizler. Bu, eklentinin Extensions > Extensions > Shipping sayfasındaki durumudur.

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

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

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

ShipStation hesabı

API Key: ShipStation > Settings > Account > API Settings sayfasındaki API Key. Yalnızca ShipStation'a gönderilir ve asla günlüğe kaydedilmez. Kaydettikten sonra alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek için yeni bir değer girin.

API Secret: aynı sayfadaki API Secret. Anahtar gibi saklanır.

Remove the saved API key and secret: anahtarlar kaydedildikten sonra görünür. İşaretleyip kaydederek ikisini de silin.

Carrier codes: virgülle ayrılmış bir veya daha fazla ShipStation kargo firması kodu, örneğin stamps_com, ups_walleted. En fazla 5 kod kullanılır ve her kargo firması için bir API isteği yapılır. Daha fazla girerseniz yalnızca ilk 5 tanesi tutulur ve sayfa bunu bildirir. Bu kargo firmalarının en ucuz tarifesi gösterilir. Kodları kaydettikten sonra görünen listeden alın.

Allowed services: isteğe bağlı, virgülle ayrılmış ShipStation hizmet kodları, örneğin usps_priority_mail, ups_ground. Yukarıdaki kargo firmalarının en ucuz hizmetini göstermek için boş bırakın.

Package code: "package" (varsayılan), kendi kutunuz için tarifeleri hesaplar ve kargo firmasının zarflarını ile sabit ücretli kutularını hariç tutar. Kargo firmasının sunduğu tüm paket türleri için tarife hesaplamak üzere boş bırakın.

Gönderici

Ship-from postal code: anlık tarifeler için zorunlu, örneğin 78703. ShipStation tarifeleri yalnızca posta koduna göre hesaplar ve bu kodun ShipStation hesabınızın ülkesinde olması gerekir. OpenCart'ta mağaza posta kodu yoktur, bu yüzden mağaza adresinden asla alınmaz.

Tarifeler

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

ShipStation account currency: ShipStation'ın tarifeleri döndürdüğü para birimi: USD, CAD, GBP, AUD, NZD veya EUR. Varsayılan: USD (ABD hesapları).

Exchange rate: hesap para biriminin 1 biriminin mağazanızın varsayılan para biriminde fiyatı, örneğin 0.92. Yalnızca varsayılan para birimi hesap para biriminden farklı olduğunda gerekir. Bu olmadan anlık tarifeler kullanılmaz ve yedek fiyatlar uygulanır. Döviz kurları otomatik olarak güncellenmez.

Yedek fiyatlar (anlık tarife olmadığında kullanılır: API anahtarı yok, ShipStation'a ulaşılamıyor veya adres için kargo firması tarifesi yok; fiyatlar mağazanızın varsayılan para biriminde; bu durumda yöntemi gizlemek için tabloyu ve Other countries alanını boş bırakın)

Prices by country: ülke başına bir Base fiyatı ve paket ağırlığına göre boyut sütunları olan bir tablo: XS 1 kg'a kadar, S 2 kg'a kadar, M 3 kg'a kadar, L 5 kg'a kadar ve XL 5 kg'ın üzeri. Satır eklemek için Add country düğmesine tıklayın. Boş bir boyut temel fiyatı kullanır. 0 temel fiyatı ücretsiz kargo anlamına gelir. * Default (all other countries) satırı, kendi satırı olmayan ülkeler için geçerlidir. Hiçbir fiyatı olmayan bir satır kaydedilmez.

Other countries: tabloda ülke için fiyat olmadığında uygulanan fiyat. Bu durumda yöntemi gizlemek için boş bırakın.

Koşullar

Free shipping from: kargo gerektiren ürünlerin ara toplamı (kupondan sonra, vergi öncesi); bu tutardan itibaren kargo ücretsizdir. Bu durumda ShipStation'a istek gönderilmez. Kapatmak için boş bırakın.

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

Minimum weight: yöntemin gösterilmesi için mağazanızın ağırlık biriminde (alan adında gösterilir) en düşük sepet ağırlığı. 0 sınır olmadığı anlamına gelir (varsayılan).

Maximum weight: yöntem, mağazanızın ağırlık birimindeki bu sepet ağırlığının üzerinde gizlenir. 0 sınır olmadığı anlamına gelir (varsayılan).

Kullanılabilirlik

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. Ignore shipping zones açıkken kontrol edilmez. Coğrafi bölgeler System > Localisation > Geo Zones sayfasında yönetilir.

Ignore shipping zones: coğrafi bölgeden bağımsız olarak yöntemi 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: ShipStation isteklerini storage/logs/vfd_shst_debug.log.php dosyasına kaydeder (OpenCart 4'te system/storage/logs/vfd_shst_debug.log.php). Dosya web üzerinden okunamaz. API hataları bu seçenek kapalı olsa bile her zaman kaydedilir. API Key, API Secret ve müşteri adresleri asla kaydedilmez. Posta kodu gizlenir. Dosya 5 MB'a ulaştığında vfd_shst_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 en son girişlerini gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Remove data on uninstall: açıksa eklentiyi kaldırmak ShipStation ayarlarını ve günlüğü siler. Kapalıysa (varsayılan), yeniden kurulum için saklanırlar. Önbelleğe alınmış tarifeler her zaman kaldırılır. Verilmiş siparişlerin ShipStation hizmeti her zaman korunur.

İçe / Dışa Aktarma

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

Import: daha önce dışa aktarılmış 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. Kaydedilmiş API Key ve API Secret korunur.

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

OpenCart kargo yöntemlerini gösterdiğinde, eklentiden ShipStation 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 sayılır: diğer ürünler ağırlık eklemez ve ara toplama dahil edilmez. Eklenti ardından koşulları kontrol eder: izin verilen ülkeler (Ignore shipping zones ile), sepet ağırlığı ve minimum ara toplam. Hediye sertifikaları, puanlar ve mağaza kredisi dikkate alınmaz. Ücretsiz kargo uygulanırsa yöntem 0 fiyatla gösterilir ve ShipStation'a istek gönderilmez.

Eklenti daha sonra ShipStation'a gönderici posta kodunu, hedef ülkeyi, eyalet kodunu, şehri ve posta kodunu, paket ağırlığını ve kutu boyutunu gönderir. Müşteri bir posta kodu girmeden hiçbir istek yapılmaz. Posta kodu olmayan ülkeler yedek fiyatları alır. Ürünler tek bir kutuya yerleştirilir. Bir ürünün boyutu yoksa paket yalnızca ağırlığa göre tarifelendirilir.

ShipStation her kargo firması kodu için bir kez sorgulanır. Eklenti en ucuz izin verilen tarifeyi kullanır, bunu mağazanızın varsayılan para birimine çevirir ve ondalık basamaklarına yuvarlar. Fiyat daha sonra seçilen Tax class vergisiyle müşterinin para biriminde gösterilir.

Her yanıt 1 saat önbelleğe alınır. ShipStation kullanılabilir bir tarife olmadan yanıt verirse, yanıt 10 dakika hatırlanır. ShipStation anahtarları reddederse veya ulaşılamazsa, istekler 5 dakika duraklatılır. İstek limitinden sonra duraklama, ShipStation'ın bildirdiği sıfırlama zamanını izler. İstek zaman aşımı 12 saniyedir.

Anlık tarife yoksa fiyat önce yedek tablodan, sonra Other countries alanından alınır. Hiçbiri geçerli değilse yöntem gizlenir. Müşteri ShipStation hata metinlerini asla görmez. Ayrıntılar hata ayıklama günlüğüne gider.

Eklenti yalnızca tarifeleri hesaplar. ShipStation'da etiket satın almaz, sipariş veya gönderi oluşturmaz, paketleri takip etmez ve iadeleri yönetmez. Teslim noktası yoktur, ödeme sayfasında birden fazla hizmet arasında seçim yoktur, adres doğrulama, sigorta, imza onayı, birden fazla pakete bölme veya tarife üzerine ek ücret yoktur.

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

Siparişler

Bir sipariş canlı bir ShipStation tarifesiyle verildiğinde, seçilen hizmet siparişle birlikte kaydedilir. Siparişi Sales > Orders bölümünde açın: sipariş geçmişinin üstündeki ShipStation paneli bunu Service olarak gösterir, örneğin "USPS Ground Advantage - Package", böylece ShipStation'da karşılık gelen etiketi oluşturabilirsiniz. Ürün başına modda hizmetler virgülle ayrılmış olarak listelenir. Sepetteki sonraki değişiklikler bunu değiştirmez ve yöntemi kapattıktan sonra da panel gösterilmeye devam eder. Yedek fiyat veya ücretsiz kargo ile verilen siparişlerde ShipStation paneli yoktur.

OpenCart 4, ödeme için tek bir sipariş tutar ve müşteri her onayladığında bunu günceller. Kaydedilmiş ShipStation hizmeti de onunla birlikte güncellenir. Müşteri başka bir kargo yöntemine geçerse ya da şimdi yedek fiyat uygulanırsa, kaydedilmiş hizmet siparişten kaldırılır.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox ShipStation lisans bloğu, ayarların üstünde, Extensions > Extensions > Shipping > VibeFox ShipStation > Edit sayfasının ilk bloğudur. 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 düğmesini (durumu yeniden kontrol eder), Change key düğmesini (başka bir anahtar girer) ve Remove key düğmesini (anahtarı bu mağazadan kaldırır) gösterir. Bunların altında Product: opencart-shipping-shipstation satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca eklenti için Modify yetkisi olan yönetici kullanıcılar 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 tarihli License expired on. Mağaza adresi değiştikten sonra ya da 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 adresinde. 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 ShipStation ödeme sayfasında müşterilere gösterilmez ve tarife hesaplanmaz. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı yöntemi mağazada yine görür; bu yöntem (unlicensed — visible to admins only) ile işaretlenir. Böylece bir 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 olmadan yöntem herkesten 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 sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Durum, yönetici Dashboard sayfasını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün bir kez, ardından haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

ShipStation ödeme sayfasında görünmüyor: lisansın etkin olduğunu ve Enable ShipStation shipping seçeneğinin açık olduğunu kontrol edin. Geo zone değerini (veya Ignore shipping zones açıksa Countries değerini), ağırlık sınırlarını ve Minimum subtotal değerini kontrol edin. Anlık tarife yoksa ülkenin, * Default değerinin veya Other countries değerinin bir fiyatı olup olmadığını kontrol edin. Ürünlerin Requires Shipping değerinin Yes olduğunu kontrol edin.

Ödeme sayfası ShipStation tarifesi yerine yedek fiyatı gösteriyor: eklenti sayfasının üstündeki uyarıları (anahtarlar, kargo firması kodu, gönderici posta kodu, döviz kuru) kontrol edin. Debug log seçeneğini açın, ödeme sayfasını yenileyin ve Log alanına bakın. Müşterinin posta kodu zorunludur. Girilmeden hiçbir istek yapılmaz.

Hangi kargo firması kodunun girileceği: ayarları anahtar ve gizli anahtar ile kaydedin. Sayfa hesabınızın kargo firması kodlarını listeler. Bunlardan bir veya birkaçını kullanın.

ShipStation bağlantı kontrolü başarısız oldu: mesaj nedeni gösterir. API Key ve API Secret değerlerini kontrol edin, ardından kontrolü tekrarlamak için yeniden kaydedin.

Tarife ShipStation'dan farklı: paket, ürün ağırlıklarından ve boyutlarından, ürünler tek bir kutuda birleştirilerek oluşturulur. Boyutu olmayan ürünler yalnızca ağırlığa göre tarifelendirilir. Tarifeler 1 saat önbelleğe alınır. Önbelleği temizlemek için eklenti sayfasında Save düğmesine tıklayın.

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

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

Kaldırma

Extensions > Extensions sayfasına gidin, Shipping türünü seçin ve VibeFox ShipStation 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 ShipStation shipping, Sort order, Tax class ve Geo zone değerlerini sıfırlar. Önbelleğe alınmış tarifeler ve bağlantı kontrolünün sonucu her zaman kaldırılır. Remove data on uninstall açıksa ShipStation 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 ShipStation hizmetini korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox ShipStation 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.

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